@@ -46,7 +46,15 @@ export class {{ service.name | caseUcfirst }} {
4646 {%~ if method .parameters .all | length > 0 %}
4747 {{ 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 }};
4848 /**
49- * @deprecated This API has been deprecated.
49+ * @deprecated Parameter-based methods will be removed in the upcoming version.
50+ * Please use the object based method instead for better developer experience.
51+ *
52+ * @example
53+ * // Old (deprecated)
54+ * {{ 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 }};
55+ *
56+ * // New (object based)
57+ * {{ 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 }};
5058 */
5159 {{ 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 }};
5260 {{ method .name | caseCamel }}{{ method .responseModel | getGenerics(spec ) | raw }}(
@@ -60,7 +68,7 @@ export class {{ service.name | caseUcfirst }} {
6068 let onProgress: ((progress: UploadProgress) => {});
6169 {%~ endif %}
6270
63- if (paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst)) {
71+ if (paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst){% set firstParamType = method . parameters . all [ 0 ] | getPropertyType( method ) | raw %}{% if not ( firstParamType starts with ' string ' or firstParamType starts with ' number ' or firstParamType starts with ' boolean ' ) %} && '{{ method . parameters . all [ 0 ].name | caseCamel | escapeKeyword }}' in paramsOrFirst{% endif %} ) {
6472 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 %} };
6573 {%~ if ' multipart/form-data' in method .consumes %}
6674 onProgress = paramsOrFirst.onProgress as ((progress: UploadProgress) => {});
0 commit comments