From 262be06b0d693f8a8d33c0e001255edc803bad7f Mon Sep 17 00:00:00 2001
From: Chirag Aggarwal <chiragaggarwal5k@gmail.com>
Date: Fri, 29 Aug 2025 18:37:44 +0530
Subject: [PATCH] chore: improve deprecation warning

---
 app/controllers/general.php | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/app/controllers/general.php b/app/controllers/general.php
index 22954afd96..91ba1477bd 100644
--- a/app/controllers/general.php
+++ b/app/controllers/general.php
@@ -1065,7 +1065,6 @@ App::init()
          */
         /** @var \Appwrite\SDK\Method $sdk */
         $sdk = $route->getLabel('sdk', false);
-        $deprecationWarning = 'This route is deprecated. See the updated documentation for improved compatibility and migration details.';
         $sdkItems = is_array($sdk) ? $sdk : (!empty($sdk) ? [$sdk] : []);
         if (!empty($sdkItems) && count($sdkItems) > 0) {
             $allDeprecated = true;
@@ -1076,6 +1075,13 @@ App::init()
                 }
             }
             if ($allDeprecated) {
+                $deprecatedMethod = $sdkItems[0]->getDeprecated();
+                $replaceWith = $deprecatedMethod->getReplaceWith();
+                if ($replaceWith) {
+                    $replaceWith = preg_replace('/\./', '#', $replaceWith, 1);
+                }
+                $deprecatedReplaceWithLink = 'https://appwrite.io/docs/references/cloud/server-rest/' . $replaceWith;
+                $deprecationWarning = 'Route ' . $route->getPath() . ' is deprecated since ' . $deprecatedMethod->getSince() . '. Please use ' . $deprecatedMethod->getReplaceWith() . ' instead. See: ' . $deprecatedReplaceWithLink;
                 $warnings[] = $deprecationWarning;
             }
         }