@@ -46,7 +46,15 @@ export class {{ service.name | caseUcfirst }} {
46
46
{%~ if method .parameters .all | length > 0 %}
47
47
{{ 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 }};
48
48
/**
49
- * @deprecated This API has been deprecated.
49
+ * @deprecated Parameter-based methods will be removed in the next major 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 }};
50
58
*/
51
59
{{ 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 }};
52
60
{{ method .name | caseCamel }}{{ method .responseModel | getGenerics(spec ) | raw }}(
@@ -60,7 +68,7 @@ export class {{ service.name | caseUcfirst }} {
60
68
let onProgress: ((progress: UploadProgress) => {});
61
69
{%~ endif %}
62
70
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 %} ) {
64
72
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 %} };
65
73
{%~ if ' multipart/form-data' in method .consumes %}
66
74
onProgress = paramsOrFirst.onProgress as ((progress: UploadProgress) => {});
0 commit comments