chore: use deprecatedVersion in kotlin

Author: ChiragAgg5k

src/Spec/Swagger2.php

@@ -177,6 +177,8 @@ protected function parseMethod(string $methodName, string $pathName, array $meth
             'cookies' => $method['x-appwrite']['cookies'] ?? false,
             'type' => $method['x-appwrite']['type'] ?? false,
             'deprecated' => $method['x-appwrite']['deprecated'] ?? false,
+            'deprecatedMessage' => $method['x-appwrite']['deprecatedMessage'] ?? '',
+            'deprecatedVersion' => $method['x-appwrite']['deprecatedVersion'] ?? '',
             'replaceWith' => $method['x-appwrite']['replaceWith'] ?? '',
             'headers' => [],
             'parameters' => [

templates/android/library/src/main/java/io/package/services/Service.kt.twig

@@ -39,12 +39,13 @@ class {{ service.name | caseUcfirst }}(client: Client) : Service(client) {
     {%~ endif %}
      */
     {%~ if method.deprecated %}
-{% set deprecated_message = "This API is deprecated and uses outdated terminologies." %}
+{% set deprecated_message = "This API is deprecated since " ~ method.deprecatedVersion ~ " and uses outdated terminologies." %}
 {% if method.replaceWith %}
-{% set deprecated_message = deprecated_message ~ ' Please use ' ~ (method.replaceWith | capitalizeFirst) ~ ' instead.' %}
+{% set deprecated_message = deprecated_message ~ ' Please use `' ~ (method.replaceWith | capitalizeFirst) ~ '` instead.' %}
     @Deprecated(
-        "{{ deprecated_message }}",
-        ReplaceWith("{{ sdk.namespace | caseDot }}.services.{{ method.replaceWith | capitalizeFirst }}")
+        message = "{{ deprecated_message }}",
+        replaceWith = ReplaceWith("{{ sdk.namespace | caseDot }}.services.{{ method.replaceWith | capitalizeFirst }}"),
+        since = "{{ method.deprecatedVersion }}"
     )
 {% else %}
     @Deprecated("{{ deprecated_message }}")
@@ -205,12 +206,13 @@ class {{ service.name | caseUcfirst }}(client: Client) : Service(client) {
     {%~ endif %}
      */
     {%~ if method.deprecated %}
-{% set deprecated_message = "This API is deprecated and uses outdated terminologies." %}
+{% set deprecated_message = "This API is deprecated since " ~ method.deprecatedVersion ~ " and uses outdated terminologies." %}
 {% if method.replaceWith %}
-{% set deprecated_message = deprecated_message ~ ' Please use ' ~ (method.replaceWith | capitalizeFirst) ~ ' instead.' %}
+{% set deprecated_message = deprecated_message ~ ' Please use `' ~ (method.replaceWith | capitalizeFirst) ~ '` instead.' %}
     @Deprecated(
-        "{{ deprecated_message }}",
-        ReplaceWith("{{ sdk.namespace | caseDot }}.services.{{ method.replaceWith | capitalizeFirst }}")
+        message = "{{ deprecated_message }}",
+        replaceWith = ReplaceWith("{{ sdk.namespace | caseDot }}.services.{{ method.replaceWith | capitalizeFirst }}"),
+        since = "{{ method.deprecatedVersion }}"
     )
 {% else %}
     @Deprecated("{{ deprecated_message }}")

templates/kotlin/src/main/kotlin/io/appwrite/services/ServiceTemplate.kt.twig

@@ -31,12 +31,13 @@ class {{ service.name | caseUcfirst }}(client: Client) : Service(client) {
      * @return [{{ method | returnType(spec, sdk.namespace | caseDot) | raw }}]
      */
     {%~ if method.deprecated %}
-{% set deprecated_message = "This API is deprecated and uses outdated terminologies." %}
+{% set deprecated_message = "This API is deprecated since " ~ method.deprecatedVersion ~ " and uses outdated terminologies." %}
 {% if method.replaceWith %}
-{% set deprecated_message = deprecated_message ~ ' Please use ' ~ (method.replaceWith | capitalizeFirst) ~ ' instead.' %}
+{% set deprecated_message = deprecated_message ~ ' Please use `' ~ (method.replaceWith | capitalizeFirst) ~ '` instead.' %}
     @Deprecated(
-        "{{ deprecated_message }}",
-        ReplaceWith("{{ sdk.namespace | caseDot }}.services.{{ method.replaceWith | capitalizeFirst }}")
+        message = "{{ deprecated_message }}",
+        replaceWith = ReplaceWith("{{ sdk.namespace | caseDot }}.services.{{ method.replaceWith | capitalizeFirst }}"),
+        since = "{{ method.deprecatedVersion }}"
     )
 {% else %}
     @Deprecated("{{ deprecated_message }}")
@@ -104,12 +105,13 @@ class {{ service.name | caseUcfirst }}(client: Client) : Service(client) {
      * @return [{{ method | returnType(spec, sdk.namespace | caseDot) | raw }}]
      */
     {%~ if method.deprecated %}
-{% set deprecated_message = "This API is deprecated and uses outdated terminologies." %}
+{% set deprecated_message = "This API is deprecated since " ~ method.deprecatedVersion ~ " and uses outdated terminologies." %}
 {% if method.replaceWith %}
-{% set deprecated_message = deprecated_message ~ ' Please use ' ~ (method.replaceWith | capitalizeFirst) ~ ' instead.' %}
+{% set deprecated_message = deprecated_message ~ ' Please use `' ~ (method.replaceWith | capitalizeFirst) ~ '` instead.' %}
     @Deprecated(
-        "{{ deprecated_message }}",
-        ReplaceWith("{{ sdk.namespace | caseDot }}.services.{{ method.replaceWith | capitalizeFirst }}")
+        message = "{{ deprecated_message }}",
+        replaceWith = ReplaceWith("{{ sdk.namespace | caseDot }}.services.{{ method.replaceWith | capitalizeFirst }}"),
+        since = "{{ method.deprecatedVersion }}"
     )
 {% else %}
     @Deprecated("{{ deprecated_message }}")