explore/ui/apiDocs/utils.ts

import type { SwaggerRequest } from './types';

import config from 'configs/app';
import type { ApiPropsBase } from 'configs/app/apis';

const feature = config.features.apiDocs;

const microserviceRequestInterceptorFactory = (api: ApiPropsBase) => (req: SwaggerRequest) => {
  try {
    const url = new URL(req.url);
    if (api?.basePath && !url.pathname.includes(api.basePath)) {
      url.pathname = (api?.basePath ?? '') + url.pathname;
    }
    req.url = url.toString();
  } catch (error) {}
  return req;
};

const getMicroserviceSwaggerUrl = (api: ApiPropsBase) => `${ api.endpoint }${ api.basePath ?? '' }/api/v1/docs/swagger.yaml`;

export const REST_API_SECTIONS = [
  feature.isEnabled && {
    id: 'blockscout-core-api',
    title: 'Blockscout core API',
    swagger: {
      url: feature.coreApiSwaggerUrl,
      requestInterceptor: (req: SwaggerRequest) => {
        if (!config.apis.general) {
          return req;
        }

        const DEFAULT_SERVER = 'blockscout.com/poa/core';
        const DEFAULT_SERVER_NEW = 'eth.blockscout.com';

        if (!req.loadSpec) {
          const newUrl = new URL(
            req.url.includes(DEFAULT_SERVER) ?
              req.url.replace(DEFAULT_SERVER, config.apis.general.host) :
              req.url.replace(DEFAULT_SERVER_NEW, config.apis.general.host),
          );

          newUrl.protocol = config.apis.general.protocol + ':';

          if (config.apis.general.port) {
            newUrl.port = config.apis.general.port;
          }

          req.url = newUrl.toString();
        }
        return req;
      },
    },
  },
  config.apis.stats && {
    id: 'stats-api',
    title: 'Stats API',
    swagger: {
      url: getMicroserviceSwaggerUrl(config.apis.stats),
      requestInterceptor: microserviceRequestInterceptorFactory(config.apis.stats),
    },
  },
  config.apis.bens && {
    id: 'bens-api',
    title: 'Name service API',
    swagger: {
      url: getMicroserviceSwaggerUrl(config.apis.bens),
      requestInterceptor: microserviceRequestInterceptorFactory(config.apis.bens),
    },
  },
  config.apis.userOps && {
    id: 'user-ops-api',
    title: 'User ops indexer API',
    swagger: {
      url: getMicroserviceSwaggerUrl(config.apis.userOps),
      requestInterceptor: microserviceRequestInterceptorFactory(config.apis.userOps),
    },
  },
  config.apis.tac && {
    id: 'tac-api',
    title: 'TAC operation lifecycle API',
    swagger: {
      url: getMicroserviceSwaggerUrl(config.apis.tac),
      requestInterceptor: microserviceRequestInterceptorFactory(config.apis.tac),
    },
  },
  config.apis.zetachain && {
    id: 'zetachain-api',
    title: 'Zetachain CCTX API',
    swagger: {
      url: getMicroserviceSwaggerUrl(config.apis.zetachain),
      requestInterceptor: microserviceRequestInterceptorFactory(config.apis.zetachain),
    },
  },
].filter(Boolean);