mountain-pass/addressr

import debug from 'debug';
import LinkHeader from 'http-link-header';
import { setLinkOptions } from './setLinkOptions';
var logger = debug('api');

/**
 * API Root
 * returns a list of available APIs within the `Link` headers
 *
 * returns Root
 **/
export async function getApiRoot() {
  const paths = Object.keys(global.swaggerDoc.paths).filter(
    (p) =>
      global.swaggerDoc.paths[p].get !== undefined &&
      global.swaggerDoc.paths[p].get['x-root-rel'] !== undefined
  );

  const link = new LinkHeader();
  paths.forEach((p) => {
    const op = global.swaggerDoc.paths[p].get;
    if (
      op.parameters &&
      op.parameters.find((parameter) => parameter.required === true)
    ) {
      // skip
    } else {
      link.set({ rel: op['x-root-rel'], uri: p, title: op.summary });
    }
  });
  link.set({
    rel: 'describedby',
    uri: '/docs/',
    title: 'API Docs',
    type: 'text/html',
  });
  link.set({
    rel: 'describedby',
    uri: '/api-docs',
    title: 'API Docs',
    type: 'application/json',
  });

  const linkTemplate = new LinkHeader();
  paths.forEach((url) => {
    const op = global.swaggerDoc.paths[url].get;
    logger(op);
    setLinkOptions(op, url, linkTemplate);
  });

  return { link: link, body: {}, linkTemplate: linkTemplate };
}