phecda-server 6.1.0 → 7.0.0-alpha.1

package/dist/index.d.mts

@@ -1,13 +1,13 @@
-import { B as BaseContext, D as DefaultOptions, C as ControllerMetaData, b as MetaData, E as Emitter, c as BaseError } from './meta-KtfiBIde.mjs';
-export { g as BaseRequestType, f as BaseReturn, a as ControllerMeta, h as CustomResponse, j as ERROR_SYMBOL, i as ExtractResponse, I as IS_HMR, 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-KtfiBIde.mjs';
-import { G as Generator } from './core-P1CsH6jz.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-P1CsH6jz.mjs';
+import { B as BaseContext, a as ControllerMeta, D as DefaultOptions, C as ControllerMetaData, b as MetaData, E as Emitter, c as BaseError } from './meta-BXKLFTgG.mjs';
+export { g as BaseRequestType, f as BaseReturn, h as CustomResponse, j as ERROR_SYMBOL, i as ExtractResponse, I as IS_HMR, 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-BXKLFTgG.mjs';
+import { G as Generator } from './core-BIcUwV18.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-BIcUwV18.mjs';
 import { Base } from 'phecda-core';
 export * from 'phecda-core';
-import { H as HttpContext } from './types-BvD3B5Ny.mjs';
-export { C as CookieSerializeOptions, a as HttpOptions } from './types-BvD3B5Ny.mjs';
-import { R as RpcContext } from './types-t9D1fU6G.mjs';
-export { b as RpcClientOptions, a as RpcServerOptions } from './types-t9D1fU6G.mjs';
+import { H as HttpContext } from './types-h40T3cRG.mjs';
+export { C as CookieSerializeOptions, a as HttpOptions } from './types-h40T3cRG.mjs';
+import { R as RpcContext } from './types-BtbL49Zs.mjs';
+export { b as RpcClientOptions, a as RpcServerOptions } from './types-BtbL49Zs.mjs';
 export { Mixin } from 'ts-mixer';
 import 'node:http';
 
@@ -88,6 +88,11 @@ declare class WorkerException extends Exception {
     constructor(message: string);
 }
 
+interface AOP {
+    guards: GuardType[];
+    pipe: PipeType[];
+    filter: FilterType;
+}
 interface PipeArg {
     arg: any;
     pipe?: string;
@@ -97,8 +102,7 @@ interface PipeArg {
     reflect: any;
     define: Record<string, any>;
 }
-type GuardType<C extends BaseContext = any> = ((ctx: C) => Promise<boolean> | boolean);
-type InterceptorType<C extends BaseContext = any> = (ctx: C) => (any | ((ret: any) => any));
+type GuardType<C extends BaseContext = any> = (ctx: C, next: () => Promise<any>) => any;
 type PipeType<C extends BaseContext = any> = (arg: PipeArg, ctx: C) => Promise<any>;
 type FilterType<C extends BaseContext = any, E extends Exception = any> = (err: E | Error, ctx?: C) => Error | any;
 declare class Context<Data extends BaseContext> {
@@ -107,24 +111,34 @@ declare class Context<Data extends BaseContext> {
     params: string[];
     static filterRecord: Record<PropertyKey, FilterType>;
     static pipeRecord: Record<PropertyKey, PipeType>;
-    static guardRecord: Record<PropertyKey, GuardType>;
-    static interceptorRecord: Record<PropertyKey, InterceptorType>;
-    static pluginRecord: Record<PropertyKey, (framework: string) => any>;
-    private postInterceptors;
+    static guardRecord: Record<PropertyKey, {
+        value: GuardType;
+        priority: number;
+    }>;
+    static addonRecord: Record<PropertyKey, {
+        value: (router: any, framework: string) => any;
+        priority: number;
+    }>;
     constructor(data: Data);
-    run<ReturnData = any, ReturnErr = any>(opts: DefaultOptions, successCb: (data: any) => ReturnData, failCb: (err: any) => ReturnErr): Promise<ReturnData | ReturnErr>;
-    private usePipe;
-    private useFilter;
-    private useGuard;
-    private usePostInterceptor;
-    private useInterceptor;
-    static usePlugin<Plugin>(plugins: string[], framework: string): Plugin[];
-}
-declare function addPlugin<T>(key: PropertyKey, handler: (framework: string) => T): void;
-declare function addPipe<C extends BaseContext>(key: PropertyKey, handler: PipeType<C>): void;
-declare function addFilter<C extends BaseContext>(key: PropertyKey, handler: FilterType<C>): void;
-declare function addGuard<C extends BaseContext>(key: PropertyKey, handler: GuardType<C>): void;
-declare function addInterceptor<C extends BaseContext>(key: PropertyKey, handler: InterceptorType<C>): void;
+    static getAop(meta: ControllerMeta, opts: DefaultOptions): {
+        guards: GuardType<any>[];
+        pipe: PipeType<any>[];
+        filter: FilterType<any, any>;
+    };
+    run<ResponseData = any, ReturnErr = any>({ guards, filter, pipe, }: {
+        guards: GuardType[];
+        filter: FilterType;
+        pipe: PipeType[];
+    }, successCb: (data: any) => ResponseData, failCb: (err: any) => ReturnErr): Promise<ResponseData | ReturnErr>;
+    static getPipe(pipe: string[]): PipeType<any>[];
+    static getFilter(filter?: string): FilterType<any, any>;
+    static getGuards(guards: string[]): GuardType<any>[];
+    static applyAddons(addons: string[], router: any, framework: string): void;
+}
+declare function addPipe<C extends BaseContext>(key: PropertyKey, pipe: PipeType<C>): void;
+declare function addFilter<C extends BaseContext>(key: PropertyKey, filter: FilterType<C>): void;
+declare function addGuard<C extends BaseContext>(key: PropertyKey, guard: GuardType<C>, priority?: number): void;
+declare function addAddon(key: PropertyKey, addon: (router: any, framework: string) => void, priority?: number): void;
 
 declare class RPCGenerator extends Generator {
     name: string;
@@ -154,8 +168,7 @@ declare function Param(key: string): ParameterDecorator;
 declare function Arg(target: any, k: string, index: number): void;
 
 declare function Guard(...guards: string[]): (target: any, property?: PropertyKey) => void;
-declare function Plugin(...plugins: string[]): (target: any, property?: PropertyKey) => void;
-declare function Interceptor(...interceptors: string[]): (target: any, property?: PropertyKey) => void;
+declare function Addon(...addons: string[]): (target: any, property?: PropertyKey) => void;
 declare function Filter(filter: string): (target: any, property?: PropertyKey) => void;
 declare function Pipe(pipe?: string): (target: any, property?: any, index?: any) => void;
 
@@ -194,14 +207,9 @@ declare abstract class PFilter<C extends BaseContext = any, E extends Exception
 }
 
 declare abstract class PGuard<C extends BaseContext = any> extends ServerBase {
-    abstract use(ctx: C): Promise<boolean> | boolean;
-    readonly key: PropertyKey;
-    constructor(tag?: string);
-}
-
-declare abstract class PInterceptor<C extends BaseContext = any> extends ServerBase {
-    abstract use(ctx: C): Function | Promise<Function> | any;
+    abstract use(ctx: C, next: () => Promise<any>): any;
     readonly key: PropertyKey;
+    priority: number;
     constructor(tag?: string);
 }
 
@@ -218,14 +226,14 @@ declare abstract class PPipe<C extends BaseContext = any> extends ServerBase {
     }, ctx: C): any;
 }
 
-declare abstract class PPlugin extends ServerBase {
+declare abstract class PAddon extends ServerBase {
     readonly key: PropertyKey;
+    priority: number;
     constructor(tag?: string);
-    abstract use<Plugin = any>(framework: string): Plugin | undefined;
+    abstract use(router: any, framework: string): undefined;
 }
 
 interface PExtension<C extends BaseContext = any, E extends Exception = Exception> {
-    intercept(ctx: C): Function | Promise<Function> | any;
     guard(ctx: C): Promise<boolean> | boolean;
     pipe(param: {
         arg: any;
@@ -236,10 +244,12 @@ interface PExtension<C extends BaseContext = any, E extends Exception = Exceptio
         reflect: any;
     }, ctx: C): any;
     filter(error: Error | E, ctx?: C): BaseError;
-    plugin<Plugin = any>(framework: string): Plugin;
+    addon<Addon = any>(framework: string): Addon;
 }
 declare class PExtension extends ServerBase {
     readonly key: PropertyKey;
+    guardPriority: number;
+    addonPriority: number;
     constructor(tag?: string);
 }
 
@@ -247,5 +257,6 @@ type LogLevel = 'error' | 'info' | 'warn' | 'log' | 'debug';
 declare function setLogger(logger: Record<LogLevel, (msg: string) => void>): void;
 declare function getLogger(): Record<LogLevel, (msg: string) => void>;
 declare function log(msg: string, level?: LogLevel): void;
+declare function runMiddleware(ctx: HttpContext, middleware: (req: any, res: any, next?: any) => any): Promise<unknown>;
 
-export { Arg, BadGatewayException, BadRequestException, BaseContext, BaseError, BaseParam, Body, ConflictException, Context, Controller, ControllerMetaData, Ctx, DefaultOptions, Define, Delete, Emitter, Exception, Filter, type FilterType, ForbiddenException, FrameworkException, Generator, Get, Guard, type GuardType, HTTPGenerator, Head, Header, HttpBase, HttpContext, Interceptor, type InterceptorType, InvalidInputException, MetaData, NotFoundException, PExtension, PFilter, PGuard, PInterceptor, PPipe, PPlugin, Param, Patch, PayloadLargeException, Pipe, type PipeArg, type PipeType, Plugin, Post, Put, Query, Queue, RPCGenerator, Route, Rpc, RpcBase, RpcContext, Search, ServerBase, ServiceUnavailableException, TimeoutException, TimerException, UnauthorizedException, UndefinedException, UnsupportedMediaTypeException, ValidateException, WorkerException, addFilter, addGuard, addInterceptor, addPipe, addPlugin, defaultPipe, getLogger, log, setLogger };
+export { type AOP, Addon, Arg, BadGatewayException, BadRequestException, BaseContext, 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, HttpContext, InvalidInputException, MetaData, NotFoundException, PAddon, PExtension, PFilter, PGuard, PPipe, Param, Patch, PayloadLargeException, Pipe, type PipeArg, type PipeType, Post, Put, Query, Queue, RPCGenerator, Route, Rpc, RpcBase, RpcContext, 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 BaseContext, D as DefaultOptions, C as ControllerMetaData, b as MetaData, E as Emitter, c as BaseError } from './meta-KtfiBIde.js';
-export { g as BaseRequestType, f as BaseReturn, a as ControllerMeta, h as CustomResponse, j as ERROR_SYMBOL, i as ExtractResponse, I as IS_HMR, 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-KtfiBIde.js';
-import { G as Generator } from './core-BlN0Spy9.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-BlN0Spy9.js';
+import { B as BaseContext, a as ControllerMeta, D as DefaultOptions, C as ControllerMetaData, b as MetaData, E as Emitter, c as BaseError } from './meta-BXKLFTgG.js';
+export { g as BaseRequestType, f as BaseReturn, h as CustomResponse, j as ERROR_SYMBOL, i as ExtractResponse, I as IS_HMR, 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-BXKLFTgG.js';
+import { G as Generator } from './core-CYwEPfN4.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-CYwEPfN4.js';
 import { Base } from 'phecda-core';
 export * from 'phecda-core';
-import { H as HttpContext } from './types-DIw7B6Up.js';
-export { C as CookieSerializeOptions, a as HttpOptions } from './types-DIw7B6Up.js';
-import { R as RpcContext } from './types-JVT0mgLD.js';
-export { b as RpcClientOptions, a as RpcServerOptions } from './types-JVT0mgLD.js';
+import { H as HttpContext } from './types-VFzEM7LL.js';
+export { C as CookieSerializeOptions, a as HttpOptions } from './types-VFzEM7LL.js';
+import { R as RpcContext } from './types-m3IEDKjP.js';
+export { b as RpcClientOptions, a as RpcServerOptions } from './types-m3IEDKjP.js';
 export { Mixin } from 'ts-mixer';
 import 'node:http';
 
@@ -88,6 +88,11 @@ declare class WorkerException extends Exception {
     constructor(message: string);
 }
 
+interface AOP {
+    guards: GuardType[];
+    pipe: PipeType[];
+    filter: FilterType;
+}
 interface PipeArg {
     arg: any;
     pipe?: string;
@@ -97,8 +102,7 @@ interface PipeArg {
     reflect: any;
     define: Record<string, any>;
 }
-type GuardType<C extends BaseContext = any> = ((ctx: C) => Promise<boolean> | boolean);
-type InterceptorType<C extends BaseContext = any> = (ctx: C) => (any | ((ret: any) => any));
+type GuardType<C extends BaseContext = any> = (ctx: C, next: () => Promise<any>) => any;
 type PipeType<C extends BaseContext = any> = (arg: PipeArg, ctx: C) => Promise<any>;
 type FilterType<C extends BaseContext = any, E extends Exception = any> = (err: E | Error, ctx?: C) => Error | any;
 declare class Context<Data extends BaseContext> {
@@ -107,24 +111,34 @@ declare class Context<Data extends BaseContext> {
     params: string[];
     static filterRecord: Record<PropertyKey, FilterType>;
     static pipeRecord: Record<PropertyKey, PipeType>;
-    static guardRecord: Record<PropertyKey, GuardType>;
-    static interceptorRecord: Record<PropertyKey, InterceptorType>;
-    static pluginRecord: Record<PropertyKey, (framework: string) => any>;
-    private postInterceptors;
+    static guardRecord: Record<PropertyKey, {
+        value: GuardType;
+        priority: number;
+    }>;
+    static addonRecord: Record<PropertyKey, {
+        value: (router: any, framework: string) => any;
+        priority: number;
+    }>;
     constructor(data: Data);
-    run<ReturnData = any, ReturnErr = any>(opts: DefaultOptions, successCb: (data: any) => ReturnData, failCb: (err: any) => ReturnErr): Promise<ReturnData | ReturnErr>;
-    private usePipe;
-    private useFilter;
-    private useGuard;
-    private usePostInterceptor;
-    private useInterceptor;
-    static usePlugin<Plugin>(plugins: string[], framework: string): Plugin[];
-}
-declare function addPlugin<T>(key: PropertyKey, handler: (framework: string) => T): void;
-declare function addPipe<C extends BaseContext>(key: PropertyKey, handler: PipeType<C>): void;
-declare function addFilter<C extends BaseContext>(key: PropertyKey, handler: FilterType<C>): void;
-declare function addGuard<C extends BaseContext>(key: PropertyKey, handler: GuardType<C>): void;
-declare function addInterceptor<C extends BaseContext>(key: PropertyKey, handler: InterceptorType<C>): void;
+    static getAop(meta: ControllerMeta, opts: DefaultOptions): {
+        guards: GuardType<any>[];
+        pipe: PipeType<any>[];
+        filter: FilterType<any, any>;
+    };
+    run<ResponseData = any, ReturnErr = any>({ guards, filter, pipe, }: {
+        guards: GuardType[];
+        filter: FilterType;
+        pipe: PipeType[];
+    }, successCb: (data: any) => ResponseData, failCb: (err: any) => ReturnErr): Promise<ResponseData | ReturnErr>;
+    static getPipe(pipe: string[]): PipeType<any>[];
+    static getFilter(filter?: string): FilterType<any, any>;
+    static getGuards(guards: string[]): GuardType<any>[];
+    static applyAddons(addons: string[], router: any, framework: string): void;
+}
+declare function addPipe<C extends BaseContext>(key: PropertyKey, pipe: PipeType<C>): void;
+declare function addFilter<C extends BaseContext>(key: PropertyKey, filter: FilterType<C>): void;
+declare function addGuard<C extends BaseContext>(key: PropertyKey, guard: GuardType<C>, priority?: number): void;
+declare function addAddon(key: PropertyKey, addon: (router: any, framework: string) => void, priority?: number): void;
 
 declare class RPCGenerator extends Generator {
     name: string;
@@ -154,8 +168,7 @@ declare function Param(key: string): ParameterDecorator;
 declare function Arg(target: any, k: string, index: number): void;
 
 declare function Guard(...guards: string[]): (target: any, property?: PropertyKey) => void;
-declare function Plugin(...plugins: string[]): (target: any, property?: PropertyKey) => void;
-declare function Interceptor(...interceptors: string[]): (target: any, property?: PropertyKey) => void;
+declare function Addon(...addons: string[]): (target: any, property?: PropertyKey) => void;
 declare function Filter(filter: string): (target: any, property?: PropertyKey) => void;
 declare function Pipe(pipe?: string): (target: any, property?: any, index?: any) => void;
 
@@ -194,14 +207,9 @@ declare abstract class PFilter<C extends BaseContext = any, E extends Exception
 }
 
 declare abstract class PGuard<C extends BaseContext = any> extends ServerBase {
-    abstract use(ctx: C): Promise<boolean> | boolean;
-    readonly key: PropertyKey;
-    constructor(tag?: string);
-}
-
-declare abstract class PInterceptor<C extends BaseContext = any> extends ServerBase {
-    abstract use(ctx: C): Function | Promise<Function> | any;
+    abstract use(ctx: C, next: () => Promise<any>): any;
     readonly key: PropertyKey;
+    priority: number;
     constructor(tag?: string);
 }
 
@@ -218,14 +226,14 @@ declare abstract class PPipe<C extends BaseContext = any> extends ServerBase {
     }, ctx: C): any;
 }
 
-declare abstract class PPlugin extends ServerBase {
+declare abstract class PAddon extends ServerBase {
     readonly key: PropertyKey;
+    priority: number;
     constructor(tag?: string);
-    abstract use<Plugin = any>(framework: string): Plugin | undefined;
+    abstract use(router: any, framework: string): undefined;
 }
 
 interface PExtension<C extends BaseContext = any, E extends Exception = Exception> {
-    intercept(ctx: C): Function | Promise<Function> | any;
     guard(ctx: C): Promise<boolean> | boolean;
     pipe(param: {
         arg: any;
@@ -236,10 +244,12 @@ interface PExtension<C extends BaseContext = any, E extends Exception = Exceptio
         reflect: any;
     }, ctx: C): any;
     filter(error: Error | E, ctx?: C): BaseError;
-    plugin<Plugin = any>(framework: string): Plugin;
+    addon<Addon = any>(framework: string): Addon;
 }
 declare class PExtension extends ServerBase {
     readonly key: PropertyKey;
+    guardPriority: number;
+    addonPriority: number;
     constructor(tag?: string);
 }
 
@@ -247,5 +257,6 @@ type LogLevel = 'error' | 'info' | 'warn' | 'log' | 'debug';
 declare function setLogger(logger: Record<LogLevel, (msg: string) => void>): void;
 declare function getLogger(): Record<LogLevel, (msg: string) => void>;
 declare function log(msg: string, level?: LogLevel): void;
+declare function runMiddleware(ctx: HttpContext, middleware: (req: any, res: any, next?: any) => any): Promise<unknown>;
 
-export { Arg, BadGatewayException, BadRequestException, BaseContext, BaseError, BaseParam, Body, ConflictException, Context, Controller, ControllerMetaData, Ctx, DefaultOptions, Define, Delete, Emitter, Exception, Filter, type FilterType, ForbiddenException, FrameworkException, Generator, Get, Guard, type GuardType, HTTPGenerator, Head, Header, HttpBase, HttpContext, Interceptor, type InterceptorType, InvalidInputException, MetaData, NotFoundException, PExtension, PFilter, PGuard, PInterceptor, PPipe, PPlugin, Param, Patch, PayloadLargeException, Pipe, type PipeArg, type PipeType, Plugin, Post, Put, Query, Queue, RPCGenerator, Route, Rpc, RpcBase, RpcContext, Search, ServerBase, ServiceUnavailableException, TimeoutException, TimerException, UnauthorizedException, UndefinedException, UnsupportedMediaTypeException, ValidateException, WorkerException, addFilter, addGuard, addInterceptor, addPipe, addPlugin, defaultPipe, getLogger, log, setLogger };
+export { type AOP, Addon, Arg, BadGatewayException, BadRequestException, BaseContext, 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, HttpContext, InvalidInputException, MetaData, NotFoundException, PAddon, PExtension, PFilter, PGuard, PPipe, Param, Patch, PayloadLargeException, Pipe, type PipeArg, type PipeType, Post, Put, Query, Queue, RPCGenerator, Route, Rpc, RpcBase, RpcContext, Search, ServerBase, ServiceUnavailableException, TimeoutException, TimerException, UnauthorizedException, UndefinedException, UnsupportedMediaTypeException, ValidateException, WorkerException, addAddon, addFilter, addGuard, addPipe, defaultPipe, getLogger, log, runMiddleware, setLogger };