@doracli/define-server 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020-2029 zhangzhiguo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# `express-mock`
+
+> @doracli/express-mock
+
+## Usage

package/lib/cjs/index.js

@@ -0,0 +1,171 @@
+'use strict';
+
+function _applyDecoratedDescriptor(i, e, r, n, l) {
+  var a = {};
+  return Object.keys(n).forEach(function (i) {
+    a[i] = n[i];
+  }), a.enumerable = !!a.enumerable, a.configurable = !!a.configurable, ("value" in a || a.initializer) && (a.writable = true), a = r.slice().reverse().reduce(function (r, n) {
+    return n(i, e, r) || r;
+  }, a), l && void 0 !== a.initializer && (a.value = a.initializer ? a.initializer.call(l) : void 0, a.initializer = void 0), void 0 === a.initializer ? (Object.defineProperty(i, e, a), null) : a;
+}
+function _classCallCheck(a, n) {
+  if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function");
+}
+function _defineProperties(e, r) {
+  for (var t = 0; t < r.length; t++) {
+    var o = r[t];
+    o.enumerable = o.enumerable || false, o.configurable = true, "value" in o && (o.writable = true), Object.defineProperty(e, _toPropertyKey(o.key), o);
+  }
+}
+function _createClass(e, r, t) {
+  return r && _defineProperties(e.prototype, r), Object.defineProperty(e, "prototype", {
+    writable: false
+  }), e;
+}
+function _defineProperty(e, r, t) {
+  return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+    value: t,
+    enumerable: true,
+    configurable: true,
+    writable: true
+  }) : e[r] = t, e;
+}
+function _toPrimitive(t, r) {
+  if ("object" != typeof t || !t) return t;
+  var e = t[Symbol.toPrimitive];
+  if (void 0 !== e) {
+    var i = e.call(t, r);
+    if ("object" != typeof i) return i;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return ("string" === r ? String : Number)(t);
+}
+function _toPropertyKey(t) {
+  var i = _toPrimitive(t, "string");
+  return "symbol" == typeof i ? i : i + "";
+}
+
+var ComponentBaseImpl = /*#__PURE__*/_createClass(function ComponentBaseImpl() {
+  _classCallCheck(this, ComponentBaseImpl);
+});
+/** 标记为服务组件 */
+_defineProperty(ComponentBaseImpl, "handlerServer", void 0);
+/** handler类型 */
+_defineProperty(ComponentBaseImpl, "defineType", void 0);
+/** 默认的方法处理类型 */
+_defineProperty(ComponentBaseImpl, "defaultHandlerType", void 0);
+/** 类的子路由与方法名进行绑定 */
+_defineProperty(ComponentBaseImpl, "routeFunNameMap", void 0);
+/** 方法名 -> 请求类型 */
+_defineProperty(ComponentBaseImpl, "funNameMethodMap", void 0);
+/** 方法名 -> 方法解析类型 */
+_defineProperty(ComponentBaseImpl, "funNameHandlerTypeMap", void 0);
+
+var DefaultHandlerName = 'handlerFun';
+
+var alias = function alias(name) {
+  return function (target, propertyKey, descriptor) {
+    var constructor = target.constructor;
+    if (!constructor.routeFunNameMap) {
+      constructor.routeFunNameMap = {};
+    }
+    constructor.routeFunNameMap[name] = propertyKey;
+    return descriptor;
+  };
+};
+
+/**
+ * 类装饰器，标记为服务组件
+ * @param type 决定解析方法，不需要传，默认就是`类`解析
+ * @returns
+ */
+var component = function component(type) {
+  return function (Target) {
+    Target.handlerServer = true;
+    Target.type = type || 'CLASS';
+  };
+};
+
+/**
+ * 类装饰器，标记为服务组件
+ * @returns
+ */
+var controller = function controller() {
+  var defineType = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'CLASS';
+  return function (Target) {
+    Target.handlerServer = true;
+    Target.defineType = defineType;
+    Target.defaultHandlerType = 'REST';
+  };
+};
+
+var method = function method() {
+  for (var _len = arguments.length, methods = new Array(_len), _key = 0; _key < _len; _key++) {
+    methods[_key] = arguments[_key];
+  }
+  return function (target, propertyKey, descriptor) {
+    var constructor = target.constructor;
+    if (!constructor.funNameMethodMap) {
+      constructor.funNameMethodMap = {};
+    }
+    constructor.funNameMethodMap[propertyKey] = methods;
+    return descriptor;
+  };
+};
+
+/**
+ * 类装饰器，标记为服务组件
+ * @param type 决定解析方法，不需要传，默认就是`类`解析
+ * @returns
+ */
+var restController = function restController() {
+  return function (Target) {
+    Target.handlerServer = true;
+    Target.defineType = 'CLASS';
+    Target.defaultHandlerType = 'REST';
+  };
+};
+
+/**
+ * 定义路由
+ * @param name 路由名称，默认使用方法名
+ */
+var route = function route(name) {
+  return function (target, propertyKey, descriptor) {
+    var constructor = target.constructor;
+    if (!constructor.routeFunNameMap) {
+      constructor.routeFunNameMap = {};
+    }
+    constructor.routeFunNameMap[name || propertyKey] = propertyKey;
+    return descriptor;
+  };
+};
+
+var defineControllerFun = function defineControllerFun(cb) {
+  var _dec, _dec2, _class, _class2;
+  var HandlerClass = (_dec = controller('FUN'), _dec2 = route(), _dec(_class = (_class2 = /*#__PURE__*/function () {
+    function HandlerClass() {
+      _classCallCheck(this, HandlerClass);
+    }
+    return _createClass(HandlerClass, [{
+      key: "handlerFun",
+      value: function handlerFun() {
+        for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+          args[_key] = arguments[_key];
+        }
+        return cb.apply(this, args);
+      }
+    }]);
+  }(), _applyDecoratedDescriptor(_class2.prototype, "handlerFun", [_dec2], Object.getOwnPropertyDescriptor(_class2.prototype, "handlerFun"), _class2.prototype), _class2)) || _class);
+  return HandlerClass;
+};
+
+exports.ComponentBaseImpl = ComponentBaseImpl;
+exports.DefaultHandlerName = DefaultHandlerName;
+exports.alias = alias;
+exports.component = component;
+exports.controller = controller;
+exports.defineControllerFun = defineControllerFun;
+exports.method = method;
+exports.restController = restController;
+exports.route = route;

package/lib/esm/index.js

@@ -0,0 +1,161 @@
+function _applyDecoratedDescriptor(i, e, r, n, l) {
+  var a = {};
+  return Object.keys(n).forEach(function (i) {
+    a[i] = n[i];
+  }), a.enumerable = !!a.enumerable, a.configurable = !!a.configurable, ("value" in a || a.initializer) && (a.writable = true), a = r.slice().reverse().reduce(function (r, n) {
+    return n(i, e, r) || r;
+  }, a), l && void 0 !== a.initializer && (a.value = a.initializer ? a.initializer.call(l) : void 0, a.initializer = void 0), void 0 === a.initializer ? (Object.defineProperty(i, e, a), null) : a;
+}
+function _classCallCheck(a, n) {
+  if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function");
+}
+function _defineProperties(e, r) {
+  for (var t = 0; t < r.length; t++) {
+    var o = r[t];
+    o.enumerable = o.enumerable || false, o.configurable = true, "value" in o && (o.writable = true), Object.defineProperty(e, _toPropertyKey(o.key), o);
+  }
+}
+function _createClass(e, r, t) {
+  return r && _defineProperties(e.prototype, r), Object.defineProperty(e, "prototype", {
+    writable: false
+  }), e;
+}
+function _defineProperty(e, r, t) {
+  return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+    value: t,
+    enumerable: true,
+    configurable: true,
+    writable: true
+  }) : e[r] = t, e;
+}
+function _toPrimitive(t, r) {
+  if ("object" != typeof t || !t) return t;
+  var e = t[Symbol.toPrimitive];
+  if (void 0 !== e) {
+    var i = e.call(t, r);
+    if ("object" != typeof i) return i;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return ("string" === r ? String : Number)(t);
+}
+function _toPropertyKey(t) {
+  var i = _toPrimitive(t, "string");
+  return "symbol" == typeof i ? i : i + "";
+}
+
+var ComponentBaseImpl = /*#__PURE__*/_createClass(function ComponentBaseImpl() {
+  _classCallCheck(this, ComponentBaseImpl);
+});
+/** 标记为服务组件 */
+_defineProperty(ComponentBaseImpl, "handlerServer", void 0);
+/** handler类型 */
+_defineProperty(ComponentBaseImpl, "defineType", void 0);
+/** 默认的方法处理类型 */
+_defineProperty(ComponentBaseImpl, "defaultHandlerType", void 0);
+/** 类的子路由与方法名进行绑定 */
+_defineProperty(ComponentBaseImpl, "routeFunNameMap", void 0);
+/** 方法名 -> 请求类型 */
+_defineProperty(ComponentBaseImpl, "funNameMethodMap", void 0);
+/** 方法名 -> 方法解析类型 */
+_defineProperty(ComponentBaseImpl, "funNameHandlerTypeMap", void 0);
+
+var DefaultHandlerName = 'handlerFun';
+
+var alias = function alias(name) {
+  return function (target, propertyKey, descriptor) {
+    var constructor = target.constructor;
+    if (!constructor.routeFunNameMap) {
+      constructor.routeFunNameMap = {};
+    }
+    constructor.routeFunNameMap[name] = propertyKey;
+    return descriptor;
+  };
+};
+
+/**
+ * 类装饰器，标记为服务组件
+ * @param type 决定解析方法，不需要传，默认就是`类`解析
+ * @returns
+ */
+var component = function component(type) {
+  return function (Target) {
+    Target.handlerServer = true;
+    Target.type = type || 'CLASS';
+  };
+};
+
+/**
+ * 类装饰器，标记为服务组件
+ * @returns
+ */
+var controller = function controller() {
+  var defineType = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'CLASS';
+  return function (Target) {
+    Target.handlerServer = true;
+    Target.defineType = defineType;
+    Target.defaultHandlerType = 'REST';
+  };
+};
+
+var method = function method() {
+  for (var _len = arguments.length, methods = new Array(_len), _key = 0; _key < _len; _key++) {
+    methods[_key] = arguments[_key];
+  }
+  return function (target, propertyKey, descriptor) {
+    var constructor = target.constructor;
+    if (!constructor.funNameMethodMap) {
+      constructor.funNameMethodMap = {};
+    }
+    constructor.funNameMethodMap[propertyKey] = methods;
+    return descriptor;
+  };
+};
+
+/**
+ * 类装饰器，标记为服务组件
+ * @param type 决定解析方法，不需要传，默认就是`类`解析
+ * @returns
+ */
+var restController = function restController() {
+  return function (Target) {
+    Target.handlerServer = true;
+    Target.defineType = 'CLASS';
+    Target.defaultHandlerType = 'REST';
+  };
+};
+
+/**
+ * 定义路由
+ * @param name 路由名称，默认使用方法名
+ */
+var route = function route(name) {
+  return function (target, propertyKey, descriptor) {
+    var constructor = target.constructor;
+    if (!constructor.routeFunNameMap) {
+      constructor.routeFunNameMap = {};
+    }
+    constructor.routeFunNameMap[name || propertyKey] = propertyKey;
+    return descriptor;
+  };
+};
+
+var defineControllerFun = function defineControllerFun(cb) {
+  var _dec, _dec2, _class, _class2;
+  var HandlerClass = (_dec = controller('FUN'), _dec2 = route(), _dec(_class = (_class2 = /*#__PURE__*/function () {
+    function HandlerClass() {
+      _classCallCheck(this, HandlerClass);
+    }
+    return _createClass(HandlerClass, [{
+      key: "handlerFun",
+      value: function handlerFun() {
+        for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+          args[_key] = arguments[_key];
+        }
+        return cb.apply(this, args);
+      }
+    }]);
+  }(), _applyDecoratedDescriptor(_class2.prototype, "handlerFun", [_dec2], Object.getOwnPropertyDescriptor(_class2.prototype, "handlerFun"), _class2.prototype), _class2)) || _class);
+  return HandlerClass;
+};
+
+export { ComponentBaseImpl, DefaultHandlerName, alias, component, controller, defineControllerFun, method, restController, route };

package/lib/type/index.d.ts

@@ -0,0 +1,92 @@
+import { TPlainObject, TPlainFunction, TAny } from '@cclr/lang';
+import { Request, Response } from 'express';
+export { Request, Response } from 'express';
+
+type TMethod = 'get' | 'post' | 'put' | 'delete' | 'all' | 'options';
+type TDefineType = 'CLASS' | 'FUN';
+type TControllerType = 'REST' | 'BASE';
+type TRoutesMap = {
+    /**
+     * 路由 -> 请求类型 -> 方法名
+     */
+    [route: string]: Record<TMethod, string>;
+};
+
+type TRouterHandlerFun = (req: Request, res: Response) => void | Promise<void>;
+type THandlerConfig = {
+    /** 路由前缀 */
+    route: string;
+    /** handler文件相对路径 */
+    relativeFilePath: string;
+    /** 文件后缀 */
+    fileExt: string;
+    /** 文件名称 */
+    fileName: string;
+    /** 文件原始内容，类，函数，json */
+    orange: TPlainObject;
+    /** 统一后的类型 */
+    Controller: TController;
+};
+
+type TController = typeof ComponentBaseImpl;
+declare class ComponentBaseImpl {
+    /** 标记为服务组件 */
+    static handlerServer: boolean;
+    /** handler类型 */
+    static defineType: TDefineType;
+    /** 默认的方法处理类型 */
+    static defaultHandlerType: TControllerType;
+    /** 类的子路由与方法名进行绑定 */
+    static routeFunNameMap: {
+        [route: string]: string;
+    };
+    /** 方法名 -> 请求类型 */
+    static funNameMethodMap: {
+        [funName: string]: TMethod[];
+    };
+    /** 方法名 -> 方法解析类型 */
+    static funNameHandlerTypeMap: {
+        [funName: string]: TControllerType;
+    };
+}
+
+declare const DefaultHandlerName = "handlerFun";
+
+declare const alias: (name: string) => <T extends TypedPropertyDescriptor<TPlainFunction>>(target: TAny, propertyKey: string, descriptor: T) => T;
+
+/**
+ * 类装饰器，标记为服务组件
+ * @param type 决定解析方法，不需要传，默认就是`类`解析
+ * @returns
+ */
+declare const component: (type?: TControllerType) => <T extends new (...args: TAny[]) => TAny>(Target: T) => void;
+
+/**
+ * 类装饰器，标记为服务组件
+ * @returns
+ */
+declare const controller: (defineType?: TDefineType) => <T extends new (...args: TAny[]) => TAny>(Target: T) => void;
+
+declare const method: (...methods: TMethod[]) => <T extends TypedPropertyDescriptor<TPlainFunction>>(target: TAny, propertyKey: string, descriptor: T) => T;
+
+/**
+ * 类装饰器，标记为服务组件
+ * @param type 决定解析方法，不需要传，默认就是`类`解析
+ * @returns
+ */
+declare const restController: () => <T extends new (...args: TAny[]) => TAny>(Target: T) => void;
+
+/**
+ * 定义路由
+ * @param name 路由名称，默认使用方法名
+ */
+declare const route: (name?: string) => <T extends TypedPropertyDescriptor<TAny>>(target: TAny, propertyKey: string, descriptor: T) => T;
+
+declare const defineControllerFun: (cb: TRouterHandlerFun) => {
+    new (): {
+        handlerFun(...args: any[]): any;
+    };
+};
+
+export { ComponentBaseImpl, DefaultHandlerName, alias, component, controller, defineControllerFun, method, restController, route };
+export type { TController, TControllerType, TDefineType, THandlerConfig, TMethod, TRouterHandlerFun, TRoutesMap };

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@doracli/define-server",
+  "version": "0.0.1",
+  "description": "",
+  "author": "cclr <18843152354@163.com>",
+  "homepage": "",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    "import": "./lib/esm/index.js",
+    "require": "./lib/cjs/index.js"
+  },
+  "types": "lib/type/index.d.ts",
+  "files": [
+    "lib",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "test": "vitest",
+    "g:test": "vitest run",
+    "build": "drn build",
+    "g:build": "drn build"
+  },
+  "dependencies": {
+    "@cclr/lang": "^0.1.28",
+    "@types/express": "^5.0.3"
+  },
+  "gitHead": "40ab496f25042487a671979074515f3345c96453"
+}