k99 0.4.0-beta.0 → 0.5.0-beta.0

package/browser/index.d.ts

@@ -1,5 +1,5 @@
 /*!
- * k99 v0.4.0-beta.0
+ * k99 v0.5.0-beta.0
  * (c) 2019-2022 猛火 Fierflame
  * @license MIT
  */

package/browser/index.js

@@ -1,5 +1,5 @@
 /*!
- * k99 v0.4.0-beta.0
+ * k99 v0.5.0-beta.0
  * (c) 2019-2022 猛火 Fierflame
  * @license MIT
  */

package/browser/index.min.js

@@ -1,5 +1,5 @@
 /*!
- * k99 v0.4.0-beta.0
+ * k99 v0.5.0-beta.0
  * (c) 2019-2022 猛火 Fierflame
  * @license MIT
  */

package/browser/index.min.mjs

@@ -1,5 +1,5 @@
 /*!
- * k99 v0.4.0-beta.0
+ * k99 v0.5.0-beta.0
  * (c) 2019-2022 猛火 Fierflame
  * @license MIT
  */

package/browser/index.mjs

@@ -1,5 +1,5 @@
 /*!
- * k99 v0.4.0-beta.0
+ * k99 v0.5.0-beta.0
  * (c) 2019-2022 猛火 Fierflame
  * @license MIT
  */

package/cli/index.d.ts

@@ -1,5 +1,5 @@
 /*!
- * k99 v0.4.0-beta.0
+ * k99 v0.5.0-beta.0
  * (c) 2019-2022 猛火 Fierflame
  * @license MIT
  */

package/cli/index.mjs

@@ -1,5 +1,5 @@
 /*!
- * k99 v0.4.0-beta.0
+ * k99 v0.5.0-beta.0
  * (c) 2019-2022 猛火 Fierflame
  * @license MIT
  */
@@ -94,7 +94,7 @@ async function exec({
   }
 
   if (!cfg.dependencies.k99) {
-    cfg.dependencies.k99 = '^0.4.0-beta.0';
+    cfg.dependencies.k99 = '^0.5.0-beta.0';
   }
 
   await new Promise((resolve, reject) => fsFn.writeFile('package.json', JSON.stringify(cfg, null, 2), e => e ? reject(e) : resolve()));

package/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /*!
- * k99 v0.4.0-beta.0
+ * k99 v0.5.0-beta.0
  * (c) 2019-2022 猛火 Fierflame
  * @license MIT
  */

package/index.d.ts

@@ -1,115 +1,8 @@
 /*!
- * k99 v0.4.0-beta.0
+ * k99 v0.5.0-beta.0
  * (c) 2019-2022 猛火 Fierflame
  * @license MIT
  */
-/**
- * 服务
- */
-declare abstract class Service<T = unknown, P extends any[] = []> implements Context {
-    /**
-     * @warning 不要重载构造函数或者主动调用创建实例
-     */
-    constructor(context: Context);
-    readonly context: Context;
-    abstract export(...p: P): T;
-    /** 销毁时，会自动调用此方法销毁自动创建的容器 */
-    destroy(): Promise<void>;
-}
-interface Service extends Context {
-}
-declare namespace Service {
-    interface Constructor<T, P extends any[] = []> {
-        new (context: Context): Service<T, P>;
-        prototype: Service<T, P>;
-    }
-    interface Func<T, P extends any[] = []> {
-        (context: Context, ...p: P): T;
-    }
-}
-
-/**
- * 路由卫士
- * @description 用于路由的过滤及处理函数执行前的预处理
- */
-declare abstract class Guard<T = unknown> extends Service<T> {
-    decide(): void | boolean | null | undefined | Promise<void | boolean | null | undefined>;
-    /**
-     * 测试请求是否允许通过此路由访问
-     * @description 同一请求、同一路径下，在此函数中调用的 this.set、this.get、this.delete、this.has、this.keys、this.clear 等方法的数据与实例初始化后的共享。目前不同路径下暂不共享，后续可能会被设计为共享，但不同请求下必然不共享
-     * @description 同一路径下，若存在任意 test 返回 false 均会使得此路径不会被执行
-     * @param param 请求参数
-     */
-    static test(param?: {
-        [k: string]: string | string[] | undefined;
-    }): Promise<boolean>;
-    /**
-     * @description 映射的 Map 实例的 set 方法，与同一请求同一路径下的 test 共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    set(k: any, v: any): this;
-    /**
-     * @description 映射的 Map 实例的 get 方法，与同一请求同一路径下的 test 共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    get(k: any): any;
-    /**
-     * @description 映射的 Map 实例的 delete 方法，与同一请求同一路径下的 test 共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    delete(k: any): boolean;
-    /**
-     * @description 映射的 Map 实例的 has 方法，与同一请求同一路径下的 test 共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    has(k: any): boolean;
-    /**
-     * @description 映射的 Map 实例的 keys 方法，与同一请求同一路径下的 test 共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    keys(): IterableIterator<any>;
-    /**
-     * @description 映射的 Map 实例的 clear 方法，与同一请求同一路径下的 test 共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    clear(): void;
-    /**
-     * @description 映射的 Map 实例的 size 属性，与同一请求同一路径下的 test 共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    get size(): number;
-    /**
-     * @description 映射的 Map 实例的 set 方法，与同一请求同一路径下的 Guard 实例共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    static set(k: any, v: any): typeof Guard;
-    /**
-     * @description 映射的 Map 实例的 get 方法，与同一请求同一路径下的 Guard 实例共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    static get(k: any): any;
-    /**
-     * @description 映射的 Map 实例的 delete 方法，与同一请求同一路径下的 Guard 实例共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    static delete(k: any): boolean;
-    /**
-     * @description 映射的 Map 实例的 has 方法，与同一请求同一路径下的 Guard 实例共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    static has(k: any): boolean;
-    /**
-     * @description 映射的 Map 实例的 keys 方法，与同一请求同一路径下的 Guard 实例共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    static keys(): IterableIterator<any>;
-    /**
-     * @description 映射的 Map 实例的 clear 方法，与同一请求同一路径下的 Guard 实例共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    static clear(): void;
-    /**
-     * @description 映射的 Map 实例的 size 属性，与同一请求同一路径下的 Guard 实例共享同一 Map 实例，此方法会在其他地方重载，常规方式重载无效
-     */
-    static get size(): number;
-}
-declare namespace Guard {
-    interface Constructor<T> extends Service.Constructor<T> {
-        new (context: Context): Guard<T>;
-        prototype: Guard<T>;
-        test(param: {
-            [k: string]: string | string[] | undefined;
-        }): void | boolean | null | undefined | Promise<void | boolean | null | undefined>;
-    }
-}
-
 declare const returnSymbol: unique symbol;
 declare const catchSymbol: unique symbol;
 declare const finallySymbol: unique symbol;
@@ -183,7 +76,7 @@ declare class Router {
     /** 子路由 */
     route(path: string | Router): Router;
     controller?: Controller.Constructor<any>;
-    readonly guards: Set<Guard.Constructor<any>>;
+    readonly guards: Set<Guard<any, any, any>>;
     /**
      * 注册处理函数
      * @param path    要注册的路径
@@ -322,7 +215,7 @@ declare type WriteType = BaseWriteType | AsyncIterable<WriteType> | Iterable<Wri
 
 /** 处理函数定义 */
 interface Handle<T extends Record<string, any>> extends Handle.Attrs<T> {
-    (this: Context, data: T): MaybePromise<void | undefined | WriteType | object>;
+    (data: T, ctx: Context): MaybePromise<void | undefined | WriteType | object>;
 }
 declare function Handle<T extends Record<string, any>>(handle: Handle<T> | Handles<T>): Handle<T> | Handles<T>;
 declare namespace Handle {
@@ -374,6 +267,10 @@ interface ResourceOption {
     absPath?: string;
 }
 
+interface Guard<T, D extends Record<string | symbol, any>, P extends any[] = any[]> extends Service<T, D, P> {
+    (init: true, params: any, data?: D): boolean | D | Promise<boolean | D>;
+    (init: false, context: Context, data?: D): boolean | D | Promise<boolean | D>;
+}
 declare type Method = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD' | 'OPTIONS';
 interface Match {
     (pathname: string, parent: string, key: number): null | Match.Result;
@@ -414,15 +311,15 @@ interface Route {
     }): boolean | Promise<boolean>;
 }
 /** 处理项目文件导出 */
-interface Exports<C extends Controller = any> extends Handles<C> {
-    Controller?: Controller.Constructor<C>;
-    Guard?: Guard.Constructor<Guard<C>>;
-    index?: Handle<C> | Handles<C>;
-    new?: Handle<C> | Handles<C>;
-    create?: Handle<C> | Handles<C>;
-    show?: Handle<C> | Handles<C>;
-    update?: Handle<C> | Handles<C>;
-    destroy?: Handle<C> | Handles<C>;
+interface Exports extends Handles<any> {
+    Controller?: Controller.Constructor<any>;
+    Guard?: Guard<any, any, any>;
+    index?: Handle<any> | Handles<any>;
+    new?: Handle<any> | Handles<any>;
+    create?: Handle<any> | Handles<any>;
+    show?: Handle<any> | Handles<any>;
+    update?: Handle<any> | Handles<any>;
+    destroy?: Handle<any> | Handles<any>;
     [key: string]: any;
 }
 
@@ -621,6 +518,9 @@ declare namespace K99Request {
     }
 }
 
+interface Service<T, D extends Record<string | symbol, any>, P extends any[] = []> {
+    (context: Context, data: D, ...p: P): T;
+}
 interface Context {
     /** 当前的路由 */
     readonly app: App;
@@ -698,7 +598,7 @@ interface Context {
          */
         (option?: CookieClearOption, all?: boolean): void;
     };
-    service<T, P extends any[] = []>(Service: Service.Constructor<T, P> | Service.Func<T, P>, ...p: P): T;
+    service<T, P extends any[] = []>(Service: Service<T, any, P>, ...p: P): T;
     hasHeader(name: string): boolean;
     getHeader(name: string): string | number | string[] | undefined;
     setHeader(name: string, value?: string | number | string[]): void;