swaggie 0.6.5 → 0.6.9-beta

package/README.md

@@ -4,15 +4,16 @@
 
 # Swaggie
 
+![npm latest version](https://img.shields.io/npm/v/swaggie)
 ![NodeCI](https://github.com/yhnavein/swaggie/workflows/NodeCI/badge.svg)
 [![CircleCI](https://circleci.com/gh/yhnavein/swaggie.svg?style=svg)](https://circleci.com/gh/yhnavein/swaggie)
-![Dependencies](https://img.shields.io/david/yhnavein/swaggie.svg)
 ![Snyk Vulnerabilities for GitHub Repo](https://img.shields.io/snyk/vulnerabilities/github/yhnavein/swaggie.svg)
 ![npm downloads](https://img.shields.io/npm/dw/swaggie.svg)
-![npm latest version](https://img.shields.io/npm/v/swaggie)
 ![npm bundle size](https://img.shields.io/bundlephobia/minzip/swaggie.svg)
 ![npm install size](https://packagephobia.now.sh/badge?p=swaggie)
 
+<!-- ![Dependencies](https://img.shields.io/david/yhnavein/swaggie.svg) -->
+
 Generate ES6 or Typescript code from an OpenAPI 2.0 spec, so that accessing REST API resources from the client code is less error-prone, static-typed and just easier to use long-term.
 
 You can take a look at the [Examples section](#example) down below.
@@ -88,6 +89,7 @@ The following templates are bundled with Swaggie:
 
 ```
 axios     Default template. Recommended for React / Vue / similar frameworks. Uses axios
+swr-axios Template that embraces SRW for GET requests and as a fallback uses axios.
 fetch     Template similar to axios, but with fetch API instead. Recommended for React / Vue / similar frameworks
 ng1       Template for Angular 1 (this is for the old one)
 ng2       Template for Angular 2+ (uses HttpClient, InjectionTokens, etc)
@@ -177,6 +179,16 @@ If Petstore owners decide to remove method we use, then after running `swaggie`
 
 Without this approach, the error would be spotted by our end-user and he/she would not appreciate it at all!
 
+## Server config
+
+You might wonder how to set up server to fully utilize Swaggie's features. For that I've added a `samples/` folder with sample configurations.
+
+[ASP.NET Core + Nswag](./samples/dotnetcore/nswag/README.md)
+
+[ASP.NET Core + Swashbuckle](./samples/dotnetcore/swashbuckle/README.md)
+
+Server is not necessary to use Swaggie. Swaggie cares only about the JSON/yaml file with the Open API spec, but for your development purpose you might want to have a server that can serve this file automatically from the actual endpoints.
+
 ## Notes
 
 If you are familiar with the client-code generators for the Swagger / OpenAPI standards then you might wonder why `swaggie` is better than existing tools. Currently the most popular alternative is an open-source `NSwag`.

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-"use strict"; function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+"use strict";
 var _commander = require('commander');
-var _chalk = require('chalk'); var _chalk2 = _interopRequireDefault(_chalk);
+var _nanocolors = require('nanocolors');
 
 var _index = require('./index');
 
@@ -52,6 +52,6 @@ function complete(spec) {
 
 function error(e) {
   const msg = e instanceof Error ? e.message : e;
-  console.error(_chalk2.default.red(msg));
+  console.error(_nanocolors.red.call(void 0, msg));
   process.exit(1);
 }

package/dist/gen/js/genTypes.js

@@ -1,6 +1,6 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _util = require('../util');
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _lodash = require('lodash');
+var _util = require('../util');
 var _support = require('./support');
-var _lodash = require('lodash');
 
 
  function genTypes(
@@ -56,10 +56,9 @@ function renderTsType(name, def, options, typeToBeGeneric) {
 
   const lines = [];
   if (def.description) {
-    lines.push(`/**`);
-    lines.push(_support.DOC + def.description.trim().replace(/\n/g, `\n${_support.DOC}${_support.SP}`));
-    lines.push(` */`);
+    lines.push(renderComment(def.description));
   }
+
   if (!!def['x-enumNames']) {
     lines.push(renderXEnumType(name, def));
     return lines;
@@ -90,8 +89,7 @@ function renderTsType(name, def, options, typeToBeGeneric) {
     _util.join.call(void 0, lines, requiredPropLines);
     _util.join.call(void 0, lines, optionalPropLines);
   }
-  lines.push('}');
-  lines.push('');
+  lines.push('}\n');
   return lines;
 }
 
@@ -178,10 +176,11 @@ function renderTsInheritance(name, allOf, options) {
   const ref = allOf[0];
   const parentName = ref.$ref.split('/').pop();
   const lines = renderTsType(name, allOf[1], options);
-  if (lines[0].startsWith('export interface')) {
-    lines.shift();
+  const interfaceLineIndex = lines.findIndex((l) => l.indexOf('export interface') === 0);
+  if (interfaceLineIndex > -1) {
+    // Let's replace generic interface definition with more specific one with inheritance info
+    lines[interfaceLineIndex] = `export interface ${name} extends ${parentName} {`;
   }
-  lines.unshift(`export interface ${name} extends ${parentName} {`);
   return lines;
 }
 
@@ -198,48 +197,11 @@ function renderTsTypeProp(
     type = type.replace(typeToBeGeneric, 'T');
   }
   if (info.description) {
-    lines.push(`${_support.SP}/**`);
-    lines.push(
-      `${_support.SP}${_support.DOC}` + (info.description || '').trim().replace(/\n/g, `\n${_support.SP}${_support.DOC}${_support.SP}`)
-    );
-    lines.push(`${_support.SP} */`);
+    lines.push(renderComment(info.desciption));
   }
   const req = required ? '' : '?';
-  lines.push(`${_support.SP}${prop}${req}: ${type};`);
-  return lines;
-}
-
-function renderTypeDoc(name, def) {
-  if (def.allOf) {
-    return renderDocInheritance(name, def.allOf);
-  }
-  if (def.type !== 'object') {
-    console.warn(`Unable to render ${name} ${def.type}, skipping.`);
-    return [];
-  }
-
-  const lines = ['/**', `${_support.DOC}@typedef ${name}`];
-  const req = def.required || [];
-  const propLines = Object.keys(def.properties).map((prop) => {
-    const info = def.properties[prop];
-    const description = (info.description || '').trim().replace(/\n/g, `\n${_support.DOC}${_support.SP}`);
-    return `${_support.DOC}@property {${_support.getDocType.call(void 0, info)}} ${prop} ${description}`;
-  });
-  if (propLines.length) {
-    lines.push(`${_support.DOC}`);
-  }
-  _util.join.call(void 0, lines, propLines);
-  lines.push(' */');
-  lines.push('');
-  return lines;
-}
+  lines.push(`  ${prop}${req}: ${type};`);
 
-function renderDocInheritance(name, allOf) {
-  verifyAllOf(name, allOf);
-  const ref = allOf[0];
-  const parentName = ref.$ref.split('/').pop();
-  const lines = renderTypeDoc(name, allOf[1]);
-  lines.splice(3, 0, `${_support.DOC}@extends ${parentName}`);
   return lines;
 }
 
@@ -277,3 +239,17 @@ function unwrapDefinitions(definitions) {
 
   return result;
 }
+
+ function renderComment(comment) {
+  if (!comment) {
+    return null;
+  }
+
+  const commentLines = comment.split('\n');
+
+  if (commentLines.length === 1) {
+    return '// ' + comment.trim();
+  }
+
+  return ' /**\n' + commentLines.map((line) => '  * ' + line.trim()).join('\n') + '\n  */';
+} exports.renderComment = renderComment;

package/dist/gen/js/support.js

@@ -1,44 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); const DOC = ' * '; exports.DOC = DOC;
- const DEFAULT_SP = '  '; exports.DEFAULT_SP = DEFAULT_SP;
- let SP = exports.DEFAULT_SP; exports.SP = SP;
-
- function formatDocDescription(description) {
-  return (description || '').trim().replace(/\n/g, `\n${exports.DOC}${exports.SP}`);
-} exports.formatDocDescription = formatDocDescription;
-
- function getDocType(param, options) {
-  if (!param) {
-    return 'object';
-  } else if (param.$ref) {
-    const type = param.$ref.split('/').pop();
-    return `module:${type}`;
-  } else if (param.schema) {
-    return getDocType(param.schema, options);
-  } else if (param['x-schema']) {
-    return getDocType(param['x-schema'], options);
-  } else if (param.type === 'array') {
-    if (param.items.type) {
-      return `${getDocType(param.items, options)}[]`;
-    } else if (param.items.$ref) {
-      const type = param.items.$ref.split('/').pop();
-      return `module:${type}[]`;
-    } else {
-      return 'object[]';
-    }
-  } else if (param.type === 'integer' || param.type === 'number') {
-    return 'number';
-  } else if (param.type === 'string' && (param.format === 'date-time' || param.format === 'date')) {
-    return options && options.dateFormat === 'string' ? 'string' : 'Date';
-  } else if (param.type === 'string') {
-    return 'string';
-  } else if (param.type === 'boolean') {
-    return 'boolean';
-  } else {
-    return 'object';
-  }
-} exports.getDocType = getDocType;
-
- function getTSParamType(param, options) {
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function getTSParamType(param, options) {
   const unknownType = options.preferAny ? 'any' : 'unknown';
 
   if (!param) {
@@ -63,7 +23,7 @@
       if (param.items.enum) {
         return `(${getTSParamType(param.items, options)})[]`;
       } else {
-        return `${getTSParamType(param.items, options)}[]`;
+        return getTSParamType(param.items, options) + '[]';
       }
     } else if (param.items.$ref) {
       const type = param.items.$ref.split('/').pop();

package/dist/index.js

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }var _fs = require('fs'); var _fs2 = _interopRequireDefault(_fs);
-var _chalk = require('chalk'); var _chalk2 = _interopRequireDefault(_chalk);
+var _nanocolors = require('nanocolors');
 
 var _js = require('./gen/js'); var _js2 = _interopRequireDefault(_js);
 
@@ -15,7 +15,7 @@ var _swagger = require('./swagger');
         .then((spec) => gen(spec, options))
         .then(() => {
           console.info(
-            _chalk2.default.bold.cyan(`Api from ${options.src} code generated into ${options.out}`)
+            _nanocolors.cyan.call(void 0, `Api from ${_nanocolors.bold.call(void 0, options.src)} code generated into ${_nanocolors.bold.call(void 0, options.out)}`)
           );
           return true;
         })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swaggie",
-  "version": "0.6.5",
+  "version": "0.6.9-beta",
   "description": "Generate ES6 or TypeScript service integration code from an OpenAPI spec",
   "author": {
     "name": "Piotr Dabrowski",
@@ -16,7 +16,7 @@
     "url": "https://github.com/yhnavein/swaggie/issues"
   },
   "engines": {
-    "node": ">=8.0.0"
+    "node": ">=12.0.0"
   },
   "main": "dist/index.js",
   "bin": {
@@ -25,8 +25,7 @@
   "scripts": {
     "build": "sucrase ./src -d ./dist --transforms typescript,imports && npm run rm-tests",
     "rm-tests": "find dist/ -name '*.spec.js' -type f -delete",
-    "test": "jest --ci",
-    "test:watch": "jest --watch"
+    "test": "mocha 'src/**/*.spec.ts'"
   },
   "files": [
     "dist",
@@ -42,40 +41,25 @@
     "codegen"
   ],
   "dependencies": {
-    "chalk": "^3.0.0",
-    "commander": "^7.2.0",
+    "commander": "^8.3.0",
     "ejs": "^3.1.6",
     "js-yaml": "^4.1.0",
     "lodash": "^4.17.21",
     "mkdirp": "^1.0.3",
-    "node-fetch": "^2.6.1"
+    "nanocolors": "^0.2.0",
+    "node-fetch": "^2.6.3"
   },
   "devDependencies": {
-    "@sucrase/jest-plugin": "2.1.0",
-    "@types/ejs": "3.0.6",
-    "@types/jest": "26.0.23",
-    "@types/js-yaml": "4.0.1",
-    "@types/lodash": "4.14.168",
-    "@types/mkdirp": "^1.0.1",
-    "@types/node": "15.0.1",
-    "@types/node-fetch": "2.5.10",
-    "jest": "26.6.3",
-    "sucrase": "3.18.2",
-    "typescript": "4.2.4"
-  },
-  "jest": {
-    "testRegex": "\\.(test|spec)\\.tsx?$",
-    "transform": {
-      "^.+\\.tsx?$": "@sucrase/jest-plugin"
-    },
-    "testPathIgnorePatterns": [
-      "<rootDir>/node_modules/",
-      "<rootDir>/dist/"
-    ],
-    "testEnvironment": "node",
-    "watchPathIgnorePatterns": [
-      "<rootDir>/node_modules/",
-      "<rootDir>/dist/"
-    ]
+    "@types/chai": "4.2.22",
+    "@types/ejs": "3.1.0",
+    "@types/js-yaml": "4.0.5",
+    "@types/lodash": "4.14.177",
+    "@types/mkdirp": "^1.0.2",
+    "@types/mocha": "9.0.0",
+    "@types/node-fetch": "2.5.3",
+    "chai": "4.3.4",
+    "mocha": "9.1.3",
+    "sucrase": "3.20.3",
+    "typescript": "4.5.2"
   }
 }

package/templates/axios/operation.ejs

@@ -21,7 +21,7 @@
     <%_ if(parameter.original && parameter.original.type === 'array') { -%>
       <%- parameter.name -%>.forEach((f: any) => formDataBody.append("<%- parameter.originalName -%>", f));
     <%_ } else { %>
-      formDataBody.append("<%- parameter.originalName -%>", <%- parameter.name -%>);
+      formDataBody.append("<%- parameter.originalName -%>", <%- parameter.name -%><%- parameter.type !== 'string' && parameter.type !== 'File' && parameter.type !== 'Blob' ? '.toString()' : '' -%>);
     <%_ } %>
     }
 <% });

package/templates/swr-axios/barrel.ejs

@@ -0,0 +1,9 @@
+
+function serializeQueryParam(obj: any) {
+  if (obj === null || obj === undefined) return '';
+  if (obj instanceof Date) return obj.toJSON();
+  if (typeof obj !== 'object' || Array.isArray(obj)) return obj;
+  return Object.keys(obj)
+    .reduce((a: any, b) => a.push(b + '=' + obj[b]) && a, [])
+    .join('&');
+}

package/templates/swr-axios/baseClient.ejs

@@ -0,0 +1,20 @@
+/* tslint:disable */
+/* eslint-disable */
+//----------------------
+// <auto-generated>
+//   Generated using Swaggie (https://github.com/yhnavein/swaggie)
+//   Please avoid doing any manual changes in this file
+// </auto-generated>
+//----------------------
+// ReSharper disable InconsistentNaming
+
+import Axios, { AxiosPromise, AxiosRequestConfig } from "axios";
+import useSWR, { SWRConfiguration } from 'swr';
+
+export const axios = Axios.create({
+  baseURL: '<%- baseUrl || '' -%>',
+});
+
+interface SwrConfig extends SWRConfiguration {
+  axios?: AxiosRequestConfig;
+}

package/templates/swr-axios/client.ejs

@@ -0,0 +1,19 @@
+export const <%- varName -%>Client = {
+  <% operations.forEach(function(operation) { %>
+<%- include('operation', operation); %>
+  <% }); %>
+};
+
+<% var getOperations = operations.filter(function(o) { return o.method == 'GET'; });
+if(getOperations.length > 0) { %>
+  <% getOperations.forEach(function(operation) {
+  var opName = operation.name;
+  if(opName.toLowerCase().startsWith("get")) {
+    opName = opName.substring(3);
+  }
+  opName[0] = opName[0].toUpperCase();
+  var customName = "use" + clientName + opName;
+  var swrOperation = Object.assign({ swrOpName: customName }, operation); %>
+<%- include('swrOperation', swrOperation); %>
+  <% }); %>
+<% } %>

package/templates/swr-axios/operation.ejs

@@ -0,0 +1,58 @@
+  /**<% parameters.forEach(function(parameter) { %>
+   * @param <%- parameter.name -%> <%- parameter.optional ? '(optional)' : '' -%> <%- parameter.name != parameter.originalName ? `(API name: ${parameter.originalName})` : '' -%>
+<% }); %>
+   */
+  <%- name -%>(<% parameters.forEach(function(parameter) { -%>
+  <%- parameter.name -%>: <%- parameter.type -%> <%- parameter.optional ? ' | null | undefined' : '' -%>,
+    <% }); -%>
+  $config?: AxiosRequestConfig
+  ): AxiosPromise<<%- returnType -%>> {
+    let url = '<%- url -%>';
+
+<%_ if(pathParams && pathParams.length > 0) {
+  pathParams.forEach(function(parameter) { -%>
+    url = url.replace('{<%- parameter.name -%>}', encodeURIComponent("" + <%- parameter.name -%>));
+<% });
+} _%>
+<%_ if(formData && formData.length > 0) { _%>
+    const formDataBody = new FormData();
+  <%_ formData.forEach(function(parameter) { -%>
+    if (!!<%- parameter.name -%>) {
+    <%_ if(parameter.original && parameter.original.type === 'array') { -%>
+      <%- parameter.name -%>.forEach((f: any) => formDataBody.append("<%- parameter.originalName -%>", f));
+    <%_ } else { %>
+      formDataBody.append("<%- parameter.originalName -%>", <%- parameter.name -%><%- parameter.type !== 'string' && parameter.type !== 'File' && parameter.type !== 'Blob' ? '.toString()' : '' -%>);
+    <%_ } %>
+    }
+<% });
+} _%>
+
+    return axios.request<<%- returnType -%>>({
+      url: url,
+      method: '<%- method -%>',
+<%_ if(formData && formData.length > 0) { _%>
+      data: formDataBody,
+<%_ } else if(body) { _%>
+      data: <%- body.name -%>,
+<%_ } _%>
+<%_ if(query && query.length > 0) { _%>
+      params: {
+        <% query.forEach(function(parameter) { -%>
+    '<%- parameter.originalName -%>': serializeQueryParam(<%- parameter.name -%>),
+    <% }); -%>
+      },
+<%_ } _%>
+<%_ if(headers && headers.length > 0) { _%>
+      headers: {
+        <% headers.forEach(function(parameter) { -%>
+    <%_ if (parameter.value) { _%>
+    '<%- parameter.originalName -%>': '<%- parameter.value -%>',
+    <%_ } else { _%>
+    '<%- parameter.originalName -%>': <%- parameter.name -%>,
+    <%_ } _%>
+    <% }); -%>
+      },
+<%_ } _%>
+      ...$config,
+    });
+  },

package/templates/swr-axios/swrOperation.ejs

@@ -0,0 +1,51 @@
+  /**<% parameters.forEach(function(parameter) { %>
+   * @param <%- parameter.name -%> <%- parameter.optional ? '(optional)' : '' -%> <%- parameter.name != parameter.originalName ? `(API name: ${parameter.originalName})` : '' -%>
+<% }); %>
+   */
+export function <%- swrOpName -%>(<% parameters.forEach(function(parameter) { -%>
+  <%- parameter.name -%>: <%- parameter.type -%> <%- parameter.optional ? ' | null | undefined' : '' -%>,
+    <% }); -%>
+  $config?: SwrConfig
+  ) {
+  let url = '<%- url -%>';
+  const { axios: $axiosConf, ...config } = $config || {};
+
+<%_ if(pathParams && pathParams.length > 0) {
+  pathParams.forEach(function(parameter) { -%>
+    url = url.replace('{<%- parameter.name -%>}', encodeURIComponent("" + <%- parameter.name -%>));
+<% });
+} _%>
+
+  const { data, error } = useSWR<<%- returnType -%>>(
+    url,
+    () => axios.request({
+      url: url,
+      method: '<%- method -%>',
+<%_ if(query && query.length > 0) { _%>
+      params: {
+        <% query.forEach(function(parameter) { -%>
+    '<%- parameter.originalName -%>': serializeQueryParam(<%- parameter.name -%>),
+    <% }); -%>
+      },
+<%_ } _%>
+<%_ if(headers && headers.length > 0) { _%>
+      headers: {
+        <% headers.forEach(function(parameter) { -%>
+    <%_ if (parameter.value) { _%>
+    '<%- parameter.originalName -%>': '<%- parameter.value -%>',
+    <%_ } else { _%>
+    '<%- parameter.originalName -%>': <%- parameter.name -%>,
+    <%_ } _%>
+    <% }); -%>
+      },
+<%_ } _%>
+    ...$axiosConf})
+    .then((resp) => resp.data),
+  config);
+
+  return {
+    data,
+    isLoading: !error && !data,
+    error: error,
+  };
+}

package/dist/spec/index.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const spec_1 = require("./spec");
-exports.resolveSpec = spec_1.resolveSpec;
-const operations_1 = require("./operations");
-exports.getOperations = operations_1.getOperations;

package/dist/spec/operations.js

@@ -1,103 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const SUPPORTED_METHODS = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch'];
-/**
- * This method converts dictionary-alike operation definition to operation array.
- * Additionally some data inheritance from the specification is done as well
- * @example
- * {
- *  "paths": {
- *    "/api/heartbeat": {
- *      "get": { ... },
- *      "post": { ... }
- *    }
- *  }
- * }
- * @returns
- *  [
- *    { "method": "GET", "path": "/api/heartbeat", ... },
- *    { "method": "POST", "path": "/api/heartbeat", ... },
- *  ]
- */
-function getOperations(spec) {
-    return getPaths(spec).reduce((ops, pathInfo) => ops.concat(getPathOperations(pathInfo, spec)), []);
-}
-exports.getOperations = getOperations;
-function getPaths(spec) {
-    return Object.keys(spec.paths || {}).map((path) => Object.assign({ path }, spec.paths[path]));
-}
-function getPathOperations(pathInfo, spec) {
-    return Object.keys(pathInfo)
-        .filter((key) => !!~SUPPORTED_METHODS.indexOf(key))
-        .map((method) => getPathOperation(method, pathInfo, spec));
-}
-function inheritPathParams(op, spec, pathInfo) {
-    const pathParams = spec.paths[pathInfo.path].parameters;
-    if (pathParams) {
-        pathParams.forEach((pathParam) => {
-            if (!op.parameters.some((p) => p.name === pathParam.name && p.in === pathParam.in)) {
-                op.parameters.push(Object.assign({}, pathParam));
-            }
-        });
-    }
-}
-function getPathOperation(method, pathInfo, spec) {
-    const op = Object.assign({ method, path: pathInfo.path, parameters: [] }, pathInfo[method]);
-    op.id = op.operationId;
-    // if there's no explicit operationId given, create one based on the method and path
-    if (!op.id) {
-        op.id = method + pathInfo.path;
-        op.id = op.id.replace(/[\/{(?\/{)\-]([^{.])/g, (_, m) => m.toUpperCase());
-        op.id = op.id.replace(/[\/}\-]/g, '');
-    }
-    inheritPathParams(op, spec, pathInfo);
-    op.group = getOperationGroupName(op);
-    delete op.operationId;
-    op.responses = getOperationResponses(op);
-    op.security = getOperationSecurity(op, spec);
-    const operation = op;
-    if (operation.consumes) {
-        operation.contentTypes = operation.consumes;
-    }
-    if (operation.produces) {
-        operation.accepts = operation.produces;
-    }
-    delete operation.consumes;
-    delete operation.produces;
-    if (!op.contentTypes || !op.contentTypes.length) {
-        op.contentTypes = spec.contentTypes.slice();
-    }
-    if (!op.accepts || !op.accepts.length) {
-        op.accepts = spec.accepts.slice();
-    }
-    return op;
-}
-function getOperationGroupName(op) {
-    let name = op.tags && op.tags.length ? op.tags[0] : 'default';
-    name = name.replace(/[^$_a-z0-9]+/gi, '');
-    return name.replace(/^[0-9]+/m, '');
-}
-function getOperationResponses(op) {
-    return Object.keys(op.responses || {}).map((code) => {
-        const info = op.responses[code];
-        info.code = code;
-        return info;
-    });
-}
-function getOperationSecurity(op, spec) {
-    let security;
-    if (op.security && op.security.length) {
-        security = op.security;
-    }
-    else if (spec.security && spec.security.length) {
-        security = spec.security;
-    }
-    else {
-        return;
-    }
-    return security.map((def) => {
-        const id = Object.keys(def)[0];
-        const scopes = def[id].length ? def[id] : undefined;
-        return { id, scopes };
-    });
-}

package/dist/spec/spec.js

@@ -1,130 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const js_yaml_1 = __importDefault(require("js-yaml"));
-const got_1 = __importDefault(require("got"));
-function resolveSpec(src, options) {
-    if (!options) {
-        options = {};
-    }
-    if (typeof src === 'string') {
-        return loadFile(src).then((spec) => formatSpec(spec, src, options));
-    }
-    else {
-        return Promise.resolve(formatSpec(src, null, options));
-    }
-}
-exports.resolveSpec = resolveSpec;
-function loadFile(src) {
-    if (/^https?:\/\//im.test(src)) {
-        return loadFromUrl(src);
-    }
-    else if (String(process) === '[object process]') {
-        return readLocalFile(src).then((contents) => parseFileContents(contents, src));
-    }
-    else {
-        throw new Error(`Unable to load api at '${src}'`);
-    }
-}
-function loadFromUrl(url) {
-    return got_1.default(url)
-        .then((resp) => resp.body)
-        .then((contents) => parseFileContents(contents, url));
-}
-function readLocalFile(filePath) {
-    return new Promise((res, rej) => require('fs').readFile(filePath, 'utf8', (err, contents) => (err ? rej(err) : res(contents))));
-}
-function parseFileContents(contents, path) {
-    return /.ya?ml$/i.test(path) ? js_yaml_1.default.safeLoad(contents) : JSON.parse(contents);
-}
-function formatSpec(spec, src, options) {
-    if (!spec.basePath) {
-        spec.basePath = '';
-    }
-    else if (spec.basePath.endsWith('/')) {
-        spec.basePath = spec.basePath.slice(0, -1);
-    }
-    if (src && /^https?:\/\//im.test(src)) {
-        const parts = src.split('/');
-        if (!spec.host) {
-            spec.host = parts[2];
-        }
-        if (!spec.schemes || !spec.schemes.length) {
-            spec.schemes = [parts[0].slice(0, -1)];
-        }
-    }
-    else {
-        if (!spec.host) {
-            spec.host = 'localhost';
-        }
-        if (!spec.schemes || !spec.schemes.length) {
-            spec.schemes = ['http'];
-        }
-    }
-    const s = spec;
-    if (!s.produces || !s.produces.length) {
-        s.accepts = ['application/json']; // give sensible default
-    }
-    else {
-        s.accepts = s.produces;
-    }
-    if (!s.consumes) {
-        s.contentTypes = [];
-    }
-    else {
-        s.contentTypes = s.consumes;
-    }
-    delete s.consumes;
-    delete s.produces;
-    return expandRefs(spec, spec, options);
-}
-/**
- * Recursively expand internal references in the form `#/path/to/object`.
- *
- * @param {object} data the object to search for and update refs
- * @param {object} lookup the object to clone refs from
- * @param {regexp=} refMatch an optional regex to match specific refs to resolve
- * @returns {object} the resolved data object
- */
-function expandRefs(data, lookup, options) {
-    if (!data) {
-        return data;
-    }
-    if (Array.isArray(data)) {
-        return data.map((item) => expandRefs(item, lookup, options));
-    }
-    else if (typeof data === 'object') {
-        if (dataCache.has(data)) {
-            return data;
-        }
-        if (data.$ref && !(options.ignoreRefType && data.$ref.startsWith(options.ignoreRefType))) {
-            const resolved = expandRef(data.$ref, lookup);
-            delete data.$ref;
-            data = Object.assign({}, resolved, data);
-        }
-        dataCache.add(data);
-        // tslint:disable-next-line:forin prefer-const
-        for (let name in data) {
-            data[name] = expandRefs(data[name], lookup, options);
-        }
-    }
-    return data;
-}
-exports.expandRefs = expandRefs;
-function expandRef(ref, lookup) {
-    const parts = ref.split('/');
-    if (parts.shift() !== '#' || !parts[0]) {
-        throw new Error(`Only support JSON Schema $refs in format '#/path/to/ref'`);
-    }
-    let value = lookup;
-    while (parts.length) {
-        value = value[parts.shift()];
-        if (!value) {
-            throw new Error(`Invalid schema reference: ${ref}`);
-        }
-    }
-    return value;
-}
-const dataCache = new Set();