chore: update graphql repo, fix & refactor links plugin (#101)

src/lib/plugins/links.ts

@@ -1,3 +1,4 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import type { Root } from 'remark-gfm';
@@ -11,119 +12,88 @@ const configPath = join(DOCS_DIRECTORY, `../src/config/paths.json`);
 const pathsConfig = JSON.parse(readFileSync(configPath, 'utf8'));
 
 export function handleLinks(
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   node: any,
   dirname: string,
   idx?: number | null,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   parent?: Parent<any, any>,
   tree?: Root
 ) {
   let newUrl: string | null = null;
 
   if (node.type === 'html') {
-    const url = getUrl(node.value);
-    if (
-      url &&
-      !node.value.includes(':href') &&
-      idx !== undefined &&
-      idx !== null
-    ) {
-      node.type = 'link';
-      node.value = null;
-      node.children = [];
-      node.children.push(parent.children[idx + 1]);
-      parent.children.splice(idx + 1, 2);
-    } else if (
-      url &&
-      node.value.includes(':href') &&
-      idx !== undefined &&
-      idx !== null
-    ) {
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const scriptString = tree?.children[0] as any;
-      const newURLs = getTSUrl(scriptString.value);
-
-      if (newURLs) {
-        let newURL = newURLs[url];
-        if (newURL) {
-          newURL = newURL.replace('/v${forc}', '').replace('/v${fuels}', '');
-          for (const [key, value] of Object.entries(pathsConfig)) {
-            newURL = newURL.replaceAll(key, value as string);
-          }
-          const value = parent.children[idx + 1].value;
-          parent.children[idx] = {
-            type: 'link',
-            url: newURL,
-            children: [
-              {
-                type: 'text',
-                value: value,
-              },
-            ],
-          };
-          // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          parent.children.forEach((child: any) => {
-            if (child.type === 'html' && child.value === '</a>') {
-              child.type = 'text';
-              child.value = '';
-            } else if (child.value === value) {
-              child.value = '';
-            }
-          });
-        }
-      }
-    }
+    handleHTMLLink(node, idx, parent, tree);
   } else {
     if (!node.url.includes('http')) {
-      newUrl = node.url
-        .replace('.md', '')
-        .replace('/index', '')
-        .replace('.html', '')
-        .toLowerCase();
-
-      const configPath = join(DOCS_DIRECTORY, `../src/config/paths.json`);
-      const pathsConfig = JSON.parse(readFileSync(configPath, 'utf8'));
-
-      let dir = dirname;
-      Object.keys(pathsConfig).forEach((key) => {
-        dir = dir.replaceAll(key, pathsConfig[key]);
-      });
-
-      if (node.url.startsWith('../')) {
-        const folder = dirname.split('/').pop();
-        newUrl = `/${dir.replace(folder!, '')}${newUrl!.replace('../', '')}`;
-      }
-      if (node.url.startsWith('./') && !node.url.includes('index')) {
-        newUrl = `/${dir.endsWith('/') ? dir : `${dir}/`}${newUrl!.replace(
-          './',
-          ''
-        )}`;
-      }
-      if (/^[a-zA-Z]/.test(node.url)) {
-        newUrl = `/${dir}/${newUrl}`;
-      }
-      newUrl = newUrl!.replace('/sway/forc/', '/forc/');
+      newUrl = getNewUrl(node, dirname);
     }
-
     if (node.url.endsWith('CONTRIBUTING') && node.url.includes('github.com')) {
       newUrl = `${node.url}.md`;
     }
-    const duplicates = getTSAPIDuplicates();
-    if (newUrl) {
-      duplicates.forEach((item: DuplicateAPIItem) => {
-        if (newUrl?.startsWith(item.path.toLowerCase())) {
-          newUrl = newUrl.replace(
-            item.originalCategory.toLowerCase(),
-            item.newCategory.toLowerCase()
-          );
-        }
-      });
-    }
-    if (newUrl && newUrl.startsWith('/api/')) {
-      newUrl = newUrl.replace('/api/', '/docs/fuels-ts/');
+    newUrl = handleTSLinks(newUrl);
+  }
+
+  return newUrl;
+}
+
+function handleTSLinks(url: string | null) {
+  let newUrl = url;
+  const duplicates = getTSAPIDuplicates();
+  if (newUrl) {
+    duplicates.forEach((item: DuplicateAPIItem) => {
+      if (newUrl?.startsWith(item.path.toLowerCase())) {
+        newUrl = newUrl.replace(
+          item.originalCategory.toLowerCase(),
+          item.newCategory.toLowerCase()
+        );
+      }
+    });
+  }
+  if (newUrl && newUrl.startsWith('/api/')) {
+    newUrl = newUrl.replace('/api/', '/docs/fuels-ts/');
+  }
+  return newUrl;
+}
+
+function getNewUrl(node: any, dirname: string) {
+  let newUrl;
+  newUrl = node.url
+    .replace('.md', '')
+    .replace('/index', '')
+    .replace('.html', '')
+    .toLowerCase();
+
+  const configPath = join(DOCS_DIRECTORY, `../src/config/paths.json`);
+  const pathsConfig = JSON.parse(readFileSync(configPath, 'utf8'));
+
+  let dir = dirname;
+  Object.keys(pathsConfig).forEach((key) => {
+    dir = dir.replaceAll(key, pathsConfig[key]);
+  });
+
+  if (node.url.startsWith('../')) {
+    // TODO: remove this once wallet is updated past 13.0
+    if (!dirname.includes('fuels-wallet') && !node.url.startsWith('../dev')) {
+      const folder = dirname.split('/').pop();
+      newUrl = `/${dir.replace(folder!, '')}${newUrl!.replace('../', '')}`;
     }
   }
+  if (node.url.startsWith('./') && !node.url.includes('index')) {
+    newUrl = `/${dir.endsWith('/') ? dir : `${dir}/`}${newUrl!.replace(
+      './',
+      ''
+    )}`;
+  }
+  if (/^[a-zA-Z]/.test(node.url)) {
+    newUrl = `/${dir}/${newUrl}`;
+  }
+  newUrl = newUrl!.replace('/sway/forc/', '/forc/');
+  const isLatest = dirname.includes('/latest/');
+  if (dirname.includes('fuel-graphql-docs')) {
+    newUrl = isLatest
+      ? newUrl.replace('/docs/', '/docs/latest/graphql/')
+      : newUrl.replace('/docs/', '/docs/graphql/');
+  }
+  // TODO: add this for the wallet once wallet is updated past 13.0
 
   return newUrl;
 }
@@ -150,3 +120,72 @@ function getTSUrl(input: string): { [key: string]: string } {
   }
   return result;
 }
+
+function handleHTMLLink(
+  node: any,
+  idx?: number | null,
+  parent?: Parent<any, any>,
+  tree?: Root
+) {
+  const url = getUrl(node.value);
+  if (
+    url &&
+    !node.value.includes(':href') &&
+    idx !== undefined &&
+    idx !== null
+  ) {
+    node.type = 'link';
+    node.value = null;
+    node.children = [];
+    node.children.push(parent.children[idx + 1]);
+    parent.children.splice(idx + 1, 2);
+  } else if (
+    url &&
+    node.value.includes(':href') &&
+    idx !== undefined &&
+    idx !== null
+  ) {
+    const scriptString = tree?.children[0] as any;
+    const newURLs = getTSUrl(scriptString.value);
+
+    if (newURLs) {
+      handleNewURLs(newURLs, url, idx, parent);
+    }
+  }
+}
+
+function handleNewURLs(
+  newURLs: {
+    [key: string]: string;
+  },
+  url: string,
+  idx: number,
+  parent: Parent<any, any>
+) {
+  let newURL = newURLs[url];
+  if (newURL) {
+    newURL = newURL.replace('/v${forc}', '').replace('/v${fuels}', '');
+    for (const [key, value] of Object.entries(pathsConfig)) {
+      newURL = newURL.replaceAll(key, value as string);
+    }
+    const value = parent.children[idx + 1].value;
+    parent.children[idx] = {
+      type: 'link',
+      url: newURL,
+      children: [
+        {
+          type: 'text',
+          value: value,
+        },
+      ],
+    };
+    parent.children.forEach((child: any) => {
+      if (child.type === 'html' && child.value === '</a>') {
+        child.type = 'text';
+        child.value = '';
+      } else if (child.value === value) {
+        child.value = '';
+      }
+    });
+  }
+}