Add deprecation markers

Author: gcatanese

modules/openapi-generator/src/main/resources/typescript/api/api.mustache

@@ -32,14 +32,18 @@ export class {{classname}}RequestFactory extends BaseAPIRequestFactory {
 
     {{#operation}}
     /**
+    {{#isDeprecated}}
+     * @deprecated
+     *
+    {{/isDeprecated}}
      {{#notes}}
      * {{&notes}}
      {{/notes}}
      {{#summary}}
      * {{&summary}}
      {{/summary}}
      {{#allParams}}
-     * @param {{paramName}} {{description}}
+     * @param {{paramName}} {{description}}{{#isDeprecated}} (@deprecated){{/isDeprecated}}
      {{/allParams}}
      */
     public async {{nickname}}({{#allParams}}{{paramName}}{{^required}}?{{/required}}: {{{dataType}}}, {{/allParams}}_options?: Configuration): Promise<RequestContext> {

modules/openapi-generator/src/test/java/org/openapitools/codegen/typescript/TypeScriptClientCodegenTest.java

@@ -210,4 +210,31 @@ public void testForAllSanitizedEnum() throws Exception {
                 "}"
         );
     }
+
+    @Test
+    public void testOrderParameters() throws Exception {
+        final File output = Files.createTempDirectory("typescriptnodeclient_").toFile();
+        output.deleteOnExit();
+
+        final CodegenConfigurator configurator = new CodegenConfigurator()
+                .setGeneratorName("typescript")
+                .setInputSpec("src/test/resources/3_0/typescript/deprecated-operation.yaml")
+                .setOutputDir(output.getAbsolutePath().replace("\\", "/"));
+
+        final ClientOptInput clientOptInput = configurator.toClientOptInput();
+        final DefaultGenerator generator = new DefaultGenerator();
+        final List<File> files = generator.opts(clientOptInput).generate();
+        files.forEach(File::deleteOnExit);
+
+        // deprecated operation
+        TestUtils.assertFileContains(
+                Paths.get(output + "/apis/DefaultApi.ts"),
+                "* @deprecated"
+        );
+        // deprecated parameter
+        TestUtils.assertFileContains(
+                Paths.get(output + "/apis/DefaultApi.ts"),
+                "* @param name name of pet  (@deprecated)"
+        );
+    }
 }

modules/openapi-generator/src/test/resources/3_0/typescript/deprecated-operation.yaml

@@ -0,0 +1,44 @@
+openapi: 3.0.0
+info:
+  description: test order parameters
+  version: 1.0.0
+  title: Test order parameters
+  license:
+    name: Apache-2.0
+    url: 'https://www.apache.org/licenses/LICENSE-2.0.html'
+paths:
+  /pets:
+    get:
+      tags:
+        - default
+      summary: Finds Pets
+      deprecated: true
+      description: Find all pets
+      operationId: findPets
+      parameters:
+        - name: type
+          in: query
+          description: type of pet
+          style: form
+          explode: false
+          schema:
+            type: string
+            default: available
+        - name: name
+          in: query
+          deprecated: true
+          description: name of pet
+          required: true
+          schema:
+            type: string
+        - name: age
+          in: query
+          description: age of pet
+          schema:
+            type: number
+            format: int32
+      responses:
+        '200':
+          description: successful operation
+        '400':
+          description: Invalid status value