extra-request 10.0.0 → 10.1.0

package/README.md

@@ -23,12 +23,13 @@ const res = await fetch(req)
 ## API
 ```ts
 interface IRequestOptions {
-  url?: URL
-  headers?: Headers
+  url: URL
+  headers: Headers
   payload?: BodyInit
   signal?: AbortSignal
   keepalive?: boolean
   redirect?: RequestRedirect
+  cache?: RequestCache
 }
 
 type IRequestOptionsTransformer = (options: IRequestOptions) => RequestOptions
@@ -64,6 +65,14 @@ function patch(...transformers: Array<IRequestOptionsTransformer | Falsy>): Requ
 function del(...transformers: Array<IRequestOptionsTrransformer | Falsy>): Request
 ```
 
+### request
+```ts
+function request(
+  method: 'GET' | 'HEAD' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
+, ...transformers: Array<IRequestOptionsTransformer | Falsy>
+): Request
+```
+
 ### pipeRequestOptionsTransformers
 ```ts
 function pipeRequestOptionsTransformers(
@@ -184,15 +193,20 @@ function bearerAuth(token: string): IRequestOptionsTransformer
 
 #### keepalive
 ```ts
-function keepalive(val: boolean = true): IRequestOptionsTransformer
+function keepalive(keepalive: boolean = true): IRequestOptionsTransformer
 ```
 
 #### redirect
 ```ts
-function redirect(val: RequestRedirect): IRequestOptionsTransformer
+function redirect(redirect: RequestRedirect): IRequestOptionsTransformer
 ```
 
 #### body
 ```ts
-function body(val: BodyInit): IRequestOptionsTransformer
+function body(body: BodyInit): IRequestOptionsTransformer
+```
+
+####
+```ts
+function cache(cache: RequestCache): IRequestOptionsTransformer
 ```

package/lib/request.d.ts

@@ -6,3 +6,4 @@ export declare function post(...transformers: Array<IRequestOptionsTransformer |
 export declare function put(...transformers: Array<IRequestOptionsTransformer | Falsy>): Request;
 export declare function patch(...transformers: Array<IRequestOptionsTransformer | Falsy>): Request;
 export declare function del(...transformers: Array<IRequestOptionsTransformer | Falsy>): Request;
+export declare function request(method: 'GET' | 'HEAD' | 'PUT' | 'POST' | 'PATCH' | 'DELETE', ...transformers: Array<IRequestOptionsTransformer | Falsy>): Request;

package/lib/request.js

@@ -18,7 +18,7 @@ export function patch(...transformers) {
 export function del(...transformers) {
     return request('DELETE', ...transformers);
 }
-function request(method, ...transformers) {
+export function request(method, ...transformers) {
     const requestOptions = pipeRequestOptionsTransformers(...transformers);
     const headers = new Headers(requestOptions.headers);
     return new Request(requestOptions.url.href, {

package/lib/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,EAAE,8BAA8B,EAAE,+CAAiD;AAG1F,MAAM,UAAU,GAAG,CAAC,GAAG,YAAuD;IAC5E,OAAO,OAAO,CAAC,KAAK,EAAE,GAAG,YAAY,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAG,YAAuD;IAC7E,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAG,YAAuD;IAC7E,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,GAAG,YAAuD;IAC5E,OAAO,OAAO,CAAC,KAAK,EAAE,GAAG,YAAY,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAG,YAAuD;IAC9E,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,GAAG,YAAuD;IAC5E,OAAO,OAAO,CAAC,QAAQ,EAAE,GAAG,YAAY,CAAC,CAAA;AAC3C,CAAC;AAED,SAAS,OAAO,CACd,MAA4D,EAC5D,GAAG,YAAuD;IAE1D,MAAM,cAAc,GAAG,8BAA8B,CAAC,GAAG,YAAY,CAAC,CAAA;IACtE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;IAEnD,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE;QAC1C,MAAM;QACN,OAAO;QACP,MAAM,EAAE,cAAc,CAAC,MAAM;QAC7B,IAAI,EAAE,cAAc,CAAC,OAAc;QACnC,SAAS,EAAE,cAAc,CAAC,SAAS;QACnC,QAAQ,EAAE,cAAc,CAAC,QAAQ;KAClC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,EAAE,8BAA8B,EAAE,+CAAiD;AAG1F,MAAM,UAAU,GAAG,CAAC,GAAG,YAAuD;IAC5E,OAAO,OAAO,CAAC,KAAK,EAAE,GAAG,YAAY,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAG,YAAuD;IAC7E,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAG,YAAuD;IAC7E,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,GAAG,YAAuD;IAC5E,OAAO,OAAO,CAAC,KAAK,EAAE,GAAG,YAAY,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAG,YAAuD;IAC9E,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,GAAG,YAAuD;IAC5E,OAAO,OAAO,CAAC,QAAQ,EAAE,GAAG,YAAY,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,MAA4D,EAC5D,GAAG,YAAuD;IAE1D,MAAM,cAAc,GAAG,8BAA8B,CAAC,GAAG,YAAY,CAAC,CAAA;IACtE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;IAEnD,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE;QAC1C,MAAM;QACN,OAAO;QACP,MAAM,EAAE,cAAc,CAAC,MAAM;QAC7B,IAAI,EAAE,cAAc,CAAC,OAAO;QAC5B,SAAS,EAAE,cAAc,CAAC,SAAS;QACnC,QAAQ,EAAE,cAAc,CAAC,QAAQ;KAClC,CAAC,CAAA;AACJ,CAAC"}

package/lib/transformers/body.d.ts

@@ -1,2 +1,2 @@
 import { IRequestOptionsTransformer } from "../types.js";
-export declare function body(val: BodyInit): IRequestOptionsTransformer;
+export declare function body(body: BodyInit): IRequestOptionsTransformer;

package/lib/transformers/body.js

@@ -1,8 +1,8 @@
-export function body(val) {
+export function body(body) {
     return (options) => {
         return {
             ...options,
-            payload: val
+            payload: body
         };
     };
 }

package/lib/transformers/body.js.map

@@ -1 +1 @@
-{"version":3,"file":"body.js","sourceRoot":"","sources":["../../src/transformers/body.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,IAAI,CAAC,GAAa;IAChC,OAAO,CAAC,OAAwB,EAAE,EAAE;QAClC,OAAO;YACL,GAAG,OAAO;YACV,OAAO,EAAE,GAAG;SACb,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"body.js","sourceRoot":"","sources":["../../src/transformers/body.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,IAAI,CAAC,IAAc;IACjC,OAAO,CAAC,OAAwB,EAAE,EAAE;QAClC,OAAO;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/lib/transformers/cache.d.ts

@@ -0,0 +1,2 @@
+import { IRequestOptionsTransformer } from "../types.js";
+export declare function cache(cache: RequestCache): IRequestOptionsTransformer;

package/lib/transformers/cache.js

@@ -0,0 +1,9 @@
+export function cache(cache) {
+    return (options) => {
+        return {
+            ...options,
+            cache
+        };
+    };
+}
+//# sourceMappingURL=cache.js.map

package/lib/transformers/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/transformers/cache.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,KAAK,CAAC,KAAmB;IACvC,OAAO,CAAC,OAAwB,EAAE,EAAE;QAClC,OAAO;YACL,GAAG,OAAO;YACV,KAAK;SACN,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/lib/transformers/index.d.ts

@@ -1,23 +1,24 @@
-export * from "./url.js";
-export * from "./text.js";
-export * from "./json.js";
-export * from "./csv.js";
-export * from "./header.js";
-export * from "./append-header.js";
-export * from "./headers.js";
-export * from "./accept.js";
-export * from "./host.js";
-export * from "./port.js";
-export * from "./pathname.js";
-export * from "./append-pathname.js";
-export * from "./search.js";
-export * from "./search-param.js";
-export * from "./search-params.js";
-export * from "./append-search-param.js";
-export * from "./form-data-field.js";
-export * from "./basic-auth.js";
-export * from "./bearer-auth.js";
-export * from "./signal.js";
-export * from "./keepalive.js";
-export * from "./redirect.js";
-export * from "./body.js";
+export * from './url.js';
+export * from './text.js';
+export * from './json.js';
+export * from './csv.js';
+export * from './header.js';
+export * from './append-header.js';
+export * from './headers.js';
+export * from './accept.js';
+export * from './host.js';
+export * from './port.js';
+export * from './pathname.js';
+export * from './append-pathname.js';
+export * from './search.js';
+export * from './search-param.js';
+export * from './search-params.js';
+export * from './append-search-param.js';
+export * from './form-data-field.js';
+export * from './basic-auth.js';
+export * from './bearer-auth.js';
+export * from './signal.js';
+export * from './keepalive.js';
+export * from './redirect.js';
+export * from './body.js';
+export * from './cache.js';

package/lib/transformers/index.js

@@ -1,24 +1,25 @@
-export * from "./url.js";
-export * from "./text.js";
-export * from "./json.js";
-export * from "./csv.js";
-export * from "./header.js";
-export * from "./append-header.js";
-export * from "./headers.js";
-export * from "./accept.js";
-export * from "./host.js";
-export * from "./port.js";
-export * from "./pathname.js";
-export * from "./append-pathname.js";
-export * from "./search.js";
-export * from "./search-param.js";
-export * from "./search-params.js";
-export * from "./append-search-param.js";
-export * from "./form-data-field.js";
-export * from "./basic-auth.js";
-export * from "./bearer-auth.js";
-export * from "./signal.js";
-export * from "./keepalive.js";
-export * from "./redirect.js";
-export * from "./body.js";
+export * from './url.js';
+export * from './text.js';
+export * from './json.js';
+export * from './csv.js';
+export * from './header.js';
+export * from './append-header.js';
+export * from './headers.js';
+export * from './accept.js';
+export * from './host.js';
+export * from './port.js';
+export * from './pathname.js';
+export * from './append-pathname.js';
+export * from './search.js';
+export * from './search-param.js';
+export * from './search-params.js';
+export * from './append-search-param.js';
+export * from './form-data-field.js';
+export * from './basic-auth.js';
+export * from './bearer-auth.js';
+export * from './signal.js';
+export * from './keepalive.js';
+export * from './redirect.js';
+export * from './body.js';
+export * from './cache.js';
 //# sourceMappingURL=index.js.map

package/lib/transformers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transformers/index.ts"],"names":[],"mappings":"AAAA,yBAAoC;AAEpC,0BAAqC;AACrC,0BAAqC;AACrC,yBAAoC;AAEpC,4BAAuC;AACvC,mCAA8C;AAC9C,6BAAwC;AACxC,4BAAuC;AAEvC,0BAAqC;AACrC,0BAAqC;AACrC,8BAAyC;AACzC,qCAAgD;AAChD,4BAAuC;AACvC,kCAA6C;AAC7C,mCAA8C;AAC9C,yCAAoD;AAEpD,qCAAgD;AAEhD,gCAA2C;AAC3C,iCAA4C;AAE5C,4BAAuC;AACvC,+BAA0C;AAC1C,8BAAyC;AACzC,0BAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transformers/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AAExB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AAExB,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAE3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AAExC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/lib/transformers/keepalive.d.ts

@@ -1,2 +1,2 @@
 import { IRequestOptionsTransformer } from "../types.js";
-export declare function keepalive(val?: boolean): IRequestOptionsTransformer;
+export declare function keepalive(keepalive?: boolean): IRequestOptionsTransformer;

package/lib/transformers/keepalive.js

@@ -1,8 +1,8 @@
-export function keepalive(val = true) {
+export function keepalive(keepalive = true) {
     return (options) => {
         return {
             ...options,
-            keepalive: val
+            keepalive
         };
     };
 }

package/lib/transformers/keepalive.js.map

@@ -1 +1 @@
-{"version":3,"file":"keepalive.js","sourceRoot":"","sources":["../../src/transformers/keepalive.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,MAAe,IAAI;IAC3C,OAAO,CAAC,OAAwB,EAAE,EAAE;QAClC,OAAO;YACL,GAAG,OAAO;YACV,SAAS,EAAE,GAAG;SACf,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"keepalive.js","sourceRoot":"","sources":["../../src/transformers/keepalive.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,YAAqB,IAAI;IACjD,OAAO,CAAC,OAAwB,EAAE,EAAE;QAClC,OAAO;YACL,GAAG,OAAO;YACV,SAAS;SACV,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/lib/transformers/redirect.d.ts

@@ -1,2 +1,2 @@
 import { IRequestOptionsTransformer } from "../types.js";
-export declare function redirect(val: RequestRedirect): IRequestOptionsTransformer;
+export declare function redirect(redirect: RequestRedirect): IRequestOptionsTransformer;

package/lib/transformers/redirect.js

@@ -1,8 +1,8 @@
-export function redirect(val) {
+export function redirect(redirect) {
     return (options) => {
         return {
             ...options,
-            redirect: val
+            redirect
         };
     };
 }

package/lib/transformers/redirect.js.map

@@ -1 +1 @@
-{"version":3,"file":"redirect.js","sourceRoot":"","sources":["../../src/transformers/redirect.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,GAAoB;IAC3C,OAAO,CAAC,OAAwB,EAAE,EAAE;QAClC,OAAO;YACL,GAAG,OAAO;YACV,QAAQ,EAAE,GAAG;SACd,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"redirect.js","sourceRoot":"","sources":["../../src/transformers/redirect.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,QAAyB;IAChD,OAAO,CAAC,OAAwB,EAAE,EAAE;QAClC,OAAO;YACL,GAAG,OAAO;YACV,QAAQ;SACT,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/lib/types.d.ts

@@ -6,4 +6,5 @@ export interface IRequestOptions {
     signal?: AbortSignal;
     keepalive?: boolean;
     redirect?: RequestRedirect;
+    cache?: RequestCache;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "extra-request",
-  "version": "10.0.0",
+  "version": "10.1.0",
   "description": "Utilities for Request",
   "type": "module",
   "sideEffects": false,

package/src/request.ts

@@ -27,7 +27,7 @@ export function del(...transformers: Array<IRequestOptionsTransformer | Falsy>):
   return request('DELETE', ...transformers)
 }
 
-function request(
+export function request(
   method: 'GET' | 'HEAD' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
 , ...transformers: Array<IRequestOptionsTransformer | Falsy>
 ): Request {
@@ -38,7 +38,7 @@ function request(
     method
   , headers
   , signal: requestOptions.signal
-  , body: requestOptions.payload as any
+  , body: requestOptions.payload
   , keepalive: requestOptions.keepalive
   , redirect: requestOptions.redirect
   })

package/src/transformers/body.ts

@@ -1,10 +1,10 @@
 import { IRequestOptions, IRequestOptionsTransformer } from '@src/types.js'
 
-export function body(val: BodyInit): IRequestOptionsTransformer {
+export function body(body: BodyInit): IRequestOptionsTransformer {
   return (options: IRequestOptions) => {
     return {
       ...options
-    , payload: val
+    , payload: body
     }
   }
 }

package/src/transformers/cache.ts

@@ -0,0 +1,10 @@
+import { IRequestOptions, IRequestOptionsTransformer } from '@src/types.js'
+
+export function cache(cache: RequestCache): IRequestOptionsTransformer {
+  return (options: IRequestOptions) => {
+    return {
+      ...options
+    , cache
+    }
+  }
+}

package/src/transformers/index.ts

@@ -1,29 +1,30 @@
-export * from '@transformers/url.js'
+export * from './url.js'
 
-export * from '@transformers/text.js'
-export * from '@transformers/json.js'
-export * from '@transformers/csv.js'
+export * from './text.js'
+export * from './json.js'
+export * from './csv.js'
 
-export * from '@transformers/header.js'
-export * from '@transformers/append-header.js'
-export * from '@transformers/headers.js'
-export * from '@transformers/accept.js'
+export * from './header.js'
+export * from './append-header.js'
+export * from './headers.js'
+export * from './accept.js'
 
-export * from '@transformers/host.js'
-export * from '@transformers/port.js'
-export * from '@transformers/pathname.js'
-export * from '@transformers/append-pathname.js'
-export * from '@transformers/search.js'
-export * from '@transformers/search-param.js'
-export * from '@transformers/search-params.js'
-export * from '@transformers/append-search-param.js'
+export * from './host.js'
+export * from './port.js'
+export * from './pathname.js'
+export * from './append-pathname.js'
+export * from './search.js'
+export * from './search-param.js'
+export * from './search-params.js'
+export * from './append-search-param.js'
 
-export * from '@transformers/form-data-field.js'
+export * from './form-data-field.js'
 
-export * from '@transformers/basic-auth.js'
-export * from '@transformers/bearer-auth.js'
+export * from './basic-auth.js'
+export * from './bearer-auth.js'
 
-export * from '@transformers/signal.js'
-export * from '@transformers/keepalive.js'
-export * from '@transformers/redirect.js'
-export * from '@transformers/body.js'
+export * from './signal.js'
+export * from './keepalive.js'
+export * from './redirect.js'
+export * from './body.js'
+export * from './cache.js'

package/src/transformers/keepalive.ts

@@ -1,10 +1,10 @@
 import { IRequestOptionsTransformer, IRequestOptions } from '@src/types.js'
 
-export function keepalive(val: boolean = true): IRequestOptionsTransformer {
+export function keepalive(keepalive: boolean = true): IRequestOptionsTransformer {
   return (options: IRequestOptions) => {
     return {
       ...options
-    , keepalive: val
+    , keepalive
     }
   }
 }

package/src/transformers/redirect.ts

@@ -1,10 +1,10 @@
 import { IRequestOptions, IRequestOptionsTransformer } from '@src/types.js'
 
-export function redirect(val: RequestRedirect): IRequestOptionsTransformer {
+export function redirect(redirect: RequestRedirect): IRequestOptionsTransformer {
   return (options: IRequestOptions) => {
     return {
       ...options
-    , redirect: val
+    , redirect
     }
   }
 }

package/src/types.ts

@@ -1,10 +1,6 @@
 export type IRequestOptionsTransformer = (options: IRequestOptions) => IRequestOptions
 
 /**
- * Q: Why not use `Request` interface?
- * A: Because `Request['body']` is `ReadableStream`,
- *    it is very difficult to use.
- * 
  * Q: Why not use `RequestInit` interface?
  * A: Because `RequestInit` has no `url` property,
  *    and its optional properties are not suitable for our cases.
@@ -16,4 +12,5 @@ export interface IRequestOptions {
   signal?: AbortSignal
   keepalive?: boolean
   redirect?: RequestRedirect
+  cache?: RequestCache
 }