feat(cpp-boost-beast): add OAS 3.1 schema validation

.circleci/config.yml

@@ -24,8 +24,26 @@ commands: # a reusable command with parameters
             libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 \
             libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates \
             fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget libgbm1
-      # The following `checkout` command checks out your code to your working directory. In 1.0 we did this implicitly. In 2.0 you can choose where in the course of a job your code should be checked out.
-      - checkout
+      # Avoid intermittent SSH checkout failures from CircleCI workers.
+      - run:
+          name: Checkout source over HTTPS with retry
+          command: |
+            if [ -n "${CIRCLE_PULL_REQUEST:-}" ]; then
+              ref="refs/pull/${CIRCLE_PULL_REQUEST##*/}/head"
+            elif [[ "${CIRCLE_BRANCH:-}" =~ ^pull/[0-9]+$ ]]; then
+              ref="refs/${CIRCLE_BRANCH}/head"
+            else
+              ref="$CIRCLE_SHA1"
+            fi
+            git init .
+            git remote add origin https://github.com/OpenAPITools/openapi-generator.git
+            for i in $(seq 1 5); do
+              if git fetch --depth=1 origin "$ref" && git checkout --detach FETCH_HEAD; then
+                exit 0
+              fi
+              sleep 5
+            done
+            exit 1
       # Prepare for artifact and test results  collection equivalent to how it was done on 1.0.
       # In many cases you can simplify this from what is generated here.
       # 'See docs on artifact collection here https://circleci.com/docs/2.0/artifacts/'
@@ -189,7 +207,6 @@ jobs:
       DOCKER_GENERATOR_IMAGE_NAME: openapitools/openapi-generator
       DOCKER_CODEGEN_CLI_IMAGE_NAME: openapitools/openapi-generator-cli
     steps:
-      - checkout
       - command_build_and_test:
           nodeNo: "3"
 workflows:

docs/generators/cpp-boost-beast-client.md

@@ -19,8 +19,17 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 | Option | Description | Values | Default |
 | ------ | ----------- | ------ | ------- |
 |apiPackage|C++ namespace for apis (convention: name.space.api).| |org.openapitools.client.api|
+|compileWithValidation|Emit schema-validation IR and kValidateOnDecode=true in generated ValidationTypes.h (default). Set to false to omit the IR for high-throughput clients. Representation diagnostics (non-finite destinations, integer range, required properties) remain active.| |true|
+|exportMacro|C++ export macro placed before public classes and functions. When non-empty, ApiExport.h is generated for Windows DLL export/import handling.| ||
+|formatAssertionPolicy|Format handling in composition branch matching. Only 'annotation' is supported: format metadata never affects match counts.|<dl><dt>**annotation**</dt><dd>Formats are annotations and do not affect validation</dd></dl>|annotation|
+|inferConditionalSseOperations|Infer conditional SSE for dual JSON/SSE operations only when the request selector and event model are unambiguous. Enabled by default.| |true|
 |modelPackage|C++ namespace for models (convention: name.space.model).| |org.openapitools.client.model|
 |packageName|C++ package and library name.| |CppBoostBeastOpenAPIClient|
+|sseEventTypeMappings|Comma-separated operationId=Model mappings for the JSON schema of each SSE event data payload.| |null|
+|sseOperationIds|Comma-separated operationIds whose JSON request body conditionally selects text/event-stream (default request property: stream).| |null|
+|sseRequestPropertyMappings|Comma-separated operationId=property mappings for the boolean request property that selects SSE.| |null|
+|sseSchemaMode|SSE schema interpretation mode for text/event-stream responses. 'representation' (default): the response schema describes the media representation; callbacks receive an owning SseEvent with raw data, event, id, and retry metadata. 'jsonEventData': decode each complete event data payload against the response schema and pass both the typed value and SseEvent metadata to the callback. Use x-sse-event-data-schema for per-operation typed decoding.|<dl><dt>**representation**</dt><dd>Schema describes the media representation; callback receives SseEvent</dd><dt>**jsonEventData**</dt><dd>Schema describes each JSON event data payload</dd></dl>|representation|
+|tolerateNonNullableNulls|Treat explicit JSON null values as absent for generated model properties whose schemas do not allow null. Enabled by default to tolerate non-conforming server responses while preserving required-key presence checks; set to false for strict schema decoding. Non-null values remain fully validated.| |true|
 
 ## IMPORT MAPPING
 
@@ -32,8 +41,12 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 |int32_t|#include &lt;cstdint&gt;|
 |int64_t|#include &lt;cstdint&gt;|
 |std::map|#include &lt;map&gt;|
+|std::monostate|#include &lt;variant&gt;|
 |std::nullptr_t|#include &lt;cstddef&gt;|
+|std::optional|#include &lt;optional&gt;|
+|std::shared_ptr|#include &lt;memory&gt;|
 |std::string|#include &lt;string&gt;|
+|std::variant|#include &lt;variant&gt;|
 |std::vector|#include &lt;vector&gt;|
 
 
@@ -51,9 +64,9 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 <li>double</li>
 <li>float</li>
 <li>int</li>
-<li>int32_t</li>
-<li>int64_t</li>
 <li>long</li>
+<li>std::int32_t</li>
+<li>std::int64_t</li>
 </ul>
 
 ## RESERVED WORDS
@@ -168,14 +181,14 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 |Int64|✓|OAS2,OAS3
 |Float|✓|OAS2,OAS3
 |Double|✓|OAS2,OAS3
-|Decimal|✓|ToolingExtension
+|Decimal|✗|ToolingExtension
 |String|✓|OAS2,OAS3
-|Byte|✓|OAS2,OAS3
-|Binary|✓|OAS2,OAS3
+|Byte|✗|OAS2,OAS3
+|Binary|✗|OAS2,OAS3
 |Boolean|✓|OAS2,OAS3
-|Date|✓|OAS2,OAS3
-|DateTime|✓|OAS2,OAS3
-|Password|✓|OAS2,OAS3
+|Date|✗|OAS2,OAS3
+|DateTime|✗|OAS2,OAS3
+|Password|✗|OAS2,OAS3
 |File|✓|OAS2
 |Uuid|✗|
 |Array|✓|OAS2,OAS3
@@ -217,11 +230,11 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 |ExternalDocumentation|✓|OAS2,OAS3
 |Examples|✓|OAS2,OAS3
 |XMLStructureDefinitions|✗|OAS2,OAS3
-|MultiServer|✗|OAS3
+|MultiServer|✓|OAS3
 |ParameterizedServer|✗|OAS3
-|ParameterStyling|✗|OAS3
-|Callbacks|✗|OAS3
-|LinkObjects|✗|OAS3
+|ParameterStyling|✓|OAS3
+|Callbacks|✓|OAS3
+|LinkObjects|✓|OAS3
 
 ### Parameter Feature
 | Name | Supported | Defined By |
@@ -232,19 +245,19 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 |Body|✓|OAS2
 |FormUnencoded|✓|OAS2
 |FormMultipart|✓|OAS2
-|Cookie|✗|OAS3
+|Cookie|✓|OAS3
 
 ### Schema Support Feature
 | Name | Supported | Defined By |
 | ---- | --------- | ---------- |
 |Simple|✓|OAS2,OAS3
 |Composite|✓|OAS2,OAS3
-|Polymorphism|✗|OAS2,OAS3
-|Union|✗|OAS3
-|allOf|✗|OAS2,OAS3
-|anyOf|✗|OAS3
-|oneOf|✗|OAS3
-|not|✗|OAS3
+|Polymorphism|✓|OAS2,OAS3
+|Union|✓|OAS3
+|allOf|✓|OAS2,OAS3
+|anyOf|✓|OAS3
+|oneOf|✓|OAS3
+|not|✓|OAS3
 
 ### Security Feature
 | Name | Supported | Defined By |

modules/openapi-generator/src/main/java/org/openapitools/codegen/InlineModelResolver.java

@@ -1173,6 +1173,13 @@ private String addSchemas(String name, Schema schema) {
             name = inlineSchemaNameMapping.get(name);
         }
 
+        // Recursive flattening can add a nested schema after its parent's name
+        // was chosen. Re-check here so the parent cannot overwrite that child.
+        if (openAPI.getComponents().getSchemas().containsKey(name)
+                || uniqueNames.contains(name)) {
+            name = uniqueName(name);
+        }
+
         addGenerated(name, schema);
         openAPI.getComponents().addSchemas(name, schema);
         if (!name.equals(schema.getTitle()) && !inlineSchemaNameMappingValues.contains(name)) {

modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/AbstractCppCodegen.java

@@ -365,7 +365,7 @@ public void preprocessOpenAPI(OpenAPI openAPI) {
         if (!scheme.isEmpty()) {
             this.additionalProperties.put("scheme", scheme);
         }
-        if (!serverList.isEmpty()) {
+        if (serverList != null && !serverList.isEmpty()) {
             for (Server server : serverList) {
                 CodegenServer s = new CodegenServer();
                 s.description = server.getDescription();