[typescript-fetch] Add option to generate validation attributes of model properties (#19448)

Author: matthiasschwarz

bin/configs/typescript-fetch-validation-attributes.yaml

@@ -0,0 +1,6 @@
+generatorName: typescript-fetch
+outputDir: samples/client/petstore/typescript-fetch/builds/validation-attributes
+inputSpec: modules/openapi-generator/src/test/resources/3_0/typescript-fetch/validation-attributes.yaml
+templateDir: modules/openapi-generator/src/main/resources/typescript-fetch
+additionalProperties:
+  validationAttributes: true

docs/generators/typescript-fetch.md

@@ -44,6 +44,7 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 |supportsES6|Generate code that conforms to ES6.| |false|
 |useSingleRequestParameter|Setting this property to true will generate functions with a single argument containing all API endpoint parameters instead of one argument per parameter.| |true|
 |useSquareBracketsInArrayNames|Setting this property to true will add brackets to array attribute names, e.g. my_values[].| |false|
+|validationAttributes|Setting this property to true will generate the validation attributes of model properties.| |false|
 |withInterfaces|Setting this property to true will generate interfaces next to the default class implementations.| |false|
 |withoutRuntimeChecks|Setting this property to true will remove any runtime checks on the request and response payloads. Payloads will be casted to their expected types.| |false|
 

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

@@ -60,6 +60,7 @@ public class TypeScriptFetchClientCodegen extends AbstractTypeScriptClientCodege
     public static final String CAMEL_CASE = "camelCase";
     public static final String PASCAL_CASE = "PascalCase";
     public static final String USE_SQUARE_BRACKETS_IN_ARRAY_NAMES = "useSquareBracketsInArrayNames";
+    public static final String VALIDATION_ATTRIBUTES = "validationAttributes";
 
     @Getter @Setter
     protected String npmRepository = null;
@@ -92,7 +93,8 @@ public class TypeScriptFetchClientCodegen extends AbstractTypeScriptClientCodege
     @Getter @Setter
     protected String inferEntityFromUniqueIdWithName = null;
     @Setter protected boolean packageAsSourceOnlyLibrary = false;
-
+    @Getter @Setter
+    protected Boolean generateValidationAttributes = false;
 
     public TypeScriptFetchClientCodegen() {
         super();
@@ -123,6 +125,7 @@ public TypeScriptFetchClientCodegen() {
         this.cliOptions.add(new CliOption(IMPORT_FILE_EXTENSION_SWITCH, IMPORT_FILE_EXTENSION_SWITCH_DESC).defaultValue(""));
         this.cliOptions.add(new CliOption(FILE_NAMING, "Naming convention for the output files: 'PascalCase', 'camelCase', 'kebab-case'.").defaultValue(this.fileNaming));
         this.cliOptions.add(new CliOption(USE_SQUARE_BRACKETS_IN_ARRAY_NAMES, "Setting this property to true will add brackets to array attribute names, e.g. my_values[].", SchemaTypeUtil.BOOLEAN_TYPE).defaultValue(Boolean.FALSE.toString()));
+        this.cliOptions.add(new CliOption(VALIDATION_ATTRIBUTES, "Setting this property to true will generate the validation attributes of model properties.", SchemaTypeUtil.BOOLEAN_TYPE).defaultValue(Boolean.FALSE.toString()));
     }
 
     @Override
@@ -308,6 +311,8 @@ public void processOpts() {
                 }
             }
         }
+
+        setGenerateValidationAttributes(convertPropertyToBooleanAndWriteBack(VALIDATION_ATTRIBUTES));
     }
 
     @Override

modules/openapi-generator/src/main/resources/typescript-fetch/modelGeneric.mustache

@@ -158,3 +158,68 @@ export function {{classname}}ToJSON(value?: {{#hasReadOnly}}Omit<{{classname}},
     return value;
     {{/hasVars}}
 }
+{{#validationAttributes}}
+
+export const {{classname}}PropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+{{#vars}}
+{{#hasValidation}}
+    {{name}}: {
+        {{#maxLength}}
+        maxLength: {{maxLength}},
+        {{/maxLength}}
+        {{#minLength}}
+        minLength: {{minLength}},
+        {{/minLength}}
+        {{#pattern}}
+        pattern: '{{pattern}}',
+        {{/pattern}}
+        {{#maximum}}
+        maximum: {{maximum}},
+        exclusiveMaximum: {{exclusiveMaximum}},
+        {{/maximum}}
+        {{#minimum}}
+        minimum: {{minimum}},
+        exclusiveMinimum: {{exclusiveMinimum}},
+        {{/minimum}}
+        {{#multipleOf}}
+        multipleOf: {{multipleOf}},
+        {{/multipleOf}}
+        {{#maxItems}}
+        maxItems: {{maxItems}},
+        {{/maxItems}}
+        {{#minItems}}
+        minItems: {{minItems}},
+        {{/minItems}}
+        {{#isArray}}
+        uniqueItems: {{uniqueItems}},
+        {{/isArray}}
+    },
+{{/hasValidation}}
+{{/vars}}
+}
+{{#isAdditionalPropertiesTrue}}
+
+export const {{classname}}AdditionalPropertiesValidationAttributes: { maxProperties?: number, minProperties?: number } = {
+    {{#maxProperties}}
+    maxProperties: {{maxProperties}},
+    {{/maxProperties}}
+    {{#minProperties}}
+    minProperties: {{minProperties}},
+    {{/minProperties}}
+}
+{{/isAdditionalPropertiesTrue}}
+{{/validationAttributes}}

modules/openapi-generator/src/test/java/org/openapitools/codegen/options/TypeScriptFetchClientOptionsProvider.java

@@ -86,6 +86,7 @@ public Map<String, String> createOptions() {
                 .put(CodegenConstants.ENUM_UNKNOWN_DEFAULT_CASE, ENUM_UNKNOWN_DEFAULT_CASE_VALUE)
                 .put(TypeScriptFetchClientCodegen.STRING_ENUMS, STRING_ENUMS)
                 .put(TypeScriptFetchClientCodegen.USE_SQUARE_BRACKETS_IN_ARRAY_NAMES, Boolean.FALSE.toString())
+                .put(TypeScriptFetchClientCodegen.VALIDATION_ATTRIBUTES, Boolean.FALSE.toString())
                 .build();
     }