feat: object params in js/ts sdks

Author: ChiragAgg5k

example.php

@@ -38,8 +38,8 @@ function getSSLPage($url) {
     }
 
     // Leave the platform you want uncommented
-    // $platform = 'client';
-    $platform = 'console';
+    $platform = 'client';
+    // $platform = 'console';
     // $platform = 'server';
 
     $version = '1.7.x';

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

@@ -44,7 +44,52 @@ export class {{ service.name | caseUcfirst }} {
     {%~ endif %}
     {%~ endif %}
      */
+    {%~ if method.parameters.all|length > 0 %}
+    {{ method.name | caseCamel }}{{ method.responseModel | getGenerics(spec) | raw }}(params: { {% 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 }};
+    {{ 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 }};
+    {{ method.name | caseCamel }}{{ method.responseModel | getGenerics(spec) | raw }}(
+        {% if method.parameters.all|length > 0 %}paramsOrFirst{% if not method.parameters.all[0].required or method.parameters.all[0].nullable %}?{% endif %}: { {% 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.parameters.all[0] | getPropertyType(method) | raw }}{% if method.parameters.all|length > 1 %},
+        ...rest: [{% for parameter in method.parameters.all[1:] %}({{ parameter | getPropertyType(method) | raw }})?{% if not loop.last %}, {% endif %}{% endfor %}{% if 'multipart/form-data' in method.consumes %},((progress: UploadProgress) => {})?{% endif %}]{% endif %}{% endif %}
+    
+    ): {{ method | getReturn(spec) | raw }} {
+        {%~ if method.parameters.all|length > 0 %}
+        let params: { {% 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 %}
+        let onProgress: ((progress: UploadProgress) => {});
+        {%~ endif %}
+        
+        if (typeof paramsOrFirst === 'object' && paramsOrFirst !== null && !Array.isArray(paramsOrFirst)
+            {% if method.parameters.all|length > 0 %}&& ({% for parameter in method.parameters.all %}'{{ parameter.name | caseCamel | escapeKeyword }}' in paramsOrFirst{% if not loop.last %} || {% endif %}{% endfor %} || Object.keys(paramsOrFirst).length === 0){% endif %}) {
+            params = paramsOrFirst as { {% 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 = paramsOrFirst.onProgress as ((progress: UploadProgress) => {});
+            {%~ endif %}
+        } else {
+            params = {
+                {%~ for parameter in method.parameters.all %}
+                {{ parameter.name | caseCamel | escapeKeyword }}: {% if loop.index0 == 0 %}paramsOrFirst{% else %}rest[{{ loop.index0 - 1 }}]{% endif %} as {{ parameter | getPropertyType(method) | raw }}{% if not loop.last %},
+{% endif %}
+                {%~ endfor %}
+            
+            };
+            {%~ if 'multipart/form-data' in method.consumes %}
+            onProgress = rest[{{ method.parameters.all|length - 1 }}] as ((progress: UploadProgress) => {});
+            {%~ endif %}
+        }
+        
+        {%~ for parameter in method.parameters.all %}
+        const {{ parameter.name | caseCamel | escapeKeyword }} = params.{{ parameter.name | caseCamel | escapeKeyword }};
+        {%~ endfor %}
+        {%~ else %}
+        {%~ if 'multipart/form-data' in method.consumes %}
+        if (typeof paramsOrFirst === 'function') {
+            onProgress = paramsOrFirst;
+        }
+        {%~ endif %}
+        {%~ endif %}
+    {%~ else %}
     {{ 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 }} {
+    {%~ endif %}
         {%~ for parameter in method.parameters.all %}
         {%~ if parameter.required %}
         if (typeof {{ parameter.name | caseCamel | escapeKeyword }} === 'undefined') {
@@ -119,4 +164,4 @@ export class {{ service.name | caseUcfirst }} {
 
 {%~ endif %}
     {%~ endfor %}
-}
+}