@faasjs/http 0.0.2-beta.26 → 0.0.2-beta.260

package/lib/cookie.d.ts

@@ -9,11 +9,9 @@ export interface CookieOptions {
     session?: SessionOptions;
     [key: string]: any;
 }
-export declare class Cookie {
-    session: Session;
-    content: {
-        [key: string]: any;
-    };
+export declare class Cookie<C, S> {
+    session: Session<S, C>;
+    content: C;
     readonly config: {
         domain?: string;
         path: string;
@@ -25,19 +23,17 @@ export declare class Cookie {
     };
     private setCookie;
     constructor(config: CookieOptions);
-    invoke(cookie: string | undefined): this;
+    invoke(cookie: string | undefined): Cookie<C, S>;
     read(key: string): any;
-    write(key: string, value: any, opts?: {
+    write(key: string, value: string, opts?: {
         domain?: string;
         path?: string;
         expires?: number | string;
         secure?: boolean;
         httpOnly?: boolean;
         sameSite?: 'Strict' | 'Lax' | 'None';
-    }): this;
+    }): Cookie<C, S>;
     headers(): {
-        'Set-Cookie'?: undefined;
-    } | {
-        'Set-Cookie': string[];
+        'Set-Cookie'?: string[];
     };
 }

package/lib/index.d.ts

@@ -1,59 +1,76 @@
-import { Plugin, InvokeData, MountData, DeployData, Next } from '@faasjs/func';
+import { Plugin, InvokeData, MountData, DeployData, Next, UseifyPlugin } from '@faasjs/func';
 import { Cookie, CookieOptions } from './cookie';
 import { Session, SessionOptions } from './session';
-import { Validator, ValidatorOptions, ValidatorRuleOptions } from './validator';
+import { Validator, ValidatorOptions, ValidatorRuleOptions, ValidatorConfig } from './validator';
 export { Cookie, CookieOptions, Session, SessionOptions, Validator, ValidatorOptions, ValidatorRuleOptions };
 export declare const ContentType: {
     [key: string]: string;
 };
-export interface HttpConfig {
+export declare type HttpConfig<TParams = {
+    [key: string]: any;
+}, TCookie = {
+    [key: string]: any;
+}, TSession = {
+    [key: string]: any;
+}> = {
     [key: string]: any;
     name?: string;
     config?: {
         [key: string]: any;
-        method?: string;
+        method?: 'BEGIN' | 'GET' | 'POST' | 'DELETE' | 'HEAD' | 'PUT' | 'OPTIONS' | 'TRACE' | 'PATCH' | 'ANY';
         timeout?: number;
+        path?: string;
+        ignorePathPrefix?: string;
         functionName?: string;
         cookie?: CookieOptions;
     };
-    validator?: {
-        params?: ValidatorOptions;
-        cookie?: ValidatorOptions;
-        session?: ValidatorOptions;
-    };
-}
+    validator?: ValidatorConfig<TParams, TCookie, TSession>;
+};
 export interface Response {
     statusCode?: number;
-    headers: {
-        [key: string]: any;
+    headers?: {
+        [key: string]: string;
     };
     body?: string;
+    message?: string;
 }
-export declare class Http implements Plugin {
+export declare class HttpError extends Error {
+    readonly statusCode: number;
+    readonly message: string;
+    constructor({ statusCode, message }: {
+        statusCode?: number;
+        message: string;
+    });
+}
+export declare class Http<TParams = {
+    [key: string]: any;
+}, TCookie = {
+    [key: string]: string;
+}, TSession = {
+    [key: string]: any;
+}> implements Plugin {
     readonly type: string;
-    name?: string;
+    readonly name: string;
     headers: {
         [key: string]: string;
     };
-    params: any;
-    cookie: Cookie;
-    session: Session;
-    config: {
-        [key: string]: any;
-        method?: number;
-        timeout?: number;
-        functionName?: string;
-        cookie?: CookieOptions;
-    };
-    private validatorOptions?;
+    params: TParams;
+    cookie: Cookie<TCookie, TSession>;
+    session: Session<TSession, TCookie>;
+    config: HttpConfig<TParams, TCookie, TSession>;
+    private readonly validatorOptions?;
     private response?;
     private validator?;
-    private logger;
+    private readonly logger;
     /**
      * 创建 Http 插件实例
      * @param config {object} 配置项
      * @param config.name {string} 配置名
      * @param config.config {object} 网关配置
+     * @param config.config.method {string} 请求方法，默认为 POST
+     * @param config.config.path {string} 请求路径，默认为云函数文件路径
+     * @param config.config.ignorePathPrefix {string} 排除的路径前缀，当设置 path 时无效
+     * @param config.config.cookie {object} Cookie 配置
      * @param config.validator {object} 入参校验配置
      * @param config.validator.params {object} params 校验配置
      * @param config.validator.params.whitelist {string} 白名单配置
@@ -67,8 +84,9 @@ export declare class Http implements Plugin {
      * @param config.validator.session.whitelist {string} 白名单配置
      * @param config.validator.session.onError {function} 自定义报错
      * @param config.validator.session.rules {object} 参数校验规则
+     * @param config.validator.before {function} 参数校验前自定义函数
      */
-    constructor(config?: HttpConfig);
+    constructor(config?: HttpConfig<TParams, TCookie, TSession>);
     onDeploy(data: DeployData, next: Next): Promise<void>;
     onMount(data: MountData, next: Next): Promise<void>;
     onInvoke(data: InvokeData, next: Next): Promise<void>;
@@ -77,21 +95,28 @@ export declare class Http implements Plugin {
      * @param key {string} key
      * @param value {*} value
      */
-    setHeader(key: string, value: any): Http;
+    setHeader(key: string, value: string): Http<TParams, TCookie, TSession>;
     /**
      * 设置 Content-Type
      * @param type {string} 类型
      * @param charset {string} 编码
      */
-    setContentType(type: string, charset?: string): Http;
+    setContentType(type: string, charset?: string): Http<TParams, TCookie, TSession>;
     /**
      * 设置状态码
      * @param code {number} 状态码
      */
-    setStatusCode(code: number): Http;
+    setStatusCode(code: number): Http<TParams, TCookie, TSession>;
     /**
      * 设置 body
      * @param body {*} 内容
      */
-    setBody(body: string): Http;
+    setBody(body: string): Http<TParams, TCookie, TSession>;
 }
+export declare function useHttp<TParams = {
+    [key: string]: any;
+}, TCookie = {
+    [key: string]: any;
+}, TSession = {
+    [key: string]: any;
+}>(config?: HttpConfig<TParams, TCookie, TSession>): Http<TParams, TCookie, TSession> & UseifyPlugin;