# tsoa-next

> Build type-safe OpenAPI APIs for Node.js using TypeScript decorators with automatic spec generation and validation

- **URL**: https://www.freshcrate.ai/projects/tsoa-next
- **Author**: tsoa-next
- **Category**: Frameworks
- **Latest version**: `tsoa-next@8.2.2` (2026-04-17)
- **License**: MIT
- **Source**: https://github.com/tsoa-next/tsoa-next
- **Homepage**: http://tsoa-next.dev/
- **Language**: TypeScript
- **GitHub**: 3 stars
- **Registry**: github
- **Tags**: `api-framework`, `backend`, `code-generation`, `contract-first`, `decorators`, `express`, `koa`, `nodejs`, `typescript`

## Description

Build type-safe OpenAPI APIs for Node.js using TypeScript decorators with automatic spec generation and validation

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `tsoa-next@8.2.2` | 2026-04-17 | High | ### Patch Changes  -   5d3e303: Fixed generated `@SpecPath(...)` routes so they register before regular controller routes in the Express, Koa, and Hapi templates. This prevents dynamic first-segment routes such as `/{tenant}/{resource}` from shadowing spec endpoints like `/SpecPath/spec`.      Refreshed the docs site and API reference to ship from one VitePress pipeline with `typedoc-plugin-markdown`, grouped install snippets, generated `llms.txt` output, published changelog pages, syntax-highli |
| `@tsoa-next/runtime@8.2.2` | 2026-04-17 | High | ### Patch Changes  -   5d3e303: Fixed generated `@SpecPath(...)` routes so they register before regular controller routes in the Express, Koa, and Hapi templates. This prevents dynamic first-segment routes such as `/{tenant}/{resource}` from shadowing spec endpoints like `/SpecPath/spec`.      Refreshed the docs site and API reference to ship from one VitePress pipeline with `typedoc-plugin-markdown`, grouped install snippets, generated `llms.txt` output, published changelog pages, syntax-highli |
| `@tsoa-next/cli@8.2.2` | 2026-04-17 | High | ### Patch Changes  -   5d3e303: Fixed generated `@SpecPath(...)` routes so they register before regular controller routes in the Express, Koa, and Hapi templates. This prevents dynamic first-segment routes such as `/{tenant}/{resource}` from shadowing spec endpoints like `/SpecPath/spec`.      Refreshed the docs site and API reference to ship from one VitePress pipeline with `typedoc-plugin-markdown`, grouped install snippets, generated `llms.txt` output, published changelog pages, syntax-highli |
| `@tsoa-next/cli@8.2.1` | 2026-04-16 | High | ### Patch Changes  -   a32e6e2: Fix live `@SpecPath(...)` serving for compiled deployments that do not ship controller source files.      Generated routes now embed the OpenAPI artifact and metadata needed for built-in spec endpoints, so live spec responses no longer depend on runtime controller glob resolution. This also keeps generated route imports aligned with embedded-spec usage and preserves normal spec-generation options when building embedded specs.      Additional follow-up fixes keep t |
| `tsoa-next@8.2.1` | 2026-04-16 | High | ### Patch Changes  -   a32e6e2: Fix live `@SpecPath(...)` serving for compiled deployments that do not ship controller source files.      Generated routes now embed the OpenAPI artifact and metadata needed for built-in spec endpoints, so live spec responses no longer depend on runtime controller glob resolution. This also keeps generated route imports aligned with embedded-spec usage and preserves normal spec-generation options when building embedded specs.      Additional follow-up fixes |
| `@tsoa-next/runtime@8.2.1` | 2026-04-16 | High | ### Patch Changes  -   a32e6e2: Fix live `@SpecPath(...)` serving for compiled deployments that do not ship controller source files.      Generated routes now embed the OpenAPI artifact and metadata needed for built-in spec endpoints, so live spec responses no longer depend on runtime controller glob resolution. This also keeps generated route imports aligned with embedded-spec usage and preserves normal spec-generation options when building embedded specs.      Additional follow-up fixes keep t |
| `@tsoa-next/runtime@8.2.0` | 2026-04-14 | Medium | ### Minor Changes  -   8a8ff5b: Improve `@SpecPath(...)` support by adding the `@SpecPath(path, options?)` signature with `target`, `cache`, and request-aware `gate` controls.      Generated Express, Koa, and Hapi routes now omit `SpecPath` support when no controller uses the decorator, and statically gated spec routes are skipped during registration. |
| `@tsoa-next/cli@8.2.0` | 2026-04-14 | Medium | ### Minor Changes  -   8a8ff5b: Improve `@SpecPath(...)` support by adding the `@SpecPath(path, options?)` signature with `target`, `cache`, and request-aware `gate` controls.      Generated Express, Koa, and Hapi routes now omit `SpecPath` support when no controller uses the decorator, and statically gated spec routes are skipped during registration.  ### Patch Changes  -   Updated dependencies [8a8ff5b]     -   @tsoa-next/runtime@8.2.0 |
| `tsoa-next@8.2.0` | 2026-04-14 | High | ### Minor Changes  -   8a8ff5b: Improve `@SpecPath(...)` support by adding the `@SpecPath(path, options?)` signature with `target`, `cache`, and request-aware `gate` controls.      Generated Express, Koa, and Hapi routes now omit `SpecPath` support when no controller uses the decorator, and statically gated spec routes are skipped during registration.  ### Patch Changes  -   Updated dependencies [8a8ff5b]     -   @tsoa-next/cli@8.2.0     -   @tsoa-next/runtime@8.2.0 |
| `tsoa-next@8.1.0` | 2026-04-12 | High | ### Minor Changes  -   84bb4a6: Add repeatable `@SpecPath(...)` controller decorators for serving OpenAPI documents and documentation UIs directly from generated routes without reading a local spec file at request time.      This release adds:      -   Built-in `json`, `yaml`, `swagger`, `redoc`, and `rapidoc` `@SpecPath(...)` targets     -   Lazy in-memory spec generation for built-in spec routes through `createOpenApiSpecGenerator(...)`     -   Support for multiple `@SpecPath(...)` decorators |

## Citation

- HTML: https://www.freshcrate.ai/projects/tsoa-next
- Markdown: https://www.freshcrate.ai/projects/tsoa-next.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/tsoa-next/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._