evaengine 1.0.14 → 3.0.0

package/dist/swagger/index.js

@@ -0,0 +1,564 @@
+/*eslint new-cap: [1]*/
+import fs, {} from 'fs';
+import { createRequire, stripTypeScriptTypes } from 'module';
+import { format } from 'util';
+import assert from 'assert';
+import merge from 'lodash/merge.js';
+import * as doctrine from 'doctrine';
+import * as acorn from 'acorn';
+import * as yaml from 'js-yaml';
+import Entitles from "../entities/index.js";
+import { RuntimeException, StandardException } from "../exceptions/index.js";
+const require = createRequire(import.meta.url);
+export class AcornParsingException extends StandardException {
+}
+export class YamlParsingException extends StandardException {
+    annotation;
+    setAnnotation(annotation) {
+        this.annotation = annotation || {};
+        return this;
+    }
+    getAnnotation() {
+        return this.annotation || {};
+    }
+    toString() {
+        const { file, start, end, value } = this.getAnnotation();
+        return format('Yaml parsing error happened in %s Line[%s - %s]\n Yaml error: %s \nOriginal Yaml Text:', file, start, end, 
+        // getPrevError() 为 unknown，这里只读取其 message 字段
+        this.getPrevError() ? this.getPrevError().message : '', value ? value.split('\n').map((v, i) => `${(i - 1).toString().padStart(5)} ${v}`) : []);
+    }
+    constructor(exceptionOrMsg) {
+        super(exceptionOrMsg);
+        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/
+export const 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'
+};
+// column.defaultValue 运行时可能为任意标量，parseInt/parseFloat 依赖 JS 的隐式转字符串
+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';
+export class Fragment {
+    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;
+    }
+    setParentFragment(fragment) {
+        assert(fragment && fragment instanceof Fragment, 'Parent fragment must be instance of Fragment');
+        this.parent = fragment;
+        return this;
+    }
+    getParentFragment() {
+        return this.parent;
+    }
+    correctSwaggerPath(swaggerDoc = {}) {
+        return swaggerDoc;
+    }
+    toSwaggerDoc(exceptions = {}) {
+        if (this.isPath()) {
+            // path 片段的 value 形如 { '/path': { get: {...} } }
+            const pathValue = this.value;
+            const path = Object.keys(pathValue)[0];
+            const method = Object.keys(pathValue[path])[0];
+            return {
+                paths: {
+                    [path]: {
+                        [method]: this.correctSwaggerPath(pathValue[path][method])
+                    }
+                }
+            };
+        }
+        if (this.isDefinition()) {
+            const definitionValue = this.value;
+            const key = Object.keys(definitionValue)[0];
+            return {
+                definitions: {
+                    [key]: definitionValue[key]
+                }
+            };
+        }
+        if (this.isException()) {
+            if (!this.getParentFragment()) {
+                return {};
+            }
+            const key = this.value;
+            const exception = exceptions[key];
+            if (!exception) {
+                return {};
+            }
+            // 上方已断言 parent 存在
+            const parent = this.getParentFragment();
+            const parentValue = parent.value;
+            const path = Object.keys(parentValue)[0];
+            const method = Object.keys(parentValue[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
+            }
+        };
+    }
+    static factory(jsdoc, annotation) {
+        const { title, description, type } = jsdoc;
+        if (title === 'throws') {
+            return new Fragment({
+                type: FRAGMENT_TYPE_EXCEPTION,
+                description: description,
+                // doctrine 的 type 字段为 unknown，这里只读取引用类型的 name；缺失时由 Fragment 构造器 assert 抛出
+                value: type ? type.name : FRAGMENT_TYPE_UNKNOWN,
+                file: annotation.file,
+                start: annotation.start,
+                end: annotation.end
+            });
+        }
+        let elementType = FRAGMENT_TYPE_UNKNOWN;
+        // yaml.load 返回 unknown；swagger 注解的 description 是一个 yaml 对象
+        const value = yaml.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: description,
+            value,
+            file: annotation.file,
+            start: annotation.start,
+            end: annotation.end
+        });
+    }
+    type;
+    description;
+    value;
+    file;
+    start;
+    end;
+    parent;
+    constructor({ type, description, value, file, start, end }) {
+        assert(type && description && value && file && start && end, 'Fragment require type && description && value && file && start && end');
+        assert(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;
+    }
+}
+export class Annotation {
+    getFragments() {
+        if (this.fragments) {
+            return this.fragments;
+        }
+        //支持两种注解:
+        //1. 所有行首必定为 space*
+        //2. 所有行首必定不为 space*
+        const unwrap = this.value.startsWith('*\n *');
+        const { tags: jsDocs = [] } = doctrine.parse(this.value, { unwrap });
+        if (jsDocs.length < 1) {
+            return [];
+        }
+        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) {
+                // catch 变量为 unknown；StandardException 构造器会自行校验入参类型
+                this.yamlErrors.push((new YamlParsingException(e)).setAnnotation(this));
+            }
+        });
+        fragments.forEach((fragment) => {
+            if (fragment.isException()) {
+                // 找不到 path 片段时由 setParentFragment 内的 assert 按原逻辑抛错
+                fragment.setParentFragment(fragments.filter(f => f.isPath())[0]);
+            }
+        });
+        this.fragments = fragments;
+        return fragments;
+    }
+    toString() {
+        return format('Annotation %s [%s - %s]: %s', this.file, this.start, this.end, this.value);
+    }
+    getYamlErrors() {
+        return this.yamlErrors;
+    }
+    value;
+    file;
+    start;
+    end;
+    yamlErrors;
+    fragments;
+    constructor({ type, //Block
+    value, //Long string
+    file, //String
+    start, end }) {
+        assert(type && type === 'Block', 'Annotation type must be Block');
+        assert(value && typeof value === 'string', 'Annotation value must be Block');
+        assert(file, 'Annotation must have file');
+        this.value = value;
+        this.file = file;
+        this.start = start;
+        this.end = end;
+        this.yamlErrors = [];
+        this.fragments = null;
+    }
+}
+export class AnnotationsContainer {
+    getFile() {
+        return this.file;
+    }
+    hasAnnotations() {
+        return this.annotations.length > 0;
+    }
+    getAnnotations() {
+        return this.annotations;
+    }
+    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;
+    }
+    collectYamlErrors() {
+        let errors = [];
+        for (const annotation of this.getAnnotations()) {
+            errors = errors.concat(annotation.getYamlErrors());
+        }
+        return errors;
+    }
+    file;
+    annotations;
+    fragments;
+    constructor(file, acornComments) {
+        assert(file && typeof file === 'string', 'Annotations require a file input');
+        assert(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
+ */
+export class ExSwagger {
+    /**
+     * Get file path array by glob
+     */
+    static async scanFiles(path, options = {}) {
+        return fs.globSync(path, options);
+    }
+    /**
+     * Get annotations from comments
+     * An annotation MUST start with double stars
+     */
+    static async filesToAnnotationsContainers(files) {
+        const results = [];
+        for (const file of files) {
+            const comments = [];
+            const source = await fs.readFileSync(file, 'utf8');
+            // acorn 只支持 JS；TS 源文件先擦除类型语法（strip 模式保留注释，swagger 注解不受影响）
+            const code = /\.(ts|mts|cts)$/.test(file) ? stripTypeScriptTypes(source) : source;
+            try {
+                acorn.parse(code, {
+                    ecmaVersion: 'latest',
+                    sourceType: 'module',
+                    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 model = models[modelName];
+            // attributes 与 rawAttributes 均缺失时保持原行为：由 modelToSwaggerDefinition 的 Object.keys 抛出 TypeError
+            const attributes = (model.attributes || model.rawAttributes);
+            const definition = ExSwagger.modelToSwaggerDefinition(attributes);
+            definitions.set(modelName, definition);
+            return true;
+        });
+        return definitions;
+    }
+    static async scanExceptions(path, exceptionInterface = Error) {
+        const exceptions = {};
+        const files = await ExSwagger.scanFiles(path);
+        if (files.length < 1) {
+            return exceptions;
+        }
+        for (const file of files) {
+            // require(esm) 与 import 共享模块实例，类身份一致；导出内容按 unknown 处理后窄化
+            const exceptionsInFile = require(file);
+            Object.keys(exceptionsInFile).forEach((exceptionName) => {
+                const exceptionClass = exceptionsInFile[exceptionName];
+                const exception = new exceptionClass(exceptionName); //eslint-disable-line new-cap
+                if (exception instanceof exceptionInterface) {
+                    exceptions[exceptionName] = exception;
+                }
+            });
+        }
+        return exceptions;
+    }
+    async exportJson(dist = this.swaggerDocsPath) {
+        this.logger.debug('Start export swagger docs by meta %j', this.getStates());
+        const fileGroups = await Promise
+            .all(this.sourceFilesPath.map(path => ExSwagger.scanFiles(path)));
+        let files = [];
+        fileGroups.forEach((fileGroup) => {
+            files = files.concat(fileGroup);
+        });
+        // 声明文件是构建产物，不是注解来源（发布态 glob 同时命中 .js 与 .d.ts）
+        files = files.filter((file) => !file.endsWith('.d.ts'));
+        if (!files || files.length < 1) {
+            throw new RuntimeException('No swagger source files found');
+        }
+        this.logger.debug('Scanner will scan %s files under %j:', files.length, this.sourceFilesPath);
+        const annotationsContainers = await ExSwagger.filesToAnnotationsContainers(files);
+        let fragments = [];
+        annotationsContainers.forEach((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(yamlError => 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 = await ExSwagger.scanExceptions(exceptionPath, this.exceptionInterface);
+            Object.assign(exceptions, exceptionsInFile);
+            this.logger.debug('Scanner found %s exceptions: %j', 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 %s', dist);
+        await fs.writeFileSync(dist, JSON.stringify(swaggerDocs));
+        return swaggerDocs;
+    }
+    static mergeAll(_template, fragments, exceptions, modelDefinitions) {
+        const template = _template;
+        fragments.forEach(fragment => merge(template, fragment.toSwaggerDoc(exceptions)));
+        if (modelDefinitions) {
+            modelDefinitions.forEach((definition, modelName) => {
+                // definitions 由片段 merge 进模板后存在；类型上对模板内部结构做局部收窄
+                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;
+    }
+    async getSwaggerIndexHtml() {
+        const uiPath = this.getSwaggerUIPath();
+        const content = await fs.readFileSync(`${uiPath}/index.html`);
+        return content.toString().replace('https://petstore.swagger.io/v2/swagger/index.json', this.swaggerDocsPath.replace(this.compileDistPath, ''));
+    }
+    getCompileDistPath() {
+        return this.compileDistPath;
+    }
+    logger;
+    swaggerDocsTemplate;
+    models;
+    modelBlacklist;
+    sourceFilesPath;
+    exceptionPaths;
+    exceptionInterface;
+    compileDistPath;
+    swaggerUIPath;
+    swaggerDocsPath;
+    constructor({ sourceRootPath, compileDistPath, models, modelBlacklist = [], swaggerDocsTemplate, logger, swaggerUIPath, swaggerDocsPath = `${compileDistPath}/docs.json`, sourceFilesPath = `${sourceRootPath}/**/*.js`, exceptionInterface = StandardException, 
+    // 注解扫描在解析前对 TS 文件做类型擦除；{js,ts} 同时命中源码态（src/utils/**/*.ts）与发布态（dist/utils/**/*.js）
+    extraSourcePaths = [
+        `${import.meta.dirname}/../utils/**/*.{js,ts}`
+    ], exceptionPaths }) {
+        this.logger = logger ||
+            {
+                debug: () => {
+                },
+                warn: () => {
+                },
+                error: () => {
+                }
+            };
+        if (!swaggerDocsTemplate) {
+            throw new RuntimeException('No swagger docs template input');
+        }
+        this.swaggerDocsTemplate = swaggerDocsTemplate;
+        if (models && !(models instanceof Entitles)) {
+            throw new 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]);
+        // 原默认值指向 exceptions 目录并依赖 require 的目录解析；TS 源码态文件是 index.ts，须显式指到文件
+        this.exceptionPaths = exceptionPaths ?
+            [`${import.meta.dirname}/../exceptions/index.{js,ts}`].concat(exceptionPaths) : [`${import.meta.dirname}/../exceptions/index.{js,ts}`];
+        this.exceptionInterface = exceptionInterface;
+        this.compileDistPath = compileDistPath;
+        if (swaggerUIPath) {
+            this.swaggerUIPath = swaggerUIPath;
+        }
+        else {
+            this.swaggerUIPath = `${import.meta.dirname}/../../node_modules/swagger-ui-dist`;
+            try {
+                fs.accessSync(this.swaggerUIPath, fs.constants.F_OK);
+            }
+            catch {
+                this.swaggerUIPath = `${import.meta.dirname}/../../../swagger-ui-dist`; //For NPM v3.x
+            }
+        }
+        this.swaggerDocsPath = swaggerDocsPath;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/swagger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/swagger/index.ts"],"names":[],"mappings":"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"}

package/dist/types/express.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Runtime request properties attached by EvaEngine middlewares that are not part
+ * of the express Request contract:
+ * - auth: set by middlewares/auth and middlewares/auth_kong, read by view_cache
+ * - uid: custom per-user cache-key rule fallback read by middlewares/view_cache
+ * Values are produced by consumer login flows or configs, so the payload shape
+ * is intentionally kept open.
+ */
+declare namespace Express {
+  interface Request {
+    auth?: Record<string, unknown>;
+    uid?: unknown;
+  }
+}

package/dist/types/vendor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Hand-written ambient module declarations for dependencies that do not bundle types.
+ * Only the API surface actually used by this package is declared; keep it in sync
+ * when upgrading these dependencies.
+ */
+
+declare module 'doctrine' {
+  export interface AnnotationTag {
+    title: string;
+    description: string | null;
+    [key: string]: unknown;
+  }
+  export interface Annotation {
+    tags: AnnotationTag[];
+    [key: string]: unknown;
+  }
+  export function parse(
+    content: string,
+    options?: { unwrap?: boolean; sloppy?: boolean; [key: string]: unknown }
+  ): Annotation;
+}
+
+/**
+ * yargs ships no types for its "./yargs" entry point (the path engine.ts
+ * imports) and no @types package covers the subpath. Only the shorthand form
+ * works here: a full `declare module 'yargs/yargs' { ... }` block is ignored
+ * because the module resolves to untyped JavaScript. Call shapes that cross
+ * public signatures are typed locally in engine.ts.
+ */
+declare module 'yargs/yargs';