@gct-paas/cli 0.0.1-dev.1 → 0.0.1-dev.10

package/es/actions/gen-api/model-manage.mjs

@@ -0,0 +1,126 @@
+import { ApiManage } from "./api-manage.mjs";
+export class ModelManage {
+  /**
+   * 所有实体模型
+   *
+   * @type {Map<string, IEntityModel>}
+   */
+  entities = /* @__PURE__ */ new Map();
+  /**
+   * 所有用到的实体定义
+   *
+   * @type {Map<string, IObject>}
+   */
+  definitions = /* @__PURE__ */ new Map();
+  /**
+   * 目前接口中的基础数据类型
+   *
+   * @protected
+   */
+  basicDataType = [
+    "any",
+    "number",
+    "string",
+    "null",
+    "boolean",
+    "Void",
+    "object"
+  ];
+  init(tag, cfg) {
+    const apiManage = new ApiManage();
+    const paths = Object.keys(cfg.paths).filter((pathStr) => {
+      return !pathStr.startsWith("/external") || pathStr === "/external/api/tenant/info/byPortOrDomain";
+    });
+    paths.forEach((pathStr) => {
+      const pathCfg = cfg.paths[pathStr];
+      apiManage.add(pathStr, pathCfg);
+    });
+    const entityNames = apiManage.cache.keys();
+    for (const entityName of entityNames) {
+      const entitySet = /* @__PURE__ */ new Set();
+      const entityManage = apiManage.cache.get(entityName);
+      const methods = [];
+      const tags = entityManage.cache.keys();
+      for (const tag2 of tags) {
+        const [methodName, mode] = tag2.split(":");
+        const config = entityManage.cache.get(tag2);
+        let requestEntity = void 0;
+        const param = config.parameters.find((param2) => {
+          if (param2.in === "body") {
+            return param2;
+          }
+        });
+        if (param && param.schema) {
+          const refKey = this.getOriginRef(param.schema);
+          requestEntity = cfg.definitions[refKey];
+          if (requestEntity && Object.keys(requestEntity).length > 0) {
+            this.definitions.set(refKey, requestEntity);
+            entitySet.add(refKey);
+          }
+        }
+        let responseEntity = void 0;
+        if (config.responses["200"].schema) {
+          const refKey = this.getOriginRef(config.responses["200"].schema);
+          responseEntity = cfg.definitions[refKey];
+          if (responseEntity && Object.keys(responseEntity).length > 0) {
+            this.definitions.set(refKey, responseEntity);
+            entitySet.add(refKey);
+          }
+        }
+        const queries = config.parameters.filter(
+          (param2) => {
+            if (param2.in === "query") {
+              return param2;
+            }
+          }
+        );
+        if (methodName === "{id}") {
+          queries.push({
+            name: "id",
+            in: "query",
+            description: "\u6570\u636E\u4E3B\u952E",
+            required: true,
+            type: "string"
+          });
+        }
+        methods.push({
+          name: methodName !== "undefined" ? methodName : "",
+          mode,
+          model: config,
+          requestEntity,
+          responseEntity,
+          queries
+        });
+      }
+      this.entities.set(entityName, {
+        tag,
+        entityName,
+        api: entityName,
+        model: cfg.definitions[entityName],
+        methods,
+        entityRefs: Array.from(entitySet.values()).filter((item) => {
+          return this.basicDataType.findIndex((type) => {
+            return item.indexOf(`\xAB${type}\xBB`) !== -1;
+          }) === -1 && !this.basicDataType.includes(item);
+        })
+      });
+    }
+  }
+  /**
+   * 获取接口的引用对象
+   *
+   * @protected
+   * @param {IObject} data
+   * @returns {*}  {string}
+   */
+  getOriginRef(data) {
+    const { $ref, originalRef, type } = data;
+    if (type) return type;
+    if (originalRef) return originalRef;
+    if ($ref) {
+      const _refs_ = $ref.split("/");
+      return _refs_[_refs_.length - 1];
+    }
+    return "any";
+  }
+}

package/es/actions/index.d.ts

@@ -0,0 +1 @@
+export { GenApiAction } from './gen-api/gen-api';

package/es/actions/index.mjs

@@ -0,0 +1 @@
+export { GenApiAction } from "./gen-api/gen-api.mjs";

package/es/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/es/commands/gen-api/gen-api.d.ts

@@ -0,0 +1,44 @@
+import { Command } from 'commander';
+import { ICommand } from '../../interface';
+export interface GenApiOptions {
+    /**
+     * 模板目录
+     *
+     * @author chitanda
+     * @date 2021-12-19 20:12:32
+     * @type {string}
+     */
+    template: string;
+    /**
+     * 模板输出目录
+     *
+     * @author chitanda
+     * @date 2021-12-19 20:12:37
+     * @type {string}
+     */
+    output: string;
+    /**
+     * 清理输出目录
+     *
+     * @author chitanda
+     * @date 2021-12-21 10:12:47
+     * @type {boolean}
+     */
+    clean: boolean;
+    /**
+     * swagger 地址
+     *
+     * @type {string}
+     */
+    url: string;
+    /**
+     * api标识
+     *
+     * @type {string}
+     */
+    tag: string;
+}
+export declare class GenApiCommand implements ICommand {
+    load(program: Command): void;
+    action(args: GenApiOptions): Promise<void>;
+}

package/es/commands/gen-api/gen-api.mjs

@@ -0,0 +1,15 @@
+import { GenApiAction } from "../../actions/index.mjs";
+export class GenApiCommand {
+  load(program) {
+    program.command("gen-api").description("\u751F\u6210 api \u6587\u4EF6").option("--url <base-url>", "\u6307\u5B9Aapi\u83B7\u53D6\u7684swagger\u5730\u5740").option("-t --template <template>", "\u6307\u5B9A\u6A21\u677F\u76EE\u5F55").option("-o --output <output>", "\u6307\u5B9A\u8F93\u51FA\u76EE\u5F55").option("--tag <tag>", "\u6307\u5B9A\u5F53\u524D\u53D1\u5E03\u7684\u5206\u652F").option("--clean", "\u6E05\u7406\u8F93\u51FA\u76EE\u5F55").action(this.action.bind(this));
+  }
+  async action(args) {
+    await new GenApiAction().run(
+      args.url,
+      args.tag,
+      args.template,
+      args.output,
+      args.clean
+    );
+  }
+}

package/es/commands/index.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare class CommandLoader {
+    static load(program: Command): void;
+    private static handleInvalidCommand;
+}

package/es/commands/index.mjs

@@ -0,0 +1,16 @@
+import { consola } from "consola";
+import { GenApiCommand } from "./gen-api/gen-api.mjs";
+export class CommandLoader {
+  static load(program) {
+    new GenApiCommand().load(program);
+    this.handleInvalidCommand(program);
+  }
+  static handleInvalidCommand(program) {
+    program.on("command:*", () => {
+      consola.error(`\u672A\u652F\u6301\u7684\u547D\u4EE4: `, program.args.join(" "));
+      consola.log(`\u8BF7\u4F7F\u7528 --help \u67E5\u770B\u5DF2\u652F\u6301\u7684\u547D\u4EE4.
+`);
+      process.exit(1);
+    });
+  }
+}

package/es/core/handlebars/constant/index.d.ts

@@ -0,0 +1,2 @@
+export declare const TEMP_EXTENSION = ".hbs";
+export declare const MACRO_FOLDER = "@macro";

package/es/core/handlebars/constant/index.mjs

@@ -0,0 +1,2 @@
+export const TEMP_EXTENSION = ".hbs";
+export const MACRO_FOLDER = "@macro";

package/es/core/handlebars/handlebars-engine.d.ts

@@ -0,0 +1,74 @@
+import Handlebars from 'handlebars';
+import { IObject } from '../interface';
+/**
+ * 生成器
+ *
+ * @export
+ * @class HandlebarsEngine
+ */
+export declare class HandlebarsEngine {
+    /**
+     * 编译参数
+     *
+     * @protected
+     * @type {CompileOptions}
+     */
+    protected compileOpt: CompileOptions;
+    /**
+     * Handlebars 运行时参数
+     *
+     * @protected
+     * @type {Handlebars.RuntimeOptions}
+     */
+    protected runtimeOpt: Handlebars.RuntimeOptions;
+    /**
+     * 忽略编译的上下文标签规则
+     *
+     * @protected
+     */
+    protected tagReg: RegExp;
+    /**
+     * 模板映射内容
+     *
+     * @type {Map<string, string>} Map<模板路径, 模板内容>
+     */
+    readonly temps: Map<string, string>;
+    constructor();
+    /**
+     * 注册宏
+     *
+     * @param {string} key 宏标识
+     * @param {string} template 宏模板内容
+     */
+    registerMacro(key: string, template: string): void;
+    /**
+     * 注册模板
+     *
+     * @param {string} key
+     * @param {string} template
+     */
+    registerTemp(key: string, template: string): void;
+    /**
+     * 编译模板获取所有使用到的上下文级参数标识
+     *
+     * @param {string} template
+     * @return {*}  {string[]}
+     */
+    parseContextTags(template: string): string[];
+    /**
+     * 计算编译模板中的参数标签
+     *
+     * @protected
+     * @param {Set<string>} set
+     * @param {Record<string, any>[]} tags
+     */
+    protected calcTemplateTags(set: Set<string>, tags: Record<string, any>[]): void;
+    /**
+     * 直接工具模板和数据编译
+     *
+     * @param {string} template
+     * @param {IObject} data
+     * @return {*}  {string}
+     */
+    render(template: string, data: IObject): string;
+}

package/es/core/handlebars/handlebars-engine.mjs

@@ -0,0 +1,122 @@
+import Handlebars from "handlebars";
+import { installHelpers } from "./helpers/index.mjs";
+import { HelperUtil, winToUnixPath } from "./utils/index.mjs";
+import { TEMP_EXTENSION } from "./constant/index.mjs";
+export class HandlebarsEngine {
+  /**
+   * 编译参数
+   *
+   * @protected
+   * @type {CompileOptions}
+   */
+  compileOpt = { compat: true, noEscape: true };
+  /**
+   * Handlebars 运行时参数
+   *
+   * @protected
+   * @type {Handlebars.RuntimeOptions}
+   */
+  runtimeOpt = {
+    allowProtoPropertiesByDefault: true
+  };
+  /**
+   * 忽略编译的上下文标签规则
+   *
+   * @protected
+   */
+  tagReg = /^[a-zA-Z0-9:_-]+$/;
+  /**
+   * 模板映射内容
+   *
+   * @type {Map<string, string>} Map<模板路径, 模板内容>
+   */
+  temps = /* @__PURE__ */ new Map();
+  constructor() {
+    installHelpers();
+  }
+  /**
+   * 注册宏
+   *
+   * @param {string} key 宏标识
+   * @param {string} template 宏模板内容
+   */
+  registerMacro(key, template) {
+    key = winToUnixPath(key);
+    if (key.endsWith(TEMP_EXTENSION)) {
+      key = key.replace(TEMP_EXTENSION, "");
+      Handlebars.registerPartial(key, template);
+    } else {
+      Handlebars.registerPartial(key, template);
+    }
+  }
+  /**
+   * 注册模板
+   *
+   * @param {string} key
+   * @param {string} template
+   */
+  registerTemp(key, template) {
+    key = winToUnixPath(key);
+    if (key.endsWith(TEMP_EXTENSION)) {
+      key = key.replace(TEMP_EXTENSION, "");
+      this.temps.set(key, template);
+    } else {
+      this.temps.set(key, template);
+    }
+  }
+  /**
+   * 编译模板获取所有使用到的上下文级参数标识
+   *
+   * @param {string} template
+   * @return {*}  {string[]}
+   */
+  parseContextTags(template) {
+    const program = Handlebars.parse(template);
+    const set = /* @__PURE__ */ new Set();
+    this.calcTemplateTags(set, program.body);
+    return Array.from(set);
+  }
+  /**
+   * 计算编译模板中的参数标签
+   *
+   * @protected
+   * @param {Set<string>} set
+   * @param {Record<string, any>[]} tags
+   */
+  calcTemplateTags(set, tags) {
+    tags.forEach((item) => {
+      switch (item.type) {
+        case "SubExpression":
+          if (item.params?.length > 0) {
+            this.calcTemplateTags(set, item.params);
+          }
+          return;
+        case "MustacheStatement":
+        case "PathExpression": {
+          const tag = item.path ? item.path.original : item.original;
+          if (HelperUtil.isHelperName(tag)) {
+            if (item.params?.length > 0) {
+              this.calcTemplateTags(set, item.params);
+            }
+            return;
+          }
+          if (this.tagReg.test(tag)) {
+            set.add(tag);
+          }
+          break;
+        }
+        default:
+      }
+    });
+  }
+  /**
+   * 直接工具模板和数据编译
+   *
+   * @param {string} template
+   * @param {IObject} data
+   * @return {*}  {string}
+   */
+  render(template, data) {
+    return Handlebars.compile(template, this.compileOpt)(data, this.runtimeOpt);
+  }
+}

package/es/core/handlebars/helpers/and/and.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 并且条件模式
+ *
+ * @description 判断: word wor2 word3 必须在判断中必须全部为 true, 用法: {{#and word word2 word3}}xxx{{else}}yyy{{/and}}、{{and word word2 word3}} 返回值为 boolean 类型
+ * @export
+ * @class HelperAnd
+ * @extends {HelperBase}
+ */
+export declare class HelperAnd extends HelperBase {
+    constructor();
+    onExecute(...args: unknown[] | Handlebars.HelperOptions[]): string | boolean;
+}

package/es/core/handlebars/helpers/and/and.mjs

@@ -0,0 +1,14 @@
+import { HelperUtil } from "../../utils/index.mjs";
+import { HelperBase } from "../helper-base.mjs";
+export class HelperAnd extends HelperBase {
+  constructor() {
+    super("and");
+  }
+  onExecute(...args) {
+    const options = args[args.length - 1];
+    args.pop();
+    const arr = args.filter((item) => !!item);
+    const bol = arr.length === args.length;
+    return HelperUtil.handleJudgmentExecute(this, bol, options);
+  }
+}

package/es/core/handlebars/helpers/camel-case/camel-case.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 转驼峰
+ *
+ * @description 用法 {{camelCase xxx}}，效果: this-is-my-name => thisIsMyName
+ * @export
+ * @class HelperCamelCase
+ * @extends {HelperBase}
+ */
+export declare class HelperCamelCase extends HelperBase {
+    constructor();
+    onExecute(param: string): string;
+}

package/es/core/handlebars/helpers/camel-case/camel-case.mjs

@@ -0,0 +1,13 @@
+import { camelCase } from "lodash-es";
+import { HelperBase } from "../helper-base.mjs";
+export class HelperCamelCase extends HelperBase {
+  constructor() {
+    super("camelCase");
+  }
+  onExecute(param) {
+    if (!param) {
+      return "";
+    }
+    return camelCase(param);
+  }
+}

package/es/core/handlebars/helpers/concat/concat.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 字符串拼接
+ *
+ * @description 用法：{{concat string1 string2 string3}} 返回值为 string 类型
+ * @export
+ * @class HelperConcat
+ * @extends {HelperBase}
+ */
+export declare class HelperConcat extends HelperBase {
+    constructor();
+    onExecute(...args: string[]): string;
+}

package/es/core/handlebars/helpers/concat/concat.mjs

@@ -0,0 +1,10 @@
+import { HelperBase } from "../helper-base.mjs";
+export class HelperConcat extends HelperBase {
+  constructor() {
+    super("concat");
+  }
+  onExecute(...args) {
+    args.pop();
+    return args.join("");
+  }
+}

package/es/core/handlebars/helpers/eq/eq.d.ts

@@ -0,0 +1,14 @@
+import * as Handlebars from 'handlebars';
+import { HelperBase } from '../helper-base';
+/**
+ * 等于
+ *
+ * @description 判断: word === word2, 用法: {{#eq word word2}}xxx{{else}}yyy{{/eq}}、{{eq word 'xxx'}} 返回值为 boolean 类型
+ * @export
+ * @class HelperEq
+ * @extends {HelperBase}
+ */
+export declare class HelperEq extends HelperBase {
+    constructor();
+    onExecute(param: unknown, param2: unknown, options: Handlebars.HelperOptions): string | boolean;
+}

package/es/core/handlebars/helpers/eq/eq.mjs

@@ -0,0 +1,12 @@
+import { eq } from "lodash-es";
+import { HelperUtil } from "../../utils/index.mjs";
+import { HelperBase } from "../helper-base.mjs";
+export class HelperEq extends HelperBase {
+  constructor() {
+    super("eq");
+  }
+  onExecute(param, param2, options) {
+    const bol = eq(param, param2);
+    return HelperUtil.handleJudgmentExecute(this, bol, options);
+  }
+}

package/es/core/handlebars/helpers/format-import/format-import.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 格式化导入
+ *
+ * @description 专门格式化导入的 response 对象，效果: ResponseEntity«List«TraceSettingResponse»» => TraceSettingResponse
+ * @export
+ * @class HelperFormatImport
+ * @extends {HelperBase}
+ */
+export declare class HelperFormatImport extends HelperBase {
+    constructor();
+    onExecute(param: string[]): string;
+}

package/es/core/handlebars/helpers/format-import/format-import.mjs

@@ -0,0 +1,34 @@
+import { HelperBase } from "../helper-base.mjs";
+export class HelperFormatImport extends HelperBase {
+  constructor() {
+    super("formatImport");
+  }
+  onExecute(param) {
+    if (!param || param.length === 0) {
+      return "";
+    }
+    const items = param.map((item) => {
+      if (item.indexOf("\xAB") > -1) {
+        const arr = item.split("\xAB");
+        return arr[arr.length - 1].split("\xBB")[0];
+      }
+      return item;
+    }).filter((item) => {
+      const keys = item.split(",");
+      const tag = keys[0];
+      switch (tag) {
+        case "string":
+        case "object":
+        case "void":
+        case "integer":
+        case "int":
+        case "long":
+        case "Map":
+          return false;
+        default:
+          return true;
+      }
+    });
+    return Array.from(new Set(items)).join(",");
+  }
+}

package/es/core/handlebars/helpers/format-import-item/format-import-item.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 格式化导入
+ *
+ * @description 专门格式化导入的 response 对象，效果: ResponseEntity«List«TraceSettingResponse»» => TraceSettingResponse
+ * @export
+ * @class HelperFormatImportItem
+ * @extends {HelperBase}
+ */
+export declare class HelperFormatImportItem extends HelperBase {
+    constructor();
+    onExecute(param: string): string;
+}

package/es/core/handlebars/helpers/format-import-item/format-import-item.mjs

@@ -0,0 +1,30 @@
+import { HelperBase } from "../helper-base.mjs";
+export class HelperFormatImportItem extends HelperBase {
+  constructor() {
+    super("formatImportItem");
+  }
+  onExecute(param) {
+    if (!param) {
+      return "";
+    }
+    if (param.indexOf("\xAB") > -1) {
+      const arr = param.split("\xAB");
+      const text = arr[arr.length - 1].split("\xBB")[0];
+      let keys = text.split(",");
+      keys = keys.map((key) => {
+        if (key === "Void") {
+          return "void";
+        }
+        if (key === "int" || key === "long") {
+          return "number";
+        }
+        if (key === "Map") {
+          return "object";
+        }
+        return key;
+      });
+      return keys.join(",");
+    }
+    return param;
+  }
+}

package/es/core/handlebars/helpers/format-js-type/format-js-type.d.ts

@@ -0,0 +1,14 @@
+import { IObject } from '../../../interface';
+import { HelperBase } from '../helper-base';
+/**
+ * 格式化导入
+ *
+ * @description 针对后台的 swagger 生成的 js 类型，进行对 js 的类型转换
+ * @export
+ * @class HelperFormatJsType
+ * @extends {HelperBase}
+ */
+export declare class HelperFormatJsType extends HelperBase {
+    constructor();
+    onExecute(param: string, cfg?: IObject): string;
+}

package/es/core/handlebars/helpers/format-js-type/format-js-type.mjs

@@ -0,0 +1,34 @@
+import { HelperBase } from "../helper-base.mjs";
+export class HelperFormatJsType extends HelperBase {
+  constructor() {
+    super("formatJsType");
+  }
+  onExecute(param, cfg) {
+    if (!param) {
+      return "unknown";
+    }
+    if (param === "array") {
+      if (cfg) {
+        let type = cfg.type || cfg.originalRef;
+        if (type) {
+          if (type === "integer") {
+            type = "number";
+          } else if (type.startsWith("Triple\xAB")) {
+            type = "unknown";
+          }
+        } else {
+          type = "unknown";
+        }
+        return type + "[]";
+      }
+      return "unknown[]";
+    }
+    if (param === "integer") {
+      return "number";
+    }
+    if (param === "object") {
+      return "Record<string, unknown>";
+    }
+    return param;
+  }
+}