Release 11.4.4

11.4.4 (2026-05-21)

Bug fixes

• #3930 fix: top-level nullable with discriminator issue (@kamilmysliwiec)

Enhancements

• #3921 feat(swagger): add summary field to Tag Object (OpenAPI 3.2) (@frbuceta)
• #3924 feat(swagger): warn when @apitags receives hierarchy fields (@frbuceta)
• #3925 fix(swagger): type Tag Object kind as a free-form string (@frbuceta)

Committers: 4

• Alexander Scholz (@LucidityDesign)
• Francisco Buceta (@frbuceta)
• Kamil Mysliwiec (@kamilmysliwiec)
• Natanael dos Santos Feitosa (@natanfeitosa)

Release 11.4.3

11.4.3 (2026-05-14)

Bug fixes

• #3910 fix(swagger): support const enum query params (@yudin-s)
• #3911 fix(swagger-module): return reply from async route handlers (@tibohaffner)
• #3883 fix(response-object-factory): preserve example/examples for built-in scalar response types (@yogeshwaran-c)
• #3882 fix(swagger-types-mapper): place multipleOf inside parameter schema (@yogeshwaran-c)

Enhancements

• #3885 feat(plugin): auto-generate enum metadata for string and number literal union types (@y-hsgw)
• #3604 feat: added api-include-endpoint (@TomSpott)

Dependencies

• #3906 fix(deps): update dependency swagger-ui-dist to v5.32.6 (@renovate[bot])

Committers: 6

• Serge Yudin (@yudin-s)
• Thibault Haffner (@tibohaffner)
• Yogeshwaran C (@yogeshwaran-c)
• Yukihiro Hasegawa (@y-hsgw)
• @TomSpott
• @kyungseopk1m

Release 11.4.2

11.4.2 (2026-04-27)

Bug fixes

• #3867 fix(plugin): keep auto-inferred default response when only error Api*Response decorators are present (@PeterTheOne)
• #3876 fix(plugin): handle IsIn enum inference when type falls back to Object (@y-hsgw)

Committers: 2

• Peter Grassberger (@PeterTheOne)
• Yukihiro Hasegawa (@y-hsgw)

Release 11.4.1

11.4.1 (2026-04-22)

Bug fixes

• #3871 fix(plugin): avoid duplicate keys when auto-generating @apioperation (@yogeshwaran-c)

Committers: 1

• Yogeshwaran C (@yogeshwaran-c)

Release 11.4.0

11.4.0 (2026-04-22)

Features

• #3868 feat(plugin): auto-mark optional @query parameters as required: false (@yogeshwaran-c)
• #3725 feat(swagger): add OpenAPI 3.2 hierarchical tags support (@apt-bh)

Bug fixes

• #3874 fix(document-builder): accept multi-digit OpenAPI version segments (@yogeshwaran-c)
• #3873 fix(plugin): strip regex delimiters and flags from @matches patterns (@yogeshwaran-c)
• #3870 fix(decorators): forward all OpenAPI parameter fields in @ApiHeader (@yogeshwaran-c)
• #3872 fix(plugin): emit @throws descriptions as proper string literals (@yogeshwaran-c)
• #3782 fix(schema): preserve example metadata for non-body params with named types (@maruthang)
• #3761 fix(plugin): support boolean literal types and boolean enum values (@lucreiss)

Enhancements

• #3865 feat(schema-object-factory): include class name chain in circular dependency errors (@yogeshwaran-c)

Committers: 4

• Lu R A (@lucreiss)
• Maruthan G (@maruthang)
• Yogeshwaran C (@yogeshwaran-c)
• @apt-bh

Release 11.3.2

What's Changed

• fix(plugin): remap import paths within rootDir to outDir by @alex-all3dp in #3858

New Contributors

• @alex-all3dp made their first contribution in #3858

Full Changelog: 11.3.1...11.3.2

Release 11.3.1

11.3.1 (2026-04-20)

Bug fixes

• #3847 fix(plugin): adjust relative import paths for tsconfig outDir depth (@kyungseopk1m)
• #3781 fix(schema): prioritize oneOf/anyOf/allOf over inferred type resolution (@maruthang)
• #3820 fix(schema): support enumName with oneOf and anyOf combinators (@maruthang)

Enhancements

• #3854 fix(swagger-ui): replace hardcoded sentinel with per-call UUID in buildJSInitOptions (@kyuna0312)

Committers: 5

• Kamil Mysliwiec (@kamilmysliwiec)
• Maruthan G (@maruthang)
• Yukihiro Hasegawa (@y-hsgw)
• @kyungseopk1m
• kyuna0312 (@kyuna0312)

Release 11.3.0

11.3.0 (2026-04-15)

Bug fixes

• #3826 fix: support nullable field in @apiresponse decorator (@Nedunchezhiyan-M)
• #3784 fix(schema): include type field when nullable is used with allOf (@maruthang)
• #3774 fix enum issue (@SupunGeethanjana)
• #3798 fix(plugin): normalize workspace package import paths in metadata generator (@maruthang)
• #3821 fix(plugin): handle same-file type references in SWC readonly metadata generation (@maruthang)
• #3822 fix(type-helpers): eagerly apply plugin metadata properties in mapped type helpers (@maruthang)
• #3840 fix: use child class type when re-declaring an inherited @ApiProperty (@Nedunchezhiyan-M)

Enhancements

• #3449 feat(api-header): add example property to ApiHeader decorator (@leemhoon00)
• #3787 feat(decorators): support RegExp instances in @ApiProperty({ pattern }) (@temrjan)
• #3699 feat(api-body): add support for encoding in ApiBody decorator (@lamuertepeluda)
• #3824 feat: support async patchDocumentOnRequest hook (@Nedunchezhiyan-M)
• #3834 feat: expose generateSchema utility for programmatic schema access (@Nedunchezhiyan-M)
• #3836 feat(plugin): add autoFillEnumName option to suppress duplicate enum schemas (@Nedunchezhiyan-M)
• #3837 feat: merge descriptions when multiple decorators share the same HTTP status code (@Nedunchezhiyan-M)
• #3839 feat: add excludeDynamicDefaults option to strip runtime-evaluated schema defaults (@Nedunchezhiyan-M)
• #3841 feat: add DeepPartialType mapped-type helper for recursive optional properties (@Nedunchezhiyan-M)

Dependencies

• #3850 fix(deps): update dependency swagger-ui-dist to v5.32.4 (@renovate[bot])

Committers: 7

• JongHun Lim (@leemhoon00)
• Maruthan G (@maruthang)
• Rajasekar Janakiraman (@rajasekar33)
• Supun Geethanjana Jayasinghe (@SupunGeethanjana)
• Temrjan (@temrjan)
• Vito Macchia (@lamuertepeluda)
• @Nedunchezhiyan-M

11.2.7

What's Changed

• fix(deps): update dependency lodash to v4.18.1 [security] by @renovate[bot] in #3808
• fix(deps): update dependency @nestjs/mapped-types to v2.1.1 by @renovate[bot] in #3791
• fix(plugin): support TypeScript project references in ReadonlyVisitor by @maruthang in #3804
• fix(plugin): skip auto-generated response decorator when Api*Response already present by @maruthang in #3803
• fix(schema): handle const enum objects from SWC compiler metadata by @maruthang in #3802
• fix(deps): update dependency path-to-regexp to v8.4.2 by @renovate[bot] in #3815
• fix(swagger-explorer): prevent enum schema mutation across multiple document generations by @maruthang in #3799
• fix(decorators): do not crash on Controller getter by @robbtraister in #3788
• fix(plugin): handle non-ASCII characters in project paths by @maruthang in #3786
• fix(explorer): pass version to operationIdFactory for all versioning types by @maruthang in #3783
• chore(deps): update dependency class-validator to v0.15.1 by @renovate[bot] in #3753
• fix(deps): update dependency swagger-ui-dist to v5.32.2 by @renovate[bot] in #3738

New Contributors

• @maruthang made their first contribution in #3804
• @robbtraister made their first contribution in #3788

Full Changelog: 11.2.6...11.2.7

11.2.6

What's Changed

• feat: support adding custom fields on the servers[*] entry by @micalevisk in #3715
• fix(decorator) add string literal types to ApiQueryOptions for autoco… by @wanderer-s in #3707
• feat: add type definition for format option in @ApiProperty decorator by @ismaildasci in #3697
• fix(deps): update dependency lodash to v4.17.23 [security] by @renovate[bot] in #3705

New Contributors

• @wanderer-s made their first contribution in #3707
• @ismaildasci made their first contribution in #3697

Full Changelog: 11.2.5...11.2.6