Merge pull request #1857 from appwrite/fix-references-routing

Fix: routing in API references

Author: ItzNotABug

src/routes/docs/references/+layout.svelte

@@ -8,9 +8,15 @@
         /\/docs\/references\/.*?\/(client|server).*?\/.*?\/?/
     );
 
-    $: prefix = `/docs/references/${$preferredVersion ?? $page.params?.version ?? 'cloud'}/${
-        $preferredPlatform ?? $page.params?.platform ?? 'client-web'
-    }`;
+    $: platform = $preferredPlatform ?? $page.params?.platform ?? 'client-web';
+
+    /* correct platform prefix for references page */
+    $: resolvedPlatformPrefix = /^server-|^client-/.test(platform)
+        ? platform
+        : `server-${platform}`;
+
+    $: prefix = `/docs/references/${$preferredVersion ?? $page.params?.version ?? 'cloud'}/${resolvedPlatformPrefix}`;
+
     $: navigation = [
         {
             label: 'Getting started',

src/routes/docs/references/[version]/[platform]/[service]/+page.svelte

@@ -54,11 +54,14 @@
         // except nodejs, all other server sided need to be saved as without `server-` prefix
         const isServerSide =
             !platform.startsWith('client-') && !platform.startsWith('server-nodejs');
+
+        let correctPlatform = platform;
         if (isServerSide) {
-            const correctPlatform = platform.replaceAll(`server-`, ``);
-            preferredPlatform.set(correctPlatform as Platform);
+            correctPlatform = platform.replaceAll(`server-`, ``) as Platform;
         }
 
+        preferredPlatform.set(correctPlatform as Platform);
+
         goto(`/docs/references/${version}/${platform}/${service}`, {
             noScroll: true
         });
@@ -87,7 +90,7 @@
         // nodejs has a `server-` prefix.
         const needsServerPrefix =
             !platform.startsWith('client-') && !platform.startsWith('server-');
-        if (needsServerPrefix) {
+        if (needsServerPrefix && document.referrer) {
             platformBindingForSelect = `server-${platform}` as Platform;
         }
     }
@@ -100,7 +103,8 @@
         const hasPlatformPrefix =
             $preferredPlatform.startsWith('client-') || $preferredPlatform.startsWith('server-');
 
-        if (!isSame) {
+        /* `document.referrer` = don't redirect if the page was opened via a direct url hit */
+        if (!isSame && document.referrer) {
             const platformMode = hasPlatformPrefix
                 ? $preferredPlatform
                 : `server-${$preferredPlatform}`;
@@ -123,7 +127,7 @@
     // the service description up to the first full stop, providing sufficient information.
     $: shortenedDescription = serviceDescription.substring(0, serviceDescription.indexOf('.') + 1);
 
-    $: platformBindingForSelect = platform;
+    $: platformBindingForSelect = $page.params.platform as Platform;
     $: platform = ($preferredPlatform ?? $page.params.platform) as Platform;
     $: platformType = platform.startsWith('client-') ? 'CLIENT' : 'SERVER';
     $: serviceName = serviceMap[data.service?.name];