evaengine 0.11.1 → 1.0.0

package/lib/swagger/index.js

@@ -1,684 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ExSwagger = exports.AnnotationsContainer = exports.Annotation = exports.Fragment = exports.MODEL_TO_FRAGMENT_TYPES_MAPPING = exports.YamlParsingException = exports.AcornParsingException = undefined;
-
-var _fs = require('fs');
-
-var _fs2 = _interopRequireDefault(_fs);
-
-var _util = require('util');
-
-var _assert = require('assert');
-
-var _assert2 = _interopRequireDefault(_assert);
-
-var _merge = require('lodash/merge');
-
-var _merge2 = _interopRequireDefault(_merge);
-
-var _doctrine = require('doctrine');
-
-var _doctrine2 = _interopRequireDefault(_doctrine);
-
-var _acorn = require('acorn/dist/acorn');
-
-var acorn = _interopRequireWildcard(_acorn);
-
-var _glob = require('glob');
-
-var _glob2 = _interopRequireDefault(_glob);
-
-var _jsYaml = require('js-yaml');
-
-var _jsYaml2 = _interopRequireDefault(_jsYaml);
-
-var _entities = require('../entities');
-
-var _entities2 = _interopRequireDefault(_entities);
-
-var _exceptions = require('../exceptions');
-
-function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) newObj[key] = obj[key]; } } newObj.default = obj; return newObj; } }
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-function _asyncToGenerator(fn) { return function () { var gen = fn.apply(this, arguments); return new Promise(function (resolve, reject) { function step(key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { return Promise.resolve(value).then(function (value) { step("next", value); }, function (err) { step("throw", err); }); } } return step("next"); }); }; } /*eslint new-cap: [1]*/
-
-
-let AcornParsingException = exports.AcornParsingException = class AcornParsingException extends _exceptions.StandardException {};
-let YamlParsingException = exports.YamlParsingException = class YamlParsingException extends _exceptions.StandardException {
-  /**
-   * @param {Annotation} annotation
-   * @returns {YamlParsingException}
-   */
-  setAnnotation(annotation) {
-    this.annotation = annotation || {};
-    return this;
-  }
-
-  /**
-   * @returns {Annotation}
-   */
-  getAnnotation() {
-    return this.annotation || {};
-  }
-
-  toString() {
-    const {
-      file, start, end, value
-    } = this.getAnnotation();
-    return (0, _util.format)('Yaml parsing error happened in %s Line[%s - %s]\n Yaml error: %s \nOriginal Yaml Text:', file, start, end, this.getPrevError() ? this.getPrevError().message : '', value ? value.split('\n').map((v, i) => `${(i - 1).toString().padStart(5)} ${v}`) : []);
-  }
-
-  constructor(...args) {
-    super(...args);
-    this.annotation = {};
-  }
-};
-
-//Mapping sequelize data types to swagger data types
-//Sequelize types: http://docs.sequelizejs.com/en/latest/api/datatypes/
-//Swagger Data Types: http://swagger.io/specification/
-
-const MODEL_TO_FRAGMENT_TYPES_MAPPING = exports.MODEL_TO_FRAGMENT_TYPES_MAPPING = {
-  BIGINT: 'integer',
-  ENUM: 'string',
-  INTEGER: 'integer',
-  FLOAT: 'number',
-  DOUBLE: 'number',
-  DECIMAL: 'number',
-  BOOLEAN: 'boolean',
-  CHAR: 'string',
-  STRING: 'string',
-  TEXT: 'string',
-  REAL: 'string',
-  TIME: 'string',
-  DATE: 'string',
-  DATEONLY: 'string',
-  HSTORE: 'string',
-  JSON: 'string',
-  JSONB: 'string',
-  NOW: 'string',
-  BLOB: 'string',
-  UUID: 'string',
-  UUIDV1: 'string',
-  UUIDV4: 'string',
-  VIRTUAL: 'string'
-};
-
-const modelDefaultValueHandlers = {
-  integer: v => parseInt(v, 10),
-  boolean: v => Boolean(parseInt(v, 10)),
-  number: v => parseFloat(v),
-  default: v => v
-};
-
-const FRAGMENT_TYPE_PATH = 'path';
-const FRAGMENT_TYPE_DEFINITION = 'definition';
-const FRAGMENT_TYPE_EXCEPTION = 'exception';
-const FRAGMENT_TYPE_UNKNOWN = 'unknown';
-
-let Fragment = exports.Fragment = class Fragment {
-  /**
-   * @returns {[*,*,*,*]}
-   */
-  getTypes() {
-    return [FRAGMENT_TYPE_PATH, FRAGMENT_TYPE_DEFINITION, FRAGMENT_TYPE_EXCEPTION, FRAGMENT_TYPE_UNKNOWN];
-  }
-
-  isPath() {
-    return this.type === FRAGMENT_TYPE_PATH;
-  }
-
-  isDefinition() {
-    return this.type === FRAGMENT_TYPE_DEFINITION;
-  }
-
-  isUnknown() {
-    return this.type === FRAGMENT_TYPE_UNKNOWN;
-  }
-
-  isException() {
-    return this.type === FRAGMENT_TYPE_EXCEPTION;
-  }
-
-  /**
-   * @param {Fragment} fragment
-   * @returns {Fragment}
-   */
-  setParentFragment(fragment) {
-    (0, _assert2.default)(fragment && fragment instanceof Fragment, 'Parent fragment must be instance of Fragment');
-    this.parent = fragment;
-    return this;
-  }
-
-  /**
-   * @returns {null|Fragment}
-   */
-  getParentFragment() {
-    return this.parent;
-  }
-
-  correctSwaggerPath(swaggerDoc = {}) {
-    return swaggerDoc;
-  }
-
-  toSwaggerDoc(exceptions = {}) {
-    if (this.isPath()) {
-      const path = Object.keys(this.value)[0];
-      const method = Object.keys(this.value[path])[0];
-      return {
-        paths: {
-          [path]: {
-            [method]: this.correctSwaggerPath(this.value[path][method])
-          }
-        }
-      };
-    }
-
-    if (this.isDefinition()) {
-      const key = Object.keys(this.value)[0];
-      return {
-        definitions: {
-          [key]: this.value[key]
-        }
-      };
-    }
-
-    if (!this.isUnknown()) {
-      return {};
-    }
-
-    if (this.isException()) {
-      if (!this.getParentFragment()) {
-        return {};
-      }
-      const key = this.value;
-      const exception = exceptions[key];
-      if (!exception) {
-        return {};
-      }
-
-      const path = Object.keys(this.getParentFragment().value)[0];
-      const method = Object.keys(this.getParentFragment().value[path])[0];
-      return {
-        definitions: {
-          [key]: Fragment.exceptionMapping(exception)
-        },
-        paths: {
-          [path]: {
-            [method]: {
-              responses: {
-                [exception.getStatusCode()]: {
-                  description: this.description,
-                  schema: {
-                    $ref: `#/definitions/${key}`
-                  }
-                }
-              }
-            }
-          }
-        }
-      };
-    }
-
-    return {};
-  }
-
-  static exceptionMapping(exception) {
-    return {
-      properties: {
-        code: {
-          type: 'integer',
-          format: 'int64'
-        },
-        message: {
-          type: 'string'
-        }
-      },
-      required: ['code', 'message'],
-      example: {
-        code: exception.getCode(),
-        message: exception.message
-      }
-    };
-  }
-
-  /**
-   * @param jsdoc
-   * @param {Annotation} annotation
-   * @returns {Fragment}
-   */
-  static factory(jsdoc, annotation) {
-    const { title, description, type } = jsdoc;
-    if (title === 'throws') {
-      return new Fragment({
-        type: FRAGMENT_TYPE_EXCEPTION,
-        description,
-        value: type ? type.name : FRAGMENT_TYPE_UNKNOWN,
-        file: annotation.file,
-        start: annotation.start,
-        end: annotation.end
-      });
-    }
-
-    let elementType = FRAGMENT_TYPE_UNKNOWN;
-    const value = _jsYaml2.default.load(description);
-    const key = Object.keys(value)[0];
-    if (title === 'swagger') {
-      elementType = key.startsWith('/') ? FRAGMENT_TYPE_PATH : FRAGMENT_TYPE_DEFINITION;
-    }
-    return new Fragment({
-      type: elementType,
-      description,
-      value,
-      file: annotation.file,
-      start: annotation.start,
-      end: annotation.end
-    });
-  }
-
-  constructor({
-    type, description, value, file, start, end
-  }) {
-    (0, _assert2.default)(type && description && value && file && start && end, 'Fragment require type && description && value && file && start && end');
-    (0, _assert2.default)(this.getTypes().includes(type), 'Fragment types not match input');
-    this.type = type;
-    this.description = description;
-    this.value = value;
-    this.file = file;
-    this.start = start;
-    this.end = end;
-    this.parent = null;
-  }
-};
-let Annotation = exports.Annotation = class Annotation {
-  /**
-   * @returns {Array<Fragment>}
-   */
-  getFragments() {
-    if (this.fragments) {
-      return this.fragments;
-    }
-    //支持两种注解:
-    //1. 所有行首必定为 space*
-    //2. 所有行首必定不为 space*
-    const unwrap = this.value.startsWith('*\n *');
-    const { tags: jsDocs = [] } = _doctrine2.default.parse(this.value, { unwrap });
-    if (jsDocs.length < 1) {
-      return [];
-    }
-
-    /**
-     * @type {Array<Fragment>}
-     */
-    const fragments = [];
-    jsDocs.filter(jsDoc => jsDoc.title && (jsDoc.title === 'swagger' || jsDoc.title === 'throws') && jsDoc.description).forEach(jsDoc => {
-      try {
-        fragments.push(Fragment.factory(jsDoc, this));
-      } catch (e) {
-        this.yamlErrors.push(new YamlParsingException(e).setAnnotation(this));
-      }
-    });
-
-    fragments.forEach(fragment => {
-      if (fragment.isException()) {
-        fragment.setParentFragment(fragments.filter(f => f.isPath())[0]);
-      }
-    });
-
-    this.fragments = fragments;
-    return fragments;
-  }
-
-  toString() {
-    return (0, _util.format)('Annotation %s [%s - %s]: %s', this.file, this.start, this.end, this.value);
-  }
-
-  getYamlErrors() {
-    return this.yamlErrors;
-  }
-
-  constructor({
-    type, //Block
-    value, //Long string
-    file, //String
-    start,
-    end
-  }) {
-    (0, _assert2.default)(type && type === 'Block', 'Annotation type must be Block');
-    (0, _assert2.default)(value && typeof value === 'string', 'Annotation value must be Block');
-    (0, _assert2.default)(file, 'Annotation must have file');
-    this.value = value;
-    this.file = file;
-    this.start = start;
-    this.end = end;
-    this.yamlErrors = [];
-    this.fragments = null;
-  }
-};
-let AnnotationsContainer = exports.AnnotationsContainer = class AnnotationsContainer {
-  /**
-   * @returns {string}
-   */
-  getFile() {
-    return this.file;
-  }
-
-  /**
-   * @returns {boolean}
-   */
-  hasAnnotations() {
-    return this.annotations.length > 0;
-  }
-
-  /**
-   * @returns {Array<Annotation>}
-   */
-  getAnnotations() {
-    return this.annotations;
-  }
-
-  /**
-   * @returns {Array.<Fragment>}
-   */
-  collectFragments() {
-    if (this.fragments.length > 0) {
-      return this.fragments;
-    }
-
-    for (const annotation of this.getAnnotations()) {
-      this.fragments = this.fragments.concat(annotation.getFragments());
-    }
-
-    return this.fragments;
-  }
-
-  /**
-   * @returns {Array}
-   */
-  collectYamlErrors() {
-    let errors = [];
-    for (const annotation of this.getAnnotations()) {
-      errors = errors.concat(annotation.getYamlErrors());
-    }
-    return errors;
-  }
-
-  constructor(file, acornComments) {
-    (0, _assert2.default)(file && typeof file === 'string', 'Annotations require a file input');
-    (0, _assert2.default)(acornComments && Array.isArray(acornComments), `Annotations for ${file} require an array of Acorn comments input`);
-    this.file = file;
-    //Annotations MUST start with double stars
-    this.annotations = acornComments.filter(v => v.type === 'Block' && v.value.startsWith('*\n')).map(c => new Annotation(Object.assign(c, { file })));
-    this.fragments = [];
-  }
-};
-
-/**
- * A Swagger Json document generator
- * Generate document from
- * - JS source code annotations (Parser is Doctrine)
- * - ORM entities (Based on Sequelize)
- * - EvaEngine Exceptions
- */
-
-let ExSwagger = exports.ExSwagger = class ExSwagger {
-  /**
-   * Get file path array by glob
-   * @param path
-   * @param options
-   * @returns {Promise|Array.<string>}
-   */
-  static scanFiles(path, options = {}) {
-    return _asyncToGenerator(function* () {
-      return new Promise(function (resolve, reject) {
-        (0, _glob2.default)(path, options, function (err, files) {
-          if (err) {
-            return reject(err);
-          }
-          return resolve(files);
-        });
-      });
-    })();
-  }
-
-  /**
-   * Get annotations from comments
-   * An annotation MUST start with double stars
-   * @param files {Array.<string>}
-   * @returns {Array.<AnnotationsContainer>}
-   */
-  static filesToAnnotationsContainers(files) {
-    return _asyncToGenerator(function* () {
-      const results = [];
-      for (const file of files) {
-        const comments = [];
-        const source = yield _fs2.default.readFileSync(file);
-        try {
-          acorn.parse(source, {
-            ecmaVersion: 9,
-            allowImportExportEverywhere: true,
-            onComment: comments
-          });
-        } catch (e) {
-          throw new AcornParsingException(`Acorn parsing file ${file} failed`).setPrevError(e);
-        }
-
-        results.push(new AnnotationsContainer(file, comments));
-      }
-      return results;
-    })();
-  }
-
-  static modelToSwaggerDefinition(model) {
-    const definition = {
-      type: 'object',
-      properties: {}
-    };
-    const requires = [];
-    Object.keys(model).forEach(columnName => {
-      const column = model[columnName];
-      const swaggerType = MODEL_TO_FRAGMENT_TYPES_MAPPING[column.type.key];
-      const property = {
-        type: swaggerType,
-        description: column.comment
-      };
-      if (column.defaultValue) {
-        const defaultValueHandler = modelDefaultValueHandlers[swaggerType] ? modelDefaultValueHandlers[swaggerType] : modelDefaultValueHandlers.default;
-        property.default = defaultValueHandler(column.defaultValue);
-      }
-      if (column.allowNull === false) {
-        requires.push(columnName);
-      }
-      definition.properties[columnName] = property;
-    });
-    definition.required = requires;
-    return definition;
-  }
-
-  static modelsToSwaggerDefinitions(models, blacklist = []) {
-    const definitions = new Map();
-    Object.keys(models).forEach(modelName => {
-      if (blacklist.includes(modelName)) {
-        return true;
-      }
-      const definition = ExSwagger.modelToSwaggerDefinition(models[modelName].attributes);
-      definitions.set(modelName, definition);
-      return true;
-    });
-    return definitions;
-  }
-
-  static scanExceptions(path, exceptionInterface = Error) {
-    return _asyncToGenerator(function* () {
-      const exceptions = {};
-      const files = yield ExSwagger.scanFiles(path);
-      if (files.length < 1) {
-        return exceptions;
-      }
-      for (const file of files) {
-        const exceptionsInFile = require(file); //eslint-disable-line
-        Object.keys(exceptionsInFile).forEach(function (exceptionName) {
-          const exceptionClass = exceptionsInFile[exceptionName];
-          const exception = new exceptionClass(exceptionName); //eslint-disable-line new-cap
-          if (exception instanceof exceptionInterface) {
-            exceptions[exceptionName] = exception;
-          }
-        });
-      }
-      return exceptions;
-    })();
-  }
-
-  exportJson(dist = this.swaggerDocsPath) {
-    var _this = this;
-
-    return _asyncToGenerator(function* () {
-      _this.logger.debug('Start export swagger docs by meta %j', _this.getStates());
-      const fileGroups = yield Promise.all(_this.sourceFilesPath.map(function (path) {
-        return ExSwagger.scanFiles(path);
-      }));
-      let files = [];
-      fileGroups.forEach(function (fileGroup) {
-        files = files.concat(fileGroup);
-      });
-      if (!files || files.length < 1) {
-        throw new _exceptions.RuntimeException('No swagger source files found');
-      }
-      _this.logger.debug('Scanner will scan %s files under %j:', files.length, _this.sourceFilesPath);
-
-      const annotationsContainers = yield ExSwagger.filesToAnnotationsContainers(files);
-      let fragments = [];
-      annotationsContainers.forEach(function (annotationsContainer) {
-        if (!annotationsContainer.hasAnnotations()) {
-          return false;
-        }
-        const annotationFragments = annotationsContainer.collectFragments();
-        fragments = fragments.concat(annotationFragments);
-        _this.logger.debug('Scanner found %s annotations and collected %s fragments in file %s', annotationsContainer.getAnnotations().length.toString().padStart(3), annotationFragments.length.toString().padStart(3), annotationsContainer.getFile());
-
-        const yamlErrors = annotationsContainer.collectYamlErrors();
-        yamlErrors.forEach(function (yamlError) {
-          return _this.logger.error(yamlError);
-        });
-        return true;
-      });
-
-      _this.logger.debug('Scanner collected %s fragments in total', fragments.length);
-
-      const template = _this.swaggerDocsTemplate;
-      const exceptions = {};
-      for (const exceptionPath of _this.exceptionPaths) {
-        _this.logger.debug('Search exception in %s', exceptionPath);
-        const exceptionsInFile = yield ExSwagger.scanExceptions(exceptionPath, _this.exceptionInterface);
-        Object.assign(exceptions, exceptionsInFile);
-        _this.logger.debug('Scanner found %s exceptions', Object.keys(exceptions).length, Object.keys(exceptions));
-      }
-      const modelDefinitions = _this.models ? ExSwagger.modelsToSwaggerDefinitions(_this.models, _this.modelBlacklist) : new Map();
-      const swaggerDocs = ExSwagger.mergeAll(template, fragments, exceptions, modelDefinitions);
-      _this.logger.debug('Export to', dist);
-      yield _fs2.default.writeFileSync(dist, JSON.stringify(swaggerDocs));
-      return swaggerDocs;
-    })();
-  }
-
-  /**
-   * @param _template
-   * @param {Array<Fragment>} fragments
-   * @param exceptions
-   * @param modelDefinitions
-   * @returns {*}
-   */
-  static mergeAll(_template, fragments, exceptions, modelDefinitions) {
-    const template = _template;
-    fragments.forEach(fragment => (0, _merge2.default)(template, fragment.toSwaggerDoc(exceptions)));
-    if (modelDefinitions) {
-      modelDefinitions.forEach((definition, modelName) => {
-        template.definitions[modelName] = definition;
-      });
-    }
-    return template;
-  }
-
-  getStates() {
-    return {
-      swaggerTemplate: this.swaggerDocsTemplate,
-      modelBlacklist: this.modelBlacklist,
-      sourceFilesPath: this.sourceFilesPath,
-      exceptionPaths: this.exceptionPaths,
-      compileDistPath: this.compileDistPath,
-      swaggerUIPath: this.swaggerUIPath,
-      swaggerDocsPath: this.swaggerDocsPath
-    };
-  }
-
-  getSwaggerUIPath() {
-    return this.swaggerUIPath;
-  }
-
-  getSwaggerIndexHtml() {
-    var _this2 = this;
-
-    return _asyncToGenerator(function* () {
-      const uiPath = _this2.getSwaggerUIPath();
-      const content = yield _fs2.default.readFileSync(`${uiPath}/index.html`);
-      return content.toString().replace('https://petstore.swagger.io/v2/swagger.json', _this2.swaggerDocsPath.replace(_this2.compileDistPath, ''));
-    })();
-  }
-
-  getCompileDistPath() {
-    return this.compileDistPath;
-  }
-
-  constructor({
-    sourceRootPath,
-    compileDistPath,
-    models,
-    modelBlacklist = [],
-    swaggerDocsTemplate,
-    logger,
-    swaggerUIPath,
-    swaggerDocsPath = `${compileDistPath}/docs.json`,
-    sourceFilesPath = `${sourceRootPath}/**/*.js`,
-    exceptionInterface = _exceptions.StandardException,
-    extraSourcePaths = [`${__dirname}/../utils/**/*.js`],
-    exceptionPaths
-  }) {
-    this.logger = logger || {
-      debug: () => {},
-      warn: () => {},
-      error: () => {}
-    };
-
-    if (!swaggerDocsTemplate) {
-      throw new _exceptions.RuntimeException('No swagger docs template input');
-    }
-    this.swaggerDocsTemplate = swaggerDocsTemplate;
-    if (models && !(models instanceof _entities2.default)) {
-      throw new _exceptions.RuntimeException('Input models must instance of engine.Entities');
-    }
-    this.models = models ? models.getAll() : null;
-    this.modelBlacklist = modelBlacklist;
-
-    this.sourceFilesPath = Array.isArray(sourceFilesPath) ? extraSourcePaths.concat(sourceFilesPath) : extraSourcePaths.concat([sourceFilesPath]);
-    this.exceptionPaths = exceptionPaths ? [`${__dirname}/../exceptions`].concat(exceptionPaths) : [`${__dirname}/../exceptions`];
-    this.exceptionInterface = exceptionInterface;
-    this.compileDistPath = compileDistPath;
-    if (swaggerUIPath) {
-      this.swaggerUIPath = swaggerUIPath;
-    } else {
-      this.swaggerUIPath = `${__dirname}/../../node_modules/swagger-ui-dist`;
-      try {
-        _fs2.default.accessSync(this.swaggerUIPath, _fs2.default.F_OK);
-      } catch (e) {
-        this.swaggerUIPath = `${__dirname}/../../../swagger-ui-dist`; //For NPM v3.x
-      }
-    }
-    this.swaggerDocsPath = swaggerDocsPath;
-  }
-};
-//# sourceMappingURL=index.js.map