![\"Ambiten\"](\"https://raw.githubusercontent.com/AmbitenHQ/ambiten/main/assets/ambiten-mark-192x192.png\")
\n
\n AWS Lambda integration for the Ambiten runtime.\n
\n\n\n Establish runtime execution boundaries for serverless workloads while preserving context propagation, multi-tenancy, observability, and transaction-aware execution across Lambda invocations.\n
\n\n\n\n---\n\n## Overview\n\n`@ambiten/adapter-lambda` connects AWS Lambda functions to the Ambiten runtime.\n\nThe adapter establishes an execution boundary for each Lambda invocation so runtime context remains available throughout the lifecycle of the function. Tenant information, request metadata, logging, instrumentation, transactions, and runtime services can then participate consistently across handlers, services, and model operations.\n\nThe adapter does not replace Lambda. It allows serverless execution to participate fully in the Ambiten runtime model.\n\n## Installation\n\n```bash\nnpm install @ambiten/core @ambiten/adapter-lambda\n```\n\n## Quick Start\n\n```ts\nimport {\n AmbitenBootstrapFactory\n} from \"@ambiten/core\";\n\nimport {\n createLambdaAdapter\n} from \"@ambiten/adapter-lambda\";\n\nconst adapter = createLambdaAdapter();\n\nconst bootstrap =\n await AmbitenBootstrapFactory.create({\n adapter\n });\n\nexport const handler =\n adapter.wrap(async (event, context) => {\n return {\n statusCode: 200,\n body: JSON.stringify({\n success: true\n })\n };\n });\n```\n\nEach invocation automatically participates in the Ambiten execution model.\n\n## What the Adapter Provides\n\nThe adapter acts as the bridge between AWS Lambda and the runtime.\n\nIt can establish invocation-scoped context, initialize tenant boundaries, propagate request metadata, participate in transaction-aware execution flows, and expose runtime state to downstream services and models.\n\nThis allows function handlers to remain focused on business logic while execution concerns remain coordinated by the runtime.\n\n## Runtime Flow\n\n```text\nLambda Invocation\n ↓\nLambda Adapter\n ↓\nAmbitenContext\n ↓\nServices\n ↓\nModels\n ↓\nMongoDB\n```\n\nThe adapter creates the execution boundary. The runtime then carries execution state throughout the remainder of the invocation lifecycle.\n\n## Invocation Context\n\nServerless applications frequently require request information to remain available across asynchronous execution paths.\n\nThe adapter can automatically expose invocation metadata through the runtime context so services and models can access request-scoped information without manually passing it between layers.\n\n```text\nLambda Event\n ↓\nRuntime Context\n ↓\nService Layer\n ↓\nModel Operations\n```\n\nExecution context remains attached throughout the entire invocation.\n\n## Multi-Tenancy\n\nWhen multi-tenancy is enabled, tenant information can be resolved from the incoming event and made available throughout the active runtime context.\n\n```text\nLambda Event\n ↓\nTenant Resolution\n ↓\nAmbitenContext\n ↓\nTenant-Aware Execution\n```\n\nThis allows models and services to operate against the correct tenant boundary without manually propagating tenant identifiers through the application.\n\n## Serverless Execution\n\nUnlike traditional servers, Lambda functions execute inside short-lived invocation boundaries.\n\nThe adapter is designed around this model and ensures runtime state is isolated per invocation while still allowing logging, instrumentation, transactions, and context propagation to behave consistently.\n\nThis makes it possible to share the same runtime model across serverless functions, APIs, workers, and long-running services.\n\n## Observability\n\nLogs, instrumentation events, and runtime metadata generated during an invocation remain correlated through the active runtime context.\n\nThis helps preserve operational visibility across distributed systems where requests may pass through multiple serverless functions before completing.\n\n## Documentation\n\nComplete documentation is available at:\n\nhttps://docs.ambiten.dev\n\n## Related Packages\n\n* `@ambiten/core`\n* `@ambiten/logger`\n* `@ambiten/create`\n\n## License\n\nMIT\n","readmeFilename":"README.md"}![\"npm](\"https://img.shields.io/npm/v/@ambiten/adapter-lambda?style=flat-square\")
\n ![\"GitHub](\"https://img.shields.io/github/stars/AmbitenHQ/ambiten?style=flat-square&color=1E88E5\")
\n