phecda-server 7.0.1 → 7.1.0

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { B as BaseCtx, a as ControllerMeta, D as DefaultOptions, b as ControllerMetaData, M as Meta, E as Emitter, c as BaseError } from './meta-BoS1E-Nz.js';
-export { d as BaseRequestType, C as CustomResponse, g as ERROR_SYMBOL, e as ExtractResponse, I as IS_DEV, h as IS_ONLY_GENERATE, j as IS_PURE, i as IS_STRICT, L as LOG_LEVEL, f as MetaData, P as PS_EXIT_CODE, S as ServiceMetaData } from './meta-BoS1E-Nz.js';
-import { G as Generator } from './core-Rq7BhPHE.js';
-export { F as Factory, O as Options, S as ServerPhecda, d as defaultServerInject, e as emitter, p as phecdaNamespace, u as useS } from './core-Rq7BhPHE.js';
+import { B as BaseCtx, a as ControllerMeta, D as DefaultOptions, b as ControllerMetaData, M as Meta, E as Emitter, c as BaseError } from './meta-C_eDyXnK.js';
+export { d as BaseRequestType, C as CustomResponse, g as ERROR_SYMBOL, e as ExtractResponse, I as IS_DEV, h as IS_ONLY_GENERATE, j as IS_PURE, i as IS_STRICT, L as LOG_LEVEL, f as MetaData, P as PS_EXIT_CODE, S as ServiceMetaData } from './meta-C_eDyXnK.js';
+import { G as Generator } from './core-BRuvL6hY.js';
+export { F as Factory, O as Options, S as ServerPhecda, d as defaultServerInject, e as emitter, p as phecdaNamespace, u as useS } from './core-BRuvL6hY.js';
 import { Base } from 'phecda-core';
 export * from 'phecda-core';
-import { H as HttpCtx } from './types-xruyYmyu.js';
-export { C as CookieSerializeOptions, a as HttpOptions } from './types-xruyYmyu.js';
-import { R as RpcCtx } from './types-CInz3bD0.js';
-export { a as RpcServerOptions } from './types-CInz3bD0.js';
+import { H as HttpCtx } from './types-BuvMT1ta.js';
+export { C as CookieSerializeOptions, a as HttpOptions } from './types-BuvMT1ta.js';
+import { R as RpcCtx } from './types-B6aU8oT-.js';
+export { a as RpcServerOptions } from './types-B6aU8oT-.js';
 export { Mixin } from 'ts-mixer';
 import 'node:http';
 
@@ -101,6 +101,7 @@ interface PipeArg {
     index: number;
     reflect: any;
     define: Record<string, any>;
+    rawMeta: any;
 }
 type GuardType<Ctx extends BaseCtx = any> = (ctx: Ctx, next: () => Promise<any>) => any;
 type PipeType<Ctx extends BaseCtx = any> = (arg: PipeArg, ctx: Ctx) => Promise<any>;
@@ -169,6 +170,23 @@ declare class OpenAPIGenerator extends Generator {
     generateCode(meta: Meta[]): string;
 }
 
+declare class DocGenerator extends Generator {
+    name: string;
+    classMap: Record<string, {
+        [key: string]: {
+            doc: string;
+            params: {
+                doc: string;
+                index: number;
+            }[];
+        };
+    }>;
+    constructor(path?: string);
+    getContent(): string;
+    addMethod(data: ControllerMetaData): void;
+    generateCode(meta: Meta[]): string;
+}
+
 declare function BaseParam(data: Record<string, any>): ParameterDecorator;
 declare function Body(key?: string): ParameterDecorator;
 declare function Head(key: string): ParameterDecorator;
@@ -329,4 +347,4 @@ declare class PExtension extends ServerBase {
     constructor(tag?: string);
 }
 
-export { type AOP, Addon, ApiDoc, Arg, BadGatewayException, BadRequestException, BaseCtx, BaseError, BaseParam, Body, ConflictException, Context, Controller, ControllerMeta, ControllerMetaData, Ctx, DefaultOptions, Define, Delete, Emitter, Exception, Filter, type FilterType, ForbiddenException, FrameworkException, Generator, Get, Guard, type GuardType, HTTPGenerator, Head, Header, HttpBase, HttpCtx, InvalidInputException, type LogLevel, type Logger, ManyFiles, Meta, NotFoundException, OneFile, type OpenAPIConfig, OpenAPIGenerator, PAddon, PExtension, PFilter, PGuard, PPipe, Param, Patch, PayloadLargeException, Pipe, type PipeArg, type PipeType, Post, Put, Query, Queue, RPCGenerator, Route, Rpc, RpcBase, RpcCtx, Search, ServerBase, ServiceUnavailableException, TimeoutException, TimerException, UnauthorizedException, UndefinedException, UnsupportedMediaTypeException, ValidateException, WorkerException, addAddon, addFilter, addGuard, addPipe, defaultPipe, getLogger, log, runMiddleware, setLogger };
+export { type AOP, Addon, ApiDoc, Arg, BadGatewayException, BadRequestException, BaseCtx, BaseError, BaseParam, Body, ConflictException, Context, Controller, ControllerMeta, ControllerMetaData, Ctx, DefaultOptions, Define, Delete, DocGenerator, Emitter, Exception, Filter, type FilterType, ForbiddenException, FrameworkException, Generator, Get, Guard, type GuardType, HTTPGenerator, Head, Header, HttpBase, HttpCtx, InvalidInputException, type LogLevel, type Logger, ManyFiles, Meta, NotFoundException, OneFile, type OpenAPIConfig, OpenAPIGenerator, PAddon, PExtension, PFilter, PGuard, PPipe, Param, Patch, PayloadLargeException, Pipe, type PipeArg, type PipeType, Post, Put, Query, Queue, RPCGenerator, Route, Rpc, RpcBase, RpcCtx, Search, ServerBase, ServiceUnavailableException, TimeoutException, TimerException, UnauthorizedException, UndefinedException, UnsupportedMediaTypeException, ValidateException, WorkerException, addAddon, addFilter, addGuard, addPipe, defaultPipe, getLogger, log, runMiddleware, setLogger };

package/dist/index.js

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _createStarExport(obj) { Object.keys(obj) .filter((key) => key !== "default" && key !== "__esModule") .forEach((key) => { if (exports.hasOwnProperty(key)) { return; } Object.defineProperty(exports, key, {enumerable: true, configurable: true, get: () => obj[key]}); }); } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _createStarExport(obj) { Object.keys(obj) .filter((key) => key !== "default" && key !== "__esModule") .forEach((key) => { if (exports.hasOwnProperty(key)) { return; } Object.defineProperty(exports, key, {enumerable: true, configurable: true, get: () => obj[key]}); }); } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7;
 
 
 
@@ -6,7 +6,7 @@
 
 
 
-var _chunkZWPOWMZPjs = require('./chunk-ZWPOWMZP.js');
+var _chunkJTSD2LIGjs = require('./chunk-JTSD2LIG.js');
 
 
 
@@ -60,7 +60,7 @@ var _chunkDPPDWBYOjs = require('./chunk-DPPDWBYO.js');
 
 
 
-var _chunkXKK2SQ7Wjs = require('./chunk-XKK2SQ7W.js');
+var _chunkOV3UJLGPjs = require('./chunk-OV3UJLGP.js');
 
 
 
@@ -102,7 +102,7 @@ var ServerBase = (_class = class extends _phecdacore.Base {constructor(...args2)
   static {
     _chunk4LLLQOMFjs.__name.call(void 0, this, "ServerBase");
   }
-  __init() {this.emitter = exports.emitter = _chunkZWPOWMZPjs.emitter}
+  __init() {this.emitter = exports.emitter = _chunkJTSD2LIGjs.emitter}
   log(msg, level = "log") {
     _chunk4LLLQOMFjs.log.call(void 0, msg, level, this.tag);
   }
@@ -138,9 +138,9 @@ var PFilter = class extends ServerBase {
   constructor(tag) {
     super();
     this.key = tag || _phecdacore.getTag.call(void 0, this);
-    _chunkXKK2SQ7Wjs.addFilter.call(void 0, this.key, this.use.bind(this));
+    _chunkOV3UJLGPjs.addFilter.call(void 0, this.key, this.use.bind(this));
     this.onUnmount(() => {
-      delete _chunkXKK2SQ7Wjs.Context.filterRecord[this.key];
+      delete _chunkOV3UJLGPjs.Context.filterRecord[this.key];
     });
   }
 };
@@ -156,9 +156,9 @@ var PGuard = (_class2 = class extends ServerBase {
   constructor(tag) {
     super();_class2.prototype.__init2.call(this);;
     this.key = tag || _phecdacore.getTag.call(void 0, this);
-    _chunkXKK2SQ7Wjs.addGuard.call(void 0, this.key, this.use.bind(this), this.priority);
+    _chunkOV3UJLGPjs.addGuard.call(void 0, this.key, this.use.bind(this), this.priority);
     this.onUnmount(() => {
-      delete _chunkXKK2SQ7Wjs.Context.guardRecord[this.key];
+      delete _chunkOV3UJLGPjs.Context.guardRecord[this.key];
     });
   }
 }, _class2);
@@ -173,9 +173,9 @@ var PPipe = class extends ServerBase {
   constructor(tag) {
     super();
     this.key = tag || _phecdacore.getTag.call(void 0, this);
-    _chunkXKK2SQ7Wjs.addPipe.call(void 0, this.key, this.use.bind(this));
+    _chunkOV3UJLGPjs.addPipe.call(void 0, this.key, this.use.bind(this));
     this.onUnmount(() => {
-      delete _chunkXKK2SQ7Wjs.Context.pipeRecord[this.key];
+      delete _chunkOV3UJLGPjs.Context.pipeRecord[this.key];
     });
   }
 };
@@ -191,9 +191,9 @@ var PAddon = (_class3 = class extends ServerBase {
   constructor(tag) {
     super();_class3.prototype.__init3.call(this);;
     this.key = tag || _phecdacore.getTag.call(void 0, this);
-    _chunkXKK2SQ7Wjs.addAddon.call(void 0, this.key, this.use.bind(this), this.priority);
+    _chunkOV3UJLGPjs.addAddon.call(void 0, this.key, this.use.bind(this), this.priority);
     this.onUnmount(() => {
-      delete _chunkXKK2SQ7Wjs.Context.addonRecord[this.key];
+      delete _chunkOV3UJLGPjs.Context.addonRecord[this.key];
     });
   }
 }, _class3);
@@ -211,27 +211,27 @@ var PExtension = class extends ServerBase {
     super();
     const key = this.key = tag || _phecdacore.getTag.call(void 0, this);
     if (this.pipe) {
-      _chunkXKK2SQ7Wjs.addPipe.call(void 0, key, this.pipe.bind(this));
+      _chunkOV3UJLGPjs.addPipe.call(void 0, key, this.pipe.bind(this));
       this.onUnmount(() => {
-        delete _chunkXKK2SQ7Wjs.Context.pipeRecord[key];
+        delete _chunkOV3UJLGPjs.Context.pipeRecord[key];
       });
     }
     if (this.addon) {
-      _chunkXKK2SQ7Wjs.addAddon.call(void 0, key, this.addon.bind(this), this.addonPriority);
+      _chunkOV3UJLGPjs.addAddon.call(void 0, key, this.addon.bind(this), this.addonPriority);
       this.onUnmount(() => {
-        delete _chunkXKK2SQ7Wjs.Context.addonRecord[key];
+        delete _chunkOV3UJLGPjs.Context.addonRecord[key];
       });
     }
     if (this.guard) {
-      _chunkXKK2SQ7Wjs.addGuard.call(void 0, key, this.guard.bind(this), this.guardPriority);
+      _chunkOV3UJLGPjs.addGuard.call(void 0, key, this.guard.bind(this), this.guardPriority);
       this.onUnmount(() => {
-        delete _chunkXKK2SQ7Wjs.Context.guardRecord[key];
+        delete _chunkOV3UJLGPjs.Context.guardRecord[key];
       });
     }
     if (this.filter) {
-      _chunkXKK2SQ7Wjs.addFilter.call(void 0, key, this.filter.bind(this));
+      _chunkOV3UJLGPjs.addFilter.call(void 0, key, this.filter.bind(this));
       this.onUnmount(() => {
-        delete _chunkXKK2SQ7Wjs.Context.filterRecord[key];
+        delete _chunkOV3UJLGPjs.Context.filterRecord[key];
       });
     }
   }
@@ -311,7 +311,7 @@ var HTTPGenerator = (_class5 = class extends Generator {constructor(...args4) {
   addMethod(args) {
     const { http, name, func, params, tag } = args;
     if (!_optionalChain([http, 'optionalAccess', _2 => _2.type])) return;
-    const url = _chunkXKK2SQ7Wjs.joinUrl.call(void 0, http.prefix, http.route).replace(/\/\:([^\/]*)/g, (_, js) => `/{{${js}}}`);
+    const url = _chunkOV3UJLGPjs.joinUrl.call(void 0, http.prefix, http.route).replace(/\/\:([^\/]*)/g, (_, js) => `/{{${js}}}`);
     if (!this.classMap[name]) this.classMap[name] = {};
     this.classMap[name][func] = `
     ${func}(...args){
@@ -354,9 +354,9 @@ var OpenAPIGenerator = (_class6 = class extends Generator {constructor(...args5)
   addMethod(args) {
     const { http, tag, func } = args;
     if (!_optionalChain([http, 'optionalAccess', _3 => _3.type])) return;
-    const path = _chunkXKK2SQ7Wjs.joinUrl.call(void 0, http.prefix, http.route);
+    const path = _chunkOV3UJLGPjs.joinUrl.call(void 0, http.prefix, http.route);
     if (!this.paths[path]) this.paths[path] = {};
-    const config = _phecdacore.getMergedMeta.call(void 0, _chunkZWPOWMZPjs.useS.call(void 0, ).getModel(tag), func).openapi;
+    const config = _phecdacore.getMergedMeta.call(void 0, _chunkJTSD2LIGjs.useS.call(void 0, ).getModel(tag), func).openapi;
     this.paths[path][http.type] = {
       summary: config.summary,
       description: config.description,
@@ -377,6 +377,41 @@ var OpenAPIGenerator = (_class6 = class extends Generator {constructor(...args5)
   }
 }, _class6);
 
+// src/generator/doc.ts
+var DocGenerator = (_class7 = class extends Generator {
+  static {
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "DocGenerator");
+  }
+  __init10() {this.name = "DOC"}
+  __init11() {this.classMap = {}}
+  constructor(path) {
+    super(path || ".ps/doc.json");_class7.prototype.__init10.call(this);_class7.prototype.__init11.call(this);;
+  }
+  getContent() {
+    return JSON.stringify(this.classMap);
+  }
+  addMethod(data) {
+    const { name, func } = data;
+    if (!data.rawMeta.doc) return;
+    if (!this.classMap[name]) this.classMap[name] = {};
+    this.classMap[name][func] = {
+      doc: data.rawMeta.doc,
+      params: data.params.filter((item) => item.rawMeta.doc).map((item) => {
+        return {
+          doc: item.rawMeta.doc,
+          index: item.index
+        };
+      })
+    };
+  }
+  generateCode(meta) {
+    meta.forEach(({ data }) => {
+      if (data.controller) this.addMethod(data);
+    });
+    return this.getContent();
+  }
+}, _class7);
+
 // src/index.ts
 
 
@@ -461,4 +496,5 @@ var OpenAPIGenerator = (_class6 = class extends Generator {constructor(...args5)
 
 
 
-exports.Addon = _chunkDPPDWBYOjs.Addon; exports.ApiDoc = _chunkDPPDWBYOjs.ApiDoc; exports.Arg = _chunkDPPDWBYOjs.Arg; exports.BadGatewayException = _chunkXKK2SQ7Wjs.BadGatewayException; exports.BadRequestException = _chunkXKK2SQ7Wjs.BadRequestException; exports.BaseParam = _chunkDPPDWBYOjs.BaseParam; exports.Body = _chunkDPPDWBYOjs.Body; exports.ConflictException = _chunkXKK2SQ7Wjs.ConflictException; exports.Context = _chunkXKK2SQ7Wjs.Context; exports.Controller = _chunkDPPDWBYOjs.Controller; exports.Ctx = _chunkDPPDWBYOjs.Ctx; exports.CustomResponse = CustomResponse; exports.Define = _chunkDPPDWBYOjs.Define; exports.Delete = _chunkDPPDWBYOjs.Delete; exports.ERROR_SYMBOL = _chunk4LLLQOMFjs.ERROR_SYMBOL; exports.Exception = _chunkXKK2SQ7Wjs.Exception; exports.Factory = _chunkZWPOWMZPjs.Factory; exports.Filter = _chunkDPPDWBYOjs.Filter; exports.ForbiddenException = _chunkXKK2SQ7Wjs.ForbiddenException; exports.FrameworkException = _chunkXKK2SQ7Wjs.FrameworkException; exports.Generator = Generator; exports.Get = _chunkDPPDWBYOjs.Get; exports.Guard = _chunkDPPDWBYOjs.Guard; exports.HTTPGenerator = HTTPGenerator; exports.Head = _chunkDPPDWBYOjs.Head; exports.Header = _chunkDPPDWBYOjs.Header; exports.HttpBase = HttpBase; exports.IS_DEV = _chunk4LLLQOMFjs.IS_DEV; exports.IS_ONLY_GENERATE = _chunk4LLLQOMFjs.IS_ONLY_GENERATE; exports.IS_PURE = _chunk4LLLQOMFjs.IS_PURE; exports.IS_STRICT = _chunk4LLLQOMFjs.IS_STRICT; exports.InvalidInputException = _chunkXKK2SQ7Wjs.InvalidInputException; exports.LOG_LEVEL = _chunk4LLLQOMFjs.LOG_LEVEL; exports.ManyFiles = _chunkDPPDWBYOjs.ManyFiles; exports.Meta = _chunkZWPOWMZPjs.Meta; exports.Mixin = _chunk4LLLQOMFjs.Mixin; exports.NotFoundException = _chunkXKK2SQ7Wjs.NotFoundException; exports.OneFile = _chunkDPPDWBYOjs.OneFile; exports.OpenAPIGenerator = OpenAPIGenerator; exports.PAddon = PAddon; exports.PExtension = PExtension; exports.PFilter = PFilter; exports.PGuard = PGuard; exports.PPipe = PPipe; exports.PS_EXIT_CODE = _chunk4LLLQOMFjs.PS_EXIT_CODE; exports.Param = _chunkDPPDWBYOjs.Param; exports.Patch = _chunkDPPDWBYOjs.Patch; exports.PayloadLargeException = _chunkXKK2SQ7Wjs.PayloadLargeException; exports.Pipe = _chunkDPPDWBYOjs.Pipe; exports.Post = _chunkDPPDWBYOjs.Post; exports.Put = _chunkDPPDWBYOjs.Put; exports.Query = _chunkDPPDWBYOjs.Query; exports.Queue = _chunkDPPDWBYOjs.Queue; exports.RPCGenerator = RPCGenerator; exports.Route = _chunkDPPDWBYOjs.Route; exports.Rpc = _chunkDPPDWBYOjs.Rpc; exports.RpcBase = RpcBase; exports.Search = _chunkDPPDWBYOjs.Search; exports.ServerBase = ServerBase; exports.ServerPhecda = _chunkZWPOWMZPjs.ServerPhecda; exports.ServiceUnavailableException = _chunkXKK2SQ7Wjs.ServiceUnavailableException; exports.TimeoutException = _chunkXKK2SQ7Wjs.TimeoutException; exports.TimerException = _chunkXKK2SQ7Wjs.TimerException; exports.UnauthorizedException = _chunkXKK2SQ7Wjs.UnauthorizedException; exports.UndefinedException = _chunkXKK2SQ7Wjs.UndefinedException; exports.UnsupportedMediaTypeException = _chunkXKK2SQ7Wjs.UnsupportedMediaTypeException; exports.ValidateException = _chunkXKK2SQ7Wjs.ValidateException; exports.WorkerException = _chunkXKK2SQ7Wjs.WorkerException; exports.addAddon = _chunkXKK2SQ7Wjs.addAddon; exports.addFilter = _chunkXKK2SQ7Wjs.addFilter; exports.addGuard = _chunkXKK2SQ7Wjs.addGuard; exports.addPipe = _chunkXKK2SQ7Wjs.addPipe; exports.defaultPipe = _chunkXKK2SQ7Wjs.defaultPipe; exports.defaultServerInject = _chunkZWPOWMZPjs.defaultServerInject; exports.emitter = _chunkZWPOWMZPjs.emitter; exports.getLogger = _chunk4LLLQOMFjs.getLogger; exports.log = _chunk4LLLQOMFjs.log; exports.phecdaNamespace = _chunkZWPOWMZPjs.phecdaNamespace; exports.runMiddleware = _chunk4LLLQOMFjs.runMiddleware; exports.setLogger = _chunk4LLLQOMFjs.setLogger; exports.useS = _chunkZWPOWMZPjs.useS;
+
+exports.Addon = _chunkDPPDWBYOjs.Addon; exports.ApiDoc = _chunkDPPDWBYOjs.ApiDoc; exports.Arg = _chunkDPPDWBYOjs.Arg; exports.BadGatewayException = _chunkOV3UJLGPjs.BadGatewayException; exports.BadRequestException = _chunkOV3UJLGPjs.BadRequestException; exports.BaseParam = _chunkDPPDWBYOjs.BaseParam; exports.Body = _chunkDPPDWBYOjs.Body; exports.ConflictException = _chunkOV3UJLGPjs.ConflictException; exports.Context = _chunkOV3UJLGPjs.Context; exports.Controller = _chunkDPPDWBYOjs.Controller; exports.Ctx = _chunkDPPDWBYOjs.Ctx; exports.CustomResponse = CustomResponse; exports.Define = _chunkDPPDWBYOjs.Define; exports.Delete = _chunkDPPDWBYOjs.Delete; exports.DocGenerator = DocGenerator; exports.ERROR_SYMBOL = _chunk4LLLQOMFjs.ERROR_SYMBOL; exports.Exception = _chunkOV3UJLGPjs.Exception; exports.Factory = _chunkJTSD2LIGjs.Factory; exports.Filter = _chunkDPPDWBYOjs.Filter; exports.ForbiddenException = _chunkOV3UJLGPjs.ForbiddenException; exports.FrameworkException = _chunkOV3UJLGPjs.FrameworkException; exports.Generator = Generator; exports.Get = _chunkDPPDWBYOjs.Get; exports.Guard = _chunkDPPDWBYOjs.Guard; exports.HTTPGenerator = HTTPGenerator; exports.Head = _chunkDPPDWBYOjs.Head; exports.Header = _chunkDPPDWBYOjs.Header; exports.HttpBase = HttpBase; exports.IS_DEV = _chunk4LLLQOMFjs.IS_DEV; exports.IS_ONLY_GENERATE = _chunk4LLLQOMFjs.IS_ONLY_GENERATE; exports.IS_PURE = _chunk4LLLQOMFjs.IS_PURE; exports.IS_STRICT = _chunk4LLLQOMFjs.IS_STRICT; exports.InvalidInputException = _chunkOV3UJLGPjs.InvalidInputException; exports.LOG_LEVEL = _chunk4LLLQOMFjs.LOG_LEVEL; exports.ManyFiles = _chunkDPPDWBYOjs.ManyFiles; exports.Meta = _chunkJTSD2LIGjs.Meta; exports.Mixin = _chunk4LLLQOMFjs.Mixin; exports.NotFoundException = _chunkOV3UJLGPjs.NotFoundException; exports.OneFile = _chunkDPPDWBYOjs.OneFile; exports.OpenAPIGenerator = OpenAPIGenerator; exports.PAddon = PAddon; exports.PExtension = PExtension; exports.PFilter = PFilter; exports.PGuard = PGuard; exports.PPipe = PPipe; exports.PS_EXIT_CODE = _chunk4LLLQOMFjs.PS_EXIT_CODE; exports.Param = _chunkDPPDWBYOjs.Param; exports.Patch = _chunkDPPDWBYOjs.Patch; exports.PayloadLargeException = _chunkOV3UJLGPjs.PayloadLargeException; exports.Pipe = _chunkDPPDWBYOjs.Pipe; exports.Post = _chunkDPPDWBYOjs.Post; exports.Put = _chunkDPPDWBYOjs.Put; exports.Query = _chunkDPPDWBYOjs.Query; exports.Queue = _chunkDPPDWBYOjs.Queue; exports.RPCGenerator = RPCGenerator; exports.Route = _chunkDPPDWBYOjs.Route; exports.Rpc = _chunkDPPDWBYOjs.Rpc; exports.RpcBase = RpcBase; exports.Search = _chunkDPPDWBYOjs.Search; exports.ServerBase = ServerBase; exports.ServerPhecda = _chunkJTSD2LIGjs.ServerPhecda; exports.ServiceUnavailableException = _chunkOV3UJLGPjs.ServiceUnavailableException; exports.TimeoutException = _chunkOV3UJLGPjs.TimeoutException; exports.TimerException = _chunkOV3UJLGPjs.TimerException; exports.UnauthorizedException = _chunkOV3UJLGPjs.UnauthorizedException; exports.UndefinedException = _chunkOV3UJLGPjs.UndefinedException; exports.UnsupportedMediaTypeException = _chunkOV3UJLGPjs.UnsupportedMediaTypeException; exports.ValidateException = _chunkOV3UJLGPjs.ValidateException; exports.WorkerException = _chunkOV3UJLGPjs.WorkerException; exports.addAddon = _chunkOV3UJLGPjs.addAddon; exports.addFilter = _chunkOV3UJLGPjs.addFilter; exports.addGuard = _chunkOV3UJLGPjs.addGuard; exports.addPipe = _chunkOV3UJLGPjs.addPipe; exports.defaultPipe = _chunkOV3UJLGPjs.defaultPipe; exports.defaultServerInject = _chunkJTSD2LIGjs.defaultServerInject; exports.emitter = _chunkJTSD2LIGjs.emitter; exports.getLogger = _chunk4LLLQOMFjs.getLogger; exports.log = _chunk4LLLQOMFjs.log; exports.phecdaNamespace = _chunkJTSD2LIGjs.phecdaNamespace; exports.runMiddleware = _chunk4LLLQOMFjs.runMiddleware; exports.setLogger = _chunk4LLLQOMFjs.setLogger; exports.useS = _chunkJTSD2LIGjs.useS;

package/dist/index.mjs

@@ -6,7 +6,7 @@ import {
   emitter,
   phecdaNamespace,
   useS
-} from "./chunk-AIAO6SV6.mjs";
+} from "./chunk-TQSHE4PZ.mjs";
 import {
   Addon,
   ApiDoc,
@@ -60,7 +60,7 @@ import {
   addPipe,
   defaultPipe,
   joinUrl
-} from "./chunk-E7EAPAGM.mjs";
+} from "./chunk-P3CS65OP.mjs";
 import {
   ERROR_SYMBOL,
   IS_DEV,
@@ -377,6 +377,41 @@ var OpenAPIGenerator = class extends Generator {
   }
 };
 
+// src/generator/doc.ts
+var DocGenerator = class extends Generator {
+  static {
+    __name(this, "DocGenerator");
+  }
+  name = "DOC";
+  classMap = {};
+  constructor(path) {
+    super(path || ".ps/doc.json");
+  }
+  getContent() {
+    return JSON.stringify(this.classMap);
+  }
+  addMethod(data) {
+    const { name, func } = data;
+    if (!data.rawMeta.doc) return;
+    if (!this.classMap[name]) this.classMap[name] = {};
+    this.classMap[name][func] = {
+      doc: data.rawMeta.doc,
+      params: data.params.filter((item) => item.rawMeta.doc).map((item) => {
+        return {
+          doc: item.rawMeta.doc,
+          index: item.index
+        };
+      })
+    };
+  }
+  generateCode(meta) {
+    meta.forEach(({ data }) => {
+      if (data.controller) this.addMethod(data);
+    });
+    return this.getContent();
+  }
+};
+
 // src/index.ts
 export * from "phecda-core";
 export {
@@ -394,6 +429,7 @@ export {
   CustomResponse,
   Define,
   Delete,
+  DocGenerator,
   ERROR_SYMBOL,
   Exception,
   Factory,

package/dist/{meta-BoS1E-Nz.d.mts → meta-C_eDyXnK.d.mts}

@@ -50,6 +50,7 @@ interface ServiceMetaData {
     name: string;
     tag: string;
     define?: any;
+    rawMeta: any;
     [key: string]: any;
 }
 interface ControllerMetaData extends ServiceMetaData {
@@ -71,6 +72,7 @@ interface ControllerMetaData extends ServiceMetaData {
         key: string;
         pipe?: string;
         define: Record<string, any>;
+        rawMeta: any;
     }[];
     guards: string[];
     pipe?: string;

package/dist/{meta-BoS1E-Nz.d.ts → meta-C_eDyXnK.d.ts}

@@ -50,6 +50,7 @@ interface ServiceMetaData {
     name: string;
     tag: string;
     define?: any;
+    rawMeta: any;
     [key: string]: any;
 }
 interface ControllerMetaData extends ServiceMetaData {
@@ -71,6 +72,7 @@ interface ControllerMetaData extends ServiceMetaData {
         key: string;
         pipe?: string;
         define: Record<string, any>;
+        rawMeta: any;
     }[];
     guards: string[];
     pipe?: string;

package/dist/rpc/bullmq/index.d.mts

@@ -1,8 +1,8 @@
 import { WorkerOptions, QueueOptions, Worker, Queue } from 'bullmq';
-import { F as Factory } from '../../core-DbqWh47p.mjs';
-import { R as RpcCtx, a as RpcServerOptions } from '../../types-E-rqlg3-.mjs';
+import { F as Factory } from '../../core-B5yKYkMJ.mjs';
+import { R as RpcCtx, a as RpcServerOptions } from '../../types-7-m2wEkP.mjs';
 import 'phecda-core';
-import '../../meta-BoS1E-Nz.mjs';
+import '../../meta-C_eDyXnK.mjs';
 
 interface BullmqCtx extends RpcCtx {
     type: 'bullmq';

package/dist/rpc/bullmq/index.d.ts

@@ -1,8 +1,8 @@
 import { WorkerOptions, QueueOptions, Worker, Queue } from 'bullmq';
-import { F as Factory } from '../../core-Rq7BhPHE.js';
-import { R as RpcCtx, a as RpcServerOptions } from '../../types-CInz3bD0.js';
+import { F as Factory } from '../../core-BRuvL6hY.js';
+import { R as RpcCtx, a as RpcServerOptions } from '../../types-B6aU8oT-.js';
 import 'phecda-core';
-import '../../meta-BoS1E-Nz.js';
+import '../../meta-C_eDyXnK.js';
 
 interface BullmqCtx extends RpcCtx {
     type: 'bullmq';

package/dist/rpc/bullmq/index.js

@@ -2,7 +2,7 @@
 
 
 
-var _chunkXKK2SQ7Wjs = require('../../chunk-XKK2SQ7W.js');
+var _chunkOV3UJLGPjs = require('../../chunk-OV3UJLGP.js');
 
 
 
@@ -17,14 +17,14 @@ async function create({ moduleMap, meta }, opts = {}) {
   const workerMap = {};
   const queueMap = {};
   const existQueue = /* @__PURE__ */ new Set();
-  const metaMap = _chunkXKK2SQ7Wjs.createControllerMetaMap.call(void 0, meta, (meta2) => {
+  const metaMap = _chunkOV3UJLGPjs.createControllerMetaMap.call(void 0, meta, (meta2) => {
     const { controller, rpc, func, tag } = meta2.data;
     if (controller === "rpc" && _optionalChain([rpc, 'optionalAccess', _ => _.queue]) !== void 0) {
       debug(`register method "${func}" in module "${tag}"`);
       return true;
     }
   });
-  _chunkXKK2SQ7Wjs.detectAopDep.call(void 0, meta, {
+  _chunkOV3UJLGPjs.detectAopDep.call(void 0, meta, {
     guards: globalGuards
   }, "rpc");
   async function subscribeQueues() {
@@ -38,7 +38,7 @@ async function create({ moduleMap, meta }, opts = {}) {
           if (existQueue.has(queue)) continue;
           existQueue.add(queue);
           workerMap[queue] = new (0, _bullmq.Worker)(queue, handleRequest, workerOpts);
-          _chunkXKK2SQ7Wjs.Context.applyAddons(addons, workerMap[queue], "bullmq");
+          _chunkOV3UJLGPjs.Context.applyAddons(addons, workerMap[queue], "bullmq");
         }
       }
     }
@@ -52,12 +52,12 @@ async function create({ moduleMap, meta }, opts = {}) {
     const meta2 = metaMap.get(tag)[func];
     const { data: { rpc: { isEvent } = {} } } = meta2;
     if (!isEvent && !(clientQueue in queueMap)) queueMap[clientQueue] = new (0, _bullmq.Queue)(clientQueue, queueOpts);
-    const aop = _chunkXKK2SQ7Wjs.Context.getAop(meta2, {
+    const aop = _chunkOV3UJLGPjs.Context.getAop(meta2, {
       globalFilter,
       globalGuards,
       globalPipe
     });
-    const context = new (0, _chunkXKK2SQ7Wjs.Context)({
+    const context = new (0, _chunkOV3UJLGPjs.Context)({
       type: "bullmq",
       category: "rpc",
       moduleMap,

package/dist/rpc/bullmq/index.mjs

@@ -2,7 +2,7 @@ import {
   Context,
   createControllerMetaMap,
   detectAopDep
-} from "../../chunk-E7EAPAGM.mjs";
+} from "../../chunk-P3CS65OP.mjs";
 import {
   HMR,
   __name

package/dist/rpc/electron/index.d.mts

@@ -1,8 +1,8 @@
 import Electron from 'electron';
-import { F as Factory } from '../../core-DbqWh47p.mjs';
-import { R as RpcCtx, a as RpcServerOptions } from '../../types-E-rqlg3-.mjs';
+import { F as Factory } from '../../core-B5yKYkMJ.mjs';
+import { R as RpcCtx, a as RpcServerOptions } from '../../types-7-m2wEkP.mjs';
 import 'phecda-core';
-import '../../meta-BoS1E-Nz.mjs';
+import '../../meta-C_eDyXnK.mjs';
 
 interface ElectronCtx extends RpcCtx {
     type: 'electron';

package/dist/rpc/electron/index.d.ts

@@ -1,8 +1,8 @@
 import Electron from 'electron';
-import { F as Factory } from '../../core-Rq7BhPHE.js';
-import { R as RpcCtx, a as RpcServerOptions } from '../../types-CInz3bD0.js';
+import { F as Factory } from '../../core-BRuvL6hY.js';
+import { R as RpcCtx, a as RpcServerOptions } from '../../types-B6aU8oT-.js';
 import 'phecda-core';
-import '../../meta-BoS1E-Nz.js';
+import '../../meta-C_eDyXnK.js';
 
 interface ElectronCtx extends RpcCtx {
     type: 'electron';

package/dist/rpc/electron/index.js

@@ -2,7 +2,7 @@
 
 
 
-var _chunkXKK2SQ7Wjs = require('../../chunk-XKK2SQ7W.js');
+var _chunkOV3UJLGPjs = require('../../chunk-OV3UJLGP.js');
 
 
 var _chunk4LLLQOMFjs = require('../../chunk-4LLLQOMF.js');
@@ -12,14 +12,14 @@ var _debug = require('debug'); var _debug2 = _interopRequireDefault(_debug);
 var debug = _debug2.default.call(void 0, "phecda-server/electron");
 function bind(IPC, { moduleMap, meta }, opts = {}) {
   const { globalGuards, globalFilter, globalPipe, globalAddons = [] } = opts;
-  const metaMap = _chunkXKK2SQ7Wjs.createControllerMetaMap.call(void 0, meta, (meta2) => {
+  const metaMap = _chunkOV3UJLGPjs.createControllerMetaMap.call(void 0, meta, (meta2) => {
     const { controller, rpc, func, tag } = meta2.data;
     if (controller === "rpc" && _optionalChain([rpc, 'optionalAccess', _ => _.queue]) !== void 0) {
       debug(`register method "${func}" in module "${tag}"`);
       return true;
     }
   });
-  _chunkXKK2SQ7Wjs.detectAopDep.call(void 0, meta, {
+  _chunkOV3UJLGPjs.detectAopDep.call(void 0, meta, {
     guards: globalGuards,
     addons: globalAddons
   }, "rpc");
@@ -31,12 +31,12 @@ function bind(IPC, { moduleMap, meta }, opts = {}) {
     if (_ps !== 1) return;
     const meta2 = metaMap.get(tag)[func];
     const { data: { rpc: { isEvent } = {} } } = meta2;
-    const aop = _chunkXKK2SQ7Wjs.Context.getAop(meta2, {
+    const aop = _chunkOV3UJLGPjs.Context.getAop(meta2, {
       globalFilter,
       globalGuards,
       globalPipe
     });
-    const context = new (0, _chunkXKK2SQ7Wjs.Context)({
+    const context = new (0, _chunkOV3UJLGPjs.Context)({
       type: "electron",
       category: "rpc",
       moduleMap,

package/dist/rpc/electron/index.mjs

@@ -2,7 +2,7 @@ import {
   Context,
   createControllerMetaMap,
   detectAopDep
-} from "../../chunk-E7EAPAGM.mjs";
+} from "../../chunk-P3CS65OP.mjs";
 import {
   __name
 } from "../../chunk-NQ55PA2X.mjs";

package/dist/rpc/kafka/index.d.mts

@@ -1,8 +1,8 @@
 import { Consumer, Producer } from 'kafkajs';
-import { F as Factory } from '../../core-DbqWh47p.mjs';
-import { R as RpcCtx, a as RpcServerOptions } from '../../types-E-rqlg3-.mjs';
+import { F as Factory } from '../../core-B5yKYkMJ.mjs';
+import { R as RpcCtx, a as RpcServerOptions } from '../../types-7-m2wEkP.mjs';
 import 'phecda-core';
-import '../../meta-BoS1E-Nz.mjs';
+import '../../meta-C_eDyXnK.mjs';
 
 interface KafkaCtx extends RpcCtx {
     type: 'kafka';

package/dist/rpc/kafka/index.d.ts

@@ -1,8 +1,8 @@
 import { Consumer, Producer } from 'kafkajs';
-import { F as Factory } from '../../core-Rq7BhPHE.js';
-import { R as RpcCtx, a as RpcServerOptions } from '../../types-CInz3bD0.js';
+import { F as Factory } from '../../core-BRuvL6hY.js';
+import { R as RpcCtx, a as RpcServerOptions } from '../../types-B6aU8oT-.js';
 import 'phecda-core';
-import '../../meta-BoS1E-Nz.js';
+import '../../meta-C_eDyXnK.js';
 
 interface KafkaCtx extends RpcCtx {
     type: 'kafka';

package/dist/rpc/kafka/index.js

@@ -2,7 +2,7 @@
 
 
 
-var _chunkXKK2SQ7Wjs = require('../../chunk-XKK2SQ7W.js');
+var _chunkOV3UJLGPjs = require('../../chunk-OV3UJLGP.js');
 
 
 var _chunk4LLLQOMFjs = require('../../chunk-4LLLQOMF.js');
@@ -13,18 +13,18 @@ var debug = _debug2.default.call(void 0, "phecda-server/kafka");
 async function bind({ consumer, producer }, { moduleMap, meta }, opts = {}) {
   const { globalGuards, globalFilter, globalPipe, globalAddons = [], defaultQueue } = opts;
   const existQueue = /* @__PURE__ */ new Set();
-  const metaMap = _chunkXKK2SQ7Wjs.createControllerMetaMap.call(void 0, meta, (meta2) => {
+  const metaMap = _chunkOV3UJLGPjs.createControllerMetaMap.call(void 0, meta, (meta2) => {
     const { controller, rpc, func, tag } = meta2.data;
     if (controller === "rpc" && _optionalChain([rpc, 'optionalAccess', _ => _.queue]) !== void 0) {
       debug(`register method "${func}" in module "${tag}"`);
       return true;
     }
   });
-  _chunkXKK2SQ7Wjs.detectAopDep.call(void 0, meta, {
+  _chunkOV3UJLGPjs.detectAopDep.call(void 0, meta, {
     guards: globalGuards,
     addons: globalAddons
   }, "rpc");
-  _chunkXKK2SQ7Wjs.Context.applyAddons(globalAddons, {
+  _chunkOV3UJLGPjs.Context.applyAddons(globalAddons, {
     consumer,
     producer
   }, "kafka");
@@ -58,12 +58,12 @@ async function bind({ consumer, producer }, { moduleMap, meta }, opts = {}) {
       const meta2 = metaMap.get(tag)[func];
       const { data: { rpc } } = meta2;
       const isEvent = rpc.isEvent;
-      const aop = _chunkXKK2SQ7Wjs.Context.getAop(meta2, {
+      const aop = _chunkOV3UJLGPjs.Context.getAop(meta2, {
         globalFilter,
         globalGuards,
         globalPipe
       });
-      const context = new (0, _chunkXKK2SQ7Wjs.Context)({
+      const context = new (0, _chunkOV3UJLGPjs.Context)({
         type: "kafka",
         category: "rpc",
         moduleMap,

package/dist/rpc/kafka/index.mjs

@@ -2,7 +2,7 @@ import {
   Context,
   createControllerMetaMap,
   detectAopDep
-} from "../../chunk-E7EAPAGM.mjs";
+} from "../../chunk-P3CS65OP.mjs";
 import {
   __name
 } from "../../chunk-NQ55PA2X.mjs";

package/dist/rpc/nats/index.d.mts

@@ -1,8 +1,8 @@
 import { NatsConnection } from 'nats';
-import { F as Factory } from '../../core-DbqWh47p.mjs';
-import { R as RpcCtx, a as RpcServerOptions } from '../../types-E-rqlg3-.mjs';
+import { F as Factory } from '../../core-B5yKYkMJ.mjs';
+import { R as RpcCtx, a as RpcServerOptions } from '../../types-7-m2wEkP.mjs';
 import 'phecda-core';
-import '../../meta-BoS1E-Nz.mjs';
+import '../../meta-C_eDyXnK.mjs';
 
 interface NatsCtx extends RpcCtx {
     type: 'nats';

package/dist/rpc/nats/index.d.ts

@@ -1,8 +1,8 @@
 import { NatsConnection } from 'nats';
-import { F as Factory } from '../../core-Rq7BhPHE.js';
-import { R as RpcCtx, a as RpcServerOptions } from '../../types-CInz3bD0.js';
+import { F as Factory } from '../../core-BRuvL6hY.js';
+import { R as RpcCtx, a as RpcServerOptions } from '../../types-B6aU8oT-.js';
 import 'phecda-core';
-import '../../meta-BoS1E-Nz.js';
+import '../../meta-C_eDyXnK.js';
 
 interface NatsCtx extends RpcCtx {
     type: 'nats';