gatsby-node.js

/* eslint-disable max-len */
const Path = require('path');

const {
  slugify,
  compose,
  childrenToList,
  stripDirectoryPath,
  dotifyVersion,
} = require('./src/utils/utils');
const {
  SUPPORTED_LOCALES,
  DEFAULT_LOCALE,
  pathCollisionDetector,
  buildFileTree,
  buildFileTreeNode,
  getChildSidebar,
  unorderify,
  getDocSection,
  buildBreadcrumbs,
  dedupePath,
  addPrefixSlash,
  addTrailingSlash,
  removeEnPrefix,
  translatePath,
  getSlug,
  getTranslatedSlug,
  replacePathsInSidebarTree,
  removeParametersFromJavaScriptAPISlug,
  isProduction,
} = require('./src/utils/utils.node');
const {
  SUPPORTED_VERSIONS,
  LATEST_VERSION,
} = require('./src/utils/versioning');

const getVersionedCustomSlug = (slug, pageVersion) => {
  if (pageVersion === LATEST_VERSION) {
    return slug;
  }

  return `/${pageVersion}${slug}`;
};

const newJavascriptURLsRedirects = {};

function stripJSAPISlugParamsAndAddToRedirects(slug, title) {
  const newSlug = removeParametersFromJavaScriptAPISlug(slug, title);

  if (slug !== newSlug) {
    newJavascriptURLsRedirects[addPrefixSlash(slug)] = newSlug;
    return newSlug;
  }

  return slug;
}

const formatSectionName = (name) => {
  if (name === 'javascript api') {
    return 'Javascript API';
  }

  return `${name[0].toUpperCase()}${name.slice(1)}`;
};

const getPageTranslations = (
  relativeDirectory,
  name,
  getGuidesSidebar,
  reporter,
) => {
  const treeReducer = (subtree, currentNode) => {
    if (
      !subtree ||
      typeof subtree.children === 'undefined' ||
      typeof subtree.children[currentNode] === 'undefined'
    ) {
      return null;
    }
    return subtree.children[currentNode];
  };

  const pageTranslations = {};

  const filePath = unorderify(
    stripDirectoryPath(relativeDirectory, 'guides'),
    // remove locale prefix
  ).slice(3);

  SUPPORTED_LOCALES.forEach((locale) => {
    let translation = [...filePath.split('/'), unorderify(name)].reduce(
      treeReducer,
      getGuidesSidebar(locale),
    );

    if (translation && translation.meta) {
      translation = translation.meta;
    } else {
      translation = null;
    }

    if (translation) {
      pageTranslations[locale] = translation;
    } else {
      reporter.warn(
        `No ${locale} translation found for ${relativeDirectory}/${name}`,
      );
    }
  });

  return pageTranslations;
};

const getPageVersions = (
  getSidebar,
  getJavascriptAPISidebar,
  relativeDirectory,
  name,
  currentVersion = null,
) => {
  const treeReducer = (subtree, currentNode) => {
    if (
      !subtree ||
      typeof subtree.children === 'undefined' ||
      typeof subtree.children[currentNode] === 'undefined'
    ) {
      return null;
    }
    return subtree.children[currentNode];
  };

  let filePath = unorderify(
    stripDirectoryPath(relativeDirectory, 'javascript-api'),
    // remove version prefix
  ).slice(currentVersion ? currentVersion.length + 1 : 0);

  if (!currentVersion) {
    filePath = unorderify(stripDirectoryPath(relativeDirectory, 'docs'));
  }

  filePath = filePath
    .replace('javascript api/', '')
    // for pages like /k6-crypto, k6-data etc
    .replace('javascript api', '');

  const pageVersions = {};

  const pathMold =
    filePath === ''
      ? [unorderify(name)]
      : [...filePath.split('/'), unorderify(name)];
  SUPPORTED_VERSIONS.forEach((version) => {
    const versionedPath = pathMold.reduce(
      treeReducer,
      getJavascriptAPISidebar(version).children['javascript api'],
    );

    if (versionedPath?.meta) {
      pageVersions[version] = versionedPath.meta;
    }
  });

  // find latest version link
  const latestVersion = pathMold.reduce(
    treeReducer,
    getSidebar('javascript api'),
  );

  if (latestVersion && latestVersion.meta) {
    pageVersions[LATEST_VERSION] = latestVersion.meta;
  }

  return pageVersions;
};

const topLevelLinks = [
  {
    label: 'guides',
    to: 'https://grafana.com/docs/k6/latest/',
  },
  {
    label: 'JAVASCRIPT API',
    to: 'https://grafana.com/docs/k6/latest/javascript-api/',
  },
  {
    label: 'Cloud Docs',
    to: '/cloud/',
    submenu: [
      {
        label: 'Grafana Cloud k6',
        to: 'https://grafana.com/docs/grafana-cloud/k6',
      },
      { label: 'k6 Cloud', to: `/cloud/` },
    ],
  },
  {
    label: 'Extensions',
    to: 'https://grafana.com/docs/k6/latest/extensions/',
  },
  {
    label: 'Integrations',
    to: 'https://grafana.com/docs/k6/latest/misc/integrations/',
  },
  {
    label: 'examples',
    to: 'https://grafana.com/docs/k6/latest/examples/',
  },
];

function generateSidebar({ nodes, type = 'docs' }) {
  const sidebarTreeBuilder = buildFileTree(buildFileTreeNode);

  nodes.forEach(({ name, relativeDirectory, children: [remarkNode] }) => {
    const {
      frontmatter: {
        title,
        redirect,
        hideFromSidebar,
        draft,
        slug,
        shouldCreatePage,
      },
    } = remarkNode;

    // skip md files that we don't generate pages for
    if (shouldCreatePage === false) {
      return;
    }

    // skip altogether if this content has draft flag
    if (draft === 'true' && isProduction) return;

    // titles like k6/html treated like paths otherwise
    const translatedPath = `${stripDirectoryPath(
      relativeDirectory,
      type,
    )}/${title.replace(/\//g, '-')}`;

    const pageLocale =
      SUPPORTED_LOCALES.find((locale) =>
        translatedPath.startsWith(`${locale}/`),
      ) || DEFAULT_LOCALE;

    let pageSlug =
      pageLocale === DEFAULT_LOCALE
        ? `/${getSlug(translatedPath)}`
        : `/${getTranslatedSlug(
            relativeDirectory,
            title,
            pageLocale,
            'guides',
          )}`;

    if (pageSlug === '//') {
      pageSlug = '/';
    }

    let customSlug = slug ? addTrailingSlash(slug) : null;

    const pageVersion = SUPPORTED_VERSIONS.find((version) =>
      translatedPath.startsWith(version),
    );

    if (pageVersion && customSlug) {
      customSlug = getVersionedCustomSlug(customSlug, pageVersion);
    }

    sidebarTreeBuilder.addNode(
      unorderify(stripDirectoryPath(relativeDirectory, type)),
      unorderify(name),
      {
        path: stripJSAPISlugParamsAndAddToRedirects(
          customSlug || dotifyVersion(pageSlug),
          title,
        ),
        title,
        redirect,
        hideFromSidebar: hideFromSidebar || false,
        isActiveSidebarLink: true,
      },
    );
  });

  return sidebarTreeBuilder.getTree();
}

const getExtensionsPageSidebar = (sidebarTree) => {
  const extensionsSidebar = {
    name: 'extensions',
    meta: {
      title: 'Extensions',
      path: '/extensions/',
    },
    children: {},
  };

  return {
    ...extensionsSidebar,
    children: { ...extensionsSidebar.children, ...sidebarTree.children },
  };
};

function getSupplementaryPagesProps({
  nodesGuides,
  reporter,
  topLevelNames,
  getSidebar,
  getGuidesSidebar,
}) {
  const notFoundProps = {
    path: '/404',
    component: Path.resolve(`./src/templates/404.js`),
    context: {
      sidebarTree: getSidebar('guides'),
      navLinks: topLevelLinks,
    },
  };
  const stubPagesProps = topLevelNames
    .filter(
      (s) =>
        ![
          'javascript api',
          'examples',
          isProduction ? 'cloud rest api' : '',
        ].includes(s.toLowerCase()),
    )
    .flatMap((section) =>
      childrenToList(getSidebar(section).children).map(({ name }) => {
        const path = `${section}/${name}`;
        let breadcrumbs = compose(buildBreadcrumbs, dedupePath)(path);

        // replace sidebar section name for k6 js api pages
        let sectionName = formatSectionName(section);

        if (path.startsWith('javascript-api/')) {
          sectionName = 'k6 API';

          breadcrumbs = breadcrumbs.map((item) => ({
            ...item,
            name: item.name === 'Javascript API' ? 'k6 API' : item.name,
          }));
        }

        let sidebarTree = getSidebar(section);

        if (path.startsWith('extensions/')) {
          sidebarTree = getExtensionsPageSidebar(sidebarTree);
        }

        return {
          path: compose(
            removeEnPrefix,
            addTrailingSlash,
            dedupePath,
            slugify,
          )(path),
          component: Path.resolve('./src/templates/docs/breadcrumb-stub.js'),
          context: {
            sidebarTree,
            sectionName,
            breadcrumbs,
            title: name,
            navLinks: topLevelLinks,
            directChildren: getSidebar(section).children[name].children,
          },
        };
      }),
    );

  const stubGuidesPagesProps = SUPPORTED_LOCALES.flatMap((locale) =>
    childrenToList(getGuidesSidebar(locale).children).map(({ name, meta }) => {
      const remarkNode = nodesGuides.find(
        (node) =>
          node.name.toLowerCase().includes(meta.title.toLowerCase()) &&
          node.relativeDirectory === 'markdown/translated-guides/en',
      );
      let extendedRemarkNode = null;

      const path = `${locale}/${meta.title}`;
      const breadcrumbs = compose(
        buildBreadcrumbs,
        removeEnPrefix,
        dedupePath,
      )(path);

      const pageTranslations = {};
      SUPPORTED_LOCALES.forEach((locale) => {
        if (
          typeof getGuidesSidebar(locale).children[name] !== 'undefined' &&
          typeof getGuidesSidebar(locale).children[name].meta !== 'undefined'
        ) {
          pageTranslations[locale] =
            getGuidesSidebar(locale).children[name].meta;
        } else {
          reporter.warn(`No ${locale} translation found for ${name}`);
        }
      });

      if (remarkNode) {
        const { relativeDirectory } = remarkNode;

        extendedRemarkNode = {
          ...remarkNode.children[0],
          frontmatter: {
            ...remarkNode.children[0].frontmatter,
            fileOrigin: encodeURI(
              `https://github.com/grafana/k6-docs/blob/main/src/data/${relativeDirectory}/${name}.md`,
            ),
          },
        };
      }

      return {
        path: compose(
          removeEnPrefix,
          addTrailingSlash,
          dedupePath,
          slugify,
        )(path),
        component: Path.resolve('./src/templates/docs/breadcrumb-stub.js'),
        context: {
          sidebarTree: getGuidesSidebar(locale),
          sectionName: 'Guides',
          breadcrumbs: breadcrumbs.filter(
            (item) => !SUPPORTED_LOCALES.includes(item.path.replace(/\//g, '')),
          ),
          title: meta.title,
          navLinks: topLevelLinks,
          remarkNode: extendedRemarkNode,
          directChildren: getGuidesSidebar(locale).children[name].children,
          locale,
          translations: pageTranslations,
        },
      };
    }),
  );

  return stubPagesProps.concat(notFoundProps, stubGuidesPagesProps);
}

function getTopLevelPagesProps({
  topLevelNames,
  getSidebar,
  getGuidesSidebar,
  pathCollisionDetectorInstance,
  getJavascriptAPISidebar,
}) {
  // generating pages currently presented in templates/docs/ folder
  // for the exception of Cloud REST API
  return topLevelNames
    .filter(
      (item) =>
        item !== 'jslib' && item !== 'xk6-disruptor' && item !== 'extensions',
    )
    .map((name) => {
      const slug = slugify(name);
      // manually exclude from top navigation cloud rest api section
      if (slug === 'cloud-rest-api') {
        return false;
      }
      // path collision check
      if (
        !pathCollisionDetectorInstance
          .add({ path: slug, name: `${slug}.js` })
          .isUnique()
      ) {
        // skip page creation if there is already a page with identical url
        return false;
      }

      return {
        path: slug === 'guides' ? `/` : `/${slug}/`,
        component: Path.resolve(`./src/templates/docs/${slug}.js`),
        context: {
          sectionName: formatSectionName(name),
          sidebarTree: getSidebar(name),
          navLinks: topLevelLinks,
        },
      };
    })
    .concat(
      SUPPORTED_LOCALES.map((locale) => ({
        path: locale === 'en' ? '/' : `/${locale}/`,
        component: Path.resolve(`./src/templates/docs/guides.js`),
        context: {
          sidebarTree: getGuidesSidebar(locale),
          navLinks: topLevelLinks,
          locale,
          sectionName: 'Guides',
        },
      })),
    )
    .concat([
      {
        path: `/extensions/`,
        component: Path.resolve(`./src/templates/docs/extensions.js`),
        context: {
          sectionName: 'Extensions',
          sidebarTree: getExtensionsPageSidebar(getSidebar('extensions')),
          navLinks: topLevelLinks,
        },
      },
      {
        path: `/extensions/get-started/explore/`,
        component: Path.resolve(`./src/templates/docs/explore-extensions.js`),
        context: {
          sectionName: 'Extensions',
          sidebarTree: getExtensionsPageSidebar(getSidebar('extensions')),
          navLinks: topLevelLinks,
        },
      },
      {
        path: `/extensions/get-started/bundle/`,
        component: Path.resolve(`./src/templates/docs/bundle-builder.js`),
        context: {
          sectionName: 'Extensions',
          sidebarTree: getExtensionsPageSidebar(getSidebar('extensions')),
          navLinks: topLevelLinks,
        },
      },
    ])
    .concat(
      SUPPORTED_VERSIONS.map((version) => ({
        path: `/${version}/javascript-api/`,
        component: Path.resolve(
          `./src/templates/docs/versioned-javascript-api.js`,
        ),
        context: {
          sectionName: 'Javascript API',
          sidebarTree:
            getJavascriptAPISidebar(version).children['javascript api'],
          navLinks: topLevelLinks,
          version,
          // eslint-disable-next-line no-useless-escape
          versionRegex: `/${version}\/javascript api/`,
          // eslint-disable-next-line no-useless-escape
          alternativeVersionRegex: `/${version}\/javascript api\/alternative main modules/`,
        },
      })),
    )
    .filter(Boolean);
}

function getDocPagesProps({
  nodes,
  reporter,
  getSidebar,
  getJavascriptAPISidebar,
  pathCollisionDetectorInstance,
}) {
  // creating actual docs pages
  return nodes
    .map(({ relativeDirectory, children: [remarkNode], name }) => {
      // for debuggin purpose in case there are errors in md/html syntax
      if (typeof remarkNode === 'undefined') {
        reporter.warn(
          `\nMarkup of a page is broken, unable to generate. Check the following file: \n\n
          ${relativeDirectory}/${name}`,
        );
        return false;
      }
      if (typeof remarkNode.frontmatter === 'undefined') {
        reporter.warn(
          `\nFrontmatter data is missing, unable to generate the page. Check the following file:\n\n ${relativeDirectory}/${name}`,
        );
        return false;
      }
      const {
        frontmatter,
        frontmatter: {
          title,
          redirect,
          draft,
          slug: customSlug,
          shouldCreatePage,
        },
      } = remarkNode;

      if (shouldCreatePage === false) {
        return false;
      }

      // if there is a value in redirect field, skip page creation
      // OR there is draft flag and mode is prod
      if ((draft === 'true' && isProduction) || redirect) {
        return false;
      }

      const strippedDirectory = stripDirectoryPath(relativeDirectory, 'docs');
      const path = `${strippedDirectory}/${title.replace(/\//g, '-')}`;

      let slug = customSlug ? addTrailingSlash(customSlug) : getSlug(path);
      // path collision check
      if (!pathCollisionDetectorInstance.add({ path: slug, name }).isUnique()) {
        // skip the page creation if there is already a page with identical url
        return false;
      }

      // generate breadcrumbs
      let breadcrumbs = compose(buildBreadcrumbs, dedupePath, unorderify)(path);

      const docSection = compose(getDocSection, unorderify)(strippedDirectory);

      let sidebarTree = getSidebar(docSection);

      if (slug.startsWith('extensions/')) {
        sidebarTree = getExtensionsPageSidebar(sidebarTree);
      }

      let pageVersions = null;
      let version = null;

      if (
        slug.startsWith('javascript-api/') ||
        slug.startsWith('/javascript-api/')
      ) {
        version = LATEST_VERSION;
        pageVersions = getPageVersions(
          getSidebar,
          getJavascriptAPISidebar,
          relativeDirectory,
          name,
        );
      }

      // replace sidebar section name for k6 js api pages
      let sectionName = formatSectionName(docSection);

      if (slug.startsWith('javascript-api/')) {
        sectionName = 'k6 API';
        breadcrumbs = breadcrumbs.map((item) => ({
          ...item,
          name: item.name === 'Javascript API' ? 'k6 API' : item.name,
        }));
      }

      // data for github button on the right
      // currently we only show it for jslib, xk6-disruptor pages
      let githubUrl = null;
      let githubTitle = '';

      // add prefix to jslib pages slugs and sidebar links
      if (slug.startsWith('jslib/')) {
        slug = `javascript-api/${slug}`;

        replacePathsInSidebarTree(
          sidebarTree,
          '/jslib',
          '/javascript-api/jslib',
        );

        githubUrl = 'https://github.com/grafana/jslib.k6.io';
        githubTitle = 'jslib';

        breadcrumbs = breadcrumbs.map((item) => ({
          ...item,
          name: item.name === 'Jslib' ? 'jslib' : item.name,
          path: item.path.replace('/jslib', '/javascript-api/jslib'),
        }));
      }

      // add prefix to xk6-disruptor pages slugs and sidebar links
      if (slug.startsWith('xk6-disruptor/')) {
        slug = `javascript-api/${slug}`;
        if (slug.includes('xk6-disruptor/get-started/first-steps')) {
          // make the section root out of the welcome page
          slug = `/javascript-api/xk6-disruptor/`;
        }

        replacePathsInSidebarTree(
          sidebarTree,
          '/xk6-disruptor',
          '/javascript-api/xk6-disruptor',
        );
        replacePathsInSidebarTree(
          sidebarTree,
          '/javascript-api/xk6-disruptor/get-started/first-steps',
          '/javascript-api/xk6-disruptor',
        );

        githubUrl = 'https://github.com/grafana/xk6-disruptor';
        githubTitle = 'xk6-disruptor';

        breadcrumbs = breadcrumbs.map((item) => ({
          ...item,
          name: item.name === 'Xk6-disruptor' ? 'xk6-disruptor' : item.name,
          path: item.path.replace(
            '/xk6-disruptor',
            '/javascript-api/xk6-disruptor',
          ),
        }));
      }

      let hideBreadcrumbs = false;
      if (
        slug === 'javascript-api/jslib/' ||
        slug === 'javascript-api/xk6-disruptor/'
      ) {
        hideBreadcrumbs = true;
      }

      const pageSlug = stripJSAPISlugParamsAndAddToRedirects(slug, title);

      const extendedRemarkNode = {
        ...remarkNode,
        frontmatter: {
          ...frontmatter,
          slug: pageSlug,
          // injection of a link to an article in git repo
          fileOrigin: encodeURI(
            `https://github.com/grafana/k6-docs/blob/main/src/data/${relativeDirectory}/${name}.md`,
          ),
        },
      };

      return {
        path: pageSlug,
        component: Path.resolve('./src/templates/doc-page.js'),
        context: {
          sectionName,
          remarkNode: extendedRemarkNode,
          sidebarTree,
          breadcrumbs,
          navLinks: topLevelLinks,
          version,
          pageVersions,
          githubUrl,
          githubTitle,
          hideBreadcrumbs,
        },
      };
    })
    .filter(Boolean);
}

function getGuidesPagesProps({
  nodesGuides,
  reporter,
  pathCollisionDetectorInstance,
  getGuidesSidebar,
}) {
  // creating actual docs pages
  return nodesGuides
    .map(({ relativeDirectory, children: [remarkNode], name }) => {
      const strippedDirectory = relativeDirectory.replace(
        /^.*guides\/(.*)$/,
        '$1',
      );
      // for debuggin purpose in case there are errors in md/html syntax
      if (typeof remarkNode === 'undefined') {
        reporter.warn(
          `\nMarkup of a page is broken, unable to generate. Check the following file: \n\n
          ${relativeDirectory}/${name}`,
        );
        return false;
      }
      if (typeof remarkNode.frontmatter === 'undefined') {
        reporter.warn(
          `\nFrontmatter data is missing, unable to generate the page. Check the following file:\n\n ${relativeDirectory}/${name}`,
        );
        return false;
      }
      const {
        frontmatter,
        frontmatter: { title, redirect, draft, slug: customSlug },
      } = remarkNode;
      // if there is a value in redirect field, skip page creation
      // OR there is draft flag and mode is prod
      if ((draft === 'true' && isProduction) || redirect) {
        return false;
      }
      const path = `${strippedDirectory}/${title.replace(/\//g, '-')}`;

      const pageLocale =
        SUPPORTED_LOCALES.find((locale) =>
          strippedDirectory.startsWith(`${locale}/`),
        ) || DEFAULT_LOCALE;

      const slug =
        pageLocale === DEFAULT_LOCALE
          ? getSlug(path)
          : getTranslatedSlug(relativeDirectory, title, pageLocale, 'guides');

      const pageSlug = customSlug ? addTrailingSlash(customSlug) : slug;

      // path collision check
      if (!pathCollisionDetectorInstance.add({ path: slug, name }).isUnique()) {
        // skip the page creation if there is already a page with identical url
        return false;
      }

      // generate breadcrumbs
      let breadcrumbs = compose(
        buildBreadcrumbs,
        removeEnPrefix,
        dedupePath,
        unorderify,
      )(path);

      if (pageLocale !== DEFAULT_LOCALE) {
        const translatedPath = translatePath(unorderify(path), pageLocale);

        breadcrumbs = compose(
          buildBreadcrumbs,
          removeEnPrefix,
          dedupePath,
        )(translatedPath);
      }

      const sidebarTree = getGuidesSidebar(pageLocale);

      const pageTranslations = getPageTranslations(
        relativeDirectory,
        name,
        getGuidesSidebar,
        reporter,
      );

      const extendedRemarkNode = {
        ...remarkNode,
        frontmatter: {
          ...frontmatter,
          slug: pageSlug,
          // injection of a link to an article in git repo
          fileOrigin: encodeURI(
            `https://github.com/grafana/k6-docs/blob/main/src/data/${relativeDirectory}/${name}.md`,
          ),
          translations: pageTranslations,
        },
      };

      return {
        path: pageSlug || '/',
        component: Path.resolve('./src/templates/doc-page.js'),
        context: {
          sectionName: 'Guides',
          remarkNode: extendedRemarkNode,
          sidebarTree,
          breadcrumbs: breadcrumbs.filter(
            (item) => !SUPPORTED_LOCALES.includes(item.path.replace(/\//g, '')),
          ),
          navLinks: topLevelLinks,
          locale: pageLocale,
        },
      };
    })
    .filter(Boolean);
}

function getJsAPIVersionedPagesProps({
  nodesJsAPI,
  reporter,
  pathCollisionDetectorInstance,
  getJavascriptAPISidebar,
  getSidebar,
}) {
  // creating actual docs pages
  return nodesJsAPI
    .map(({ relativeDirectory, children: [remarkNode], name }) => {
      const strippedDirectory = relativeDirectory.replace(
        /^.*js-api\/(.*)$/,
        '$1',
      );
      // for debuggin purpose in case there are errors in md/html syntax
      if (typeof remarkNode === 'undefined') {
        reporter.warn(
          `\nMarkup of a page is broken, unable to generate. Check the following file: \n\n
          ${relativeDirectory}/${name}`,
        );
        return false;
      }
      if (typeof remarkNode.frontmatter === 'undefined') {
        reporter.warn(
          `\nFrontmatter data is missing, unable to generate the page. Check the following file:\n\n ${relativeDirectory}/${name}`,
        );
        return false;
      }
      const {
        frontmatter,
        frontmatter: {
          title,
          redirect,
          draft,
          slug: customSlug,
          shouldCreatePage,
        },
      } = remarkNode;

      // if there is a value in redirect field, skip page creation
      // OR there is draft flag and mode is prod
      if (
        (draft === 'true' && isProduction) ||
        redirect ||
        shouldCreatePage === false
      ) {
        return false;
      }
      const path = `${strippedDirectory}/${title.replace(/\//g, '-')}`;
      const pageVersion = SUPPORTED_VERSIONS.find((version) =>
        strippedDirectory.startsWith(version),
      );

      if (!pageVersion) {
        return null;
      }

      const slug = getSlug(path);

      const pageSlug = customSlug
        ? getVersionedCustomSlug(addTrailingSlash(customSlug), pageVersion)
        : slug;

      // path collision check
      if (
        !pathCollisionDetectorInstance.add({ path: pageSlug, name }).isUnique()
      ) {
        // skip the page creation if there is already a page with identical url
        return false;
      }

      const sidebarTree =
        getJavascriptAPISidebar(pageVersion).children['javascript api'];

      const pagePath = stripJSAPISlugParamsAndAddToRedirects(
        dotifyVersion(pageSlug) || '/',
        title,
      );

      const extendedRemarkNode = {
        ...remarkNode,
        frontmatter: {
          ...frontmatter,
          slug: pagePath,
          // injection of a link to an article in git repo
          fileOrigin: encodeURI(
            `https://github.com/grafana/k6-docs/blob/main/src/data/${relativeDirectory}/${name}.md`,
          ),
        },
      };

      const pathForBreadcrumbs = compose(dedupePath, unorderify)(path);

      let breadcrumbs = buildBreadcrumbs(pathForBreadcrumbs, true);
      breadcrumbs = breadcrumbs.map((item) =>
        item.path.endsWith(`/javascript-api/`)
          ? {
              path: item.path,
              name: 'Javascript API',
            }
          : item,
      );

      breadcrumbs = breadcrumbs.filter(
        (item) => item.path !== '/' && item.path !== `/${pageVersion}/`,
      );

      const pageVersions = getPageVersions(
        getSidebar,
        getJavascriptAPISidebar,
        relativeDirectory,
        name,
        pageVersion,
      );

      return {
        path: pagePath,
        component: Path.resolve('./src/templates/doc-page.js'),
        context: {
          sectionName: 'Javascript API',
          remarkNode: extendedRemarkNode,
          sidebarTree,
          breadcrumbs,
          navLinks: topLevelLinks,
          version: pageVersion,
          pageVersions,
        },
      };
    })
    .filter(Boolean);
}

async function fetchDocPagesData(graphql) {
  const {
    data: {
      allFile: { nodes },
    },
  } = await graphql(
    `
      query docPagesQuery {
        allFile(
          filter: {
            ext: { in: [".md"] }
            relativeDirectory: { regex: "/docs/" }
          }
          sort: { fields: absolutePath, order: ASC }
        ) {
          nodes {
            name
            relativeDirectory
            children {
              ... on Mdx {
                body
                frontmatter {
                  title
                  slug
                  head_title
                  excerpt
                  heading
                  redirect
                  hideFromSidebar
                  draft
                  shouldCreatePage
                  canonicalUrl
                }
              }
            }
          }
        }
      }
    `,
  );
  return nodes;
}

async function fetchGuidesPagesData(graphql) {
  const {
    data: {
      allFile: { nodes },
    },
  } = await graphql(
    `
      query guidesPagesQuery {
        allFile(
          filter: {
            ext: { in: [".md"] }
            relativeDirectory: { regex: "/translated-guides/" }
          }
          sort: { fields: absolutePath, order: ASC }
        ) {
          nodes {
            name
            relativeDirectory
            children {
              ... on Mdx {
                body
                frontmatter {
                  title
                  slug
                  head_title
                  excerpt
                  robots
                  redirect
                  hideFromSidebar
                  draft
                  shouldCreatePage
                  canonicalUrl
                }
              }
            }
          }
        }
      }
    `,
  );
  return nodes;
}

async function fetchJavascriptAPIPagesData(graphql) {
  const {
    data: {
      allFile: { nodes },
    },
  } = await graphql(
    `
      query guidesPagesQuery {
        allFile(
          filter: {
            ext: { in: [".md"] }
            relativeDirectory: { regex: "/versioned-js-api/" }
          }
          sort: { fields: absolutePath, order: ASC }
        ) {
          nodes {
            name
            relativeDirectory
            children {
              ... on Mdx {
                body
                frontmatter {
                  title
                  slug
                  head_title
                  excerpt

                  redirect
                  hideFromSidebar
                  draft
                  shouldCreatePage
                  canonicalUrl
                }
              }
            }
          }
        }
      }
    `,
  );
  return nodes;
}

async function createDocPages({
  nodes,
  nodesGuides,
  sidebar,
  guidesSidebar,
  nodesJsAPI,
  javascriptAPISidebar,
  actions,
  reporter,
}) {
  // initiating path collision checker
  const pathCollisionDetectorInstance = pathCollisionDetector(reporter.warn);

  // local helper function that uses currying, expects one more arg
  const getSidebar = getChildSidebar(sidebar);

  // local helper function that uses currying, expects one more arg
  const getGuidesSidebar = getChildSidebar(guidesSidebar);

  const getJavascriptAPISidebar = getChildSidebar(javascriptAPISidebar);

  // create data for rendering docs navigation
  const topLevelNames = Object.keys(sidebar.children).filter(
    (name) => name !== 'xk6-disruptor' && name !== 'jslib',
  );

  getDocPagesProps({
    nodes,
    reporter,
    pathCollisionDetectorInstance,
    getSidebar,
    getJavascriptAPISidebar,
  })
    .concat(
      getGuidesPagesProps({
        nodesGuides,
        reporter,
        pathCollisionDetectorInstance,
        getGuidesSidebar,
      }),
      getJsAPIVersionedPagesProps({
        nodesJsAPI,
        reporter,
        pathCollisionDetectorInstance,
        getJavascriptAPISidebar,
        getSidebar,
      }),
      getTopLevelPagesProps({
        topLevelNames,
        getSidebar,
        getGuidesSidebar,
        getJavascriptAPISidebar,
        pathCollisionDetectorInstance,
      }),
      getSupplementaryPagesProps({
        nodesGuides,
        topLevelNames,
        getSidebar,
        getGuidesSidebar,
        getJavascriptAPISidebar,
        reporter,
      }),
    )
    .map((pageProps) => actions.createPage(pageProps));
}

const createRedirects = ({ actions }) => {
  const { createRedirect } = actions;

  createRedirect({
    fromPath: '/get-started/welcome/',
    toPath: '/',
    redirectInBrowser: true,
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/cloud/analyzing-results/logs-tab/',
    toPath: '/cloud/analyzing-results/logs/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/getting-started/community',
    toPath: 'https://k6.io/community/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/es/empezando/comunidad',
    toPath: 'https://k6.io/community/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/project-and-team-management/usage-reports/',
    toPath: '/cloud/manage/usage-reports/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/cloud/integrations/notifications/',
    toPath: '/cloud/manage/notifications/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/cloud/project-and-team-management/thresholds/',
    toPath: '/cloud/manage/thresholds/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/cloud/integrations/cloud-apm/prometheus-remote-write/',
    toPath: '/cloud/integrations/prometheus-remote-write/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/cloud/creating-and-running-a-test/scheduling-tests/',
    toPath: '/cloud/manage/scheduled-tests/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/ecosystem/',
    toPath: '/extensions/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/ecosystem/bundle-builder/',
    toPath: '/extensions/get-started/bundle/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/extensions/guides/create-an-extension/',
    toPath: '/extensions/get-started/create/javascript-extensions/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/misc/k6-extensions/',
    toPath: '/extensions/guides/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/extensions/bundle-builder/',
    toPath: '/extensions/get-started/bundle/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/extensions/explore/',
    toPath: '/extensions/get-started/explore/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/extensions/guides/get-started/',
    toPath: '/extensions/guides/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/extensions/guides/what-are-k6-extensions/',
    toPath: '/extensions/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/integrations/k6-extensions/',
    toPath: '/extensions/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/project-and-team-management/team-members/',
    toPath: '/cloud/project-and-team-management/members/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/project-and-team-management/azure-ad-saml-sso/',
    toPath: '/cloud/project-and-team-management/saml-sso/azure-ad/',
    redirectInBrowser: true,
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/using-k6/options/',
    toPath: '/using-k6/k6-options/reference/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/analyzing-results/thresholds-tab/',
    toPath: '/cloud/analyzing-results/thresholds/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/analyzing-results/checks-tab/',
    toPath: '/cloud/analyzing-results/checks/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/analyzing-results/http-tab/',
    toPath: '/cloud/analyzing-results/http/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/analyzing-results/performance-trending/',
    toPath: '/cloud/analyzing-results/test-comparison/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/billing-user-menu/billing/',
    toPath: '/cloud/your-plan/billing/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/billing-user-menu/data-retention/',
    toPath: '/cloud/your-plan/about-data-retention/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/billing-user-menu/subscription/',
    toPath: '/cloud/your-plan/manage-subscription/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/cloud-faq/general-questions/',
    toPath: '/cloud/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/cloud-faq/pricing-questions/',
    toPath: '/cloud/your-plan/pricing-questions/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/cloud-faq/private-load-zones/',
    toPath:
      'https://grafana.com/docs/grafana-cloud/k6/author-run/private-load-zone-v2/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/creating-and-running-a-test/private-load-zones/',
    toPath:
      'https://grafana.com/docs/grafana-cloud/k6/author-run/private-load-zone-v2/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-types/load-test-types/',
    toPath: 'https://grafana.com/load-testing/types-of-load-testing/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-types/smoke-testing/',
    toPath: 'https://grafana.com/blog/2024/01/30/smoke-testing/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-types/load-testing/',
    toPath: 'https://grafana.com/blog/2024/01/30/average-load-testing/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-types/stress-testing/',
    toPath: 'https://grafana.com/blog/2024/01/30/stress-testing/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-types/soak-testing/',
    toPath: 'https://grafana.com/blog/2024/01/30/soak-testing/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-types/spike-testing/',
    toPath: 'https://grafana.com/blog/2024/01/30/spike-testing/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-types/breakpoint-testing/',
    toPath: 'https://grafana.com/blog/2024/01/30/breakpoint-testing/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/cloud-faq/release-notes/',
    toPath: '/cloud/cloud-reference/release-notes/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/end-of-test-summary/',
    toPath: '/results-output/end-of-test/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/json/',
    toPath: '/results-output/real-time/json/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/csv/',
    toPath: '/results-output/real-time/csv/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-output/end-of-test/json/',
    toPath: '/results-output/real-time/json/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-output/end-of-test/csv/',
    toPath: '/results-output/real-time/csv/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/amazon-cloudwatch/',
    toPath: '/results-output/real-time/amazon-cloudwatch/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/cloud/',
    toPath: '/results-output/real-time/cloud/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/datadog/',
    toPath: '/results-output/real-time/datadog/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/netdata/',
    toPath: '/results-output/real-time/netdata/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/new-relic/',
    toPath: '/results-output/real-time/new-relic/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/prometheus/',
    toPath: '/results-output/real-time/prometheus-remote-write/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-output/real-time/prometheus/',
    toPath: '/results-output/real-time/prometheus-remote-write/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/timescaledb/',
    toPath: '/results-output/real-time/timescaledb/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/statsd/',
    toPath: '/results-output/real-time/statsd/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/javascript-api/k6-experimental-redis/',
    toPath: '/k6-experimental/redis/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/javascript-api/k6-experimental-redis/client/',
    toPath: '/k6-experimental/redis/client/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/javascript-api/k6-experimental-redis/options/',
    toPath: '/k6-experimental/redis/options/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/javascript-api/jslib/k6chaijs/plugins/',
    toPath: '/javascript-api/jslib/k6chaijs/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/javascript-api/jslib/k6chaijs/configuration/',
    toPath: '/javascript-api/jslib/k6chaijs/config/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/getting-started/installation/',
    toPath: '/get-started/installation/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/getting-started/installation/troubleshooting/',
    toPath: '/get-started/installation/troubleshooting/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/getting-started/running-k6/',
    toPath: '/get-started/running-k6/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/getting-started/results-output/',
    toPath: '/get-started/results-output/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/getting-started/resources/',
    toPath: '/get-started/resources/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/extensions/getting-started/explore/',
    toPath: '/extensions/get-started/explore/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/extensions/getting-started/bundle/',
    toPath: '/extensions/get-started/bundle/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/extensions/getting-started/create/',
    toPath: '/extensions/get-started/create/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/extensions/getting-started/create/javascript-extensions/',
    toPath: '/extensions/get-started/create/javascript-extensions/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/extensions/getting-started/create/output-extensions/',
    toPath: '/extensions/get-started/create/output-extensions/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/extensions/guides/build-a-k6-binary-with-extensions/',
    toPath: '/extensions/guides/build-a-k6-binary-using-go/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/integrations/grafana-plugin/',
    toPath: '/cloud/integrations/grafana-app/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/using-k6/test-life-cycle/',
    toPath: '/using-k6/test-lifecycle/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/using-k6/scenarios/arrival-rate/',
    toPath: '/using-k6/scenarios/concepts/open-vs-closed/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/using-k6/scenarios/graceful-stop/',
    toPath: '/using-k6/scenarios/concepts/graceful-stop/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/es/visualizacion-de-resultados/apache-kafka/',
    toPath: '/results-output/real-time/apache-kafka/',
    isPermanent: true,
  });

  createRedirect({
    fromPath:
      '/cloud/creating-and-running-a-test/cloud-tests-from-the-cli/cloud-execution-reference/',
    toPath: '/cloud/creating-and-running-a-test/cloud-scripting-extras',
    isPermanent: true,
  });

  createRedirect({
    fromPath:
      '/cloud/creating-and-running-a-test/cloud-tests-from-the-cli/run-tests/',
    toPath: '/cloud/creating-and-running-a-test/cloud-tests-from-the-cli',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-types/introduction/',
    toPath: '/test-types/load-test-types/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-output/real-time/grafana-cloud/',
    toPath: '/results-output/real-time/grafana-cloud-prometheus/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/es/visualizacion-de-resultados/influxdb-+-grafana/',
    toPath: '/results-output/grafana-dashboards/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/es/visualizacion-de-resultados/influxdb-grafana/',
    toPath: '/results-output/grafana-dashboards/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-output/real-time/influxdb-grafana/',
    toPath: '/results-output/grafana-dashboards/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/results-visualization/influxdb-+-grafana/',
    toPath: '/results-output/grafana-dashboards/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-authoring/recording-a-session/browser-recorder/',
    toPath:
      '/test-authoring/create-tests-from-recordings/using-the-browser-recorder/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/creating-and-running-a-test/recording-a-test-script/',
    toPath:
      '/test-authoring/create-tests-from-recordings/using-the-browser-recorder/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/using-k6/session-recording-har-support/',
    toPath:
      '/test-authoring/create-tests-from-recordings/using-the-har-converter/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-authoring/recording-a-session/har-converter/',
    toPath:
      '/test-authoring/create-tests-from-recordings/using-the-har-converter/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/test-authoring/recording-a-session/',
    toPath: '/test-authoring/create-tests-from-recordings/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/cloud/cloud-reference/cloud-rest-api/',
    toPath:
      'https://grafana.com/docs/grafana-cloud/k6/reference/cloud-rest-api/',
    isPermanent: true,
  });

  createRedirect({
    fromPath: '/using-k6-browser/selecting-elements/',
    toPath: '/using-k6-browser/recommended-practices/selecting-elements/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/using-k6-browser/examples/page-object-model/',
    toPath: '/using-k6-browser/recommended-practices/page-object-model/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/es/guias-de-prueba/automatizacion-de-pruebas-de-rendimiento/',
    toPath: '/testing-guides/automated-performance-testing/',
    isPermanent: true,
  });
  createRedirect({
    fromPath: '/examples/advanced-api-flow/',
    toPath: '/examples/api-crud-operations/',
    isPermanent: true,
  });

  [
    '/',
    '/describe/',
    '/expect/',
    '/and/',
    '/as/',
    '/toequal/',
    '/tobegreaterthan/',
    '/tobegreaterthanorequal/',
    '/tobelessthan/',
    '/tobelessthanorequal/',
    '/tobebetween/',
    '/tobetruthy/',
    '/tohavevalidjson/',
  ].forEach((item) => {
    createRedirect({
      fromPath: `/javascript-api/jslib/expect${item}`,
      toPath: '/javascript-api/jslib/k6chaijs/',
      isPermanent: true,
    });
  });

  const redirects = {
    '/es/': '/',
    '/es/empezando/bienvenido/': '/',
    '/es/empezando/instalacion/': '/get-started/installation/',
    '/es/empezando/instalacion/solucion-de-problemas/':
      '/get-started/installation/troubleshooting/',
    '/es/empezando/ejecucion-de-k6/': '/get-started/running-k6/',
    '/es/empezando/recursos-de-k6/': '/get-started/resources/',
    '/es/usando-k6/': '/using-k6/',
    '/es/usando-k6/peticiones-http/': '/using-k6/http-requests/',
    '/es/usando-k6/metricas/': '/using-k6/metrics/',
    '/es/usando-k6/checks/': '/using-k6/thresholds/',
    '/es/usando-k6/opciones/': '/using-k6/k6-options/',
    '/es/usando-k6/thresholds/': '/using-k6/thresholds/',
    '/es/usando-k6/etapas-de-un-test/': '/using-k6/test-lifecycle/',
    '/es/usando-k6/modulos/': '/using-k6/modules/',
    '/es/usando-k6/tags-y-groups/': '/using-k6/tags-and-groups/',
    '/es/usando-k6/cookies/': '/using-k6/cookies/',
    '/es/usando-k6/protocolos/': '/using-k6/protocols/',
    '/es/usando-k6/protocolos/http-2/': '/using-k6/protocols/',
    '/es/usando-k6/protocolos/websockets/': '/using-k6/protocols/',
    '/es/usando-k6/protocolos/grpc/': '/using-k6/protocols/',
    '/es/usando-k6/protocolos/ssl-tls/': '/using-k6/protocols/',
    '/es/usando-k6/variables-de-entorno/': '/using-k6/environment-variables/',
    '/es/usando-k6/variables-de-contexto/':
      '/using-k6/execution-context-variables/',
    '/es/usando-k6/escenarios/': '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/executors/': '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/executors/shared-iterations/':
      '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/executors/per-vu-iterations/':
      '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/executors/constant-vus/': '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/executors/ramping-vus/': '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/executors/constant-arrival-rate/':
      '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/executors/ramping-arrival-rate/':
      '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/executors/externally-controlled/':
      '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/ejemplos-avanzados/': '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/graceful-stop/': '/using-k6/scenarios/',
    '/es/usando-k6/escenarios/arrival-rate/': '/using-k6/scenarios/',
    '/es/creacion-de-pruebas/': '/test-authoring/',
    '/es/creacion-de-pruebas/constructor-de-pruebas/':
      '/test-authoring/test-builder/',
    '/es/creacion-de-pruebas/grabar-una-sesion/':
      '/test-authoring/create-tests-from-recordings/',
    '/es/creacion-de-pruebas/grabar-una-sesion/grabador-de-navegador/':
      '/test-authoring/create-tests-from-recordings/',
    '/es/creacion-de-pruebas/grabar-una-sesion/har-converter/':
      '/test-authoring/create-tests-from-recordings/',
    '/es/tipos-de-prueba/': '/test-types/',
    '/es/tipos-de-prueba/introduccion/': '/test-types/',
    '/es/tipos-de-prueba/smoke-testing/': '/test-types/smoke-testing/',
    '/es/tipos-de-prueba/load-testing/': '/test-types/load-testing/',
    '/es/tipos-de-prueba/stress-testing/': '/test-types/stress-testing/',
    '/es/tipos-de-prueba/soak-testing/': '/test-types/soak-testing/',
    '/es/visualizacion-de-resultados/': '/results-output/real-time/',
    '/es/visualizacion-de-resultados/amazon-cloudwatch/':
      '/results-output/real-time/amazon-cloudwatch/',
    '/es/visualizacion-de-resultados/cloud/':
      '/results-output/real-time/cloud/',
    '/es/visualizacion-de-resultados/csv/': '/results-output/real-time/csv/',
    '/es/visualizacion-de-resultados/datadog/':
      '/results-output/real-time/datadog/',
    '/es/visualizacion-de-resultados/json/': '/results-output/real-time/json/',
    '/es/visualizacion-de-resultados/netdata/':
      '/results-output/real-time/netdata/',
    '/es/visualizacion-de-resultados/new-relic/':
      '/results-output/real-time/new-relic/',
    '/es/visualizacion-de-resultados/statsd/':
      '/results-output/real-time/statsd/',
    '/es/visualizacion-de-resultados/resumen-del-final-de-la-prueba/':
      '/results-output/end-of-test/',
    '/es/guias-de-prueba/': '/testing-guides/',
    '/es/guias-de-prueba/pruebas-de-carga-de-sitios-web/':
      '/testing-guides/load-testing-websites/',
    '/es/guias-de-prueba/pruebas-a-gran-escala/':
      '/testing-guides/running-large-tests/',
    '/es/guias-de-prueba/pruebas-de-carga-para-apis/':
      '/testing-guides/api-load-testing/',
    '/es/misc/': '/misc/',
    '/es/misc/recopilacion-de-datos-de-uso/': '/misc/usage-collection/',
    '/es/misc/intellisense/': '/misc/intellisense/',
    '/es/misc/optimizar-el-sistema-operativo/': '/misc/fine-tuning-os/',
    '/es/misc/archivo-command/': '/misc/archive-command/',
    '/es/misc/glosario/': '/misc/glossary/',
    '/javascript-api/k6-http/cookiejar-k6-http/':
      '/javascript-api/k6-http/cookiejar/',
    '/javascript-api/k6-http/cookiejar-k6-http/cookiejar-cookiesforurl-url/':
      '/javascript-api/k6-http/cookiejar/cookiejar-cookiesforurl-url/',
    '/javascript-api/k6-http/cookiejar-k6-http/cookiejar-set-name-value-options/':
      '/javascript-api/k6-http/cookiejar/cookiejar-set-url-name-value-options/',
    '/javascript-api/k6-http/cookiejar/cookiejar-set-name-value-options/':
      '/javascript-api/k6-http/cookiejar/cookiejar-set-url-name-value-options/',
    '/javascript-api/k6-http/filedata-k6-http/':
      '/javascript-api/k6-http/filedata/',
    '/javascript-api/k6-http/params-k6-http/':
      '/javascript-api/k6-http/params/',
    '/javascript-api/k6-http/response-k6-http/':
      '/javascript-api/k6-http/response/',
    '/javascript-api/k6-http/response-k6-http/response-clicklink-params/':
      '/javascript-api/k6-http/response/response-clicklink-params/',
    '/javascript-api/k6-http/response-k6-http/response-html/':
      '/javascript-api/k6-http/response/response-html/',
    '/javascript-api/k6-http/response-k6-http/response-json-selector/':
      '/javascript-api/k6-http/response/response-json-selector/',
    '/javascript-api/k6-http/response-k6-http/response-submitform-params/':
      '/javascript-api/k6-http/response/response-submitform-params/',
    '/javascript-api/k6-metrics/counter-k6-metrics/':
      '/javascript-api/k6-metrics/counter/',
    '/javascript-api/k6-metrics/gauge-k6-metrics/':
      '/javascript-api/k6-metrics/gauge/',
    '/javascript-api/k6-metrics/rate-k6-metrics/':
      '/javascript-api/k6-metrics/rate/',
    '/javascript-api/k6-metrics/trend-k6-metrics/':
      '/javascript-api/k6-metrics/trend/',
    '/javascript-api/k6-encoding/b64decode-input-encoding/':
      '/javascript-api/k6-encoding/b64decode-input-encoding-format/',
    '/using-k6/archives-for-bundling-sharing-a-test/': '/misc/archive-command/',
    '/using-k6/ssl-tls/': '/using-k6/protocols/ssl-tls/',
    '/using-k6/ssl-tls/online-certificate-status-protocol-ocsp/':
      '/using-k6/protocols/ssl-tls/online-certificate-status-protocol-ocsp/',
    '/using-k6/ssl-tls/ssl-tls-client-certificates/':
      '/using-k6/protocols/ssl-tls/ssl-tls-client-certificates/',
    '/using-k6/ssl-tls/ssl-tls-version-and-ciphers/':
      '/using-k6/protocols/ssl-tls/ssl-tls-version-and-ciphers/',
    '/using-k6/multipart-requests-file-uploads/': '/examples/data-uploads/',
    '/results-visualization/apache-kafka/':
      '/results-output/real-time/apache-kafka/',
    '/getting-started/results-output/cloud/': '/results-visualization/cloud/',
    '/results-visualization/k6-cloud-test-results/':
      '/results-visualization/cloud/',
    '/getting-started/results-output/datadog/':
      '/results-visualization/datadog/',
    '/getting-started/results-output/influxdb/':
      '/results-output/real-time/influxdb/',
    '/getting-started/results-output/json/': '/results-visualization/json/',
    '/getting-started/results-output/statsd/': '/results-visualization/statsd/',
    '/javascript-api/k6-metrics/counter-k6-metrics/counter-add-value-tags/':
      '/javascript-api/k6-metrics/counter/counter-add-value-tags/',
    '/javascript-api/k6-metrics/gauge-k6-metrics/gauge-add-value-tags/':
      '/javascript-api/k6-metrics/gauge/gauge-add-value-tags/',
    '/javascript-api/k6-metrics/rate-k6-metrics/rate-add-value-tags/':
      '/javascript-api/k6-metrics/rate/rate-add-value-tags/',
    '/javascript-api/k6-metrics/trend-k6-metrics/trend-add-value-tags/':
      '/javascript-api/k6-metrics/trend/trend-add-value-tags/',
    '/using-k6/cloud-execution/':
      '/cloud/creating-and-running-a-test/cloud-tests-from-the-cli/',
    '/using-k6/html/working-with-html-forms/': '/examples/html-forms/',
    '/using-k6/html/': '/javascript-api/k6-html/',
    '/cloud/creating-and-running-a-test/test-builder/':
      '/test-authoring/test-builder/',
    '/cloud/creating-and-running-a-test/in-app-script-editor/':
      '/cloud/creating-and-running-a-test/script-editor/',
    '/cloud/creating-and-running-a-test/converters/': '/integrations/',
    '/cloud/integrations/ci/': '/integrations/',
    '/cloud/cloud-faq/what-is-data-retention/':
      '/cloud/billing-user-menu/data-retention/',
    '/cloud/cloud-faq/pricing-faq/': '/cloud/cloud-faq/pricing-questions/',
    '/cloud/cloud-faq/what-ip-addresses-are-used-by-the-k6-cloud/':
      '/cloud/cloud-faq/general-questions/',
    '/cloud/cloud-faq/what-is-the-best-way-to-debug-my-load-test-scripts/':
      '/cloud/cloud-faq/general-questions/',
    '/cloud/cloud-faq/i-was-invited-to-an-organization-and-i-cannot-run-tests/':
      '/cloud/cloud-faq/general-questions/',
    '/cloud/cloud-faq/how-to-open-your-firewall-to-k6-cloud-service-for-cloud-executed-tests/':
      '/cloud/cloud-faq/general-questions/',
    '/cloud/cloud-faq/test-status-codes/':
      '/cloud/cloud-faq/general-questions/',
    '/cloud/cloud-faq/what-are-vus-virtual-users/':
      '/cloud/cloud-faq/general-questions/',
    '/cloud/cloud-faq/data-uploads-with-k6-cloud/':
      '/cloud/cloud-faq/general-questions/',
    '/misc/usage-reports/': '/misc/usage-collection/',
    '/using-k6/using-node-modules/': '/using-k6/modules/',
    '/javascript-api/k6-x-browser/': '/using-k6-browser/overview/',
    '/javascript-api/xk6-browser/': '/using-k6-browser/overview/',
    '/javascript-api/k6-browser/': '/using-k6-browser/overview/',
    '/javascript-api/xk6-browser/api/':
      '/javascript-api/k6-experimental/browser/',
    '/javascript-api/k6-browser/api/':
      '/javascript-api/k6-experimental/browser/',
    '/javascript-api/k6-browser/api/browser/':
      '/javascript-api/k6-experimental/browser/browser-class/',
    '/javascript-api/k6-browser/browser/':
      '/javascript-api/k6-experimental/browser/browser-class/',
    '/javascript-api/k6-browser/api/browsercontext/':
      '/javascript-api/k6-experimental/browser/browsercontext/',
    '/javascript-api/k6-browser/browsercontext/':
      '/javascript-api/k6-experimental/browser/browsercontext/',
    '/javascript-api/k6-browser/api/browsertype/':
      '/javascript-api/k6-experimental/browser/browsertype/',
    '/javascript-api/k6-browser/browsertype/':
      '/javascript-api/k6-experimental/browser/browsertype/',
    '/javascript-api/k6-browser/api/elementhandle/':
      '/javascript-api/k6-experimental/browser/elementhandle/',
    '/javascript-api/k6-browser/elementhandle/':
      '/javascript-api/k6-experimental/browser/elementhandle/',
    '/javascript-api/k6-browser/api/frame/':
      '/javascript-api/k6-experimental/browser/frame/',
    '/javascript-api/k6-browser/frame/':
      '/javascript-api/k6-experimental/browser/frame/',
    '/javascript-api/k6-browser/api/jshandle/':
      '/javascript-api/k6-experimental/browser/jshandle/',
    '/javascript-api/k6-browser/jshandle/':
      '/javascript-api/k6-experimental/browser/jshandle/',
    '/javascript-api/k6-browser/api/keyboard/':
      '/javascript-api/k6-experimental/browser/keyboard/',
    '/javascript-api/k6-browser/keyboard/':
      '/javascript-api/k6-experimental/browser/keyboard/',
    '/javascript-api/k6-browser/api/locator/':
      '/javascript-api/k6-experimental/browser/locator/',
    '/javascript-api/k6-browser/locator/':
      '/javascript-api/k6-experimental/browser/locator/',
    '/javascript-api/k6-browser/api/mouse/':
      '/javascript-api/k6-experimental/browser/mouse/',
    '/javascript-api/k6-browser/mouse/':
      '/javascript-api/k6-experimental/browser/mouse/',
    '/javascript-api/k6-browser/api/page/':
      '/javascript-api/k6-experimental/browser/page/',
    '/javascript-api/k6-browser/page/':
      '/javascript-api/k6-experimental/browser/page/',
    '/javascript-api/k6-browser/api/request/':
      '/javascript-api/k6-experimental/browser/request/',
    '/javascript-api/k6-browser/request/':
      '/javascript-api/k6-experimental/browser/request/',
    '/javascript-api/k6-browser/api/response/':
      '/javascript-api/k6-experimental/browser/response/',
    '/javascript-api/k6-browser/response/':
      '/javascript-api/k6-experimental/browser/response/',
    '/javascript-api/k6-browser/api/touchscreen/':
      '/javascript-api/k6-experimental/browser/touchscreen/',
    '/javascript-api/k6-browser/touchscreen/':
      '/javascript-api/k6-experimental/browser/touchscreen/',
    '/javascript-api/xk6-browser/get-started/running-xk6-browser/':
      '/using-k6-browser/running-browser-tests/',
    '/javascript-api/k6-browser/get-started/running-browser-tests/':
      '/using-k6-browser/running-browser-tests/',
    '/javascript-api/xk6-browser/get-started/browser-metrics/':
      '/using-k6-browser/browser-metrics/',
    '/javascript-api/k6-browser/get-started/browser-metrics/':
      '/using-k6-browser/browser-metrics/',
    '/javascript-api/xk6-browser/get-started/selecting-elements/':
      '/using-k6-browser/selecting-elements/',
    '/javascript-api/k6-browser/get-started/selecting-elements/':
      '/using-k6-browser/selecting-elements/',
    '/javascript-api/xk6-disruptor/get-started/first-steps/':
      '/javascript-api/xk6-disruptor/',
    ...newJavascriptURLsRedirects,
  };

  // eslint-disable-next-line no-restricted-syntax
  for (const [key, value] of Object.entries(redirects)) {
    createRedirect({
      fromPath: `${key}`,
      toPath: `${value}`,
      isPermanent: true,
    });

    if (key.slice('-1') !== '/') {
      createRedirect({
        fromPath: `${key}/`,
        toPath: `${value}`,
        isPermanent: true,
      });
    }
  }

  // all redirects docs.k6.io
  [
    '/selection-findselector/',
    '/selection-attrname/',
    '/selection-getindex/',
    '/selection-nextselector/',
    '/selection-nextallselector/',
    '/selection-prevallselector/',
    '/selection-parentselector/',
    '/selection-parentsselector/',
    '/selection-prevuntilselector/',
    '/selection-nextuntilselector/',
    '/selection-parentsuntilselector/',
    '/selection-childrenselector/',
    '/selection/',
  ].forEach((item) => {
    createRedirect({
      fromPath: `/javascript-api/k6-html/selection${item}`,
      toPath: '/javascript-api/k6-html/selection/',
      isPermanent: true,
    });
  });

  [
    '/md4-input-outputencoding/',
    '/md5-input-outputencoding/',
    '/sha1-input-outputencoding/',
    '/sha256-input-outputencoding/',
    '/sha384-input-outputencoding/',
    '/sha512-input-outputencoding/',
    '/sha512_224-input-outputencoding/',
    '/sha512_256-input-outputencoding/',
    '/ripemd160-input-outputencoding/',
  ].forEach((item) => {
    createRedirect({
      fromPath: `/javascript-api/6-crypto/hmac${item}`,
      toPath: '/javascript-api/k6-crypto/',
      isPermanent: true,
    });
  });
};

exports.createPages = async (options) => {
  const pagesData = await fetchDocPagesData(options.graphql);
  const guidesData = await fetchGuidesPagesData(options.graphql);
  const javascriptAPIData = await fetchJavascriptAPIPagesData(options.graphql);

  const sidebar = generateSidebar({ nodes: pagesData });
  const guidesSidebar = generateSidebar({ nodes: guidesData, type: 'guides' });
  const javascriptAPISidebar = generateSidebar({
    nodes: javascriptAPIData,
    type: 'javascript-api',
  });

  await createDocPages({
    ...options,
    nodes: pagesData,
    nodesGuides: guidesData,
    sidebar,
    guidesSidebar,
    nodesJsAPI: javascriptAPIData,
    javascriptAPISidebar,
  });
  await createRedirects(options);
};

exports.onCreateNode = ({ node, actions }) => {
  const { createNodeField } = actions;
  // Adding default values for some fields and moving them under node.fields
  // because that how createNodeField works
  if (node.frontmatter) {
    createNodeField({
      node,
      name: 'redirect',
      value: node.frontmatter.redirect || '',
    });
    createNodeField({
      node,
      name: 'hideFromSidebar',
      value: node.frontmatter.hideFromSidebar || false,
    });
    createNodeField({
      node,
      name: 'draft',
      value: node.frontmatter.draft || 'false',
    });
    createNodeField({
      node,
      name: 'head_title',
      value: node.frontmatter.head_title || '',
    });
    createNodeField({
      node,
      name: 'slug',
      value: node.frontmatter.slug || '',
    });
    createNodeField({
      node,
      name: 'shouldCreatePage',
      value: node.frontmatter.shouldCreatePage || true,
    });
    createNodeField({
      node,
      name: 'canonicalUrl',
      value: node.frontmatter.canonicalUrl || '',
    });
  }
};