Merge pull request #307 from appwrite/feat-node-response-models

feat(node): response models

Author: TorstenDittmann

templates/node/index.d.ts.twig

@@ -1,4 +1,85 @@
+{% macro sub_schema(property, definition, spec) %}
+{% spaceless %}
+    {% if property.sub_schema %}
+        {% if _self.get_generics_sub(definition, spec) %}
+            {{property.sub_schema | caseUcfirst}}<{{ _self.get_generics_sub(definition, spec) }}>{% if property.type == 'array' %}[]{% endif %}
+        {% else %}
+            {{property.sub_schema | caseUcfirst}}{% if property.type == 'array' %}[]{% endif %}
+        {% endif %}
+    {% else %}
+        {{property.type | typeName}}
+    {% endif %}
+{% endspaceless %}
+{% endmacro %}
+{% macro get_generics(definition, spec) %}
+{% spaceless %}
+    {% for property in definition.properties %}
+        {% if spec.definitions[property.sub_schema].additionalProperties %}
+            {{property.sub_schema | caseUcfirst}} extends Models.{{property.sub_schema | caseUcfirst}}
+        {% endif %}
+        {% if spec.definitions[property.sub_schema] %}
+            {{_self.get_generics(spec.definitions[property.sub_schema], spec)}}
+        {% endif %}
+    {% endfor %}
+{% endspaceless %}
+{% endmacro %}
+{% macro get_generics_sub(definition, spec, output = false) %}
+{% spaceless %}
+    {% for property in definition.properties %}
+        {% if spec.definitions[property.sub_schema].additionalProperties and output %}
+            {{property.sub_schema | caseUcfirst}}
+        {% endif %}
+        {% if spec.definitions[property.sub_schema] %}
+            {{_self.get_generics_sub(spec.definitions[property.sub_schema], spec, true)}}
+        {% endif %}
+    {% endfor %}
+{% endspaceless %}
+{% endmacro %}
+{% macro get_generics_method(definition, spec, output = false, first = false) %}
+{% spaceless %}
+    {% if first and definition.additionalProperties %}
+        {{definition.name | caseUcfirst}} extends Models.{{definition.name | caseUcfirst}}
+    {% endif %}
+    {% for property in definition.properties %}
+        {% if spec.definitions[property.sub_schema].additionalProperties and output %}
+            {{property.sub_schema | caseUcfirst}} extends Models.{{property.sub_schema | caseUcfirst}}
+        {% endif %}
+        {% if spec.definitions[property.sub_schema] %}
+            {{_self.get_generics_method(spec.definitions[property.sub_schema], spec, true)}}
+        {% endif %}
+    {% endfor %}
+{% endspaceless %}
+{% endmacro %}
+{% macro get_generics_method_return(definition, spec) %}
+{% spaceless %}
+    {% for property in definition.properties %}
+        {% if spec.definitions[property.sub_schema].additionalProperties %}
+            {{property.sub_schema | caseUcfirst}}
+        {% endif %}
+        {% if spec.definitions[property.sub_schema] %}
+            {{_self.get_generics_method_return(spec.definitions[property.sub_schema], spec)}}
+        {% endif %}
+    {% endfor %}
+{% endspaceless %}
+{% endmacro %}
 declare module "{{ language.params.npmPackage|caseDash }}" {
+  export namespace Models {
+{% for definition in spec.definitions %}
+{% set generics = _self.get_generics(definition, spec) %}
+      /**
+      * {{ definition.description }}
+      */
+      export type {{ definition.name | caseUcfirst }}{% if generics %}<{{generics}}>{% endif %} = {
+{% for property in definition.properties %}
+{% set sub_schema = _self.sub_schema(property, definition, spec)%}
+          /**
+          * {{ property.description }}
+          */
+          {{ property.name | escapeKeyword }}{% if not property.required %}?{% endif %}: {{sub_schema}};
+{% endfor %}
+      }
+{% endfor %}
+  }
   export class Client {
     /**
      * Set endpoint.
@@ -48,7 +129,8 @@ declare module "{{ language.params.npmPackage|caseDash }}" {
 {% for service in spec.services %}
   export class {{ service.name | caseUcfirst }} extends Service {
 {% for method in service.methods %}
-
+{% set generics = _self.get_generics_method(spec.definitions[method.responseModel], spec, true, true) %}
+{% set generics_return = _self.get_generics_method_return(spec.definitions[method.responseModel], spec) %}
     /**
      * {{ method.title }}
      *
@@ -62,7 +144,7 @@ declare module "{{ language.params.npmPackage|caseDash }}" {
      * @throws {{ '{' }}{{ spec.title | caseUcfirst}}Exception}
      * @returns {Promise}
      */
-    {{ method.name | caseCamel }}{% if method.type != 'location' %}<T extends unknown>{% endif %}({% for parameter in method.parameters.all %}{{ parameter.name | caseCamel }}{% if not parameter.required %}?{% endif %}: {% if parameter.type == 'array' %}{{attribute(parameter, 'array').type}}[]{% else %}{{ parameter.type | typeName }}{% endif %}{% if not loop.last %}, {% endif %}{% endfor %}): Promise<{% if method.type == 'location' %}Buffer{% else %}T{% endif %}>;
+    {{ method.name | caseCamel }}{% if generics %}<{{generics}}>{% endif %}({% for parameter in method.parameters.all %}{{ parameter.name | caseCamel | escapeKeyword }}{% if not parameter.required %}?{% endif %}: {{ parameter.type | typeName }}{% if not loop.last %}, {% endif %}{% endfor %}): Promise<{% if method.type == 'location' %}Buffer{% else %}{% if method.responseModel and method.responseModel != 'any' %}{% if not spec.definitions[method.responseModel].additionalProperties %}Models.{% endif %}{{method.responseModel | caseUcfirst}}{% if generics_return %}<{{generics_return}}>{% endif %}{% else %}Response{% endif %}{% endif %}>;
 {% endfor %}
   }
 {% endfor %}