{
    "outFolder": string, // path to write apidoc to
    "ignoreRoutes": string[], // array of routes to ignore
}

const request = require('supertest');
const { setApiResponse } = require('jest-apidoc');
const server = require('./app');
const apiRequest = async (
  method,
  url,
  params = {},
) => {
  const loadedServer = request(server);
  let requestBuilder;
  switch (method) {
    case GET:
      requestBuilder = loadedServer.get(url).query(params);
      break;
    case POST:
      requestBuilder = loadedServer.post(url).send(params);
      break;
    case DELETE:
      requestBuilder = loadedServer.delete(url).send(params);
      break;
    case PUT:
      requestBuilder = loadedServer.put(url).send(params);
      break;
    case PATCH:
      requestBuilder = loadedServer.patch(url).send(params);
      break;
    default:
      throw new Error(`No method for: ${method}`);
  }
  return requestBuilder
    .set('Content-Type', 'application/json')
    .then((res) => {
        setApiResponse({ method, params, status: res.statusCode, response });
        return res;
    });
};

describe('some-route.routes.js`, () => {
    describe('GET /some-route', () => {
        test('some functionality', async () => {
            ...
        });
    });
});

const { writeApiDoc } = require('jest-apidoc');
afterAll(() => {
    writeApiDoc();
})