@celerity-sdk/serverless-aws 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @celerity-sdk/serverless-aws
 
-AWS Lambda adapter for the Celerity Node SDK — maps API Gateway v2 events to SDK types and routes them through the handler pipeline.
+AWS Lambda adapter for the Celerity Node SDK. Maps API Gateway v2 events to SDK types and routes them through the handler pipeline.
 
 ## Installation
 
@@ -14,10 +14,20 @@ The `AwsLambdaAdapter` implements the `ServerlessAdapter` interface from `@celer
 
 1. Receives an API Gateway v2 proxy event
 2. Maps it to an `HttpRequest` via `mapApiGatewayV2Event`
-3. Resolves the matching handler from the registry
+3. Resolves the matching handler using the three-tier resolution chain (see below)
 4. Executes the full handler pipeline (system layers, app layers, handler layers, handler)
 5. Maps the `HttpResponse` back to an `APIGatewayProxyResultV2`
 
+### Handler Resolution
+
+When `CELERITY_HANDLER_ID` is set (typical for serverless deployments where each Lambda maps to a single handler), the adapter resolves the handler using a three-tier chain:
+
+1. **Direct registry lookup** - `registry.getHandlerById(CELERITY_HANDLER_ID)` for handlers with an explicit ID
+2. **Module resolution fallback** - dynamically imports the handler module and matches the exported function against the registry by reference. Supports formats like `"handlers.hello"` (named export) and `"handlers"` (default export). Dotted module names like `"app.module"` are handled by trying the named export split first, then falling back to the full string as a module with a default export.
+3. **Path/method routing** - falls back to matching the incoming request's HTTP method and path
+
+Resolution is cached: once a handler is matched on cold start, subsequent warm invocations use the cached handler directly without repeating the lookup.
+
 ### Event Mapping
 
 `mapApiGatewayV2Event` extracts from the API Gateway v2 event:
@@ -33,7 +43,7 @@ The `AwsLambdaAdapter` implements the `ServerlessAdapter` interface from `@celer
 The `./handler` export provides a pre-configured Lambda handler that bootstraps the application module, initialises system layers, and caches the handler for warm invocations. It also registers a SIGTERM handler for graceful shutdown (container close + layer disposal).
 
 ```typescript
-// handler.ts — used as the Lambda entry point
+// handler.ts - used as the Lambda entry point
 export { handler } from "@celerity-sdk/serverless-aws/handler";
 ```
 

package/dist/entry.cjs

@@ -34,6 +34,7 @@ __export(entry_exports, {
   handler: () => handler
 });
 module.exports = __toCommonJS(entry_exports);
+var import_node_path = require("path");
 var import_debug2 = __toESM(require("debug"), 1);
 var import_core = require("@celerity-sdk/core");
 
@@ -162,12 +163,14 @@ async function ensureBootstrapped() {
     debug2("entry: %d system layers created", systemLayers.length);
     const rootModule = await (0, import_core.discoverModule)();
     const result = await (0, import_core.bootstrap)(rootModule);
+    const modulePath = process.env.CELERITY_MODULE_PATH;
     cached = {
       registry: result.registry,
       options: {
         container: result.container,
         systemLayers
-      }
+      },
+      moduleDir: modulePath ? (0, import_node_path.dirname)((0, import_node_path.resolve)(modulePath)) : process.cwd()
     };
     debug2("entry: bootstrap complete");
   }
@@ -175,12 +178,19 @@ async function ensureBootstrapped() {
 }
 __name(ensureBootstrapped, "ensureBootstrapped");
 async function handler(event, _context) {
-  const { registry, options } = await ensureBootstrapped();
+  const { registry, options, moduleDir } = await ensureBootstrapped();
   registerShutdownHandler(options);
   const apiEvent = event;
   const httpRequest = mapApiGatewayV2Event(apiEvent);
   debug2("entry: %s %s", httpRequest.method, httpRequest.path);
-  const resolved = registry.getHandler(httpRequest.path, httpRequest.method);
+  const handlerId = process.env.CELERITY_HANDLER_ID;
+  let resolved = handlerId ? registry.getHandlerById(handlerId) : void 0;
+  if (!resolved && handlerId) {
+    resolved = await (0, import_core.resolveHandlerByModuleRef)(handlerId, registry, moduleDir) ?? void 0;
+  }
+  if (!resolved) {
+    resolved = registry.getHandler(httpRequest.path, httpRequest.method);
+  }
   if (!resolved) {
     return {
       statusCode: 404,

package/dist/entry.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/entry.ts","../src/event-mapper.ts"],"sourcesContent":["import createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type { PipelineOptions } from \"@celerity-sdk/core\";\nimport {\n  discoverModule,\n  bootstrap,\n  executeHandlerPipeline,\n  createDefaultSystemLayers,\n  disposeLayers,\n} from \"@celerity-sdk/core\";\nimport type { HandlerRegistry } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nlet cached: { registry: HandlerRegistry; options: PipelineOptions } | null = null;\nlet shutdownRegistered = false;\n\nfunction registerShutdownHandler(options: PipelineOptions): void {\n  if (shutdownRegistered) return;\n  shutdownRegistered = true;\n  debug(\"entry: SIGTERM shutdown handler registered\");\n\n  process.on(\"SIGTERM\", async () => {\n    await options.container.closeAll();\n    await disposeLayers([...(options.systemLayers ?? []), ...(options.appLayers ?? [])]);\n    process.exit(0);\n  });\n}\n\nasync function ensureBootstrapped(): Promise<{\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n}> {\n  if (!cached) {\n    debug(\"entry: cold start, bootstrapping\");\n    const systemLayers = await createDefaultSystemLayers();\n    debug(\"entry: %d system layers created\", systemLayers.length);\n    const rootModule = await discoverModule();\n    const result = await bootstrap(rootModule);\n    cached = {\n      registry: result.registry,\n      options: {\n        container: result.container,\n        systemLayers,\n      },\n    };\n    debug(\"entry: bootstrap complete\");\n  }\n  return cached;\n}\n\nexport async function handler(event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> {\n  const { registry, options } = await ensureBootstrapped();\n  registerShutdownHandler(options);\n  const apiEvent = event as APIGatewayProxyEventV2;\n  const httpRequest = mapApiGatewayV2Event(apiEvent);\n  debug(\"entry: %s %s\", httpRequest.method, httpRequest.path);\n\n  const resolved = registry.getHandler(httpRequest.path, httpRequest.method);\n  if (!resolved) {\n    return {\n      statusCode: 404,\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        statusCode: 404,\n        message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n      }),\n    };\n  }\n\n  const httpResponse = await executeHandlerPipeline(resolved, httpRequest, options);\n  return mapHttpResponseToResult(httpResponse);\n}\n","import createDebug from \"debug\";\nimport type { HttpMethod, HttpRequest, HttpResponse } from \"@celerity-sdk/types\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from \"aws-lambda\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nfunction parseBody(event: APIGatewayProxyEventV2): {\n  textBody: string | null;\n  binaryBody: Buffer | null;\n} {\n  if (!event.body) return { textBody: null, binaryBody: null };\n  if (event.isBase64Encoded)\n    return { textBody: null, binaryBody: Buffer.from(event.body, \"base64\") };\n  return { textBody: event.body, binaryBody: null };\n}\n\nfunction parseHeaders(event: APIGatewayProxyEventV2): Record<string, string | string[]> {\n  const headers: Record<string, string | string[]> = {};\n  if (!event.headers) return headers;\n\n  for (const [key, value] of Object.entries(event.headers)) {\n    if (value !== undefined) {\n      headers[key.toLowerCase()] = value;\n    }\n  }\n  return headers;\n}\n\nfunction parseCookies(event: APIGatewayProxyEventV2): Record<string, string> {\n  const cookies: Record<string, string> = {};\n  if (!event.cookies) return cookies;\n\n  for (const cookie of event.cookies) {\n    const eqIndex = cookie.indexOf(\"=\");\n    if (eqIndex > 0) {\n      cookies[cookie.slice(0, eqIndex).trim()] = cookie.slice(eqIndex + 1).trim();\n    }\n  }\n  return cookies;\n}\n\nfunction parsePathParams(event: APIGatewayProxyEventV2): Record<string, string> {\n  const params: Record<string, string> = {};\n  if (!event.pathParameters) return params;\n\n  for (const [key, value] of Object.entries(event.pathParameters)) {\n    if (value !== undefined) {\n      params[key] = value;\n    }\n  }\n  return params;\n}\n\nexport function mapApiGatewayV2Event(event: APIGatewayProxyEventV2): HttpRequest {\n  const method = event.requestContext.http.method.toUpperCase() as HttpMethod;\n  const headers = parseHeaders(event);\n  const { textBody, binaryBody } = parseBody(event);\n\n  const authorizer = (\n    event.requestContext as unknown as {\n      authorizer?: { jwt?: { claims?: Record<string, unknown> } };\n    }\n  ).authorizer;\n\n  const contentType = (headers[\"content-type\"] as string | undefined) ?? null;\n  const xrayHeader = (headers[\"x-amzn-trace-id\"] as string | undefined) ?? null;\n\n  const request: HttpRequest = {\n    method,\n    path: event.rawPath,\n    pathParams: parsePathParams(event),\n    query: (event.queryStringParameters ?? {}) as Record<string, string | string[]>,\n    headers,\n    cookies: parseCookies(event),\n    textBody,\n    binaryBody,\n    contentType,\n    requestId: event.requestContext.requestId,\n    requestTime: event.requestContext.time ?? new Date().toISOString(),\n    auth: authorizer?.jwt?.claims ?? null,\n    clientIp: event.requestContext.http.sourceIp,\n    traceContext: xrayHeader ? { \"x-amzn-trace-id\": xrayHeader } : null,\n    userAgent: event.requestContext.http.userAgent ?? null,\n    matchedRoute: event.routeKey ?? null,\n  };\n\n  debug(\n    \"mapEvent: %s %s (auth=%s, traceContext=%s)\",\n    method,\n    event.rawPath,\n    !!authorizer?.jwt?.claims,\n    !!xrayHeader,\n  );\n\n  return request;\n}\n\nexport function mapHttpResponseToResult(response: HttpResponse): APIGatewayProxyStructuredResultV2 {\n  const result: APIGatewayProxyStructuredResultV2 = {\n    statusCode: response.status,\n  };\n\n  if (response.headers) {\n    result.headers = response.headers;\n  }\n\n  if (response.binaryBody) {\n    result.body = response.binaryBody.toString(\"base64\");\n    result.isBase64Encoded = true;\n  } else if (response.body) {\n    result.body = response.body;\n  }\n\n  return result;\n}\n"],"mappings":"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","names":["import_debug","debug","createDebug","parseBody","event","body","textBody","binaryBody","isBase64Encoded","Buffer","from","parseHeaders","headers","key","value","Object","entries","undefined","toLowerCase","parseCookies","cookies","cookie","eqIndex","indexOf","slice","trim","parsePathParams","params","pathParameters","mapApiGatewayV2Event","method","requestContext","http","toUpperCase","authorizer","contentType","xrayHeader","request","path","rawPath","pathParams","query","queryStringParameters","requestId","requestTime","time","Date","toISOString","auth","jwt","claims","clientIp","sourceIp","traceContext","userAgent","matchedRoute","routeKey","mapHttpResponseToResult","response","result","statusCode","status","toString","debug","createDebug","cached","shutdownRegistered","registerShutdownHandler","options","process","on","container","closeAll","disposeLayers","systemLayers","appLayers","exit","ensureBootstrapped","createDefaultSystemLayers","length","rootModule","discoverModule","result","bootstrap","registry","handler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","resolved","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult"]}
+{"version":3,"sources":["../src/entry.ts","../src/event-mapper.ts"],"sourcesContent":["import { dirname, resolve } from \"node:path\";\nimport createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type { PipelineOptions } from \"@celerity-sdk/core\";\nimport {\n  discoverModule,\n  bootstrap,\n  executeHandlerPipeline,\n  createDefaultSystemLayers,\n  disposeLayers,\n  resolveHandlerByModuleRef,\n} from \"@celerity-sdk/core\";\nimport type { HandlerRegistry } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nlet cached: {\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n  moduleDir: string;\n} | null = null;\nlet shutdownRegistered = false;\n\nfunction registerShutdownHandler(options: PipelineOptions): void {\n  if (shutdownRegistered) return;\n  shutdownRegistered = true;\n  debug(\"entry: SIGTERM shutdown handler registered\");\n\n  process.on(\"SIGTERM\", async () => {\n    await options.container.closeAll();\n    await disposeLayers([...(options.systemLayers ?? []), ...(options.appLayers ?? [])]);\n    process.exit(0);\n  });\n}\n\nasync function ensureBootstrapped(): Promise<{\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n  moduleDir: string;\n}> {\n  if (!cached) {\n    debug(\"entry: cold start, bootstrapping\");\n    const systemLayers = await createDefaultSystemLayers();\n    debug(\"entry: %d system layers created\", systemLayers.length);\n    const rootModule = await discoverModule();\n    const result = await bootstrap(rootModule);\n    const modulePath = process.env.CELERITY_MODULE_PATH;\n    cached = {\n      registry: result.registry,\n      options: {\n        container: result.container,\n        systemLayers,\n      },\n      moduleDir: modulePath ? dirname(resolve(modulePath)) : process.cwd(),\n    };\n    debug(\"entry: bootstrap complete\");\n  }\n  return cached;\n}\n\nexport async function handler(event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> {\n  const { registry, options, moduleDir } = await ensureBootstrapped();\n  registerShutdownHandler(options);\n  const apiEvent = event as APIGatewayProxyEventV2;\n  const httpRequest = mapApiGatewayV2Event(apiEvent);\n  debug(\"entry: %s %s\", httpRequest.method, httpRequest.path);\n\n  const handlerId = process.env.CELERITY_HANDLER_ID;\n\n  let resolved = handlerId ? registry.getHandlerById(handlerId) : undefined;\n\n  if (!resolved && handlerId) {\n    resolved = (await resolveHandlerByModuleRef(handlerId, registry, moduleDir)) ?? undefined;\n  }\n\n  if (!resolved) {\n    resolved = registry.getHandler(httpRequest.path, httpRequest.method);\n  }\n\n  if (!resolved) {\n    return {\n      statusCode: 404,\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        statusCode: 404,\n        message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n      }),\n    };\n  }\n\n  const httpResponse = await executeHandlerPipeline(resolved, httpRequest, options);\n  return mapHttpResponseToResult(httpResponse);\n}\n","import createDebug from \"debug\";\nimport type { HttpMethod, HttpRequest, HttpResponse } from \"@celerity-sdk/types\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from \"aws-lambda\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nfunction parseBody(event: APIGatewayProxyEventV2): {\n  textBody: string | null;\n  binaryBody: Buffer | null;\n} {\n  if (!event.body) return { textBody: null, binaryBody: null };\n  if (event.isBase64Encoded)\n    return { textBody: null, binaryBody: Buffer.from(event.body, \"base64\") };\n  return { textBody: event.body, binaryBody: null };\n}\n\nfunction parseHeaders(event: APIGatewayProxyEventV2): Record<string, string | string[]> {\n  const headers: Record<string, string | string[]> = {};\n  if (!event.headers) return headers;\n\n  for (const [key, value] of Object.entries(event.headers)) {\n    if (value !== undefined) {\n      headers[key.toLowerCase()] = value;\n    }\n  }\n  return headers;\n}\n\nfunction parseCookies(event: APIGatewayProxyEventV2): Record<string, string> {\n  const cookies: Record<string, string> = {};\n  if (!event.cookies) return cookies;\n\n  for (const cookie of event.cookies) {\n    const eqIndex = cookie.indexOf(\"=\");\n    if (eqIndex > 0) {\n      cookies[cookie.slice(0, eqIndex).trim()] = cookie.slice(eqIndex + 1).trim();\n    }\n  }\n  return cookies;\n}\n\nfunction parsePathParams(event: APIGatewayProxyEventV2): Record<string, string> {\n  const params: Record<string, string> = {};\n  if (!event.pathParameters) return params;\n\n  for (const [key, value] of Object.entries(event.pathParameters)) {\n    if (value !== undefined) {\n      params[key] = value;\n    }\n  }\n  return params;\n}\n\nexport function mapApiGatewayV2Event(event: APIGatewayProxyEventV2): HttpRequest {\n  const method = event.requestContext.http.method.toUpperCase() as HttpMethod;\n  const headers = parseHeaders(event);\n  const { textBody, binaryBody } = parseBody(event);\n\n  const authorizer = (\n    event.requestContext as unknown as {\n      authorizer?: { jwt?: { claims?: Record<string, unknown> } };\n    }\n  ).authorizer;\n\n  const contentType = (headers[\"content-type\"] as string | undefined) ?? null;\n  const xrayHeader = (headers[\"x-amzn-trace-id\"] as string | undefined) ?? null;\n\n  const request: HttpRequest = {\n    method,\n    path: event.rawPath,\n    pathParams: parsePathParams(event),\n    query: (event.queryStringParameters ?? {}) as Record<string, string | string[]>,\n    headers,\n    cookies: parseCookies(event),\n    textBody,\n    binaryBody,\n    contentType,\n    requestId: event.requestContext.requestId,\n    requestTime: event.requestContext.time ?? new Date().toISOString(),\n    auth: authorizer?.jwt?.claims ?? null,\n    clientIp: event.requestContext.http.sourceIp,\n    traceContext: xrayHeader ? { \"x-amzn-trace-id\": xrayHeader } : null,\n    userAgent: event.requestContext.http.userAgent ?? null,\n    matchedRoute: event.routeKey ?? null,\n  };\n\n  debug(\n    \"mapEvent: %s %s (auth=%s, traceContext=%s)\",\n    method,\n    event.rawPath,\n    !!authorizer?.jwt?.claims,\n    !!xrayHeader,\n  );\n\n  return request;\n}\n\nexport function mapHttpResponseToResult(response: HttpResponse): APIGatewayProxyStructuredResultV2 {\n  const result: APIGatewayProxyStructuredResultV2 = {\n    statusCode: response.status,\n  };\n\n  if (response.headers) {\n    result.headers = response.headers;\n  }\n\n  if (response.binaryBody) {\n    result.body = response.binaryBody.toString(\"base64\");\n    result.isBase64Encoded = true;\n  } else if (response.body) {\n    result.body = response.body;\n  }\n\n  return result;\n}\n"],"mappings":"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","names":["import_debug","debug","createDebug","parseBody","event","body","textBody","binaryBody","isBase64Encoded","Buffer","from","parseHeaders","headers","key","value","Object","entries","undefined","toLowerCase","parseCookies","cookies","cookie","eqIndex","indexOf","slice","trim","parsePathParams","params","pathParameters","mapApiGatewayV2Event","method","requestContext","http","toUpperCase","authorizer","contentType","xrayHeader","request","path","rawPath","pathParams","query","queryStringParameters","requestId","requestTime","time","Date","toISOString","auth","jwt","claims","clientIp","sourceIp","traceContext","userAgent","matchedRoute","routeKey","mapHttpResponseToResult","response","result","statusCode","status","toString","debug","createDebug","cached","shutdownRegistered","registerShutdownHandler","options","process","on","container","closeAll","disposeLayers","systemLayers","appLayers","exit","ensureBootstrapped","createDefaultSystemLayers","length","rootModule","discoverModule","result","bootstrap","modulePath","env","CELERITY_MODULE_PATH","registry","moduleDir","dirname","resolve","cwd","handler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","handlerId","CELERITY_HANDLER_ID","resolved","getHandlerById","undefined","resolveHandlerByModuleRef","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult"]}

package/dist/entry.js

@@ -2,8 +2,9 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/entry.ts
+import { dirname, resolve } from "path";
 import createDebug2 from "debug";
-import { discoverModule, bootstrap, executeHandlerPipeline, createDefaultSystemLayers, disposeLayers } from "@celerity-sdk/core";
+import { discoverModule, bootstrap, executeHandlerPipeline, createDefaultSystemLayers, disposeLayers, resolveHandlerByModuleRef } from "@celerity-sdk/core";
 
 // src/event-mapper.ts
 import createDebug from "debug";
@@ -130,12 +131,14 @@ async function ensureBootstrapped() {
     debug2("entry: %d system layers created", systemLayers.length);
     const rootModule = await discoverModule();
     const result = await bootstrap(rootModule);
+    const modulePath = process.env.CELERITY_MODULE_PATH;
     cached = {
       registry: result.registry,
       options: {
         container: result.container,
         systemLayers
-      }
+      },
+      moduleDir: modulePath ? dirname(resolve(modulePath)) : process.cwd()
     };
     debug2("entry: bootstrap complete");
   }
@@ -143,12 +146,19 @@ async function ensureBootstrapped() {
 }
 __name(ensureBootstrapped, "ensureBootstrapped");
 async function handler(event, _context) {
-  const { registry, options } = await ensureBootstrapped();
+  const { registry, options, moduleDir } = await ensureBootstrapped();
   registerShutdownHandler(options);
   const apiEvent = event;
   const httpRequest = mapApiGatewayV2Event(apiEvent);
   debug2("entry: %s %s", httpRequest.method, httpRequest.path);
-  const resolved = registry.getHandler(httpRequest.path, httpRequest.method);
+  const handlerId = process.env.CELERITY_HANDLER_ID;
+  let resolved = handlerId ? registry.getHandlerById(handlerId) : void 0;
+  if (!resolved && handlerId) {
+    resolved = await resolveHandlerByModuleRef(handlerId, registry, moduleDir) ?? void 0;
+  }
+  if (!resolved) {
+    resolved = registry.getHandler(httpRequest.path, httpRequest.method);
+  }
   if (!resolved) {
     return {
       statusCode: 404,

package/dist/entry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/entry.ts","../src/event-mapper.ts"],"sourcesContent":["import createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type { PipelineOptions } from \"@celerity-sdk/core\";\nimport {\n  discoverModule,\n  bootstrap,\n  executeHandlerPipeline,\n  createDefaultSystemLayers,\n  disposeLayers,\n} from \"@celerity-sdk/core\";\nimport type { HandlerRegistry } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nlet cached: { registry: HandlerRegistry; options: PipelineOptions } | null = null;\nlet shutdownRegistered = false;\n\nfunction registerShutdownHandler(options: PipelineOptions): void {\n  if (shutdownRegistered) return;\n  shutdownRegistered = true;\n  debug(\"entry: SIGTERM shutdown handler registered\");\n\n  process.on(\"SIGTERM\", async () => {\n    await options.container.closeAll();\n    await disposeLayers([...(options.systemLayers ?? []), ...(options.appLayers ?? [])]);\n    process.exit(0);\n  });\n}\n\nasync function ensureBootstrapped(): Promise<{\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n}> {\n  if (!cached) {\n    debug(\"entry: cold start, bootstrapping\");\n    const systemLayers = await createDefaultSystemLayers();\n    debug(\"entry: %d system layers created\", systemLayers.length);\n    const rootModule = await discoverModule();\n    const result = await bootstrap(rootModule);\n    cached = {\n      registry: result.registry,\n      options: {\n        container: result.container,\n        systemLayers,\n      },\n    };\n    debug(\"entry: bootstrap complete\");\n  }\n  return cached;\n}\n\nexport async function handler(event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> {\n  const { registry, options } = await ensureBootstrapped();\n  registerShutdownHandler(options);\n  const apiEvent = event as APIGatewayProxyEventV2;\n  const httpRequest = mapApiGatewayV2Event(apiEvent);\n  debug(\"entry: %s %s\", httpRequest.method, httpRequest.path);\n\n  const resolved = registry.getHandler(httpRequest.path, httpRequest.method);\n  if (!resolved) {\n    return {\n      statusCode: 404,\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        statusCode: 404,\n        message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n      }),\n    };\n  }\n\n  const httpResponse = await executeHandlerPipeline(resolved, httpRequest, options);\n  return mapHttpResponseToResult(httpResponse);\n}\n","import createDebug from \"debug\";\nimport type { HttpMethod, HttpRequest, HttpResponse } from \"@celerity-sdk/types\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from \"aws-lambda\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nfunction parseBody(event: APIGatewayProxyEventV2): {\n  textBody: string | null;\n  binaryBody: Buffer | null;\n} {\n  if (!event.body) return { textBody: null, binaryBody: null };\n  if (event.isBase64Encoded)\n    return { textBody: null, binaryBody: Buffer.from(event.body, \"base64\") };\n  return { textBody: event.body, binaryBody: null };\n}\n\nfunction parseHeaders(event: APIGatewayProxyEventV2): Record<string, string | string[]> {\n  const headers: Record<string, string | string[]> = {};\n  if (!event.headers) return headers;\n\n  for (const [key, value] of Object.entries(event.headers)) {\n    if (value !== undefined) {\n      headers[key.toLowerCase()] = value;\n    }\n  }\n  return headers;\n}\n\nfunction parseCookies(event: APIGatewayProxyEventV2): Record<string, string> {\n  const cookies: Record<string, string> = {};\n  if (!event.cookies) return cookies;\n\n  for (const cookie of event.cookies) {\n    const eqIndex = cookie.indexOf(\"=\");\n    if (eqIndex > 0) {\n      cookies[cookie.slice(0, eqIndex).trim()] = cookie.slice(eqIndex + 1).trim();\n    }\n  }\n  return cookies;\n}\n\nfunction parsePathParams(event: APIGatewayProxyEventV2): Record<string, string> {\n  const params: Record<string, string> = {};\n  if (!event.pathParameters) return params;\n\n  for (const [key, value] of Object.entries(event.pathParameters)) {\n    if (value !== undefined) {\n      params[key] = value;\n    }\n  }\n  return params;\n}\n\nexport function mapApiGatewayV2Event(event: APIGatewayProxyEventV2): HttpRequest {\n  const method = event.requestContext.http.method.toUpperCase() as HttpMethod;\n  const headers = parseHeaders(event);\n  const { textBody, binaryBody } = parseBody(event);\n\n  const authorizer = (\n    event.requestContext as unknown as {\n      authorizer?: { jwt?: { claims?: Record<string, unknown> } };\n    }\n  ).authorizer;\n\n  const contentType = (headers[\"content-type\"] as string | undefined) ?? null;\n  const xrayHeader = (headers[\"x-amzn-trace-id\"] as string | undefined) ?? null;\n\n  const request: HttpRequest = {\n    method,\n    path: event.rawPath,\n    pathParams: parsePathParams(event),\n    query: (event.queryStringParameters ?? {}) as Record<string, string | string[]>,\n    headers,\n    cookies: parseCookies(event),\n    textBody,\n    binaryBody,\n    contentType,\n    requestId: event.requestContext.requestId,\n    requestTime: event.requestContext.time ?? new Date().toISOString(),\n    auth: authorizer?.jwt?.claims ?? null,\n    clientIp: event.requestContext.http.sourceIp,\n    traceContext: xrayHeader ? { \"x-amzn-trace-id\": xrayHeader } : null,\n    userAgent: event.requestContext.http.userAgent ?? null,\n    matchedRoute: event.routeKey ?? null,\n  };\n\n  debug(\n    \"mapEvent: %s %s (auth=%s, traceContext=%s)\",\n    method,\n    event.rawPath,\n    !!authorizer?.jwt?.claims,\n    !!xrayHeader,\n  );\n\n  return request;\n}\n\nexport function mapHttpResponseToResult(response: HttpResponse): APIGatewayProxyStructuredResultV2 {\n  const result: APIGatewayProxyStructuredResultV2 = {\n    statusCode: response.status,\n  };\n\n  if (response.headers) {\n    result.headers = response.headers;\n  }\n\n  if (response.binaryBody) {\n    result.body = response.binaryBody.toString(\"base64\");\n    result.isBase64Encoded = true;\n  } else if (response.body) {\n    result.body = response.body;\n  }\n\n  return result;\n}\n"],"mappings":"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","names":["createDebug","discoverModule","bootstrap","executeHandlerPipeline","createDefaultSystemLayers","disposeLayers","createDebug","debug","createDebug","parseBody","event","body","textBody","binaryBody","isBase64Encoded","Buffer","from","parseHeaders","headers","key","value","Object","entries","undefined","toLowerCase","parseCookies","cookies","cookie","eqIndex","indexOf","slice","trim","parsePathParams","params","pathParameters","mapApiGatewayV2Event","method","requestContext","http","toUpperCase","authorizer","contentType","xrayHeader","request","path","rawPath","pathParams","query","queryStringParameters","requestId","requestTime","time","Date","toISOString","auth","jwt","claims","clientIp","sourceIp","traceContext","userAgent","matchedRoute","routeKey","mapHttpResponseToResult","response","result","statusCode","status","toString","debug","createDebug","cached","shutdownRegistered","registerShutdownHandler","options","process","on","container","closeAll","disposeLayers","systemLayers","appLayers","exit","ensureBootstrapped","createDefaultSystemLayers","length","rootModule","discoverModule","result","bootstrap","registry","handler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","resolved","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult"]}
+{"version":3,"sources":["../src/entry.ts","../src/event-mapper.ts"],"sourcesContent":["import { dirname, resolve } from \"node:path\";\nimport createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type { PipelineOptions } from \"@celerity-sdk/core\";\nimport {\n  discoverModule,\n  bootstrap,\n  executeHandlerPipeline,\n  createDefaultSystemLayers,\n  disposeLayers,\n  resolveHandlerByModuleRef,\n} from \"@celerity-sdk/core\";\nimport type { HandlerRegistry } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nlet cached: {\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n  moduleDir: string;\n} | null = null;\nlet shutdownRegistered = false;\n\nfunction registerShutdownHandler(options: PipelineOptions): void {\n  if (shutdownRegistered) return;\n  shutdownRegistered = true;\n  debug(\"entry: SIGTERM shutdown handler registered\");\n\n  process.on(\"SIGTERM\", async () => {\n    await options.container.closeAll();\n    await disposeLayers([...(options.systemLayers ?? []), ...(options.appLayers ?? [])]);\n    process.exit(0);\n  });\n}\n\nasync function ensureBootstrapped(): Promise<{\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n  moduleDir: string;\n}> {\n  if (!cached) {\n    debug(\"entry: cold start, bootstrapping\");\n    const systemLayers = await createDefaultSystemLayers();\n    debug(\"entry: %d system layers created\", systemLayers.length);\n    const rootModule = await discoverModule();\n    const result = await bootstrap(rootModule);\n    const modulePath = process.env.CELERITY_MODULE_PATH;\n    cached = {\n      registry: result.registry,\n      options: {\n        container: result.container,\n        systemLayers,\n      },\n      moduleDir: modulePath ? dirname(resolve(modulePath)) : process.cwd(),\n    };\n    debug(\"entry: bootstrap complete\");\n  }\n  return cached;\n}\n\nexport async function handler(event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> {\n  const { registry, options, moduleDir } = await ensureBootstrapped();\n  registerShutdownHandler(options);\n  const apiEvent = event as APIGatewayProxyEventV2;\n  const httpRequest = mapApiGatewayV2Event(apiEvent);\n  debug(\"entry: %s %s\", httpRequest.method, httpRequest.path);\n\n  const handlerId = process.env.CELERITY_HANDLER_ID;\n\n  let resolved = handlerId ? registry.getHandlerById(handlerId) : undefined;\n\n  if (!resolved && handlerId) {\n    resolved = (await resolveHandlerByModuleRef(handlerId, registry, moduleDir)) ?? undefined;\n  }\n\n  if (!resolved) {\n    resolved = registry.getHandler(httpRequest.path, httpRequest.method);\n  }\n\n  if (!resolved) {\n    return {\n      statusCode: 404,\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        statusCode: 404,\n        message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n      }),\n    };\n  }\n\n  const httpResponse = await executeHandlerPipeline(resolved, httpRequest, options);\n  return mapHttpResponseToResult(httpResponse);\n}\n","import createDebug from \"debug\";\nimport type { HttpMethod, HttpRequest, HttpResponse } from \"@celerity-sdk/types\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from \"aws-lambda\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nfunction parseBody(event: APIGatewayProxyEventV2): {\n  textBody: string | null;\n  binaryBody: Buffer | null;\n} {\n  if (!event.body) return { textBody: null, binaryBody: null };\n  if (event.isBase64Encoded)\n    return { textBody: null, binaryBody: Buffer.from(event.body, \"base64\") };\n  return { textBody: event.body, binaryBody: null };\n}\n\nfunction parseHeaders(event: APIGatewayProxyEventV2): Record<string, string | string[]> {\n  const headers: Record<string, string | string[]> = {};\n  if (!event.headers) return headers;\n\n  for (const [key, value] of Object.entries(event.headers)) {\n    if (value !== undefined) {\n      headers[key.toLowerCase()] = value;\n    }\n  }\n  return headers;\n}\n\nfunction parseCookies(event: APIGatewayProxyEventV2): Record<string, string> {\n  const cookies: Record<string, string> = {};\n  if (!event.cookies) return cookies;\n\n  for (const cookie of event.cookies) {\n    const eqIndex = cookie.indexOf(\"=\");\n    if (eqIndex > 0) {\n      cookies[cookie.slice(0, eqIndex).trim()] = cookie.slice(eqIndex + 1).trim();\n    }\n  }\n  return cookies;\n}\n\nfunction parsePathParams(event: APIGatewayProxyEventV2): Record<string, string> {\n  const params: Record<string, string> = {};\n  if (!event.pathParameters) return params;\n\n  for (const [key, value] of Object.entries(event.pathParameters)) {\n    if (value !== undefined) {\n      params[key] = value;\n    }\n  }\n  return params;\n}\n\nexport function mapApiGatewayV2Event(event: APIGatewayProxyEventV2): HttpRequest {\n  const method = event.requestContext.http.method.toUpperCase() as HttpMethod;\n  const headers = parseHeaders(event);\n  const { textBody, binaryBody } = parseBody(event);\n\n  const authorizer = (\n    event.requestContext as unknown as {\n      authorizer?: { jwt?: { claims?: Record<string, unknown> } };\n    }\n  ).authorizer;\n\n  const contentType = (headers[\"content-type\"] as string | undefined) ?? null;\n  const xrayHeader = (headers[\"x-amzn-trace-id\"] as string | undefined) ?? null;\n\n  const request: HttpRequest = {\n    method,\n    path: event.rawPath,\n    pathParams: parsePathParams(event),\n    query: (event.queryStringParameters ?? {}) as Record<string, string | string[]>,\n    headers,\n    cookies: parseCookies(event),\n    textBody,\n    binaryBody,\n    contentType,\n    requestId: event.requestContext.requestId,\n    requestTime: event.requestContext.time ?? new Date().toISOString(),\n    auth: authorizer?.jwt?.claims ?? null,\n    clientIp: event.requestContext.http.sourceIp,\n    traceContext: xrayHeader ? { \"x-amzn-trace-id\": xrayHeader } : null,\n    userAgent: event.requestContext.http.userAgent ?? null,\n    matchedRoute: event.routeKey ?? null,\n  };\n\n  debug(\n    \"mapEvent: %s %s (auth=%s, traceContext=%s)\",\n    method,\n    event.rawPath,\n    !!authorizer?.jwt?.claims,\n    !!xrayHeader,\n  );\n\n  return request;\n}\n\nexport function mapHttpResponseToResult(response: HttpResponse): APIGatewayProxyStructuredResultV2 {\n  const result: APIGatewayProxyStructuredResultV2 = {\n    statusCode: response.status,\n  };\n\n  if (response.headers) {\n    result.headers = response.headers;\n  }\n\n  if (response.binaryBody) {\n    result.body = response.binaryBody.toString(\"base64\");\n    result.isBase64Encoded = true;\n  } else if (response.body) {\n    result.body = response.body;\n  }\n\n  return result;\n}\n"],"mappings":"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","names":["dirname","resolve","createDebug","discoverModule","bootstrap","executeHandlerPipeline","createDefaultSystemLayers","disposeLayers","resolveHandlerByModuleRef","createDebug","debug","createDebug","parseBody","event","body","textBody","binaryBody","isBase64Encoded","Buffer","from","parseHeaders","headers","key","value","Object","entries","undefined","toLowerCase","parseCookies","cookies","cookie","eqIndex","indexOf","slice","trim","parsePathParams","params","pathParameters","mapApiGatewayV2Event","method","requestContext","http","toUpperCase","authorizer","contentType","xrayHeader","request","path","rawPath","pathParams","query","queryStringParameters","requestId","requestTime","time","Date","toISOString","auth","jwt","claims","clientIp","sourceIp","traceContext","userAgent","matchedRoute","routeKey","mapHttpResponseToResult","response","result","statusCode","status","toString","debug","createDebug","cached","shutdownRegistered","registerShutdownHandler","options","process","on","container","closeAll","disposeLayers","systemLayers","appLayers","exit","ensureBootstrapped","createDefaultSystemLayers","length","rootModule","discoverModule","result","bootstrap","modulePath","env","CELERITY_MODULE_PATH","registry","moduleDir","dirname","resolve","cwd","handler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","handlerId","CELERITY_HANDLER_ID","resolved","getHandlerById","undefined","resolveHandlerByModuleRef","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult"]}

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/adapter.ts
+var import_node_path = require("path");
 var import_debug2 = __toESM(require("debug"), 1);
 var import_core = require("@celerity-sdk/core");
 
@@ -148,6 +149,10 @@ var AwsLambdaAdapter = class {
   static {
     __name(this, "AwsLambdaAdapter");
   }
+  config;
+  constructor() {
+    this.config = captureAwsLambdaConfig();
+  }
   createHandler(registry, options) {
     let cachedHandler = null;
     return async (event, _context) => {
@@ -155,7 +160,13 @@ var AwsLambdaAdapter = class {
       const httpRequest = mapApiGatewayV2Event(apiEvent);
       if (!cachedHandler) {
         debug2("adapter: cache miss, looking up handler for %s %s", httpRequest.method, httpRequest.path);
-        cachedHandler = registry.getHandler(httpRequest.path, httpRequest.method) ?? null;
+        cachedHandler = (this.config.handlerId ? registry.getHandlerById(this.config.handlerId) : void 0) ?? null;
+        if (!cachedHandler && this.config.handlerId) {
+          cachedHandler = await (0, import_core.resolveHandlerByModuleRef)(this.config.handlerId, registry, this.config.moduleDir);
+        }
+        if (!cachedHandler) {
+          cachedHandler = registry.getHandler(httpRequest.path, httpRequest.method) ?? null;
+        }
       } else {
         debug2("adapter: using cached handler for %s %s", httpRequest.method, httpRequest.path);
       }
@@ -176,8 +187,17 @@ var AwsLambdaAdapter = class {
     };
   }
 };
+function captureAwsLambdaConfig() {
+  const modulePath = process.env.CELERITY_MODULE_PATH;
+  return {
+    handlerId: process.env.CELERITY_HANDLER_ID,
+    moduleDir: modulePath ? (0, import_node_path.dirname)((0, import_node_path.resolve)(modulePath)) : process.cwd()
+  };
+}
+__name(captureAwsLambdaConfig, "captureAwsLambdaConfig");
 
 // src/entry.ts
+var import_node_path2 = require("path");
 var import_debug3 = __toESM(require("debug"), 1);
 var import_core2 = require("@celerity-sdk/core");
 var debug3 = (0, import_debug3.default)("celerity:serverless-aws");
@@ -204,12 +224,14 @@ async function ensureBootstrapped() {
     debug3("entry: %d system layers created", systemLayers.length);
     const rootModule = await (0, import_core2.discoverModule)();
     const result = await (0, import_core2.bootstrap)(rootModule);
+    const modulePath = process.env.CELERITY_MODULE_PATH;
     cached = {
       registry: result.registry,
       options: {
         container: result.container,
         systemLayers
-      }
+      },
+      moduleDir: modulePath ? (0, import_node_path2.dirname)((0, import_node_path2.resolve)(modulePath)) : process.cwd()
     };
     debug3("entry: bootstrap complete");
   }
@@ -217,12 +239,19 @@ async function ensureBootstrapped() {
 }
 __name(ensureBootstrapped, "ensureBootstrapped");
 async function handler(event, _context) {
-  const { registry, options } = await ensureBootstrapped();
+  const { registry, options, moduleDir } = await ensureBootstrapped();
   registerShutdownHandler(options);
   const apiEvent = event;
   const httpRequest = mapApiGatewayV2Event(apiEvent);
   debug3("entry: %s %s", httpRequest.method, httpRequest.path);
-  const resolved = registry.getHandler(httpRequest.path, httpRequest.method);
+  const handlerId = process.env.CELERITY_HANDLER_ID;
+  let resolved = handlerId ? registry.getHandlerById(handlerId) : void 0;
+  if (!resolved && handlerId) {
+    resolved = await (0, import_core2.resolveHandlerByModuleRef)(handlerId, registry, moduleDir) ?? void 0;
+  }
+  if (!resolved) {
+    resolved = registry.getHandler(httpRequest.path, httpRequest.method);
+  }
   if (!resolved) {
     return {
       statusCode: 404,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/adapter.ts","../src/event-mapper.ts","../src/entry.ts"],"sourcesContent":["export { AwsLambdaAdapter } from \"./adapter\";\nexport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\nexport { handler } from \"./entry\";\n","import createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type {\n  HandlerRegistry,\n  ServerlessAdapter,\n  ResolvedHandler,\n  PipelineOptions,\n} from \"@celerity-sdk/core\";\nimport { executeHandlerPipeline } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nexport class AwsLambdaAdapter implements ServerlessAdapter {\n  createHandler(\n    registry: HandlerRegistry,\n    options: PipelineOptions,\n  ): (event: unknown, context: unknown) => Promise<unknown> {\n    let cachedHandler: ResolvedHandler | null = null;\n\n    return async (event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> => {\n      const apiEvent = event as APIGatewayProxyEventV2;\n      const httpRequest = mapApiGatewayV2Event(apiEvent);\n\n      if (!cachedHandler) {\n        debug(\n          \"adapter: cache miss, looking up handler for %s %s\",\n          httpRequest.method,\n          httpRequest.path,\n        );\n        cachedHandler = registry.getHandler(httpRequest.path, httpRequest.method) ?? null;\n      } else {\n        debug(\"adapter: using cached handler for %s %s\", httpRequest.method, httpRequest.path);\n      }\n\n      if (!cachedHandler) {\n        debug(\"adapter: no handler found → 404\");\n        return {\n          statusCode: 404,\n          headers: { \"content-type\": \"application/json\" },\n          body: JSON.stringify({\n            message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n          }),\n        };\n      }\n\n      const httpResponse = await executeHandlerPipeline(cachedHandler, httpRequest, options);\n      return mapHttpResponseToResult(httpResponse);\n    };\n  }\n}\n","import createDebug from \"debug\";\nimport type { HttpMethod, HttpRequest, HttpResponse } from \"@celerity-sdk/types\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from \"aws-lambda\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nfunction parseBody(event: APIGatewayProxyEventV2): {\n  textBody: string | null;\n  binaryBody: Buffer | null;\n} {\n  if (!event.body) return { textBody: null, binaryBody: null };\n  if (event.isBase64Encoded)\n    return { textBody: null, binaryBody: Buffer.from(event.body, \"base64\") };\n  return { textBody: event.body, binaryBody: null };\n}\n\nfunction parseHeaders(event: APIGatewayProxyEventV2): Record<string, string | string[]> {\n  const headers: Record<string, string | string[]> = {};\n  if (!event.headers) return headers;\n\n  for (const [key, value] of Object.entries(event.headers)) {\n    if (value !== undefined) {\n      headers[key.toLowerCase()] = value;\n    }\n  }\n  return headers;\n}\n\nfunction parseCookies(event: APIGatewayProxyEventV2): Record<string, string> {\n  const cookies: Record<string, string> = {};\n  if (!event.cookies) return cookies;\n\n  for (const cookie of event.cookies) {\n    const eqIndex = cookie.indexOf(\"=\");\n    if (eqIndex > 0) {\n      cookies[cookie.slice(0, eqIndex).trim()] = cookie.slice(eqIndex + 1).trim();\n    }\n  }\n  return cookies;\n}\n\nfunction parsePathParams(event: APIGatewayProxyEventV2): Record<string, string> {\n  const params: Record<string, string> = {};\n  if (!event.pathParameters) return params;\n\n  for (const [key, value] of Object.entries(event.pathParameters)) {\n    if (value !== undefined) {\n      params[key] = value;\n    }\n  }\n  return params;\n}\n\nexport function mapApiGatewayV2Event(event: APIGatewayProxyEventV2): HttpRequest {\n  const method = event.requestContext.http.method.toUpperCase() as HttpMethod;\n  const headers = parseHeaders(event);\n  const { textBody, binaryBody } = parseBody(event);\n\n  const authorizer = (\n    event.requestContext as unknown as {\n      authorizer?: { jwt?: { claims?: Record<string, unknown> } };\n    }\n  ).authorizer;\n\n  const contentType = (headers[\"content-type\"] as string | undefined) ?? null;\n  const xrayHeader = (headers[\"x-amzn-trace-id\"] as string | undefined) ?? null;\n\n  const request: HttpRequest = {\n    method,\n    path: event.rawPath,\n    pathParams: parsePathParams(event),\n    query: (event.queryStringParameters ?? {}) as Record<string, string | string[]>,\n    headers,\n    cookies: parseCookies(event),\n    textBody,\n    binaryBody,\n    contentType,\n    requestId: event.requestContext.requestId,\n    requestTime: event.requestContext.time ?? new Date().toISOString(),\n    auth: authorizer?.jwt?.claims ?? null,\n    clientIp: event.requestContext.http.sourceIp,\n    traceContext: xrayHeader ? { \"x-amzn-trace-id\": xrayHeader } : null,\n    userAgent: event.requestContext.http.userAgent ?? null,\n    matchedRoute: event.routeKey ?? null,\n  };\n\n  debug(\n    \"mapEvent: %s %s (auth=%s, traceContext=%s)\",\n    method,\n    event.rawPath,\n    !!authorizer?.jwt?.claims,\n    !!xrayHeader,\n  );\n\n  return request;\n}\n\nexport function mapHttpResponseToResult(response: HttpResponse): APIGatewayProxyStructuredResultV2 {\n  const result: APIGatewayProxyStructuredResultV2 = {\n    statusCode: response.status,\n  };\n\n  if (response.headers) {\n    result.headers = response.headers;\n  }\n\n  if (response.binaryBody) {\n    result.body = response.binaryBody.toString(\"base64\");\n    result.isBase64Encoded = true;\n  } else if (response.body) {\n    result.body = response.body;\n  }\n\n  return result;\n}\n","import createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type { PipelineOptions } from \"@celerity-sdk/core\";\nimport {\n  discoverModule,\n  bootstrap,\n  executeHandlerPipeline,\n  createDefaultSystemLayers,\n  disposeLayers,\n} from \"@celerity-sdk/core\";\nimport type { HandlerRegistry } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nlet cached: { registry: HandlerRegistry; options: PipelineOptions } | null = null;\nlet shutdownRegistered = false;\n\nfunction registerShutdownHandler(options: PipelineOptions): void {\n  if (shutdownRegistered) return;\n  shutdownRegistered = true;\n  debug(\"entry: SIGTERM shutdown handler registered\");\n\n  process.on(\"SIGTERM\", async () => {\n    await options.container.closeAll();\n    await disposeLayers([...(options.systemLayers ?? []), ...(options.appLayers ?? [])]);\n    process.exit(0);\n  });\n}\n\nasync function ensureBootstrapped(): Promise<{\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n}> {\n  if (!cached) {\n    debug(\"entry: cold start, bootstrapping\");\n    const systemLayers = await createDefaultSystemLayers();\n    debug(\"entry: %d system layers created\", systemLayers.length);\n    const rootModule = await discoverModule();\n    const result = await bootstrap(rootModule);\n    cached = {\n      registry: result.registry,\n      options: {\n        container: result.container,\n        systemLayers,\n      },\n    };\n    debug(\"entry: bootstrap complete\");\n  }\n  return cached;\n}\n\nexport async function handler(event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> {\n  const { registry, options } = await ensureBootstrapped();\n  registerShutdownHandler(options);\n  const apiEvent = event as APIGatewayProxyEventV2;\n  const httpRequest = mapApiGatewayV2Event(apiEvent);\n  debug(\"entry: %s %s\", httpRequest.method, httpRequest.path);\n\n  const resolved = registry.getHandler(httpRequest.path, httpRequest.method);\n  if (!resolved) {\n    return {\n      statusCode: 404,\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        statusCode: 404,\n        message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n      }),\n    };\n  }\n\n  const httpResponse = await executeHandlerPipeline(resolved, httpRequest, options);\n  return mapHttpResponseToResult(httpResponse);\n}\n"],"mappings":"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","names":["import_debug","debug","createDebug","parseBody","event","body","textBody","binaryBody","isBase64Encoded","Buffer","from","parseHeaders","headers","key","value","Object","entries","undefined","toLowerCase","parseCookies","cookies","cookie","eqIndex","indexOf","slice","trim","parsePathParams","params","pathParameters","mapApiGatewayV2Event","method","requestContext","http","toUpperCase","authorizer","contentType","xrayHeader","request","path","rawPath","pathParams","query","queryStringParameters","requestId","requestTime","time","Date","toISOString","auth","jwt","claims","clientIp","sourceIp","traceContext","userAgent","matchedRoute","routeKey","mapHttpResponseToResult","response","result","statusCode","status","toString","debug","createDebug","AwsLambdaAdapter","createHandler","registry","options","cachedHandler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult","import_debug","import_core","debug","createDebug","cached","shutdownRegistered","registerShutdownHandler","options","process","on","container","closeAll","disposeLayers","systemLayers","appLayers","exit","ensureBootstrapped","createDefaultSystemLayers","length","rootModule","discoverModule","result","bootstrap","registry","handler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","resolved","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult"]}
+{"version":3,"sources":["../src/index.ts","../src/adapter.ts","../src/event-mapper.ts","../src/entry.ts"],"sourcesContent":["export { AwsLambdaAdapter } from \"./adapter\";\nexport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\nexport { handler } from \"./entry\";\n","import { dirname, resolve } from \"node:path\";\nimport createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type {\n  HandlerRegistry,\n  ServerlessAdapter,\n  ResolvedHandler,\n  PipelineOptions,\n} from \"@celerity-sdk/core\";\nimport { executeHandlerPipeline, resolveHandlerByModuleRef } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\ntype AwsLambdaAdapterConfig = {\n  handlerId?: string;\n  moduleDir: string;\n};\n\nexport class AwsLambdaAdapter implements ServerlessAdapter {\n  config: AwsLambdaAdapterConfig;\n\n  constructor() {\n    // Capture config from environment variables on construction\n    // to take a snapshot at the initialisation phase similarly to\n    // how layers capture config.\n    this.config = captureAwsLambdaConfig();\n  }\n\n  createHandler(\n    registry: HandlerRegistry,\n    options: PipelineOptions,\n  ): (event: unknown, context: unknown) => Promise<unknown> {\n    let cachedHandler: ResolvedHandler | null = null;\n\n    return async (event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> => {\n      const apiEvent = event as APIGatewayProxyEventV2;\n      const httpRequest = mapApiGatewayV2Event(apiEvent);\n\n      if (!cachedHandler) {\n        debug(\n          \"adapter: cache miss, looking up handler for %s %s\",\n          httpRequest.method,\n          httpRequest.path,\n        );\n\n        cachedHandler =\n          (this.config.handlerId ? registry.getHandlerById(this.config.handlerId) : undefined) ??\n          null;\n\n        if (!cachedHandler && this.config.handlerId) {\n          cachedHandler = await resolveHandlerByModuleRef(\n            this.config.handlerId,\n            registry,\n            this.config.moduleDir,\n          );\n        }\n\n        if (!cachedHandler) {\n          cachedHandler = registry.getHandler(httpRequest.path, httpRequest.method) ?? null;\n        }\n      } else {\n        debug(\"adapter: using cached handler for %s %s\", httpRequest.method, httpRequest.path);\n      }\n\n      if (!cachedHandler) {\n        debug(\"adapter: no handler found → 404\");\n        return {\n          statusCode: 404,\n          headers: { \"content-type\": \"application/json\" },\n          body: JSON.stringify({\n            message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n          }),\n        };\n      }\n\n      const httpResponse = await executeHandlerPipeline(cachedHandler, httpRequest, options);\n      return mapHttpResponseToResult(httpResponse);\n    };\n  }\n}\n\nfunction captureAwsLambdaConfig(): AwsLambdaAdapterConfig {\n  const modulePath = process.env.CELERITY_MODULE_PATH;\n  return {\n    handlerId: process.env.CELERITY_HANDLER_ID,\n    moduleDir: modulePath ? dirname(resolve(modulePath)) : process.cwd(),\n  };\n}\n","import createDebug from \"debug\";\nimport type { HttpMethod, HttpRequest, HttpResponse } from \"@celerity-sdk/types\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from \"aws-lambda\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nfunction parseBody(event: APIGatewayProxyEventV2): {\n  textBody: string | null;\n  binaryBody: Buffer | null;\n} {\n  if (!event.body) return { textBody: null, binaryBody: null };\n  if (event.isBase64Encoded)\n    return { textBody: null, binaryBody: Buffer.from(event.body, \"base64\") };\n  return { textBody: event.body, binaryBody: null };\n}\n\nfunction parseHeaders(event: APIGatewayProxyEventV2): Record<string, string | string[]> {\n  const headers: Record<string, string | string[]> = {};\n  if (!event.headers) return headers;\n\n  for (const [key, value] of Object.entries(event.headers)) {\n    if (value !== undefined) {\n      headers[key.toLowerCase()] = value;\n    }\n  }\n  return headers;\n}\n\nfunction parseCookies(event: APIGatewayProxyEventV2): Record<string, string> {\n  const cookies: Record<string, string> = {};\n  if (!event.cookies) return cookies;\n\n  for (const cookie of event.cookies) {\n    const eqIndex = cookie.indexOf(\"=\");\n    if (eqIndex > 0) {\n      cookies[cookie.slice(0, eqIndex).trim()] = cookie.slice(eqIndex + 1).trim();\n    }\n  }\n  return cookies;\n}\n\nfunction parsePathParams(event: APIGatewayProxyEventV2): Record<string, string> {\n  const params: Record<string, string> = {};\n  if (!event.pathParameters) return params;\n\n  for (const [key, value] of Object.entries(event.pathParameters)) {\n    if (value !== undefined) {\n      params[key] = value;\n    }\n  }\n  return params;\n}\n\nexport function mapApiGatewayV2Event(event: APIGatewayProxyEventV2): HttpRequest {\n  const method = event.requestContext.http.method.toUpperCase() as HttpMethod;\n  const headers = parseHeaders(event);\n  const { textBody, binaryBody } = parseBody(event);\n\n  const authorizer = (\n    event.requestContext as unknown as {\n      authorizer?: { jwt?: { claims?: Record<string, unknown> } };\n    }\n  ).authorizer;\n\n  const contentType = (headers[\"content-type\"] as string | undefined) ?? null;\n  const xrayHeader = (headers[\"x-amzn-trace-id\"] as string | undefined) ?? null;\n\n  const request: HttpRequest = {\n    method,\n    path: event.rawPath,\n    pathParams: parsePathParams(event),\n    query: (event.queryStringParameters ?? {}) as Record<string, string | string[]>,\n    headers,\n    cookies: parseCookies(event),\n    textBody,\n    binaryBody,\n    contentType,\n    requestId: event.requestContext.requestId,\n    requestTime: event.requestContext.time ?? new Date().toISOString(),\n    auth: authorizer?.jwt?.claims ?? null,\n    clientIp: event.requestContext.http.sourceIp,\n    traceContext: xrayHeader ? { \"x-amzn-trace-id\": xrayHeader } : null,\n    userAgent: event.requestContext.http.userAgent ?? null,\n    matchedRoute: event.routeKey ?? null,\n  };\n\n  debug(\n    \"mapEvent: %s %s (auth=%s, traceContext=%s)\",\n    method,\n    event.rawPath,\n    !!authorizer?.jwt?.claims,\n    !!xrayHeader,\n  );\n\n  return request;\n}\n\nexport function mapHttpResponseToResult(response: HttpResponse): APIGatewayProxyStructuredResultV2 {\n  const result: APIGatewayProxyStructuredResultV2 = {\n    statusCode: response.status,\n  };\n\n  if (response.headers) {\n    result.headers = response.headers;\n  }\n\n  if (response.binaryBody) {\n    result.body = response.binaryBody.toString(\"base64\");\n    result.isBase64Encoded = true;\n  } else if (response.body) {\n    result.body = response.body;\n  }\n\n  return result;\n}\n","import { dirname, resolve } from \"node:path\";\nimport createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type { PipelineOptions } from \"@celerity-sdk/core\";\nimport {\n  discoverModule,\n  bootstrap,\n  executeHandlerPipeline,\n  createDefaultSystemLayers,\n  disposeLayers,\n  resolveHandlerByModuleRef,\n} from \"@celerity-sdk/core\";\nimport type { HandlerRegistry } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nlet cached: {\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n  moduleDir: string;\n} | null = null;\nlet shutdownRegistered = false;\n\nfunction registerShutdownHandler(options: PipelineOptions): void {\n  if (shutdownRegistered) return;\n  shutdownRegistered = true;\n  debug(\"entry: SIGTERM shutdown handler registered\");\n\n  process.on(\"SIGTERM\", async () => {\n    await options.container.closeAll();\n    await disposeLayers([...(options.systemLayers ?? []), ...(options.appLayers ?? [])]);\n    process.exit(0);\n  });\n}\n\nasync function ensureBootstrapped(): Promise<{\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n  moduleDir: string;\n}> {\n  if (!cached) {\n    debug(\"entry: cold start, bootstrapping\");\n    const systemLayers = await createDefaultSystemLayers();\n    debug(\"entry: %d system layers created\", systemLayers.length);\n    const rootModule = await discoverModule();\n    const result = await bootstrap(rootModule);\n    const modulePath = process.env.CELERITY_MODULE_PATH;\n    cached = {\n      registry: result.registry,\n      options: {\n        container: result.container,\n        systemLayers,\n      },\n      moduleDir: modulePath ? dirname(resolve(modulePath)) : process.cwd(),\n    };\n    debug(\"entry: bootstrap complete\");\n  }\n  return cached;\n}\n\nexport async function handler(event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> {\n  const { registry, options, moduleDir } = await ensureBootstrapped();\n  registerShutdownHandler(options);\n  const apiEvent = event as APIGatewayProxyEventV2;\n  const httpRequest = mapApiGatewayV2Event(apiEvent);\n  debug(\"entry: %s %s\", httpRequest.method, httpRequest.path);\n\n  const handlerId = process.env.CELERITY_HANDLER_ID;\n\n  let resolved = handlerId ? registry.getHandlerById(handlerId) : undefined;\n\n  if (!resolved && handlerId) {\n    resolved = (await resolveHandlerByModuleRef(handlerId, registry, moduleDir)) ?? undefined;\n  }\n\n  if (!resolved) {\n    resolved = registry.getHandler(httpRequest.path, httpRequest.method);\n  }\n\n  if (!resolved) {\n    return {\n      statusCode: 404,\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        statusCode: 404,\n        message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n      }),\n    };\n  }\n\n  const httpResponse = await executeHandlerPipeline(resolved, httpRequest, options);\n  return mapHttpResponseToResult(httpResponse);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;ACAA,uBAAiC;AACjC,IAAAA,gBAAwB;AAQxB,kBAAkE;;;ACTlE,mBAAwB;AAIxB,IAAMC,YAAQC,aAAAA,SAAY,yBAAA;AAE1B,SAASC,UAAUC,OAA6B;AAI9C,MAAI,CAACA,MAAMC,KAAM,QAAO;IAAEC,UAAU;IAAMC,YAAY;EAAK;AAC3D,MAAIH,MAAMI,gBACR,QAAO;IAAEF,UAAU;IAAMC,YAAYE,OAAOC,KAAKN,MAAMC,MAAM,QAAA;EAAU;AACzE,SAAO;IAAEC,UAAUF,MAAMC;IAAME,YAAY;EAAK;AAClD;AARSJ;AAUT,SAASQ,aAAaP,OAA6B;AACjD,QAAMQ,UAA6C,CAAC;AACpD,MAAI,CAACR,MAAMQ,QAAS,QAAOA;AAE3B,aAAW,CAACC,KAAKC,KAAAA,KAAUC,OAAOC,QAAQZ,MAAMQ,OAAO,GAAG;AACxD,QAAIE,UAAUG,QAAW;AACvBL,cAAQC,IAAIK,YAAW,CAAA,IAAMJ;IAC/B;EACF;AACA,SAAOF;AACT;AAVSD;AAYT,SAASQ,aAAaf,OAA6B;AACjD,QAAMgB,UAAkC,CAAC;AACzC,MAAI,CAAChB,MAAMgB,QAAS,QAAOA;AAE3B,aAAWC,UAAUjB,MAAMgB,SAAS;AAClC,UAAME,UAAUD,OAAOE,QAAQ,GAAA;AAC/B,QAAID,UAAU,GAAG;AACfF,cAAQC,OAAOG,MAAM,GAAGF,OAAAA,EAASG,KAAI,CAAA,IAAMJ,OAAOG,MAAMF,UAAU,CAAA,EAAGG,KAAI;IAC3E;EACF;AACA,SAAOL;AACT;AAXSD;AAaT,SAASO,gBAAgBtB,OAA6B;AACpD,QAAMuB,SAAiC,CAAC;AACxC,MAAI,CAACvB,MAAMwB,eAAgB,QAAOD;AAElC,aAAW,CAACd,KAAKC,KAAAA,KAAUC,OAAOC,QAAQZ,MAAMwB,cAAc,GAAG;AAC/D,QAAId,UAAUG,QAAW;AACvBU,aAAOd,GAAAA,IAAOC;IAChB;EACF;AACA,SAAOa;AACT;AAVSD;AAYF,SAASG,qBAAqBzB,OAA6B;AAChE,QAAM0B,SAAS1B,MAAM2B,eAAeC,KAAKF,OAAOG,YAAW;AAC3D,QAAMrB,UAAUD,aAAaP,KAAAA;AAC7B,QAAM,EAAEE,UAAUC,WAAU,IAAKJ,UAAUC,KAAAA;AAE3C,QAAM8B,aACJ9B,MAAM2B,eAGNG;AAEF,QAAMC,cAAevB,QAAQ,cAAA,KAA0C;AACvE,QAAMwB,aAAcxB,QAAQ,iBAAA,KAA6C;AAEzE,QAAMyB,UAAuB;IAC3BP;IACAQ,MAAMlC,MAAMmC;IACZC,YAAYd,gBAAgBtB,KAAAA;IAC5BqC,OAAQrC,MAAMsC,yBAAyB,CAAC;IACxC9B;IACAQ,SAASD,aAAaf,KAAAA;IACtBE;IACAC;IACA4B;IACAQ,WAAWvC,MAAM2B,eAAeY;IAChCC,aAAaxC,MAAM2B,eAAec,SAAQ,oBAAIC,KAAAA,GAAOC,YAAW;IAChEC,MAAMd,YAAYe,KAAKC,UAAU;IACjCC,UAAU/C,MAAM2B,eAAeC,KAAKoB;IACpCC,cAAcjB,aAAa;MAAE,mBAAmBA;IAAW,IAAI;IAC/DkB,WAAWlD,MAAM2B,eAAeC,KAAKsB,aAAa;IAClDC,cAAcnD,MAAMoD,YAAY;EAClC;AAEAvD,QACE,8CACA6B,QACA1B,MAAMmC,SACN,CAAC,CAACL,YAAYe,KAAKC,QACnB,CAAC,CAACd,UAAAA;AAGJ,SAAOC;AACT;AA1CgBR;AA4CT,SAAS4B,wBAAwBC,UAAsB;AAC5D,QAAMC,SAA4C;IAChDC,YAAYF,SAASG;EACvB;AAEA,MAAIH,SAAS9C,SAAS;AACpB+C,WAAO/C,UAAU8C,SAAS9C;EAC5B;AAEA,MAAI8C,SAASnD,YAAY;AACvBoD,WAAOtD,OAAOqD,SAASnD,WAAWuD,SAAS,QAAA;AAC3CH,WAAOnD,kBAAkB;EAC3B,WAAWkD,SAASrD,MAAM;AACxBsD,WAAOtD,OAAOqD,SAASrD;EACzB;AAEA,SAAOsD;AACT;AAjBgBF;;;ADrFhB,IAAMM,aAAQC,cAAAA,SAAY,yBAAA;AAOnB,IAAMC,mBAAN,MAAMA;EAnBb,OAmBaA;;;EACXC;EAEA,cAAc;AAIZ,SAAKA,SAASC,uBAAAA;EAChB;EAEAC,cACEC,UACAC,SACwD;AACxD,QAAIC,gBAAwC;AAE5C,WAAO,OAAOC,OAAgBC,aAAAA;AAC5B,YAAMC,WAAWF;AACjB,YAAMG,cAAcC,qBAAqBF,QAAAA;AAEzC,UAAI,CAACH,eAAe;AAClBR,QAAAA,OACE,qDACAY,YAAYE,QACZF,YAAYG,IAAI;AAGlBP,yBACG,KAAKL,OAAOa,YAAYV,SAASW,eAAe,KAAKd,OAAOa,SAAS,IAAIE,WAC1E;AAEF,YAAI,CAACV,iBAAiB,KAAKL,OAAOa,WAAW;AAC3CR,0BAAgB,UAAMW,uCACpB,KAAKhB,OAAOa,WACZV,UACA,KAAKH,OAAOiB,SAAS;QAEzB;AAEA,YAAI,CAACZ,eAAe;AAClBA,0BAAgBF,SAASe,WAAWT,YAAYG,MAAMH,YAAYE,MAAM,KAAK;QAC/E;MACF,OAAO;AACLd,QAAAA,OAAM,2CAA2CY,YAAYE,QAAQF,YAAYG,IAAI;MACvF;AAEA,UAAI,CAACP,eAAe;AAClBR,QAAAA,OAAM,sCAAA;AACN,eAAO;UACLsB,YAAY;UACZC,SAAS;YAAE,gBAAgB;UAAmB;UAC9CC,MAAMC,KAAKC,UAAU;YACnBC,SAAS,kBAAkBf,YAAYE,MAAM,IAAIF,YAAYG,IAAI;UACnE,CAAA;QACF;MACF;AAEA,YAAMa,eAAe,UAAMC,oCAAuBrB,eAAeI,aAAaL,OAAAA;AAC9E,aAAOuB,wBAAwBF,YAAAA;IACjC;EACF;AACF;AAEA,SAASxB,yBAAAA;AACP,QAAM2B,aAAaC,QAAQC,IAAIC;AAC/B,SAAO;IACLlB,WAAWgB,QAAQC,IAAIE;IACvBf,WAAWW,iBAAaK,8BAAQC,0BAAQN,UAAAA,CAAAA,IAAeC,QAAQM,IAAG;EACpE;AACF;AANSlC;;;AElFT,IAAAmC,oBAAiC;AACjC,IAAAC,gBAAwB;AAGxB,IAAAC,eAOO;AAIP,IAAMC,aAAQC,cAAAA,SAAY,yBAAA;AAE1B,IAAIC,SAIO;AACX,IAAIC,qBAAqB;AAEzB,SAASC,wBAAwBC,SAAwB;AACvD,MAAIF,mBAAoB;AACxBA,uBAAqB;AACrBH,EAAAA,OAAM,4CAAA;AAENM,UAAQC,GAAG,WAAW,YAAA;AACpB,UAAMF,QAAQG,UAAUC,SAAQ;AAChC,cAAMC,4BAAc;SAAKL,QAAQM,gBAAgB,CAAA;SAASN,QAAQO,aAAa,CAAA;KAAI;AACnFN,YAAQO,KAAK,CAAA;EACf,CAAA;AACF;AAVST;AAYT,eAAeU,qBAAAA;AAKb,MAAI,CAACZ,QAAQ;AACXF,IAAAA,OAAM,kCAAA;AACN,UAAMW,eAAe,UAAMI,wCAAAA;AAC3Bf,IAAAA,OAAM,mCAAmCW,aAAaK,MAAM;AAC5D,UAAMC,aAAa,UAAMC,6BAAAA;AACzB,UAAMC,SAAS,UAAMC,wBAAUH,UAAAA;AAC/B,UAAMI,aAAaf,QAAQgB,IAAIC;AAC/BrB,aAAS;MACPsB,UAAUL,OAAOK;MACjBnB,SAAS;QACPG,WAAWW,OAAOX;QAClBG;MACF;MACAc,WAAWJ,iBAAaK,+BAAQC,2BAAQN,UAAAA,CAAAA,IAAef,QAAQsB,IAAG;IACpE;AACA5B,IAAAA,OAAM,2BAAA;EACR;AACA,SAAOE;AACT;AAvBeY;AAyBf,eAAsBe,QAAQC,OAAgBC,UAAiB;AAC7D,QAAM,EAAEP,UAAUnB,SAASoB,UAAS,IAAK,MAAMX,mBAAAA;AAC/CV,0BAAwBC,OAAAA;AACxB,QAAM2B,WAAWF;AACjB,QAAMG,cAAcC,qBAAqBF,QAAAA;AACzChC,EAAAA,OAAM,gBAAgBiC,YAAYE,QAAQF,YAAYG,IAAI;AAE1D,QAAMC,YAAY/B,QAAQgB,IAAIgB;AAE9B,MAAIC,WAAWF,YAAYb,SAASgB,eAAeH,SAAAA,IAAaI;AAEhE,MAAI,CAACF,YAAYF,WAAW;AAC1BE,eAAY,UAAMG,wCAA0BL,WAAWb,UAAUC,SAAAA,KAAegB;EAClF;AAEA,MAAI,CAACF,UAAU;AACbA,eAAWf,SAASmB,WAAWV,YAAYG,MAAMH,YAAYE,MAAM;EACrE;AAEA,MAAI,CAACI,UAAU;AACb,WAAO;MACLK,YAAY;MACZC,SAAS;QAAE,gBAAgB;MAAmB;MAC9CC,MAAMC,KAAKC,UAAU;QACnBJ,YAAY;QACZK,SAAS,kBAAkBhB,YAAYE,MAAM,IAAIF,YAAYG,IAAI;MACnE,CAAA;IACF;EACF;AAEA,QAAMc,eAAe,UAAMC,qCAAuBZ,UAAUN,aAAa5B,OAAAA;AACzE,SAAO+C,wBAAwBF,YAAAA;AACjC;AAhCsBrB;","names":["import_debug","debug","createDebug","parseBody","event","body","textBody","binaryBody","isBase64Encoded","Buffer","from","parseHeaders","headers","key","value","Object","entries","undefined","toLowerCase","parseCookies","cookies","cookie","eqIndex","indexOf","slice","trim","parsePathParams","params","pathParameters","mapApiGatewayV2Event","method","requestContext","http","toUpperCase","authorizer","contentType","xrayHeader","request","path","rawPath","pathParams","query","queryStringParameters","requestId","requestTime","time","Date","toISOString","auth","jwt","claims","clientIp","sourceIp","traceContext","userAgent","matchedRoute","routeKey","mapHttpResponseToResult","response","result","statusCode","status","toString","debug","createDebug","AwsLambdaAdapter","config","captureAwsLambdaConfig","createHandler","registry","options","cachedHandler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","handlerId","getHandlerById","undefined","resolveHandlerByModuleRef","moduleDir","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult","modulePath","process","env","CELERITY_MODULE_PATH","CELERITY_HANDLER_ID","dirname","resolve","cwd","import_node_path","import_debug","import_core","debug","createDebug","cached","shutdownRegistered","registerShutdownHandler","options","process","on","container","closeAll","disposeLayers","systemLayers","appLayers","exit","ensureBootstrapped","createDefaultSystemLayers","length","rootModule","discoverModule","result","bootstrap","modulePath","env","CELERITY_MODULE_PATH","registry","moduleDir","dirname","resolve","cwd","handler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","handlerId","CELERITY_HANDLER_ID","resolved","getHandlerById","undefined","resolveHandlerByModuleRef","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult"]}

package/dist/index.d.cts

@@ -3,7 +3,13 @@ import { HttpRequest, HttpResponse } from '@celerity-sdk/types';
 import { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from 'aws-lambda';
 export { handler } from './entry.cjs';
 
+type AwsLambdaAdapterConfig = {
+    handlerId?: string;
+    moduleDir: string;
+};
 declare class AwsLambdaAdapter implements ServerlessAdapter {
+    config: AwsLambdaAdapterConfig;
+    constructor();
     createHandler(registry: HandlerRegistry, options: PipelineOptions): (event: unknown, context: unknown) => Promise<unknown>;
 }
 

package/dist/index.d.ts

@@ -3,7 +3,13 @@ import { HttpRequest, HttpResponse } from '@celerity-sdk/types';
 import { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from 'aws-lambda';
 export { handler } from './entry.js';
 
+type AwsLambdaAdapterConfig = {
+    handlerId?: string;
+    moduleDir: string;
+};
 declare class AwsLambdaAdapter implements ServerlessAdapter {
+    config: AwsLambdaAdapterConfig;
+    constructor();
     createHandler(registry: HandlerRegistry, options: PipelineOptions): (event: unknown, context: unknown) => Promise<unknown>;
 }
 

package/dist/index.js

@@ -2,8 +2,9 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/adapter.ts
+import { dirname, resolve } from "path";
 import createDebug2 from "debug";
-import { executeHandlerPipeline } from "@celerity-sdk/core";
+import { executeHandlerPipeline, resolveHandlerByModuleRef } from "@celerity-sdk/core";
 
 // src/event-mapper.ts
 import createDebug from "debug";
@@ -111,6 +112,10 @@ var AwsLambdaAdapter = class {
   static {
     __name(this, "AwsLambdaAdapter");
   }
+  config;
+  constructor() {
+    this.config = captureAwsLambdaConfig();
+  }
   createHandler(registry, options) {
     let cachedHandler = null;
     return async (event, _context) => {
@@ -118,7 +123,13 @@ var AwsLambdaAdapter = class {
       const httpRequest = mapApiGatewayV2Event(apiEvent);
       if (!cachedHandler) {
         debug2("adapter: cache miss, looking up handler for %s %s", httpRequest.method, httpRequest.path);
-        cachedHandler = registry.getHandler(httpRequest.path, httpRequest.method) ?? null;
+        cachedHandler = (this.config.handlerId ? registry.getHandlerById(this.config.handlerId) : void 0) ?? null;
+        if (!cachedHandler && this.config.handlerId) {
+          cachedHandler = await resolveHandlerByModuleRef(this.config.handlerId, registry, this.config.moduleDir);
+        }
+        if (!cachedHandler) {
+          cachedHandler = registry.getHandler(httpRequest.path, httpRequest.method) ?? null;
+        }
       } else {
         debug2("adapter: using cached handler for %s %s", httpRequest.method, httpRequest.path);
       }
@@ -139,10 +150,19 @@ var AwsLambdaAdapter = class {
     };
   }
 };
+function captureAwsLambdaConfig() {
+  const modulePath = process.env.CELERITY_MODULE_PATH;
+  return {
+    handlerId: process.env.CELERITY_HANDLER_ID,
+    moduleDir: modulePath ? dirname(resolve(modulePath)) : process.cwd()
+  };
+}
+__name(captureAwsLambdaConfig, "captureAwsLambdaConfig");
 
 // src/entry.ts
+import { dirname as dirname2, resolve as resolve2 } from "path";
 import createDebug3 from "debug";
-import { discoverModule, bootstrap, executeHandlerPipeline as executeHandlerPipeline2, createDefaultSystemLayers, disposeLayers } from "@celerity-sdk/core";
+import { discoverModule, bootstrap, executeHandlerPipeline as executeHandlerPipeline2, createDefaultSystemLayers, disposeLayers, resolveHandlerByModuleRef as resolveHandlerByModuleRef2 } from "@celerity-sdk/core";
 var debug3 = createDebug3("celerity:serverless-aws");
 var cached = null;
 var shutdownRegistered = false;
@@ -167,12 +187,14 @@ async function ensureBootstrapped() {
     debug3("entry: %d system layers created", systemLayers.length);
     const rootModule = await discoverModule();
     const result = await bootstrap(rootModule);
+    const modulePath = process.env.CELERITY_MODULE_PATH;
     cached = {
       registry: result.registry,
       options: {
         container: result.container,
         systemLayers
-      }
+      },
+      moduleDir: modulePath ? dirname2(resolve2(modulePath)) : process.cwd()
     };
     debug3("entry: bootstrap complete");
   }
@@ -180,12 +202,19 @@ async function ensureBootstrapped() {
 }
 __name(ensureBootstrapped, "ensureBootstrapped");
 async function handler(event, _context) {
-  const { registry, options } = await ensureBootstrapped();
+  const { registry, options, moduleDir } = await ensureBootstrapped();
   registerShutdownHandler(options);
   const apiEvent = event;
   const httpRequest = mapApiGatewayV2Event(apiEvent);
   debug3("entry: %s %s", httpRequest.method, httpRequest.path);
-  const resolved = registry.getHandler(httpRequest.path, httpRequest.method);
+  const handlerId = process.env.CELERITY_HANDLER_ID;
+  let resolved = handlerId ? registry.getHandlerById(handlerId) : void 0;
+  if (!resolved && handlerId) {
+    resolved = await resolveHandlerByModuleRef2(handlerId, registry, moduleDir) ?? void 0;
+  }
+  if (!resolved) {
+    resolved = registry.getHandler(httpRequest.path, httpRequest.method);
+  }
   if (!resolved) {
     return {
       statusCode: 404,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/adapter.ts","../src/event-mapper.ts","../src/entry.ts"],"sourcesContent":["import createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type {\n  HandlerRegistry,\n  ServerlessAdapter,\n  ResolvedHandler,\n  PipelineOptions,\n} from \"@celerity-sdk/core\";\nimport { executeHandlerPipeline } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nexport class AwsLambdaAdapter implements ServerlessAdapter {\n  createHandler(\n    registry: HandlerRegistry,\n    options: PipelineOptions,\n  ): (event: unknown, context: unknown) => Promise<unknown> {\n    let cachedHandler: ResolvedHandler | null = null;\n\n    return async (event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> => {\n      const apiEvent = event as APIGatewayProxyEventV2;\n      const httpRequest = mapApiGatewayV2Event(apiEvent);\n\n      if (!cachedHandler) {\n        debug(\n          \"adapter: cache miss, looking up handler for %s %s\",\n          httpRequest.method,\n          httpRequest.path,\n        );\n        cachedHandler = registry.getHandler(httpRequest.path, httpRequest.method) ?? null;\n      } else {\n        debug(\"adapter: using cached handler for %s %s\", httpRequest.method, httpRequest.path);\n      }\n\n      if (!cachedHandler) {\n        debug(\"adapter: no handler found → 404\");\n        return {\n          statusCode: 404,\n          headers: { \"content-type\": \"application/json\" },\n          body: JSON.stringify({\n            message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n          }),\n        };\n      }\n\n      const httpResponse = await executeHandlerPipeline(cachedHandler, httpRequest, options);\n      return mapHttpResponseToResult(httpResponse);\n    };\n  }\n}\n","import createDebug from \"debug\";\nimport type { HttpMethod, HttpRequest, HttpResponse } from \"@celerity-sdk/types\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from \"aws-lambda\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nfunction parseBody(event: APIGatewayProxyEventV2): {\n  textBody: string | null;\n  binaryBody: Buffer | null;\n} {\n  if (!event.body) return { textBody: null, binaryBody: null };\n  if (event.isBase64Encoded)\n    return { textBody: null, binaryBody: Buffer.from(event.body, \"base64\") };\n  return { textBody: event.body, binaryBody: null };\n}\n\nfunction parseHeaders(event: APIGatewayProxyEventV2): Record<string, string | string[]> {\n  const headers: Record<string, string | string[]> = {};\n  if (!event.headers) return headers;\n\n  for (const [key, value] of Object.entries(event.headers)) {\n    if (value !== undefined) {\n      headers[key.toLowerCase()] = value;\n    }\n  }\n  return headers;\n}\n\nfunction parseCookies(event: APIGatewayProxyEventV2): Record<string, string> {\n  const cookies: Record<string, string> = {};\n  if (!event.cookies) return cookies;\n\n  for (const cookie of event.cookies) {\n    const eqIndex = cookie.indexOf(\"=\");\n    if (eqIndex > 0) {\n      cookies[cookie.slice(0, eqIndex).trim()] = cookie.slice(eqIndex + 1).trim();\n    }\n  }\n  return cookies;\n}\n\nfunction parsePathParams(event: APIGatewayProxyEventV2): Record<string, string> {\n  const params: Record<string, string> = {};\n  if (!event.pathParameters) return params;\n\n  for (const [key, value] of Object.entries(event.pathParameters)) {\n    if (value !== undefined) {\n      params[key] = value;\n    }\n  }\n  return params;\n}\n\nexport function mapApiGatewayV2Event(event: APIGatewayProxyEventV2): HttpRequest {\n  const method = event.requestContext.http.method.toUpperCase() as HttpMethod;\n  const headers = parseHeaders(event);\n  const { textBody, binaryBody } = parseBody(event);\n\n  const authorizer = (\n    event.requestContext as unknown as {\n      authorizer?: { jwt?: { claims?: Record<string, unknown> } };\n    }\n  ).authorizer;\n\n  const contentType = (headers[\"content-type\"] as string | undefined) ?? null;\n  const xrayHeader = (headers[\"x-amzn-trace-id\"] as string | undefined) ?? null;\n\n  const request: HttpRequest = {\n    method,\n    path: event.rawPath,\n    pathParams: parsePathParams(event),\n    query: (event.queryStringParameters ?? {}) as Record<string, string | string[]>,\n    headers,\n    cookies: parseCookies(event),\n    textBody,\n    binaryBody,\n    contentType,\n    requestId: event.requestContext.requestId,\n    requestTime: event.requestContext.time ?? new Date().toISOString(),\n    auth: authorizer?.jwt?.claims ?? null,\n    clientIp: event.requestContext.http.sourceIp,\n    traceContext: xrayHeader ? { \"x-amzn-trace-id\": xrayHeader } : null,\n    userAgent: event.requestContext.http.userAgent ?? null,\n    matchedRoute: event.routeKey ?? null,\n  };\n\n  debug(\n    \"mapEvent: %s %s (auth=%s, traceContext=%s)\",\n    method,\n    event.rawPath,\n    !!authorizer?.jwt?.claims,\n    !!xrayHeader,\n  );\n\n  return request;\n}\n\nexport function mapHttpResponseToResult(response: HttpResponse): APIGatewayProxyStructuredResultV2 {\n  const result: APIGatewayProxyStructuredResultV2 = {\n    statusCode: response.status,\n  };\n\n  if (response.headers) {\n    result.headers = response.headers;\n  }\n\n  if (response.binaryBody) {\n    result.body = response.binaryBody.toString(\"base64\");\n    result.isBase64Encoded = true;\n  } else if (response.body) {\n    result.body = response.body;\n  }\n\n  return result;\n}\n","import createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type { PipelineOptions } from \"@celerity-sdk/core\";\nimport {\n  discoverModule,\n  bootstrap,\n  executeHandlerPipeline,\n  createDefaultSystemLayers,\n  disposeLayers,\n} from \"@celerity-sdk/core\";\nimport type { HandlerRegistry } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nlet cached: { registry: HandlerRegistry; options: PipelineOptions } | null = null;\nlet shutdownRegistered = false;\n\nfunction registerShutdownHandler(options: PipelineOptions): void {\n  if (shutdownRegistered) return;\n  shutdownRegistered = true;\n  debug(\"entry: SIGTERM shutdown handler registered\");\n\n  process.on(\"SIGTERM\", async () => {\n    await options.container.closeAll();\n    await disposeLayers([...(options.systemLayers ?? []), ...(options.appLayers ?? [])]);\n    process.exit(0);\n  });\n}\n\nasync function ensureBootstrapped(): Promise<{\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n}> {\n  if (!cached) {\n    debug(\"entry: cold start, bootstrapping\");\n    const systemLayers = await createDefaultSystemLayers();\n    debug(\"entry: %d system layers created\", systemLayers.length);\n    const rootModule = await discoverModule();\n    const result = await bootstrap(rootModule);\n    cached = {\n      registry: result.registry,\n      options: {\n        container: result.container,\n        systemLayers,\n      },\n    };\n    debug(\"entry: bootstrap complete\");\n  }\n  return cached;\n}\n\nexport async function handler(event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> {\n  const { registry, options } = await ensureBootstrapped();\n  registerShutdownHandler(options);\n  const apiEvent = event as APIGatewayProxyEventV2;\n  const httpRequest = mapApiGatewayV2Event(apiEvent);\n  debug(\"entry: %s %s\", httpRequest.method, httpRequest.path);\n\n  const resolved = registry.getHandler(httpRequest.path, httpRequest.method);\n  if (!resolved) {\n    return {\n      statusCode: 404,\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        statusCode: 404,\n        message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n      }),\n    };\n  }\n\n  const httpResponse = await executeHandlerPipeline(resolved, httpRequest, options);\n  return mapHttpResponseToResult(httpResponse);\n}\n"],"mappings":"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","names":["createDebug","executeHandlerPipeline","createDebug","debug","createDebug","parseBody","event","body","textBody","binaryBody","isBase64Encoded","Buffer","from","parseHeaders","headers","key","value","Object","entries","undefined","toLowerCase","parseCookies","cookies","cookie","eqIndex","indexOf","slice","trim","parsePathParams","params","pathParameters","mapApiGatewayV2Event","method","requestContext","http","toUpperCase","authorizer","contentType","xrayHeader","request","path","rawPath","pathParams","query","queryStringParameters","requestId","requestTime","time","Date","toISOString","auth","jwt","claims","clientIp","sourceIp","traceContext","userAgent","matchedRoute","routeKey","mapHttpResponseToResult","response","result","statusCode","status","toString","debug","createDebug","AwsLambdaAdapter","createHandler","registry","options","cachedHandler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult","createDebug","discoverModule","bootstrap","executeHandlerPipeline","createDefaultSystemLayers","disposeLayers","debug","createDebug","cached","shutdownRegistered","registerShutdownHandler","options","process","on","container","closeAll","disposeLayers","systemLayers","appLayers","exit","ensureBootstrapped","createDefaultSystemLayers","length","rootModule","discoverModule","result","bootstrap","registry","handler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","resolved","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult"]}
+{"version":3,"sources":["../src/adapter.ts","../src/event-mapper.ts","../src/entry.ts"],"sourcesContent":["import { dirname, resolve } from \"node:path\";\nimport createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type {\n  HandlerRegistry,\n  ServerlessAdapter,\n  ResolvedHandler,\n  PipelineOptions,\n} from \"@celerity-sdk/core\";\nimport { executeHandlerPipeline, resolveHandlerByModuleRef } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\ntype AwsLambdaAdapterConfig = {\n  handlerId?: string;\n  moduleDir: string;\n};\n\nexport class AwsLambdaAdapter implements ServerlessAdapter {\n  config: AwsLambdaAdapterConfig;\n\n  constructor() {\n    // Capture config from environment variables on construction\n    // to take a snapshot at the initialisation phase similarly to\n    // how layers capture config.\n    this.config = captureAwsLambdaConfig();\n  }\n\n  createHandler(\n    registry: HandlerRegistry,\n    options: PipelineOptions,\n  ): (event: unknown, context: unknown) => Promise<unknown> {\n    let cachedHandler: ResolvedHandler | null = null;\n\n    return async (event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> => {\n      const apiEvent = event as APIGatewayProxyEventV2;\n      const httpRequest = mapApiGatewayV2Event(apiEvent);\n\n      if (!cachedHandler) {\n        debug(\n          \"adapter: cache miss, looking up handler for %s %s\",\n          httpRequest.method,\n          httpRequest.path,\n        );\n\n        cachedHandler =\n          (this.config.handlerId ? registry.getHandlerById(this.config.handlerId) : undefined) ??\n          null;\n\n        if (!cachedHandler && this.config.handlerId) {\n          cachedHandler = await resolveHandlerByModuleRef(\n            this.config.handlerId,\n            registry,\n            this.config.moduleDir,\n          );\n        }\n\n        if (!cachedHandler) {\n          cachedHandler = registry.getHandler(httpRequest.path, httpRequest.method) ?? null;\n        }\n      } else {\n        debug(\"adapter: using cached handler for %s %s\", httpRequest.method, httpRequest.path);\n      }\n\n      if (!cachedHandler) {\n        debug(\"adapter: no handler found → 404\");\n        return {\n          statusCode: 404,\n          headers: { \"content-type\": \"application/json\" },\n          body: JSON.stringify({\n            message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n          }),\n        };\n      }\n\n      const httpResponse = await executeHandlerPipeline(cachedHandler, httpRequest, options);\n      return mapHttpResponseToResult(httpResponse);\n    };\n  }\n}\n\nfunction captureAwsLambdaConfig(): AwsLambdaAdapterConfig {\n  const modulePath = process.env.CELERITY_MODULE_PATH;\n  return {\n    handlerId: process.env.CELERITY_HANDLER_ID,\n    moduleDir: modulePath ? dirname(resolve(modulePath)) : process.cwd(),\n  };\n}\n","import createDebug from \"debug\";\nimport type { HttpMethod, HttpRequest, HttpResponse } from \"@celerity-sdk/types\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyStructuredResultV2 } from \"aws-lambda\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nfunction parseBody(event: APIGatewayProxyEventV2): {\n  textBody: string | null;\n  binaryBody: Buffer | null;\n} {\n  if (!event.body) return { textBody: null, binaryBody: null };\n  if (event.isBase64Encoded)\n    return { textBody: null, binaryBody: Buffer.from(event.body, \"base64\") };\n  return { textBody: event.body, binaryBody: null };\n}\n\nfunction parseHeaders(event: APIGatewayProxyEventV2): Record<string, string | string[]> {\n  const headers: Record<string, string | string[]> = {};\n  if (!event.headers) return headers;\n\n  for (const [key, value] of Object.entries(event.headers)) {\n    if (value !== undefined) {\n      headers[key.toLowerCase()] = value;\n    }\n  }\n  return headers;\n}\n\nfunction parseCookies(event: APIGatewayProxyEventV2): Record<string, string> {\n  const cookies: Record<string, string> = {};\n  if (!event.cookies) return cookies;\n\n  for (const cookie of event.cookies) {\n    const eqIndex = cookie.indexOf(\"=\");\n    if (eqIndex > 0) {\n      cookies[cookie.slice(0, eqIndex).trim()] = cookie.slice(eqIndex + 1).trim();\n    }\n  }\n  return cookies;\n}\n\nfunction parsePathParams(event: APIGatewayProxyEventV2): Record<string, string> {\n  const params: Record<string, string> = {};\n  if (!event.pathParameters) return params;\n\n  for (const [key, value] of Object.entries(event.pathParameters)) {\n    if (value !== undefined) {\n      params[key] = value;\n    }\n  }\n  return params;\n}\n\nexport function mapApiGatewayV2Event(event: APIGatewayProxyEventV2): HttpRequest {\n  const method = event.requestContext.http.method.toUpperCase() as HttpMethod;\n  const headers = parseHeaders(event);\n  const { textBody, binaryBody } = parseBody(event);\n\n  const authorizer = (\n    event.requestContext as unknown as {\n      authorizer?: { jwt?: { claims?: Record<string, unknown> } };\n    }\n  ).authorizer;\n\n  const contentType = (headers[\"content-type\"] as string | undefined) ?? null;\n  const xrayHeader = (headers[\"x-amzn-trace-id\"] as string | undefined) ?? null;\n\n  const request: HttpRequest = {\n    method,\n    path: event.rawPath,\n    pathParams: parsePathParams(event),\n    query: (event.queryStringParameters ?? {}) as Record<string, string | string[]>,\n    headers,\n    cookies: parseCookies(event),\n    textBody,\n    binaryBody,\n    contentType,\n    requestId: event.requestContext.requestId,\n    requestTime: event.requestContext.time ?? new Date().toISOString(),\n    auth: authorizer?.jwt?.claims ?? null,\n    clientIp: event.requestContext.http.sourceIp,\n    traceContext: xrayHeader ? { \"x-amzn-trace-id\": xrayHeader } : null,\n    userAgent: event.requestContext.http.userAgent ?? null,\n    matchedRoute: event.routeKey ?? null,\n  };\n\n  debug(\n    \"mapEvent: %s %s (auth=%s, traceContext=%s)\",\n    method,\n    event.rawPath,\n    !!authorizer?.jwt?.claims,\n    !!xrayHeader,\n  );\n\n  return request;\n}\n\nexport function mapHttpResponseToResult(response: HttpResponse): APIGatewayProxyStructuredResultV2 {\n  const result: APIGatewayProxyStructuredResultV2 = {\n    statusCode: response.status,\n  };\n\n  if (response.headers) {\n    result.headers = response.headers;\n  }\n\n  if (response.binaryBody) {\n    result.body = response.binaryBody.toString(\"base64\");\n    result.isBase64Encoded = true;\n  } else if (response.body) {\n    result.body = response.body;\n  }\n\n  return result;\n}\n","import { dirname, resolve } from \"node:path\";\nimport createDebug from \"debug\";\nimport type { APIGatewayProxyEventV2, APIGatewayProxyResultV2 } from \"aws-lambda\";\nimport type { PipelineOptions } from \"@celerity-sdk/core\";\nimport {\n  discoverModule,\n  bootstrap,\n  executeHandlerPipeline,\n  createDefaultSystemLayers,\n  disposeLayers,\n  resolveHandlerByModuleRef,\n} from \"@celerity-sdk/core\";\nimport type { HandlerRegistry } from \"@celerity-sdk/core\";\nimport { mapApiGatewayV2Event, mapHttpResponseToResult } from \"./event-mapper\";\n\nconst debug = createDebug(\"celerity:serverless-aws\");\n\nlet cached: {\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n  moduleDir: string;\n} | null = null;\nlet shutdownRegistered = false;\n\nfunction registerShutdownHandler(options: PipelineOptions): void {\n  if (shutdownRegistered) return;\n  shutdownRegistered = true;\n  debug(\"entry: SIGTERM shutdown handler registered\");\n\n  process.on(\"SIGTERM\", async () => {\n    await options.container.closeAll();\n    await disposeLayers([...(options.systemLayers ?? []), ...(options.appLayers ?? [])]);\n    process.exit(0);\n  });\n}\n\nasync function ensureBootstrapped(): Promise<{\n  registry: HandlerRegistry;\n  options: PipelineOptions;\n  moduleDir: string;\n}> {\n  if (!cached) {\n    debug(\"entry: cold start, bootstrapping\");\n    const systemLayers = await createDefaultSystemLayers();\n    debug(\"entry: %d system layers created\", systemLayers.length);\n    const rootModule = await discoverModule();\n    const result = await bootstrap(rootModule);\n    const modulePath = process.env.CELERITY_MODULE_PATH;\n    cached = {\n      registry: result.registry,\n      options: {\n        container: result.container,\n        systemLayers,\n      },\n      moduleDir: modulePath ? dirname(resolve(modulePath)) : process.cwd(),\n    };\n    debug(\"entry: bootstrap complete\");\n  }\n  return cached;\n}\n\nexport async function handler(event: unknown, _context: unknown): Promise<APIGatewayProxyResultV2> {\n  const { registry, options, moduleDir } = await ensureBootstrapped();\n  registerShutdownHandler(options);\n  const apiEvent = event as APIGatewayProxyEventV2;\n  const httpRequest = mapApiGatewayV2Event(apiEvent);\n  debug(\"entry: %s %s\", httpRequest.method, httpRequest.path);\n\n  const handlerId = process.env.CELERITY_HANDLER_ID;\n\n  let resolved = handlerId ? registry.getHandlerById(handlerId) : undefined;\n\n  if (!resolved && handlerId) {\n    resolved = (await resolveHandlerByModuleRef(handlerId, registry, moduleDir)) ?? undefined;\n  }\n\n  if (!resolved) {\n    resolved = registry.getHandler(httpRequest.path, httpRequest.method);\n  }\n\n  if (!resolved) {\n    return {\n      statusCode: 404,\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        statusCode: 404,\n        message: `No handler for ${httpRequest.method} ${httpRequest.path}`,\n      }),\n    };\n  }\n\n  const httpResponse = await executeHandlerPipeline(resolved, httpRequest, options);\n  return mapHttpResponseToResult(httpResponse);\n}\n"],"mappings":"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","names":["dirname","resolve","createDebug","executeHandlerPipeline","resolveHandlerByModuleRef","createDebug","debug","createDebug","parseBody","event","body","textBody","binaryBody","isBase64Encoded","Buffer","from","parseHeaders","headers","key","value","Object","entries","undefined","toLowerCase","parseCookies","cookies","cookie","eqIndex","indexOf","slice","trim","parsePathParams","params","pathParameters","mapApiGatewayV2Event","method","requestContext","http","toUpperCase","authorizer","contentType","xrayHeader","request","path","rawPath","pathParams","query","queryStringParameters","requestId","requestTime","time","Date","toISOString","auth","jwt","claims","clientIp","sourceIp","traceContext","userAgent","matchedRoute","routeKey","mapHttpResponseToResult","response","result","statusCode","status","toString","debug","createDebug","AwsLambdaAdapter","config","captureAwsLambdaConfig","createHandler","registry","options","cachedHandler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","handlerId","getHandlerById","undefined","resolveHandlerByModuleRef","moduleDir","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult","modulePath","process","env","CELERITY_MODULE_PATH","CELERITY_HANDLER_ID","dirname","resolve","cwd","dirname","resolve","createDebug","discoverModule","bootstrap","executeHandlerPipeline","createDefaultSystemLayers","disposeLayers","resolveHandlerByModuleRef","debug","createDebug","cached","shutdownRegistered","registerShutdownHandler","options","process","on","container","closeAll","disposeLayers","systemLayers","appLayers","exit","ensureBootstrapped","createDefaultSystemLayers","length","rootModule","discoverModule","result","bootstrap","modulePath","env","CELERITY_MODULE_PATH","registry","moduleDir","dirname","resolve","cwd","handler","event","_context","apiEvent","httpRequest","mapApiGatewayV2Event","method","path","handlerId","CELERITY_HANDLER_ID","resolved","getHandlerById","undefined","resolveHandlerByModuleRef","getHandler","statusCode","headers","body","JSON","stringify","message","httpResponse","executeHandlerPipeline","mapHttpResponseToResult"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celerity-sdk/serverless-aws",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "AWS Lambda adapter for the Celerity Node SDK — converts API Gateway events to SDK types",
   "license": "Apache-2.0",
   "repository": {
@@ -42,8 +42,8 @@
   },
   "dependencies": {
     "debug": "^4.4.0",
-    "@celerity-sdk/types": "^0.2.0",
-    "@celerity-sdk/core": "^0.2.0"
+    "@celerity-sdk/core": "^0.3.0",
+    "@celerity-sdk/types": "^0.3.0"
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.160"