Corrections to v14.7.0

v14.7.1 updates to NJsonSchema v11.6.1, which corrects the handling of the C# required keyword and [JsonRequired]:

• These are now treated as presence markers (the property must be present in the JSON) rather than value constraints.
• Nullability from the declared type (string?, T?) is preserved.
• No spurious MinLength=1 on non-nullable strings.
• DataAnnotations [Required] semantics remain unchanged (still suppresses nullability and adds MinLength=1 to strings by default, matching its runtime behavior).

Observable client changes vs v14.7.0

For public required string[]? OptionList { get; init; } (#5359):

For full details and truth tables across all required / [Required] / [JsonRequired] / [JsonProperty(Required=*)] combinations, see the NJsonSchema v11.6.1 release notes and NJsonSchema #1919.

What's Changed

• Upgrade to NJsonSchema v11.6.1 (NSwag v14.7.1) by @RicoSuter in #5367 (fixes #5359)

Full Changelog: v14.7.0...v14.7.1

What's Changed

• Upgrade to NUKE 10 by @lahma in #5310
• Upgrade to NUKE 10.1.0 by @lahma in #5314
• Fix specifying runtime for NSwag.Npm resulting in a NConsole.UnusedArgumentException by @ptasev in #5320
• fix: nullpointer by @MeikelLP in #5337
• fix axios template: [object Object] is not valid JSON. by @adnanalbeda in #5283
• Fix legacy document transformation by @copyleftproducts in #5315
• Fix compile error in generated C# client when media type contains quotes by @bkoelman in #5345
• Fix duplicate client/operation names when operation IDs contain multiple underscores by @Copilot in #5348
• Update to NJsonSchema v11.6.0 and Namotion.Reflection v3.5.0 (v14.7.0) by @RicoSuter in #5357

NJsonSchema v11.6.0 (potentially breaking changes)

This release updates to NJsonSchema v11.6.0 and Namotion.Reflection v3.5.0, which include the following changes that may affect generated code:

• C# 11 required keyword now correctly recognized: Properties using the C# 11 required keyword (via RequiredMemberAttribute / JsonRequiredAttribute) are now properly treated as required in the schema and generated code. Previously these were incorrectly treated as optional.
• Removed extra blank line before class declarations in generated C# controller code (cosmetic).
• New WriteAccessor setting to control property setter syntax (set vs init).
• New JsonLibraryVersion setting for controlling enum attribute generation with System.Text.Json.
• Fixed MinLength validation no longer incorrectly applied to DateTime properties.
• Fixed nullable enum array detection for string enum converters.
• Support for public fields with System.Text.Json when IncludeFields is enabled.

For the full list of changes, see the NJsonSchema v11.6.0 release notes.

New Contributors

• @ptasev made their first contribution in #5320
• @MeikelLP made their first contribution in #5337
• @adnanalbeda made their first contribution in #5283
• @copyleftproducts made their first contribution in #5315
• @Copilot made their first contribution in #5348

Full Changelog: v14.6.3...v14.7.0

What's Changed

• Using final .NET 10 libraries/SDK and minor .NET 10 fixes (v14.6.3) by @RicoSuter in #5307
• Updated packages for CVE-2025-55315 by @erjdev in #5299
• fix: nswag.js try detect the runtime version from config file by @dylanvdmerwe in #5302

New Contributors

• @erjdev made their first contribution in #5299
• @dylanvdmerwe made their first contribution in #5302

Full Changelog: v14.6.2...v14.6.3

Fixes EnumValue regression in v14.6.1 by introducing a new JsonLibraryVersion configuration (default 8.0)

What's Changed

• v14.6.2: Update NJS and update commands/UI & update .NET 10 SDK (RC2) by @RicoSuter in #5298
• Update NJsonSchema to v11.5.2 (with revert to previous EnumValue behavior and new config)
  • https://github.com/RicoSuter/NJsonSchema/releases/tag/v11.5.2

Full Changelog: v14.6.1...v14.6.2

What's Changed

• Fix binary operation result type generation for AspNetCore CSharp by @xamele0n in #5255
• Update NJsonSchema to v11.5.1 by @RicoSuter in #5279
  • https://github.com/RicoSuter/NJsonSchema/releases/tag/v11.5.1
• fix: Support web host (legacy) in ServiceProviderResolver by @RicoSuter in #5278

New Contributors

• @xamele0n made their first contribution in #5255

Full Changelog: v14.6.0...v14.6.1

What's Changed

• Update NJS v11.5.0, breaking: minimum TypeScript output version is now 4.3 by @RicoSuter in #5268
• Add .NET 10 support by @RicoSuter in #5271
• Fix generating typescript fetch client interfaces when useAbortSignal is false by @htuomola in #5243
• Add test coverage for some APIs by @lahma in #5244
• Issue-5239 - Adding K6 template to TypeScript Code Generator by @jsclifford in #5240
• Fix NPM CLI argument handling by @lahma in #5245
• #5250 - K6 template for Typescript has errors when void is return type by @jsclifford in #5251
• Add option to generate code only for selected operation IDs by @amayouf in #5248
• Add credentials and mode attributes to fetch template generation by @etriebe in #5235
• Fix for Reusable request bodies are not handled correctly #2747 by @Doomic in #5196
• Refactor: Inline NConsole with fixes by @RicoSuter in #5272

New Contributors

• @htuomola made their first contribution in #5243
• @jsclifford made their first contribution in #5240
• @amayouf made their first contribution in #5248
• @etriebe made their first contribution in #5235

Full Changelog: v14.5.0...v14.6.0

What's Changed

• Better support for reading yaml from a stream by @simonthum in #5170
• #4821 Cleanup packages to use those provided by framework by @thompson-tomo in #4831
• Set GH actions target .NET SDK to 9.0.204 by @lahma in #5172
• Better support for reading yaml from a stream (part two) by @simonthum in #5171
• Avoid multiple enumeration of array typed path parameters by @Khyalis in #5149
• Restores all disabled compiler warnings. 649 and 8765 were missing. by @carlbjorknas in #4962
• Fix to explode array parameters implicitly when SchemaType is OpenAPI 3.0 by @Phoosha in #5176
• Adding cancellationToken to all calls to ReadAsStringAsync() and ReadAsStreamAsync() by @arshrp in #5187
• Remove requirement for specific NET SDK in GH Actions by @lahma in #5188
• Adjusted cancellationToken to work for all NSwag supported frameworks by @arshrp in #5190
• Allow setting of the client interface access modifier based on the model access modifier by @pbolduc in #4820
• Prioritize wildcard over json over first entry for accept content-type by @mdi1984 in #5198
• Reduce interface dispatch to improve performance by @lahma in #5199
• Surface ExtensionData in CSharpControllerTemplateModel by @hirudan in #5204
• Expose the UseRequiredKeyword on CSharpClientGeneratorSettings for CSharp client generator by @r-englund in #5205
• Fix to expose an optional param for AbortSignal (for axios) / CancelToken (for fetch) when GenerateClientInterfaces = true by @tomvdk in #5202
• Sort client operation responses by status code by @lahma in #5206
• TSC UpdateUseDtoClassAndDataConversionCodeProperties cleanup by @lahma in #5212
• Update Microsoft.AspNetCore.* references to target 2.3.0 by @lahma in #5214
• Convert to using Central Package Management by @lahma in #5217
• Convert NSwagStudio setup to use WiX 6 by @lahma in #5218
• Add support for TypeScript compilation testing by @lahma in #5219
• Replace TypeScript string contain asserts with Verify tests by @lahma in #5220
• Replace C# string contain asserts with Verify tests by @lahma in #5221
• Remove deprecated tslint suppression by @CaringDev in #5020
• Fix empty enumerable parameter handling in C# client by @lahma in #5222
• Fix: C# Code Generation generates method with return default(void) by @nzeemin in #4826
• Optimize DefaultParameterNameGenerator and add some more char cleanup by @lahma in #5223
• Convert more tests to use verify by @lahma in #5224
• Convert to xUnit v3 by @lahma in #5225
• Ensure operation names start with alphanumeric character by @lahma in #5227
• Change GenerateSampleSpecificationTests to auto verify mode by @lahma in #5228
• Show DisplayName for conflicting actions by @Saibamen in #5057
• Fix: When generated TS class name is "Error", it is conflicting with TS Error class by @doruk-info in #5032
• Update NJsonSchema to 11.4.0, update testsuite to reflect a change in class name generation by @WolfgangHG in #5177
• Improve nswag.js parameter handling by @KaterSchnurz in #5232
• Use TypeScript 4.3 as default testing version by @lahma in #5234
• v14.5.0 by @RicoSuter in #5236

New Contributors

• @simonthum made their first contribution in #5170
• @thompson-tomo made their first contribution in #4831
• @Khyalis made their first contribution in #5149
• @carlbjorknas made their first contribution in #4962
• @Phoosha made their first contribution in #5176
• @arshrp made their first contribution in #5187
• @pbolduc made their first contribution in #4820
• @mdi1984 made their first contribution in #5198
• @hirudan made their first contribution in #5204
• @r-englund made their first contribution in #5205
• @CaringDev made their first contribution in #5020
• @nzeemin made their first contribution in #4826
• @doruk-info made their first contribution in #5032
• @WolfgangHG made their first contribution in #5177
• @KaterSchnurz made their first contribution in #5232

Full Changelog: v14.4.0...v14.5.0

What's Changed

• Fix optional parameter ordering in generated TS/CS clients by @lahma in #5135
• Add MSBuildProjectDirectory fallback to ProjectDir resolution by @lahma in #5146
• Tolerate missing schema in OperationModelBase.GetActualParameters by @lahma in #5147
• Improve OpenApiOperation ActualResponses and Responses performance by @lahma in #5148
• Optimize OpenApiDocument.GenerateOperationIds by @lahma in #5150
• Optimize MultipleClientsFromOperationIdOperationNameGenerator duplicate checks by @lahma in #5151
• Fix some string API usage by @lahma in #5152
• Add NET 8 targets to core libraries by @lahma in #5153
• Optimize ObservableDictionary.CollectionChanged by @lahma in #5154
• Fix array parameter explosion check by @lahma in #5158
• Include each client type in JIRA OpenAPI Verify testing by @lahma in #5160
• Update to NJsonSchema v11.3.2 & Namotion.Reflection v3.4.2 by @RicoSuter in #5161
• Upgraded Microsoft.Extensions.ApiDescription.* to 8.0.14 by @ntyrrell in #5121
• Add support for STJ-native C# code gen by @mac-michael in #5155
• Update to Swagger UI v5.21.0 by @RicoSuter in #5162

New Contributors

• @ntyrrell made their first contribution in #5121
• @mac-michael made their first contribution in #5155

Full Changelog: v14.3.0...v14.4.0

Updated to NJsonSchema v11.2.0, see https://github.com/RicoSuter/NJsonSchema/releases/tag/v11.2.0

What's Changed

• Fix EnableTryItOut UI option by @Saibamen in #5031
• Add analysis rules and relaxations by @lahma in #5036
• Seal private/internal types and make methods static when applicable by @lahma in #5037
• Add GitHub issues templates by @lahma in #5038
• Use Count instead of using Any() by @lahma in #5039
• Enable implicit usings and remove unused by @lahma in #5040
• Fix some code style issues by @lahma in #5041
• Use TryGetValue() and Any() when possible by @lahma in #5042
• Simplify using statements by @lahma in #5043
• Simplify collection initialization by @lahma in #5044
• Use pattern matching by @lahma in #5045
• Use compound assignment by @lahma in #5046
• Simplify collection initialization and use pattern matching by @lahma in #5047
• Remove unnecessary member initialized to its default value by @lahma in #5048
• Add braces to if statements and ensure correct use of variables by @lahma in #5049
• Fix string usage problems reported by analyzers by @lahma in #5050
• Remove unused usings by @lahma in #5051
• Use expression bodies for properties and accessors by @lahma in #5053
• Fix some code formatting issues by @lahma in #5054
• Only run publish when in main repository by @lahma in #5055
• Update Microsoft.NET.Tests.Sdk and Verify.XUnit by @Saibamen in #5059
• Upgrade to NUKE 9 by @lahma in #5052
• Remove NET 6.0 from GitHub Actions by @lahma in #5083
• jsonschema2csclient GenerateNativeRecords argument by @jokarls in #5082
• Fix analyzer issues and remove obsolete NoWarn items by @lahma in #5119
• Remove Microsoft.Extensions.PlatformAbstractions by @lahma in #5058
• Upgrade to NUKE 9.0.4 by @lahma in #5120
• Import dayjs with the default named import by @Seveilith in #4813
• Inheritdoc for ApiDescription by @Saibamen in #5064
• Allow SwaggerUiIndexMiddleware to work with ReDocSettings by @miloszkukla in #5122
• Upgrade NJsonSchema to 11.3.0 & Namotion.Reflection by @RicoSuter in #5128
• Fix for unwanted parameter explosion in C# client by @simonnieder in #5016
• Fix for #3414 - C# generated client using FormUrlEncodedContent instead of StringContent by @ErikApption in #5029
• fix media type on empty request body by @jamesmanningrapidscale in #5068
• Suppress compiler warnings for possible nulls in generated code by @velvolue in #5099
• Update to Swagger UI v5.20.2 by @RicoSuter in #5129

New Contributors

• @Saibamen made their first contribution in #5031
• @jokarls made their first contribution in #5082
• @Seveilith made their first contribution in #4813
• @miloszkukla made their first contribution in #5122
• @simonnieder made their first contribution in #5016
• @ErikApption made their first contribution in #5029
• @jamesmanningrapidscale made their first contribution in #5068
• @velvolue made their first contribution in #5099

Full Changelog: v14.2.0...v14.3.0

What's Changed

• Support $ref in requestBody by @eatdrinksleepcode in #4917
• Upgrade to NUKE 8.1 by @lahma in #4980
• Ensure GitHubActionsTestLogger is in use by @lahma in #4951
• feat: update NJsonSchema and Namotion.Reflection by @RicoSuter in #5028
• Add NET 9 support, drop NET 6 support by @lahma in #5026

New Contributors

• @eatdrinksleepcode made their first contribution in #4917

Full Changelog: v14.1.0...v14.2.0