phecda-server 7.0.0-alpha.9 → 7.0.1

package/dist/index.d.mts

@@ -1,13 +1,13 @@
-import { B as BaseCtx, C as ControllerMeta, D as DefaultOptions, a as ControllerMetaData, b as MetaData, E as Emitter, c as BaseError } from './meta-BX5jhe4Z.mjs';
-export { g as BaseRequestType, f as BaseReturn, h as CustomResponse, j as ERROR_SYMBOL, i as ExtractResponse, I as IS_DEV, k as IS_ONLY_GENERATE, l as IS_STRICT, L as LOG_LEVEL, M as Meta, O as OmitFunction, m as PS_EXIT_CODE, P as PickFunc, S as ServiceMetaData, e as ToClientFn, d as ToClientInstance, T as ToClientMap } from './meta-BX5jhe4Z.mjs';
-import { G as Generator } from './core-BDkhrEyf.mjs';
-export { F as Factory, O as Options, S as ServerPhecda, d as defaultServerInject, e as emitter, p as phecdaNamespace, u as useS } from './core-BDkhrEyf.mjs';
+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.mjs';
+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.mjs';
+import { G as Generator } from './core-DbqWh47p.mjs';
+export { F as Factory, O as Options, S as ServerPhecda, d as defaultServerInject, e as emitter, p as phecdaNamespace, u as useS } from './core-DbqWh47p.mjs';
 import { Base } from 'phecda-core';
 export * from 'phecda-core';
-import { H as HttpCtx } from './types-DKVhyZk_.mjs';
-export { C as CookieSerializeOptions, a as HttpOptions } from './types-DKVhyZk_.mjs';
-import { R as RpcCtx } from './types-B-rUM9Fm.mjs';
-export { b as RpcClientOptions, a as RpcServerOptions } from './types-B-rUM9Fm.mjs';
+import { H as HttpCtx } from './types-SCJZFCYt.mjs';
+export { C as CookieSerializeOptions, a as HttpOptions } from './types-SCJZFCYt.mjs';
+import { R as RpcCtx } from './types-E-rqlg3-.mjs';
+export { a as RpcServerOptions } from './types-E-rqlg3-.mjs';
 export { Mixin } from 'ts-mixer';
 import 'node:http';
 
@@ -120,7 +120,6 @@ declare class Context<Ctx extends BaseCtx> {
         priority: number;
     }>;
     ctx: Ctx;
-    protected canGetCtx: boolean;
     constructor(data: Ctx);
     static getAop(meta: ControllerMeta, opts: DefaultOptions): {
         guards: GuardType<any>[];
@@ -149,7 +148,7 @@ declare class RPCGenerator extends Generator {
     }>;
     getContent(): string;
     addMethod(args: ControllerMetaData): void;
-    generateCode(meta: MetaData[]): string;
+    generateCode(meta: Meta[]): string;
 }
 
 declare class HTTPGenerator extends Generator {
@@ -159,7 +158,15 @@ declare class HTTPGenerator extends Generator {
     }>;
     getContent(): string;
     addMethod(args: ControllerMetaData): void;
-    generateCode(meta: MetaData[]): string;
+    generateCode(meta: Meta[]): string;
+}
+
+declare class OpenAPIGenerator extends Generator {
+    name: string;
+    paths: Record<string, any>;
+    getContent(): string;
+    addMethod(args: ControllerMetaData): void;
+    generateCode(meta: Meta[]): string;
 }
 
 declare function BaseParam(data: Record<string, any>): ParameterDecorator;
@@ -168,6 +175,8 @@ declare function Head(key: string): ParameterDecorator;
 declare function Query(key?: string): ParameterDecorator;
 declare function Param(key: string): ParameterDecorator;
 declare function Arg(target: any, k: string, index: number): void;
+declare function OneFile(key?: string): ParameterDecorator;
+declare function ManyFiles(key?: string): ParameterDecorator;
 
 declare function Guard(...guards: string[]): (target: any, property?: PropertyKey) => void;
 declare function Addon(...addons: string[]): (target: any, property?: PropertyKey) => void;
@@ -190,6 +199,61 @@ declare function Rpc(): ClassDecorator;
 declare const Ctx: PropertyDecorator;
 declare function Define(key: string, value: any): any;
 
+interface OpenAPIBaseConfig {
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    deprecated?: boolean;
+}
+interface OpenAPIParameterConfig {
+    name: string;
+    in: 'query' | 'header' | 'path' | 'cookie';
+    description?: string;
+    required?: boolean;
+    schema: {
+        type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+        items?: any;
+        properties?: Record<string, any>;
+    };
+}
+interface OpenAPIResponseConfig {
+    description: string;
+    content?: {
+        [key: string]: {
+            schema: {
+                type: string;
+                properties?: Record<string, any>;
+                items?: any;
+                description?: string;
+            };
+        };
+    };
+}
+interface OpenAPIConfig extends OpenAPIBaseConfig {
+    parameters?: OpenAPIParameterConfig[];
+    requestBody?: {
+        required?: boolean;
+        content: {
+            [key: string]: {
+                schema: {
+                    type: string;
+                    properties?: Record<string, any>;
+                    items?: any;
+                    [key: string]: any;
+                };
+            };
+        };
+    };
+    responses?: {
+        [statusCode: string]: OpenAPIResponseConfig;
+    };
+}
+/**
+ * OpenAPI 装饰器函数
+ * @param config OpenAPI/Swagger 配置
+ */
+declare function ApiDoc(config: OpenAPIConfig): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+
 declare const defaultPipe: PipeType;
 
 type LogLevel = 'error' | 'info' | 'warn' | 'log' | 'debug';
@@ -265,4 +329,4 @@ declare class PExtension extends ServerBase {
     constructor(tag?: string);
 }
 
-export { type AOP, Addon, 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, MetaData, NotFoundException, 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, 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.d.ts

@@ -1,13 +1,13 @@
-import { B as BaseCtx, C as ControllerMeta, D as DefaultOptions, a as ControllerMetaData, b as MetaData, E as Emitter, c as BaseError } from './meta-BX5jhe4Z.js';
-export { g as BaseRequestType, f as BaseReturn, h as CustomResponse, j as ERROR_SYMBOL, i as ExtractResponse, I as IS_DEV, k as IS_ONLY_GENERATE, l as IS_STRICT, L as LOG_LEVEL, M as Meta, O as OmitFunction, m as PS_EXIT_CODE, P as PickFunc, S as ServiceMetaData, e as ToClientFn, d as ToClientInstance, T as ToClientMap } from './meta-BX5jhe4Z.js';
-import { G as Generator } from './core-D_cz0tKa.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-D_cz0tKa.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-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 { Base } from 'phecda-core';
 export * from 'phecda-core';
-import { H as HttpCtx } from './types-CMeuFoyd.js';
-export { C as CookieSerializeOptions, a as HttpOptions } from './types-CMeuFoyd.js';
-import { R as RpcCtx } from './types-MxxtkZXw.js';
-export { b as RpcClientOptions, a as RpcServerOptions } from './types-MxxtkZXw.js';
+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';
 export { Mixin } from 'ts-mixer';
 import 'node:http';
 
@@ -120,7 +120,6 @@ declare class Context<Ctx extends BaseCtx> {
         priority: number;
     }>;
     ctx: Ctx;
-    protected canGetCtx: boolean;
     constructor(data: Ctx);
     static getAop(meta: ControllerMeta, opts: DefaultOptions): {
         guards: GuardType<any>[];
@@ -149,7 +148,7 @@ declare class RPCGenerator extends Generator {
     }>;
     getContent(): string;
     addMethod(args: ControllerMetaData): void;
-    generateCode(meta: MetaData[]): string;
+    generateCode(meta: Meta[]): string;
 }
 
 declare class HTTPGenerator extends Generator {
@@ -159,7 +158,15 @@ declare class HTTPGenerator extends Generator {
     }>;
     getContent(): string;
     addMethod(args: ControllerMetaData): void;
-    generateCode(meta: MetaData[]): string;
+    generateCode(meta: Meta[]): string;
+}
+
+declare class OpenAPIGenerator extends Generator {
+    name: string;
+    paths: Record<string, any>;
+    getContent(): string;
+    addMethod(args: ControllerMetaData): void;
+    generateCode(meta: Meta[]): string;
 }
 
 declare function BaseParam(data: Record<string, any>): ParameterDecorator;
@@ -168,6 +175,8 @@ declare function Head(key: string): ParameterDecorator;
 declare function Query(key?: string): ParameterDecorator;
 declare function Param(key: string): ParameterDecorator;
 declare function Arg(target: any, k: string, index: number): void;
+declare function OneFile(key?: string): ParameterDecorator;
+declare function ManyFiles(key?: string): ParameterDecorator;
 
 declare function Guard(...guards: string[]): (target: any, property?: PropertyKey) => void;
 declare function Addon(...addons: string[]): (target: any, property?: PropertyKey) => void;
@@ -190,6 +199,61 @@ declare function Rpc(): ClassDecorator;
 declare const Ctx: PropertyDecorator;
 declare function Define(key: string, value: any): any;
 
+interface OpenAPIBaseConfig {
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    deprecated?: boolean;
+}
+interface OpenAPIParameterConfig {
+    name: string;
+    in: 'query' | 'header' | 'path' | 'cookie';
+    description?: string;
+    required?: boolean;
+    schema: {
+        type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+        items?: any;
+        properties?: Record<string, any>;
+    };
+}
+interface OpenAPIResponseConfig {
+    description: string;
+    content?: {
+        [key: string]: {
+            schema: {
+                type: string;
+                properties?: Record<string, any>;
+                items?: any;
+                description?: string;
+            };
+        };
+    };
+}
+interface OpenAPIConfig extends OpenAPIBaseConfig {
+    parameters?: OpenAPIParameterConfig[];
+    requestBody?: {
+        required?: boolean;
+        content: {
+            [key: string]: {
+                schema: {
+                    type: string;
+                    properties?: Record<string, any>;
+                    items?: any;
+                    [key: string]: any;
+                };
+            };
+        };
+    };
+    responses?: {
+        [statusCode: string]: OpenAPIResponseConfig;
+    };
+}
+/**
+ * OpenAPI 装饰器函数
+ * @param config OpenAPI/Swagger 配置
+ */
+declare function ApiDoc(config: OpenAPIConfig): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+
 declare const defaultPipe: PipeType;
 
 type LogLevel = 'error' | 'info' | 'warn' | 'log' | 'debug';
@@ -265,4 +329,4 @@ declare class PExtension extends ServerBase {
     constructor(tag?: string);
 }
 
-export { type AOP, Addon, 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, MetaData, NotFoundException, 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, 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;
+"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;
 
 
 
@@ -6,7 +6,7 @@
 
 
 
-var _chunkKJUD2BKEjs = require('./chunk-KJUD2BKE.js');
+var _chunkZWPOWMZPjs = require('./chunk-ZWPOWMZP.js');
 
 
 
@@ -31,10 +31,10 @@ var _chunkKJUD2BKEjs = require('./chunk-KJUD2BKE.js');
 
 
 
-var _chunkV5EYXVJTjs = require('./chunk-V5EYXVJT.js');
 
 
 
+var _chunkDPPDWBYOjs = require('./chunk-DPPDWBYO.js');
 
 
 
@@ -57,10 +57,10 @@ var _chunkV5EYXVJTjs = require('./chunk-V5EYXVJT.js');
 
 
 
-var _chunkFX3LDQIIjs = require('./chunk-FX3LDQII.js');
 
 
 
+var _chunkXKK2SQ7Wjs = require('./chunk-XKK2SQ7W.js');
 
 
 
@@ -71,13 +71,16 @@ var _chunkFX3LDQIIjs = require('./chunk-FX3LDQII.js');
 
 
 
-var _chunk5RBTN33Ajs = require('./chunk-5RBTN33A.js');
+
+
+
+
+var _chunk4LLLQOMFjs = require('./chunk-4LLLQOMF.js');
 
 // src/types.ts
-var ResponseSymbol = Symbol("response");
 var CustomResponse = class {
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "CustomResponse");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "CustomResponse");
   }
   
 };
@@ -90,38 +93,38 @@ function _ts_decorate(decorators, target, key, desc) {
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-_chunk5RBTN33Ajs.__name.call(void 0, _ts_decorate, "_ts_decorate");
+_chunk4LLLQOMFjs.__name.call(void 0, _ts_decorate, "_ts_decorate");
 function _ts_metadata(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-_chunk5RBTN33Ajs.__name.call(void 0, _ts_metadata, "_ts_metadata");
+_chunk4LLLQOMFjs.__name.call(void 0, _ts_metadata, "_ts_metadata");
 var ServerBase = (_class = class extends _phecdacore.Base {constructor(...args2) { super(...args2); _class.prototype.__init.call(this); }
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "ServerBase");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "ServerBase");
   }
-  __init() {this.emitter = exports.emitter = _chunkKJUD2BKEjs.emitter}
+  __init() {this.emitter = exports.emitter = _chunkZWPOWMZPjs.emitter}
   log(msg, level = "log") {
-    _chunk5RBTN33Ajs.log.call(void 0, msg, level, this.tag);
+    _chunk4LLLQOMFjs.log.call(void 0, msg, level, this.tag);
   }
 }, _class);
 var HttpBase = class extends ServerBase {
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "HttpBase");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "HttpBase");
   }
   
 };
 _ts_decorate([
-  _chunkV5EYXVJTjs.Ctx,
+  _chunkDPPDWBYOjs.Ctx,
   _ts_metadata("design:type", typeof Ctx === "undefined" ? Object : Ctx)
 ], HttpBase.prototype, "context", void 0);
 var RpcBase = class extends ServerBase {
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "RpcBase");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "RpcBase");
   }
   
 };
 _ts_decorate([
-  _chunkV5EYXVJTjs.Ctx,
+  _chunkDPPDWBYOjs.Ctx,
   _ts_metadata("design:type", typeof Ctx === "undefined" ? Object : Ctx)
 ], RpcBase.prototype, "context", void 0);
 
@@ -129,15 +132,15 @@ _ts_decorate([
 
 var PFilter = class extends ServerBase {
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "PFilter");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "PFilter");
   }
   
   constructor(tag) {
     super();
     this.key = tag || _phecdacore.getTag.call(void 0, this);
-    _chunkFX3LDQIIjs.addFilter.call(void 0, this.key, this.use.bind(this));
+    _chunkXKK2SQ7Wjs.addFilter.call(void 0, this.key, this.use.bind(this));
     this.onUnmount(() => {
-      delete _chunkFX3LDQIIjs.Context.filterRecord[this.key];
+      delete _chunkXKK2SQ7Wjs.Context.filterRecord[this.key];
     });
   }
 };
@@ -146,16 +149,16 @@ var PFilter = class extends ServerBase {
 
 var PGuard = (_class2 = class extends ServerBase {
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "PGuard");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "PGuard");
   }
   
   __init2() {this.priority = 0}
   constructor(tag) {
     super();_class2.prototype.__init2.call(this);;
     this.key = tag || _phecdacore.getTag.call(void 0, this);
-    _chunkFX3LDQIIjs.addGuard.call(void 0, this.key, this.use.bind(this), this.priority);
+    _chunkXKK2SQ7Wjs.addGuard.call(void 0, this.key, this.use.bind(this), this.priority);
     this.onUnmount(() => {
-      delete _chunkFX3LDQIIjs.Context.guardRecord[this.key];
+      delete _chunkXKK2SQ7Wjs.Context.guardRecord[this.key];
     });
   }
 }, _class2);
@@ -164,15 +167,15 @@ var PGuard = (_class2 = class extends ServerBase {
 
 var PPipe = class extends ServerBase {
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "PPipe");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "PPipe");
   }
   
   constructor(tag) {
     super();
     this.key = tag || _phecdacore.getTag.call(void 0, this);
-    _chunkFX3LDQIIjs.addPipe.call(void 0, this.key, this.use.bind(this));
+    _chunkXKK2SQ7Wjs.addPipe.call(void 0, this.key, this.use.bind(this));
     this.onUnmount(() => {
-      delete _chunkFX3LDQIIjs.Context.pipeRecord[this.key];
+      delete _chunkXKK2SQ7Wjs.Context.pipeRecord[this.key];
     });
   }
 };
@@ -181,16 +184,16 @@ var PPipe = class extends ServerBase {
 
 var PAddon = (_class3 = class extends ServerBase {
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "PAddon");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "PAddon");
   }
   
   __init3() {this.priority = 0}
   constructor(tag) {
     super();_class3.prototype.__init3.call(this);;
     this.key = tag || _phecdacore.getTag.call(void 0, this);
-    _chunkFX3LDQIIjs.addAddon.call(void 0, this.key, this.use.bind(this), this.priority);
+    _chunkXKK2SQ7Wjs.addAddon.call(void 0, this.key, this.use.bind(this), this.priority);
     this.onUnmount(() => {
-      delete _chunkFX3LDQIIjs.Context.addonRecord[this.key];
+      delete _chunkXKK2SQ7Wjs.Context.addonRecord[this.key];
     });
   }
 }, _class3);
@@ -199,7 +202,7 @@ var PAddon = (_class3 = class extends ServerBase {
 
 var PExtension = class extends ServerBase {
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "PExtension");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "PExtension");
   }
   
   
@@ -208,27 +211,27 @@ var PExtension = class extends ServerBase {
     super();
     const key = this.key = tag || _phecdacore.getTag.call(void 0, this);
     if (this.pipe) {
-      _chunkFX3LDQIIjs.addPipe.call(void 0, key, this.pipe.bind(this));
+      _chunkXKK2SQ7Wjs.addPipe.call(void 0, key, this.pipe.bind(this));
       this.onUnmount(() => {
-        delete _chunkFX3LDQIIjs.Context.pipeRecord[key];
+        delete _chunkXKK2SQ7Wjs.Context.pipeRecord[key];
       });
     }
     if (this.addon) {
-      _chunkFX3LDQIIjs.addAddon.call(void 0, key, this.addon.bind(this), this.addonPriority);
+      _chunkXKK2SQ7Wjs.addAddon.call(void 0, key, this.addon.bind(this), this.addonPriority);
       this.onUnmount(() => {
-        delete _chunkFX3LDQIIjs.Context.addonRecord[key];
+        delete _chunkXKK2SQ7Wjs.Context.addonRecord[key];
       });
     }
     if (this.guard) {
-      _chunkFX3LDQIIjs.addGuard.call(void 0, key, this.guard.bind(this), this.guardPriority);
+      _chunkXKK2SQ7Wjs.addGuard.call(void 0, key, this.guard.bind(this), this.guardPriority);
       this.onUnmount(() => {
-        delete _chunkFX3LDQIIjs.Context.guardRecord[key];
+        delete _chunkXKK2SQ7Wjs.Context.guardRecord[key];
       });
     }
     if (this.filter) {
-      _chunkFX3LDQIIjs.addFilter.call(void 0, key, this.filter.bind(this));
+      _chunkXKK2SQ7Wjs.addFilter.call(void 0, key, this.filter.bind(this));
       this.onUnmount(() => {
-        delete _chunkFX3LDQIIjs.Context.filterRecord[key];
+        delete _chunkXKK2SQ7Wjs.Context.filterRecord[key];
       });
     }
   }
@@ -238,7 +241,7 @@ var PExtension = class extends ServerBase {
 var _fsextra = require('fs-extra'); var _fsextra2 = _interopRequireDefault(_fsextra);
 var Generator = class {
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "Generator");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "Generator");
   }
   
   constructor(path) {
@@ -248,14 +251,14 @@ var Generator = class {
     return this._path || `.ps/${this.name.toLowerCase()}.js`;
   }
   async output(meta) {
-    await _fsextra2.default.outputFile(this.path, this.generateCode(meta.map((item) => item.data)));
+    await _fsextra2.default.outputFile(this.path, this.generateCode(meta));
   }
 };
 
 // src/generator/rpc.ts
 var RPCGenerator = (_class4 = class extends Generator {constructor(...args3) { super(...args3); _class4.prototype.__init4.call(this);_class4.prototype.__init5.call(this); }
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "RPCGenerator");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "RPCGenerator");
   }
   __init4() {this.name = "RPC"}
   __init5() {this.classMap = {}}
@@ -281,9 +284,9 @@ var RPCGenerator = (_class4 = class extends Generator {constructor(...args3) { s
     `;
   }
   generateCode(meta) {
-    for (const i of meta) {
-      if (i.controller === "rpc") this.addMethod(i);
-    }
+    meta.forEach(({ data }) => {
+      if (data.controller === "rpc") this.addMethod(data);
+    });
     return this.getContent();
   }
 }, _class4);
@@ -291,7 +294,7 @@ var RPCGenerator = (_class4 = class extends Generator {constructor(...args3) { s
 // src/generator/http.ts
 var HTTPGenerator = (_class5 = class extends Generator {constructor(...args4) { super(...args4); _class5.prototype.__init6.call(this);_class5.prototype.__init7.call(this); }
   static {
-    _chunk5RBTN33Ajs.__name.call(void 0, this, "HTTPGenerator");
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "HTTPGenerator");
   }
   __init6() {this.name = "HTTP"}
   __init7() {this.classMap = {}}
@@ -308,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 = _chunkFX3LDQIIjs.joinUrl.call(void 0, http.prefix, http.route).replace(/\/\:([^\/]*)/g, (_, js) => `/{{${js}}}`);
+    const url = _chunkXKK2SQ7Wjs.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){
@@ -322,13 +325,58 @@ return ret
     `;
   }
   generateCode(meta) {
-    for (const i of meta) {
-      if (i.controller === "http") this.addMethod(i);
-    }
+    meta.forEach(({ data }) => {
+      if (data.controller === "http") this.addMethod(data);
+    });
     return this.getContent();
   }
 }, _class5);
 
+// src/generator/openapi.ts
+
+var OpenAPIGenerator = (_class6 = class extends Generator {constructor(...args5) { super(...args5); _class6.prototype.__init8.call(this);_class6.prototype.__init9.call(this); }
+  static {
+    _chunk4LLLQOMFjs.__name.call(void 0, this, "OpenAPIGenerator");
+  }
+  __init8() {this.name = "OpenAPI"}
+  __init9() {this.paths = {}}
+  getContent() {
+    return JSON.stringify({
+      openapi: "3.0.0",
+      info: {
+        title: "API Documentation",
+        version: "1.0.0",
+        description: "API documentation generated by phecda-server"
+      },
+      paths: this.paths
+    });
+  }
+  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);
+    if (!this.paths[path]) this.paths[path] = {};
+    const config = _phecdacore.getMergedMeta.call(void 0, _chunkZWPOWMZPjs.useS.call(void 0, ).getModel(tag), func).openapi;
+    this.paths[path][http.type] = {
+      summary: config.summary,
+      description: config.description,
+      tags: config.tags || [
+        tag
+      ],
+      deprecated: config.deprecated,
+      parameters: config.parameters,
+      requestBody: config.requestBody,
+      responses: config.responses
+    };
+  }
+  generateCode(meta) {
+    meta.forEach(({ data }) => {
+      if (data.controller === "http") this.addMethod(data);
+    });
+    return this.getContent();
+  }
+}, _class6);
+
 // src/index.ts
 
 
@@ -408,4 +456,9 @@ return ret
 
 
 
-exports.Addon = _chunkV5EYXVJTjs.Addon; exports.Arg = _chunkV5EYXVJTjs.Arg; exports.BadGatewayException = _chunkFX3LDQIIjs.BadGatewayException; exports.BadRequestException = _chunkFX3LDQIIjs.BadRequestException; exports.BaseParam = _chunkV5EYXVJTjs.BaseParam; exports.Body = _chunkV5EYXVJTjs.Body; exports.ConflictException = _chunkFX3LDQIIjs.ConflictException; exports.Context = _chunkFX3LDQIIjs.Context; exports.Controller = _chunkV5EYXVJTjs.Controller; exports.Ctx = _chunkV5EYXVJTjs.Ctx; exports.CustomResponse = CustomResponse; exports.Define = _chunkV5EYXVJTjs.Define; exports.Delete = _chunkV5EYXVJTjs.Delete; exports.ERROR_SYMBOL = _chunk5RBTN33Ajs.ERROR_SYMBOL; exports.Exception = _chunkFX3LDQIIjs.Exception; exports.Factory = _chunkKJUD2BKEjs.Factory; exports.Filter = _chunkV5EYXVJTjs.Filter; exports.ForbiddenException = _chunkFX3LDQIIjs.ForbiddenException; exports.FrameworkException = _chunkFX3LDQIIjs.FrameworkException; exports.Generator = Generator; exports.Get = _chunkV5EYXVJTjs.Get; exports.Guard = _chunkV5EYXVJTjs.Guard; exports.HTTPGenerator = HTTPGenerator; exports.Head = _chunkV5EYXVJTjs.Head; exports.Header = _chunkV5EYXVJTjs.Header; exports.HttpBase = HttpBase; exports.IS_DEV = _chunk5RBTN33Ajs.IS_DEV; exports.IS_ONLY_GENERATE = _chunk5RBTN33Ajs.IS_ONLY_GENERATE; exports.IS_STRICT = _chunk5RBTN33Ajs.IS_STRICT; exports.InvalidInputException = _chunkFX3LDQIIjs.InvalidInputException; exports.LOG_LEVEL = _chunk5RBTN33Ajs.LOG_LEVEL; exports.Meta = _chunkKJUD2BKEjs.Meta; exports.Mixin = _chunk5RBTN33Ajs.Mixin; exports.NotFoundException = _chunkFX3LDQIIjs.NotFoundException; exports.PAddon = PAddon; exports.PExtension = PExtension; exports.PFilter = PFilter; exports.PGuard = PGuard; exports.PPipe = PPipe; exports.PS_EXIT_CODE = _chunk5RBTN33Ajs.PS_EXIT_CODE; exports.Param = _chunkV5EYXVJTjs.Param; exports.Patch = _chunkV5EYXVJTjs.Patch; exports.PayloadLargeException = _chunkFX3LDQIIjs.PayloadLargeException; exports.Pipe = _chunkV5EYXVJTjs.Pipe; exports.Post = _chunkV5EYXVJTjs.Post; exports.Put = _chunkV5EYXVJTjs.Put; exports.Query = _chunkV5EYXVJTjs.Query; exports.Queue = _chunkV5EYXVJTjs.Queue; exports.RPCGenerator = RPCGenerator; exports.Route = _chunkV5EYXVJTjs.Route; exports.Rpc = _chunkV5EYXVJTjs.Rpc; exports.RpcBase = RpcBase; exports.Search = _chunkV5EYXVJTjs.Search; exports.ServerBase = ServerBase; exports.ServerPhecda = _chunkKJUD2BKEjs.ServerPhecda; exports.ServiceUnavailableException = _chunkFX3LDQIIjs.ServiceUnavailableException; exports.TimeoutException = _chunkFX3LDQIIjs.TimeoutException; exports.TimerException = _chunkFX3LDQIIjs.TimerException; exports.UnauthorizedException = _chunkFX3LDQIIjs.UnauthorizedException; exports.UndefinedException = _chunkFX3LDQIIjs.UndefinedException; exports.UnsupportedMediaTypeException = _chunkFX3LDQIIjs.UnsupportedMediaTypeException; exports.ValidateException = _chunkFX3LDQIIjs.ValidateException; exports.WorkerException = _chunkFX3LDQIIjs.WorkerException; exports.addAddon = _chunkFX3LDQIIjs.addAddon; exports.addFilter = _chunkFX3LDQIIjs.addFilter; exports.addGuard = _chunkFX3LDQIIjs.addGuard; exports.addPipe = _chunkFX3LDQIIjs.addPipe; exports.defaultPipe = _chunkFX3LDQIIjs.defaultPipe; exports.defaultServerInject = _chunkKJUD2BKEjs.defaultServerInject; exports.emitter = _chunkKJUD2BKEjs.emitter; exports.getLogger = _chunk5RBTN33Ajs.getLogger; exports.log = _chunk5RBTN33Ajs.log; exports.phecdaNamespace = _chunkKJUD2BKEjs.phecdaNamespace; exports.runMiddleware = _chunk5RBTN33Ajs.runMiddleware; exports.setLogger = _chunk5RBTN33Ajs.setLogger; exports.useS = _chunkKJUD2BKEjs.useS;
+
+
+
+
+
+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;