chore: add deprecated to ts

Author: ChiragAgg5k

templates/node/src/services/template.ts.twig

@@ -27,14 +27,17 @@ export class {{ service.name | caseUcfirst }} {
     {%~ for method in service.methods %}
     /**
     {%~ if method.description %}
-     * {{ method.description }}
+     * {{ method.description | replace({'\n': '\n     * '}) }}
     {%~ endif %}
      *
     {%~ for parameter in method.parameters.all %}
      * @param {{ '{' }}{{ parameter | getPropertyType(method) | raw }}{{ '}' }} {{ parameter.name | caseCamel | escapeKeyword }}
     {%~ endfor %}
      * @throws {{ '{' }}{{ spec.title | caseUcfirst}}Exception}
      * @returns {{ '{' }}{{ method | getReturn(spec) | raw }}{{ '}' }}
+    {%~ if method.deprecated %}
+     * @deprecated This API is deprecated and uses outdated terminologies.{% if method.replaceWith %} Please use `{{ method.replaceWith | capitalizeFirst }}` instead.{% endif %} 
+    {%~ endif %}
      */
     {{ method.name | caseCamel }}{{ method.responseModel | getGenerics(spec) | raw }}({% for parameter in method.parameters.all %}{{ parameter.name | caseCamel | escapeKeyword }}{% if not parameter.required or parameter.nullable %}?{% endif %}: {{ parameter | getPropertyType(method) | raw }}{% if not loop.last %}, {% endif %}{% endfor %}{% if 'multipart/form-data' in method.consumes %}, onProgress = (progress: UploadProgress) => {}{% endif %}): {{ method | getReturn(spec) | raw }} {
         {%~ for parameter in method.parameters.all %}
@@ -94,5 +97,8 @@ export class {{ service.name | caseUcfirst }} {
         );
         {%~ endif %}
     }
+{% if not loop.last %}
+
+{% endif %}
     {%~ endfor %}
 }

templates/react-native/src/services/template.ts.twig

@@ -41,7 +41,10 @@ export class {{ service.name | caseUcfirst }} extends Service {
      * @throws {{ '{' }}{{ spec.title | caseUcfirst}}Exception}
      * @returns {% if method.type == 'webAuth' %}{void|string}{% elseif method.type == 'location' %}{ArrayBuffer}{% else %}{Promise}{% endif %}
 
-    */
+    {%~ if method.deprecated %}
+     * @deprecated This API is deprecated and uses outdated terminologies.{% if method.replaceWith %} Please use `{{ method.replaceWith | capitalizeFirst }}` instead.{% endif %} 
+    {%~ endif %}
+     */
     {% if method.type == 'upload'%}async {% endif %}{{ method.name | caseCamel }}{{ method.responseModel | getGenerics(spec) | raw }}({% for parameter in method.parameters.all %}{{ parameter.name | caseCamel | escapeKeyword }}{% if not parameter.required or parameter.nullable %}?{% endif %}: {{ parameter | getPropertyType(method) | raw }}{% if not loop.last %}, {% endif %}{% endfor %}{% if 'multipart/form-data' in method.consumes %}, onProgress = (progress: UploadProgress) => {}{% endif %}): {{ method | getReturn(spec) | raw }} {
 {% for parameter in method.parameters.all %}
 {% if parameter.required %}
@@ -187,6 +190,9 @@ export class {{ service.name | caseUcfirst }} extends Service {
 {% endfor %}
      * @throws {{ '{' }}{{ spec.title | caseUcfirst}}Exception}
      * @returns {{ '{' }}URL{{ '}' }}
+    {%~ if method.deprecated %}
+     * @deprecated This API is deprecated and uses outdated terminologies.{% if method.replaceWith %} Please use `{{ method.replaceWith | capitalizeFirst }}` instead.{% endif %} 
+    {%~ endif %}
     */
     {{ method.name | caseCamel }}URL({% for parameter in method.parameters.all %}{{ parameter.name | caseCamel | escapeKeyword }}{% if not parameter.required or parameter.nullable %}?{% endif %}: {{ parameter | getPropertyType(method) | raw }}{% if not loop.last %}, {% endif %}{% endfor %}{% if 'multipart/form-data' in method.consumes %}, onProgress = (progress: UploadProgress) => {}{% endif %}): URL {
         const apiPath = '{{ method.path }}'{% for parameter in method.parameters.path %}.replace('{{ '{' }}{{ parameter.name | caseCamel | escapeKeyword }}{{ '}' }}', {{ parameter.name | caseCamel | escapeKeyword }}){% endfor %};

templates/web/src/services/template.ts.twig

@@ -28,14 +28,17 @@ export class {{ service.name | caseUcfirst }} {
     {%~ for method in service.methods %}
     /**
     {%~ if method.description %}
-     * {{ method.description }}
+     * {{ method.description | replace({'\n': '\n     * '}) }}
     {%~ endif %}
      *
     {%~ for parameter in method.parameters.all %}
      * @param {{ '{' }}{{ parameter | getPropertyType(method) | raw }}{{ '}' }} {{ parameter.name | caseCamel | escapeKeyword }}
     {%~ endfor %}
      * @throws {{ '{' }}{{ spec.title | caseUcfirst}}Exception}
      * @returns {{ '{' }}{{ method | getReturn(spec) | raw }}{{ '}' }}
+    {%~ if method.deprecated %}
+     * @deprecated This API is deprecated and uses outdated terminologies.{% if method.replaceWith %} Please use `{{ method.replaceWith | capitalizeFirst }}` instead.{% endif %} 
+    {%~ endif %}
      */
     {{ method.name | caseCamel }}{{ method.responseModel | getGenerics(spec) | raw }}({% for parameter in method.parameters.all %}{{ parameter.name | caseCamel | escapeKeyword }}{% if not parameter.required or parameter.nullable %}?{% endif %}: {{ parameter | getPropertyType(method) | raw }}{% if not loop.last %}, {% endif %}{% endfor %}{% if 'multipart/form-data' in method.consumes %}, onProgress = (progress: UploadProgress) => {}{% endif %}): {{ method | getReturn(spec) | raw }} {
         {%~ for parameter in method.parameters.all %}
@@ -108,5 +111,8 @@ export class {{ service.name | caseUcfirst }} {
         );
         {%~ endif %}
     }
+{% if not loop.last %}
+
+{% endif %}
     {%~ endfor %}
 }