fetch-request-browser 1.0.1 → 1.0.3

package/README.md

@@ -24,9 +24,17 @@ $ npm install -S fetch-request-browser
 ## Usage
 
 ```typescript
-import { sendGET } from 'fetch-request-browser';
-
-await sendGET('https://httpbin.org/get');
+import { send } from 'fetch-request-browser';
+
+await send(
+  'https://httpbin.org/get', 
+  { 
+    requestOptions: {  
+      method: 'GET' 
+    } 
+  }, 
+  [3, 5, 10]
+);
 // {
 //   code: 200,
 //   headers: Headers {
@@ -69,7 +77,8 @@ Build and send an HTTP Request (any method):
 ```typescript
 send(
   input: IRequestInput, 
-  options?: Partial<IOptions>
+  options?: Partial<IOptions>,
+  retryDelaySchedule?: number[],
 ): Promise<IRequestResponse>
 ```
 
@@ -80,8 +89,7 @@ Build and send a `GET` HTTP Request:
 sendGET(
   input: IRequestInput,
   options?: Partial<IOptions>,
-  retryAttempts?: number,
-  retryDelaySeconds?: number
+  retryDelaySchedule?: number[],
 ): Promise<IRequestResponse>
 ```
 
@@ -91,7 +99,8 @@ Build and send a `POST` HTTP Request:
 ```typescript
 sendPOST(
   input: IRequestInput,
-  options?: Partial<IOptions>
+  options?: Partial<IOptions>,
+  retryDelaySchedule?: number[],
 ): Promise<IRequestResponse>
 ```
 
@@ -101,7 +110,8 @@ Build and send a `PUT` HTTP Request:
 ```typescript
 sendPUT(
   input: IRequestInput,
-  options?: Partial<IOptions>
+  options?: Partial<IOptions>,
+  retryDelaySchedule?: number[],
 ): Promise<IRequestResponse>
 ```
 
@@ -111,7 +121,8 @@ Build and send a `PATCH` HTTP Request:
 ```typescript
 sendPATCH(
   input: IRequestInput,
-  options?: Partial<IOptions>
+  options?: Partial<IOptions>,
+  retryDelaySchedule?: number[],
 ): Promise<IRequestResponse>
 ```
 
@@ -121,7 +132,8 @@ Build and send a `DELETE` HTTP Request:
 ```typescript
 sendDELETE(
   input: IRequestInput,
-  options?: Partial<IOptions>
+  options?: Partial<IOptions>,
+  retryDelaySchedule?: number[],
 ): Promise<IRequestResponse>
 ```
 

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { IRequestInput, IRequestMethod, IRequestOptions, IResponseDataType, IOptions, IRequestResponse } from './shared/types.js';
 /**
- * Builds and sends an HTTP Request based on the provided input and options.
+ * Attempts to send a HTTP request persistently (optionally).
  * @param input
  * @param options?
+ * @param retryDelaySchedule? - list of seconds that will be applied to the delay before retrying
  * @returns Promise<IRequestResponse>
  * @throws
  * - INVALID_REQUEST_URL: if the provided input URL cannot be parsed
@@ -13,7 +14,7 @@ import { IRequestInput, IRequestMethod, IRequestOptions, IResponseDataType, IOpt
  * - CONTENT_TYPE_MISSMATCH: if the Content-Type Headers don't match
  * - INVALID_RESPONSE_DTYPE: if the data type is not supported by the Response Instance
  */
-declare const send: (input: IRequestInput, options?: Partial<IOptions>) => Promise<IRequestResponse>;
+declare const send: (input: IRequestInput, options?: Partial<IOptions>, retryDelaySchedule?: number[]) => Promise<IRequestResponse>;
 /**
  * Builds and sends a GET HTTP Request based on the provided input and options.
  * IMPORTANT: The browser environment can be highly unreliable as the user can physically move
@@ -21,8 +22,7 @@ declare const send: (input: IRequestInput, options?: Partial<IOptions>) => Promi
  * worth retrying as they could fail temporarily and prevent a view from loading.
  * @param input
  * @param options?
- * @param retryAttempts? - the number of times it will retry the request on failure
- * @param retryDelaySeconds? - the # of secs it will wait before re-sending the req. Defaults to 3
+ * @param retryDelaySchedule? - list of seconds that will be applied to the delay before retrying
  * @returns Promise<IRequestResponse>
  * @throws
  * - INVALID_REQUEST_URL: if the provided input URL cannot be parsed
@@ -33,11 +33,12 @@ declare const send: (input: IRequestInput, options?: Partial<IOptions>) => Promi
  * - CONTENT_TYPE_MISSMATCH: if the Content-Type Headers don't match
  * - INVALID_RESPONSE_DTYPE: if the data type is not supported by the Response Instance
  */
-declare const sendGET: (input: IRequestInput, options?: Partial<IOptions>, retryAttempts?: number, retryDelaySeconds?: number) => Promise<IRequestResponse>;
+declare const sendGET: (input: IRequestInput, options?: Partial<IOptions>, retryDelaySchedule?: number[]) => Promise<IRequestResponse>;
 /**
  * Builds and sends a POST HTTP Request based on the provided input and options.
  * @param input
  * @param options?
+ * @param retryDelaySchedule? - list of seconds that will be applied to the delay before retrying
  * @returns Promise<IRequestResponse>
  * @throws
  * - INVALID_REQUEST_URL: if the provided input URL cannot be parsed
@@ -48,11 +49,12 @@ declare const sendGET: (input: IRequestInput, options?: Partial<IOptions>, retry
  * - CONTENT_TYPE_MISSMATCH: if the Content-Type Headers don't match
  * - INVALID_RESPONSE_DTYPE: if the data type is not supported by the Response Instance
  */
-declare const sendPOST: (input: IRequestInput, options?: Partial<IOptions>) => Promise<IRequestResponse>;
+declare const sendPOST: (input: IRequestInput, options?: Partial<IOptions>, retryDelaySchedule?: number[]) => Promise<IRequestResponse>;
 /**
  * Builds and sends a PUT HTTP Request based on the provided input and options.
  * @param input
  * @param options?
+ * @param retryDelaySchedule? - list of seconds that will be applied to the delay before retrying
  * @returns Promise<IRequestResponse>
  * @throws
  * - INVALID_REQUEST_URL: if the provided input URL cannot be parsed
@@ -63,11 +65,12 @@ declare const sendPOST: (input: IRequestInput, options?: Partial<IOptions>) => P
  * - CONTENT_TYPE_MISSMATCH: if the Content-Type Headers don't match
  * - INVALID_RESPONSE_DTYPE: if the data type is not supported by the Response Instance
  */
-declare const sendPUT: (input: IRequestInput, options?: Partial<IOptions>) => Promise<IRequestResponse>;
+declare const sendPUT: (input: IRequestInput, options?: Partial<IOptions>, retryDelaySchedule?: number[]) => Promise<IRequestResponse>;
 /**
  * Builds and sends a PATCH HTTP Request based on the provided input and options.
  * @param input
  * @param options?
+ * @param retryDelaySchedule? - list of seconds that will be applied to the delay before retrying
  * @returns Promise<IRequestResponse>
  * @throws
  * - INVALID_REQUEST_URL: if the provided input URL cannot be parsed
@@ -78,11 +81,12 @@ declare const sendPUT: (input: IRequestInput, options?: Partial<IOptions>) => Pr
  * - CONTENT_TYPE_MISSMATCH: if the Content-Type Headers don't match
  * - INVALID_RESPONSE_DTYPE: if the data type is not supported by the Response Instance
  */
-declare const sendPATCH: (input: IRequestInput, options?: Partial<IOptions>) => Promise<IRequestResponse>;
+declare const sendPATCH: (input: IRequestInput, options?: Partial<IOptions>, retryDelaySchedule?: number[]) => Promise<IRequestResponse>;
 /**
  * Builds and sends a DELETE HTTP Request based on the provided input and options.
  * @param input
  * @param options?
+ * @param retryDelaySchedule? - list of seconds that will be applied to the delay before retrying
  * @returns Promise<IRequestResponse>
  * @throws
  * - INVALID_REQUEST_URL: if the provided input URL cannot be parsed
@@ -93,5 +97,5 @@ declare const sendPATCH: (input: IRequestInput, options?: Partial<IOptions>) =>
  * - CONTENT_TYPE_MISSMATCH: if the Content-Type Headers don't match
  * - INVALID_RESPONSE_DTYPE: if the data type is not supported by the Response Instance
  */
-declare const sendDELETE: (input: IRequestInput, options?: Partial<IOptions>) => Promise<IRequestResponse>;
+declare const sendDELETE: (input: IRequestInput, options?: Partial<IOptions>, retryDelaySchedule?: number[]) => Promise<IRequestResponse>;
 export { IRequestInput, IRequestMethod, IRequestOptions, IResponseDataType, IOptions, IRequestResponse, send, sendGET, sendPOST, sendPUT, sendPATCH, sendDELETE, };

package/dist/index.js

@@ -1 +1 @@
-import{buildOptions,buildRequest,extractResponseData,delay}from"./utils/utils.js";import{validateResponse}from"./validations/validations.js";const send=async(e,t)=>{const s=buildOptions(t),n=buildRequest(e,s.requestOptions),d=await fetch(n);return validateResponse(n,d,s),d.redirected&&console.warn(`The request sent to '${n.url}' was redirected. Please update the implementation to avoid future redirections.`),{code:d.status,headers:d.headers,data:await extractResponseData(d,s.responseDataType)}},__executeSendGET=(e,t)=>send(e,{...t,requestOptions:{...t?.requestOptions,method:"GET"}}),sendGET=async(e,t,s,n)=>{try{return await __executeSendGET(e,t)}catch(d){if("number"==typeof s&&s>0)return await delay(n||3),sendGET(e,t,s-1,n);throw d}},sendPOST=(e,t)=>send(e,{...t,requestOptions:{...t?.requestOptions,method:"POST"}}),sendPUT=(e,t)=>send(e,{...t,requestOptions:{...t?.requestOptions,method:"PUT"}}),sendPATCH=(e,t)=>send(e,{...t,requestOptions:{...t?.requestOptions,method:"PATCH"}}),sendDELETE=(e,t)=>send(e,{...t,requestOptions:{...t?.requestOptions,method:"DELETE"}});export{send,sendGET,sendPOST,sendPUT,sendPATCH,sendDELETE};
+import{extractMessage}from"error-message-utils";import{buildOptions,buildRequest,extractResponseData,delay}from"./utils/utils.js";import{validateResponse}from"./validations/validations.js";const __executeSend=async(e,s)=>{const t=buildOptions(s),n=buildRequest(e,t.requestOptions),r=await fetch(n);return validateResponse(n,r,t),r.redirected&&console.warn(`The request sent to '${n.url}' was redirected. Please update the implementation to avoid future redirections.`),{code:r.status,headers:r.headers,data:await extractResponseData(r,t.responseDataType)}},send=async(e,s,t)=>{try{return await __executeSend(e,s)}catch(n){if(extractMessage(n).includes("429")||!Array.isArray(t)||0===t.length)throw n;return await delay(t[0]),send(e,s,t.slice(1))}},sendGET=async(e,s,t)=>send(e,{...s,requestOptions:{...s?.requestOptions,method:"GET"}},t),sendPOST=(e,s,t)=>send(e,{...s,requestOptions:{...s?.requestOptions,method:"POST"}},t),sendPUT=(e,s,t)=>send(e,{...s,requestOptions:{...s?.requestOptions,method:"PUT"}},t),sendPATCH=(e,s,t)=>send(e,{...s,requestOptions:{...s?.requestOptions,method:"PATCH"}},t),sendDELETE=(e,s,t)=>send(e,{...s,requestOptions:{...s?.requestOptions,method:"DELETE"}},t);export{send,sendGET,sendPOST,sendPUT,sendPATCH,sendDELETE};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fetch-request-browser",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "The fetch-request-browser package makes working with external APIs simple and efficient. This intuitive wrapper leverages the power of the Fetch API, providing a clean and concise interface for your API interactions.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,15 +33,15 @@
   },
   "homepage": "https://github.com/jesusgraterol/fetch-request-browser#readme",
   "devDependencies": {
-    "@types/node": "^20.13.0",
-    "@typescript-eslint/eslint-plugin": "^7.11.0",
-    "@typescript-eslint/parser": "^7.11.0",
+    "@types/node": "^20.14.12",
+    "@typescript-eslint/eslint-plugin": "^7.17.0",
+    "@typescript-eslint/parser": "^7.17.0",
     "eslint-config-airbnb-typescript": "^18.0.0",
     "ts-lib-builder": "^1.0.3",
-    "typescript": "^5.4.5",
+    "typescript": "^5.5.4",
     "vitest": "^1.6.0"
   },
   "dependencies": {
-    "error-message-utils": "^1.1.0"
+    "error-message-utils": "^1.1.1"
   }
 }