![\"npm](\"https://img.shields.io/npm/v/@ambiten/adapter-nestjs?style=flat-square\")
\n \n \n \n \n ![\"GitHub](\"https://img.shields.io/github/stars/AmbitenHQ/ambiten?style=flat-square&color=1E88E5\")
\n \n\n
\n NestJS integration for the Ambiten runtime.\n
\n\n\n Establish request-scoped execution boundaries, context propagation, multi-tenancy, and transaction-aware runtime behavior throughout NestJS applications.\n
\n\n\n\n---\n\n## Overview\n\n`@ambiten/adapter-nestjs` connects NestJS applications to the Ambiten runtime.\n\nThe adapter establishes execution boundaries using NestJS lifecycle mechanisms such as middleware, guards, interceptors, and request pipelines so runtime context remains available throughout the lifecycle of a request. Tenant information, request metadata, transactions, logging, instrumentation, and runtime services can then participate consistently across controllers, providers, services, and model operations.\n\nThe adapter does not replace NestJS. It allows NestJS to operate as an execution entry point for the Ambiten runtime.\n\n## Installation\n\n```bash\nnpm install @ambiten/core @ambiten/adapter-nestjs\n```\n\n## Quick Start\n\n```ts\nimport { Module } from '@nestjs/common';\nimport { AmbitenBootstrapFactory } from '@ambiten/core';\nimport { createNestJSAdapter } from '@ambiten/adapter-nestjs';\n\nconst adapter = createNestJSAdapter();\n\nawait AmbitenBootstrapFactory.create({\n adapter\n});\n\n@Module({})\nexport class AppModule {}\n```\n\nOnce installed, incoming requests automatically participate in the Ambiten execution model.\n\n## What the Adapter Provides\n\nThe adapter acts as the bridge between NestJS and the runtime.\n\nIt can establish request-scoped context, initialize tenant boundaries, propagate request metadata, participate in transaction-aware execution flows, and expose runtime state to controllers, providers, services, and models.\n\nThis allows application code to remain focused on business logic while execution concerns remain coordinated by the runtime.\n\n## Runtime Flow\n\n```text\nIncoming Request\n ↓\nNestJS\n ↓\nAmbiten Adapter\n ↓\nAmbitenContext\n ↓\nControllers\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 request lifecycle.\n\n## NestJS Integration\n\nThe adapter integrates naturally with NestJS architecture.\n\nRuntime context remains available throughout controllers, providers, guards, interceptors, middleware, pipes, and services without requiring request metadata to be manually passed through every layer.\n\n```text\nRequest\n ↓\nGuard\n ↓\nInterceptor\n ↓\nController\n ↓\nService\n ↓\nModel\n```\n\nExecution context remains attached throughout the entire flow.\n\n## Multi-Tenancy\n\nWhen multi-tenancy is enabled, tenant information can be resolved from incoming requests and made available throughout the active runtime context.\n\n```text\nRequest\n ↓\nTenant Resolution\n ↓\nAmbitenContext\n ↓\nTenant-Aware Execution\n```\n\nThis allows services and models to operate against the correct tenant boundary without manually propagating tenant identifiers throughout the application.\n\n## Transaction-Aware Execution\n\nNestJS applications often involve multiple service layers participating in a single business workflow.\n\nThe adapter allows transaction state to remain available throughout the active runtime context so model operations can participate in the same transaction boundary without manually passing sessions between services.\n\nThis helps maintain consistent execution behavior across complex application architectures.\n\n## Observability\n\nLogs, instrumentation events, runtime metrics, and execution metadata generated throughout the request lifecycle remain correlated through the active runtime context.\n\nThis provides a consistent operational view across controllers, services, repositories, middleware, and model operations.\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"}