keq 1.7.3 → 1.8.2

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.8.2](https://www.github.com/keq-request/keq/compare/v1.8.1...v1.8.2) (2022-04-26)
+
+
+### Bug Fixes
+
+* cannot find keq main file ([41908fa](https://www.github.com/keq-request/keq/commit/41908fa47eeb8f54fc018d445c5ef85ffc5ca383))
+
+### [1.8.1](https://www.github.com/keq-request/keq/compare/v1.8.0...v1.8.1) (2022-04-25)
+
+
+### Bug Fixes
+
+* cannot compile by vite ([2727867](https://www.github.com/keq-request/keq/commit/27278676f924428e2598b634577ed8b63a1e935b))
+* wrong return of response.blob() ([ca5a5b5](https://www.github.com/keq-request/keq/commit/ca5a5b5bd64bdde6a476d7ce5e86b9833cd2a43b))
+
+## [1.8.0](https://www.github.com/keq-request/keq/compare/v1.7.3...v1.8.0) (2022-03-22)
+
+
+### Features
+
+* support custom request instance ([2c05dec](https://www.github.com/keq-request/keq/commit/2c05dec6d779861112507b7365822ecff175dbc3))
+
 ### [1.7.3](https://www.github.com/keq-request/keq/compare/v1.7.2...v1.7.3) (2022-03-08)
 
 

package/README.md

@@ -91,7 +91,7 @@ Add option `resolveWithFullResponse` to get the origin  [`Response`][Response MD
 import { request } from 'keq'
 
 const response = await request
-  .get('http://example.com')
+  .get('http://test.com')
   .option('resolveWithFullResponse')
 
 const body = await response.json()
@@ -311,7 +311,7 @@ No retry by default, invoke `.retry(times[, initialTime[, callback]])`  to set r
 import { request } from 'keq'
 
 await request
-  .get('http://example.com')
+  .get('http://test.com')
   .retry(2, 1000, () => {})
 ```
 
@@ -324,7 +324,7 @@ Invoke `.option()` add options.
 import { request } from 'keq'
 
 await request
-  .get('http://example.com')
+  .get('http://test.com')
   .option('resolveWithFullResponse')
   .option('middlewareOption', 'value')
 ```
@@ -335,7 +335,7 @@ Or as a single object:
 import { request } from 'keq'
 
 await request
-  .get('http://example.com')
+  .get('http://test.com')
   .options({
     resolveWithFullResponse: true,
     middlewareOption: 'value',
@@ -390,7 +390,7 @@ request
 
 // Request Middleware
 await request
-  .get('http://example.com')
+  .get('http://test.com')
   .use(middleware)
 ```
 
@@ -416,7 +416,7 @@ Keq's context object has many parameters. The following lists all the built-in c
 **Property**                  | **Type**
 :-----------------------------|:------------------------------------
 `context.request`             | Includes request options for Fetch API.
-`context.request.url`         | The return type of `url.parse('http://example.com', true)`.
+`context.request.url`         | The return type of `url.parse('http://test.com', true)`.
 `context.request.method`      | One of 'get', 'post', 'put', 'patch', 'head', 'delete'.
 `context.request.body`        | Object, Array, Stream, Blob or undefined.
 `context.request.headers`     | The [`Headers`][Headers MDN] Object.
@@ -440,6 +440,24 @@ This is the utils used to mount middleware.
  `mount.pathname(matcher: string \| Regexp)`  | Mount to the pathname that match the `matcher`. `string` can be [`glob`](https://www.npmjs.com/package/picomatch).
  `mount.host(host: string)`                   | Mount to the Host.
 
+### Create Request
+
+ If you want to create a request instance, you can invoke `request.create()`:
+
+
+```typescript
+import { request } from 'keq'
+
+const customRequest = request.create()
+
+// Middleware only takes effect on customRequests
+customRequest.use(/** some middleware */)
+
+const body = await customRequest
+  .get('http://test.com')
+```
+
+ > The gloabl request instance is created by `request.create()` too.
 
 <!-- usage -->
 
@@ -459,7 +477,7 @@ The difference between the two is that when called multiple times.
 ```javascript
 import { request } from 'keq'
 
-const keq = request.get('http://example.com')
+const keq = request.get('http://test.com')
 
 keq.then(onfulfilled, onrejected)
 // Won't send request, and will use the last request result.

package/ava.config.mjs

@@ -0,0 +1,5 @@
+export default {
+  files: ['tests/**/*.ts', '!tests/**/*.before-each.ts'],
+  extensions: ['ts'],
+  require: ['ts-node/register'],
+}

package/doc/zh-cn/readme.md

@@ -90,7 +90,7 @@ await request.del('https://example.com/search')
 import { request } from 'keq'
 
 const response = await request
-  .get('http://example.com')
+  .get('http://test.com')
   .option('resolveWithFullResponse')
 
 const body = await response.json()
@@ -301,7 +301,7 @@ await request
 import { request } from 'keq'
 
 await request
-  .get('http://example.com')
+  .get('http://test.com')
   .option('resolveWithFullResponse')
   .option('middlewareOption', 'value')
 ```
@@ -312,7 +312,7 @@ await request
 import { request } from 'keq'
 
 await request
-  .get('http://example.com')
+  .get('http://test.com')
   .options({
     resolveWithFullResponse: true,
     middlewareOption: 'value',
@@ -353,7 +353,7 @@ request
 
 // Request Middleware
 await request
-  .get('http://example.com')
+  .get('http://test.com')
   .use(middleware)
 ```
 
@@ -379,7 +379,7 @@ Keq的上下文对象有许多可以修改和使用的参数，下面列出了
 **Property**                  | **Type**
 :-----------------------------|:------------------------------------
 `context.request`             | 发送fetch请求的参数。
-`context.request.url`         | 请求地址，是一个`URL`对象，通过`url.parse('http://example.com', true)`创建。
+`context.request.url`         | 请求地址，是一个`URL`对象，通过`url.parse('http://test.com', true)`创建。
 `context.request.method`      | Request method。
 `context.request.body`        | 请求体，根据发送请求的不同，其结构可能是：`Object`（json/form-data/x-www-form-urlencoded), Array（json）, Stream（NodeJS发送二进制文件）, Blob（浏览器中发送二进制文件）, undefined（未携带请求体）中的任意一种。
 `context.request.headers`     | 请求头[`Headers`][Headers MDN]对象。
@@ -409,7 +409,7 @@ Keq的上下文对象有许多可以修改和使用的参数，下面列出了
 ```javascript
 import { request } from 'keq'
 
-const keq = request.get('http://example.com')
+const keq = request.get('http://test.com')
 
 keq.then(onfulfilled, onrejected)
 // Won't send request, and will use the last request result.
@@ -425,6 +425,26 @@ keq.end()
 
 更重要的是，在`NodeJS`里面，`node-fetch`库没有实现`Response`的`.formData()`方法，在`NodeJS`环境中，`Keq`在克隆`ctx.res`后会自动添加`.formData()`实现。
 
+### 创建可自定义的请求实例
+
+如果你打算自己创建一个请求实例，而不使用全局的`request`实例，可以调用`request.create()`方法：
+
+```typescript
+import { request } from 'keq'
+
+const customRequest = request.create()
+
+// Middleware only takes effect on customRequests
+customRequest.use(/** some middleware */)
+
+const body = await customRequest
+  .get('http://test.com')
+```
+
+ > 全局的`request`实例也是调用`request.create()`方法创建的。
+ > 因此，自定义的`request`实例也具备全局`request`的所有特性。
+
+
 
 ## 更多信息
 

package/es/index.d.ts

@@ -1,4 +1 @@
-export * from "./src/index";
-/** @ts-ignore */
-import defaultExport from "./src/index";
-export default defaultExport;
+export * from './src/index';

package/es/index.js

@@ -1,5 +1 @@
-export * from "./src/index";
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-/** @ts-ignore */
-import defaultExport from "./src/index";
-export default defaultExport;
+export * from './src/index';

package/es/src/exception/file-expected.exception.d.ts

@@ -1,4 +1,4 @@
-import { Exception } from "./exception";
+import { Exception } from './exception';
 export declare class FileExpectedException extends Exception {
     constructor();
 }

package/es/src/exception/file-expected.exception.js

@@ -1,4 +1,4 @@
-import { Exception } from "./exception";
+import { Exception } from './exception';
 export class FileExpectedException extends Exception {
     constructor() {
         super('File/Blob (Browser) or Buffer (NodeJS) expected');

package/es/src/exception/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./exception";
-export * from "./file-expected.exception";
-export * from "./overwrite-array-body.exception";
-export * from "./unknow-content-type.exception";
+export * from './exception';
+export * from './file-expected.exception';
+export * from './overwrite-array-body.exception';
+export * from './unknown-content-type.exception';

package/es/src/exception/index.js

@@ -1,4 +1,4 @@
-export * from "./exception";
-export * from "./file-expected.exception";
-export * from "./overwrite-array-body.exception";
-export * from "./unknow-content-type.exception";
+export * from './exception';
+export * from './file-expected.exception';
+export * from './overwrite-array-body.exception';
+export * from './unknown-content-type.exception';

package/es/src/exception/overwrite-array-body.exception.d.ts

@@ -1,4 +1,4 @@
-import { Exception } from "./exception";
+import { Exception } from './exception';
 export declare class OverwriteArrayBodyException extends Exception {
     constructor();
 }

package/es/src/exception/overwrite-array-body.exception.js

@@ -1,4 +1,4 @@
-import { Exception } from "./exception";
+import { Exception } from './exception';
 export class OverwriteArrayBodyException extends Exception {
     constructor() {
         super('Cannot merge or overwrite body. Because it has been set as an array.');

package/es/src/exception/unknown-content-type.exception.d.ts

@@ -0,0 +1,4 @@
+import { Exception } from './exception';
+export declare class UnknownContentTypeException extends Exception {
+    constructor();
+}

package/es/src/exception/unknown-content-type.exception.js

@@ -0,0 +1,6 @@
+import { Exception } from './exception';
+export class UnknownContentTypeException extends Exception {
+    constructor() {
+        super('Unknow Content-Type');
+    }
+}

package/es/src/index.d.ts

@@ -1,7 +1,7 @@
-export * from "./request";
-export * from "./types";
-export { compose } from "./middleware";
-export * from "./keq";
-export * from "./polyfill";
-import * as mount from "./mount";
+export * from './request';
+export * from './types';
+export { compose } from './middleware';
+export * from './keq';
+export * from './polyfill';
+import * as mount from './mount';
 export { mount };

package/es/src/index.js

@@ -1,7 +1,7 @@
-export * from "./request";
-export * from "./types";
-export { compose } from "./middleware";
-export * from "./keq";
-export * from "./polyfill";
-import * as mount from "./mount";
+export * from './request';
+export * from './types';
+export { compose } from './middleware';
+export * from './keq';
+export * from './polyfill';
+import * as mount from './mount';
 export { mount };

package/es/src/keq-url.js

@@ -1,10 +1,10 @@
 import { URL } from 'whatwg-url';
 import { compile } from 'path-to-regexp';
-import { Exception } from "./exception";
-import * as R from 'ramda';
-import { isBrowser } from "./util";
+import { Exception } from './exception';
+import { isBrowser } from './util';
+import { clone } from './util/clone';
 export class KeqURL extends URL {
-    constructor(url, base = isBrowser() ? window.location.origin : 'http://localhost') {
+    constructor(url, base = isBrowser ? window.location.origin : 'http://localhost') {
         super(url, base);
         this.params = {};
     }
@@ -73,7 +73,7 @@ export class KeqURL extends URL {
     }
     clone() {
         const uri = new KeqURL(this.href);
-        uri.params = R.clone(this.params);
+        uri.params = clone(this.params);
         return uri;
     }
 }

package/es/src/keq.d.ts

@@ -1,7 +1,6 @@
 /// <reference types="node" />
-import { SerializeBodyFn, RequestMethod, Options, BuildInOptions, OptionsWithFullResponse, OptionsWithoutFullResponse, Middleware, MiddlewareMatcher, ShorthandContentType, FormDataFieldOptions, RetryCallback } from "./types";
-import { KeqURL } from "./keq-url";
-import { Stream } from 'stream';
+import { SerializeBodyFn, RequestMethod, Options, BuildInOptions, OptionsWithFullResponse, OptionsWithoutFullResponse, Middleware, MiddlewareMatcher, ShorthandContentType, RetryCallback } from "./types";
+import { KeqURL } from './keq-url';
 export declare class Keq<T> {
     private requestPromise?;
     private urlObj;
@@ -38,9 +37,9 @@ export declare class Keq<T> {
     send(value: FormData | Record<string, any> | any[] | string): Keq<T>;
     field(arg1: string, value: string): Keq<T>;
     field(arg1: Record<string, string>): Keq<T>;
-    attach(key: string, file: Blob | File | Buffer | Stream): Keq<T>;
-    attach(key: string, file: Blob | File | Buffer | Stream, filename: string): Keq<T>;
-    attach(key: string, file: Blob | File | Buffer | Stream, options: FormDataFieldOptions): Keq<T>;
+    attach(key: string, file: Blob | File | Buffer): Keq<T>;
+    attach(key: string, file: Blob | File | Buffer, filename: string): Keq<T>;
+    attach(key: string, file: Blob | File | Buffer): Keq<T>;
     serialize(fn: SerializeBodyFn): Keq<T>;
     use(middleware: Middleware): Keq<T>;
     use(host: string, middleware: Middleware): Keq<T>;

package/es/src/keq.js

@@ -7,12 +7,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import fetch, { Headers } from 'cross-fetch';
 import { clone } from "./util/clone";
-import { Exception, FileExpectedException, OverwriteArrayBodyException, UnknowContentTypeException, } from "./exception";
-import { isFormData, isFile, isBrowser, encodeBase64, sleep, inferContentTypeByBody, fixContentType, getBoundaryByContentType, parseFormData, serializeBody, } from "./util";
-import { matchHost, matchMiddleware, compose } from "./middleware";
-import { FormData, Response } from "./polyfill";
+import { Exception, FileExpectedException, OverwriteArrayBodyException, UnknownContentTypeException, } from "./exception";
+import { sleep, inferContentTypeByBody, fixContentType, getBoundaryByContentType, parseFormData, serializeBody, } from "./util";
+import { isBlob, isBrowser, isFormData } from './util/is';
+import { FormData, Response, Headers, Blob, fetch, btoa, } from "./polyfill";
+import { matchHost, matchMiddleware, compose } from './middleware';
 export class Keq {
     constructor(urlObj, method, middlewares) {
         this.headers = new Headers();
@@ -47,7 +47,7 @@ export class Keq {
     type(contentType) {
         const type = fixContentType(contentType);
         if (!type)
-            throw new UnknowContentTypeException();
+            throw new UnknownContentTypeException();
         this.headers.set('Content-Type', type);
         return this;
     }
@@ -55,7 +55,7 @@ export class Keq {
      * Http Basic Authentication
      */
     auth(username, password) {
-        this.headers.set('Authorization', `Basic ${encodeBase64(`${username}:${password}`)}`);
+        this.headers.set('Authorization', `Basic ${btoa(`${username}:${password}`)}`);
         return this;
     }
     appendFormDate(formData) {
@@ -136,13 +136,15 @@ export class Keq {
             throw new OverwriteArrayBodyException();
         if (!this.body)
             this.body = {};
-        if (!isFile(file))
+        if (!(isBlob(file) || file instanceof Buffer))
             throw new FileExpectedException();
         const formData = new FormData();
-        if (isBrowser() && typeof arg3 === 'object')
-            formData.set(key, file, arg3.filename);
-        else
+        if (isBlob(file)) {
             formData.set(key, file, arg3);
+        }
+        else {
+            formData.set(key, new Blob([file]), arg3);
+        }
         this.appendFormDate(formData);
         this.setType('form-data');
         return this;
@@ -214,7 +216,6 @@ export class Keq {
         return this;
     }
     fetch(ctx) {
-        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             const uri = ctx.request.url.toPath();
             const fetchOptions = Object.assign({ method: ctx.request.method.toUpperCase(), headers: ctx.request.headers, body: this.serializeBodyFn(ctx.request.body, ctx) }, ctx.request.options);
@@ -224,13 +225,6 @@ export class Keq {
             if (ctx.options.highWaterMark) {
                 fetchOptions['highWaterMark'] = ctx.options.highWaterMark;
             }
-            /**
-             * Content-Type should be removed when it is 'multipart/form-data
-             * FetchAPI will auth set it and add boundary
-             */
-            if (((_a = fetchOptions.headers.get('content-type')) === null || _a === void 0 ? void 0 : _a.toLocaleLowerCase()) === 'multipart/form-data') {
-                fetchOptions.headers.delete('content-type');
-            }
             const res = yield ctx.options.fetchAPI(uri, fetchOptions);
             function resFromData() {
                 return __awaiter(this, void 0, void 0, function* () {
@@ -242,20 +236,27 @@ export class Keq {
                     return parseFormData(str, boundary);
                 });
             }
-            if (!isBrowser()) {
+            if (!isBrowser) {
                 // node-fetch does not implement Response.formData()
                 res.formData = resFromData.bind(res);
             }
             let cache;
             ctx.res = new Proxy(res, {
                 get(target, property) {
-                    if (!(typeof property === 'string' && ['json', 'formData', 'text', 'blob'].includes(property))) {
+                    if (typeof property !== 'string' ||
+                        (property !== 'json' &&
+                            property !== 'text' &&
+                            property !== 'formData' &&
+                            property !== 'blob')) {
                         return target[property];
                     }
                     return () => __awaiter(this, void 0, void 0, function* () {
+                        if (isBrowser)
+                            return target.clone()[property]();
                         if (!cache)
                             cache = yield target.arrayBuffer();
-                        const res = new Response(new TextDecoder().decode(cache), { headers: target.headers });
+                        const buf = Buffer.from(cache);
+                        const res = new Response(buf, { headers: target.headers });
                         res.formData = resFromData.bind(res);
                         return yield res[property]();
                     });

package/es/src/mount.js

@@ -1,6 +1,6 @@
 import { Exception } from "./exception";
-import * as picomatch from 'picomatch';
-import { isBrowser } from "./util";
+import * as minimatch from 'minimatch';
+import { isBrowser } from './util';
 function createMounter(matcher) {
     const mounter = ctx => matcher(ctx);
     mounter.pathname = arg => compose(mounter, pathname(arg));
@@ -17,7 +17,7 @@ export function location() {
     return createMounter((ctx) => {
         if (!ctx.request.url.host)
             return true;
-        if (isBrowser()) {
+        if (isBrowser) {
             if (ctx.request.url.host === window.location.host)
                 return true;
         }
@@ -31,7 +31,7 @@ export function pathname(matcher) {
     return createMounter(ctx => {
         const pathname = ctx.url.pathname || '/';
         if (typeof matcher === 'string')
-            return picomatch.isMatch(pathname, matcher);
+            return minimatch(pathname, matcher);
         return matcher.test(pathname);
     });
 }

package/es/src/polyfill.d.ts

@@ -1,6 +1,7 @@
-import FormDataNode from "./form-data-node";
-export { fetch, Headers, Response } from 'cross-fetch';
-export declare const FormData: {
-    new (form?: HTMLFormElement | undefined): FormData;
-    prototype: FormData;
-} | typeof FormDataNode;
+export declare const FormData: typeof global.FormData;
+export declare const fetch: typeof global.fetch;
+export declare const Headers: typeof global.Headers;
+export declare const Response: typeof global.Response;
+export declare const Blob: typeof global.Blob;
+export declare const File: typeof global.File;
+export declare const btoa: typeof global.btoa;

package/es/src/polyfill.js

@@ -1,4 +1,11 @@
+/* eslint-disable @typescript-eslint/ban-ts-comment */
+/* eslint-disable @typescript-eslint/no-var-requires */
 import { isBrowser } from "./util";
-import FormDataNode from "./form-data-node";
-export { fetch, Headers, Response } from 'cross-fetch';
-export const FormData = isBrowser() ? window.FormData : FormDataNode;
+export const FormData = isBrowser ? window.FormData : require('formdata-node').FormData;
+export const fetch = isBrowser ? window.fetch.bind(window) : require('node-fetch').default;
+// export const fetch: typeof global.fetch = cFetch
+export const Headers = isBrowser ? window.Headers : require('node-fetch').default.Headers;
+export const Response = isBrowser ? window.Response : require('node-fetch').Response;
+export const Blob = isBrowser ? window.Blob : require('formdata-node').Blob;
+export const File = isBrowser ? window.File : require('formdata-node').File;
+export const btoa = isBrowser ? window.btoa : (str) => Buffer.from(str).toString('base64');

package/es/src/request.d.ts

@@ -1,2 +1 @@
-import { RequestCreator } from "./types";
-export declare const request: RequestCreator;
+export declare const request: import("./types").RequestCreator;

package/es/src/request.js

@@ -1,44 +1,2 @@
-import { Keq } from "./keq";
-import * as clone from 'clone';
-import { matchMiddleware, matchHost } from "./middleware";
-import { KeqURL } from "./keq-url";
-const defaultOptions = {};
-const middlewares = [];
-export const request = function (params, options = defaultOptions) {
-    const request = new Keq(new KeqURL(params.url), 'get', middlewares);
-    return request.options(options);
-};
-request.get = function (href) {
-    const request = new Keq(new KeqURL(href), 'get', clone(middlewares));
-    return request;
-};
-request.put = function (href) {
-    const request = new Keq(new KeqURL(href), 'put', middlewares);
-    return request;
-};
-request.delete = function (href) {
-    const request = new Keq(new KeqURL(href), 'delete', middlewares);
-    return request;
-};
-request.del = request.delete;
-request.post = function (href) {
-    const request = new Keq(new KeqURL(href), 'post', middlewares);
-    return request;
-};
-request.head = function (href) {
-    const request = new Keq(new KeqURL(href), 'head', middlewares);
-    return request;
-};
-request.patch = function (href) {
-    const request = new Keq(new KeqURL(href), 'patch', middlewares);
-    return request;
-};
-request.use = function use(m, middleware) {
-    if (!middleware)
-        middlewares.push(m);
-    else if (typeof m === 'string')
-        middlewares.push(matchMiddleware(matchHost(m), middleware));
-    else
-        middlewares.push(matchMiddleware(m, middleware));
-    return request;
-};
+import { createRequest } from './util/create-request';
+export const request = createRequest();

package/es/src/types/context.d.ts

@@ -1,7 +1,7 @@
-import { KeqURL } from "../keq-url";
-import { KeqBody } from "./keq-body";
-import { RequestMethod } from "./request-method";
-import { Options } from "./options";
+import { KeqURL } from '../keq-url';
+import { KeqBody } from './keq-body';
+import { RequestMethod } from './request-method';
+import { Options } from './options';
 export interface RequestContext {
     url: KeqURL;
     method: RequestMethod;

package/es/src/types/index.d.ts

@@ -1,10 +1,10 @@
-export * from "./keq-body";
-export * from "./request-method";
-export * from "./request-creator";
-export * from "./serialize-body-fn";
-export * from "./context";
-export * from "./options";
-export * from "./middleware";
-export * from "./shorthand-content-type";
-export * from "./mounter";
-export * from "./retry-callback";
+export * from './keq-body';
+export * from './request-method';
+export * from './request-creator';
+export * from './serialize-body-fn';
+export * from './context';
+export * from './options';
+export * from './middleware';
+export * from './shorthand-content-type';
+export * from './mounter';
+export * from './retry-callback';

package/es/src/types/index.js

@@ -1,10 +1,10 @@
-export * from "./keq-body";
-export * from "./request-method";
-export * from "./request-creator";
-export * from "./serialize-body-fn";
-export * from "./context";
-export * from "./options";
-export * from "./middleware";
-export * from "./shorthand-content-type";
-export * from "./mounter";
-export * from "./retry-callback";
+export * from './keq-body';
+export * from './request-method';
+export * from './request-creator';
+export * from './serialize-body-fn';
+export * from './context';
+export * from './options';
+export * from './middleware';
+export * from './shorthand-content-type';
+export * from './mounter';
+export * from './retry-callback';

package/es/src/types/middleware.d.ts

@@ -1,4 +1,4 @@
-import { Context } from "./context";
+import { Context } from './context';
 export declare type InnerMiddleware = () => Promise<void>;
 export declare type Middleware = (ctx: Context, next: InnerMiddleware) => Promise<void>;
 export declare type MiddlewareMatcher = (ctx: Context) => boolean;