![\"npm](\"https://img.shields.io/npm/v/@ambiten/adapter-runtime?style=flat-square\")
\n \n \n \n ![\"GitHub](\"https://img.shields.io/github/stars/AmbitenHQ/ambiten?style=flat-square&color=1E88E5\")
\n \n\n
\n Shared execution runtime for Ambiten adapters.\n
\n\n\n Provides the execution boundary, context propagation, tenant resolution, transaction coordination, and runtime lifecycle primitives used by the Ambiten adapter ecosystem.\n
\n\n\n\n---\n\n## Overview\n\n`@ambiten/adapter-runtime` is the shared execution layer that powers the Ambiten adapter ecosystem.\n\nIt provides the common runtime infrastructure used by framework integrations such as Express, Fastify, NestJS, GraphQL, and AWS Lambda.\n\nMost applications will never interact with this package directly. Instead, it operates behind the scenes to establish execution boundaries, propagate runtime context, coordinate transactions, resolve tenants, and maintain execution continuity across different environments.\n\nThe purpose of the package is to ensure that every adapter participates in the same runtime model regardless of framework or deployment target.\n\n## Installation\n\nThis package is installed automatically by Ambiten adapter packages and typically does not need to be added manually.\n\n```bash\nnpm install @ambiten/adapter-runtime\n```\n\n## Runtime Responsibility\n\nThe adapter runtime exists between the framework layer and the Ambiten runtime.\n\n```text\nIncoming Request\n ↓\nFramework Adapter\n ↓\nAdapter Runtime\n ↓\nAmbitenContext\n ↓\nModels & Services\n ↓\nMongoDB\n```\n\nThe framework adapter establishes the entry point.\n\nThe adapter runtime establishes the execution boundary.\n\nThe Ambiten runtime then carries execution state throughout the remainder of the operation.\n\n## What the Runtime Provides\n\nThe adapter runtime provides the shared capabilities required by all adapter implementations.\n\nExecution context can be established consistently regardless of whether a request originates from Express, Fastify, GraphQL, NestJS, Lambda, or future adapter integrations.\n\nTenant resolution, request metadata propagation, transaction coordination, runtime instrumentation, and execution lifecycle management are all handled through a common runtime contract.\n\nThis allows adapter implementations to remain lightweight while sharing the same operational behavior.\n\n## Context Propagation\n\nOne of the primary responsibilities of the runtime is maintaining execution continuity.\n\n```text\nRequest\n ↓\nExecution Boundary\n ↓\nAmbitenContext\n ↓\nServices\n ↓\nModels\n```\n\nOnce context has been established, runtime state remains available throughout middleware, services, repositories, transactions, asynchronous operations, and model execution.\n\nThis allows application code to remain focused on business behavior rather than infrastructure plumbing.\n\n## Multi-Tenancy\n\nThe runtime provides shared tenant resolution primitives used by all Ambiten adapters.\n\n```text\nRequest\n ↓\nTenant Resolution\n ↓\nRuntime Context\n ↓\nTenant-Aware Execution\n```\n\nThis ensures tenant-aware behavior remains consistent regardless of framework choice.\n\n## Transaction Coordination\n\nThe runtime also provides the execution mechanisms required for transaction-aware operations.\n\nTransaction state can propagate through the active runtime context, allowing multiple model operations to participate in a shared execution boundary without manual session management.\n\nThis behavior remains consistent across all supported adapters.\n\n## Who Should Use This Package?\n\nMost developers should use one of the framework-specific adapters:\n\n* `@ambiten/adapter-express`\n* `@ambiten/adapter-fastify`\n* `@ambiten/adapter-nestjs`\n* `@ambiten/adapter-graphql`\n* `@ambiten/adapter-lambda`\n\nDirect usage of `@ambiten/adapter-runtime` is generally reserved for adapter authors, framework integrations, and advanced runtime extensions.\n\n## Documentation\n\nComplete documentation is available at:\n\nhttps://docs.ambiten.dev\n\n## Related Packages\n\n* `@ambiten/core`\n* `@ambiten/adapter-express`\n* `@ambiten/adapter-fastify`\n* `@ambiten/adapter-nestjs`\n* `@ambiten/adapter-graphql`\n* `@ambiten/adapter-lambda`\n\n## License\n\nMIT\n","readmeFilename":"README.md"}