Docs are a work in progress - contributions welcome
Logonestjs-openapi
Guides

Support Matrix

What is supported and what is not

A concise view of what the generator reads today. For details, see the full Decorators Guide.

Routing

FeatureStatusNotes
@Controller('path')SupportedString path only
@Controller({ path, version })Not supportedObject syntax is ignored
HTTP method decoratorsSupported@Get, @Post, @Put, @Patch, @Delete, @Options, @Head, @All (all is non-standard)

Parameters

DecoratorStatusNotes
@Param()SupportedPath parameters
@Query()SupportedQuery params, DTOs inline by default
@Body()SupportedRequest body
@Headers()SupportedHeader parameters

Swagger Operation Decorators

DecoratorStatusNotes
@ApiTagsSupportedController and method level
@ApiOperationSupportedSummary, description, operationId
@ApiParamSupportedPath parameter docs
@ApiQuerySupportedQuery parameter docs
@ApiBodySupportedBody metadata
@ApiResponseSupportedstatus is required
@ApiExcludeEndpointSupportedMethod-level, controlled by excludeDecorators
@ApiConsumes, @ApiProducesSupportedContent types
@ApiExcludeControllerNot supportedController-level exclusion is not applied

Response Shortcuts

DecoratorStatusNotes
@ApiOkResponse, @ApiCreatedResponse, etc.Not supportedUse @ApiResponse({ status: ... })

Property Decorators

DecoratorStatusNotes
@ApiPropertyNot supportedUse TypeScript types + JSDoc
@ApiPropertyOptionalNot supportedUse optional properties (?)
@ApiHidePropertyNot supportedNo equivalent

Security

DecoratorStatusNotes
@ApiBearerAuthSupportedScheme must exist in config
@ApiBasicAuthSupportedScheme must exist in config
@ApiOAuth2SupportedScheme must exist in config
@ApiSecuritySupportedScheme must exist in config
@ApiCookieAuthSupportedScheme must exist in config

DTO Schema Generation

SourceStatusNotes
TypeScript typesSupportedPrimary source of truth
JSDoc tagsSupportedDescriptions and constraints
class-validator decoratorsSupportedRequires extractValidation: true

Limitations

  • Dynamic route registration at runtime is not supported
  • Controller versioning via @Controller({ path, version }) is not supported
  • Response shortcut decorators are ignored
  • Controller-level exclusion decorators are not applied
  • @All() maps to a non-standard all operation

Next Steps

On this page