@ndriadev/futurable 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Andrea Cosentino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,536 @@
+
+<h1 align="center">Futurable</h1>
+<p align="center">
+Power up for Javascript's Promise API with cancellation support and more.
+</p>
+<p align="center">
+<a  href="https://www.npmjs.com/package/futurable">
+<img  src="https://img.shields.io/npm/v/futurable?color=orange&label="  alt="version" />
+</a>
+</p>
+
+
+#  Summary
+- [ToDo](#TODO)
+- [Introduction](#introduction)
+	- [Installation](#Installation)
+- [Usage](#Usage)
+	- [Use-case](#Use-case)
+		- [React](#React)
+- [API](#API)
+	- [constructor](#constructor)
+	- [cancel](#cancel)
+	- [onCancel](#onCancel)
+	- [sleep](#sleep)
+	- [delay](#delay)
+	- [fetch](#fetch)
+	- [promisify](#promisify)
+	- [futurizable](#futurizable)
+	- [Futurable.onCancel](#Futurable.onCancel)
+	- [Futurable.sleep](#Futurable.sleep)
+	- [Futurable.delay](#Futurable.delay)
+	- [Futurable.fetch](#Futurable.fetch)
+	- [Futurable.futurizable](#Futurable.futurizable)
+	- [Futurable.all](#Futurable.all)
+	- [Futurable.allSettled](Futurable.allSettled)
+	- [Futurable.race](#Futurable.race)
+	- [Futurable.any](#Futurable.any)
+- [License](#License)
+
+
+#  ToDo
+- Think about the possibility of making a static method that returns an object with the futurable, resolve, reject, utils properties inside to be used as done for usePromiser.
+
+
+#  Introduction
+Futurable is a library that extends Javascript's Promise API, adding a number of useful features and with support for Typescirpt. It can be used on both browser and node.
+
+Often it happens where to develop a feature using promises that covers a particular need. Often there is a need to delay execution, or even to cancel what is in progress. Javascript's Promise API doesn't offer an immediate way to do this, so we are forced to implement the code ourselves that does what we need. The purpose of this library is to provide these features ready to use, without the user having to think about anything else.
+
+:warning: If you intend to use the library in node, for versions lower than **17.5.0** it is necessary to install the *node-fetch* library, since the native support for the Fetch API was introduced by this version.
+
+##  Installation
+```bash
+
+npm  install  futurable  # or yarn add futurable or pnpm add futurable
+
+```
+
+
+#  Usage
+The library supports both ESM and CJS formats, so it can be used as follows:
+```javascript
+import Futurable from 'futurable'; 		// ok
+
+const { Futurable } = require('futurable');	// ok
+```
+
+## Use-case
+### React
+Thanks to the use of this library, there is a simple and effective way to be able to cancel an Api request executed in a useEffect which, due to the Strict Mode, is executed twice:
+```jsx
+export default function Component() {
+	//...code
+
+	useEffect(() => {
+        const f;
+        function callApi() {
+            f = Futurable
+            .fetch("https://jsonplaceholder.typicode.com/todos/2")
+            .onAbort(() => console.log("aborted"))
+            .then(resp => resp.json())
+            .then(setTodo);
+        }
+        callApi();
+        return () => {
+            f && f.cancel();
+        }
+    },[])
+
+	//OR
+
+	useEffect(() => {
+        const controller = new AbortController();
+        Futurable
+        .fetch(
+            "https://jsonplaceholder.typicode.com/todos/2",
+            {
+                signal: controller.signal
+            }
+        )
+        .then(resp => resp.json())
+        .then(setTodo);
+
+        return () => {
+            controller.abort();
+        }
+    },[])
+
+	//...code
+}
+```
+
+#  API
+The methods implemented, excluding those that are by nature static can be used:
+- During the construction of the futurable using the ***new*** operator;
+- In the chain-style ***promise chaining***.
+
+They are the following:
+- [cancel](#cancel)
+- [onCancel](#onCancel)
+- [sleep](#sleep)
+- [delay](#delay)
+- [fetch](#fetch)
+- [promisify](#promisify)
+- [futurizable](#futurizable)
+- [Futurable.onCancel](#Futurable.onCancel)
+- [Futurable.sleep](#Futurable.sleep)
+- [Futurable.delay](#Futurable.delay)
+- [Futurable.fetch](#Futurable.fetch)
+- [Futurable.futurizable](#Futurable.futurizable)
+- [Futurable.all](#Futurable.all)
+- [Futurable.allSettled](Futurable.allSettled)
+- [Futurable.race](#Futurable.race)
+- [Futurable.any](#Futurable.any)
+
+### constructor(executor: FuturableExecutor, signal?: AbortSignal)
+Futurable is instantiable like a classic Promise.
+```javascript
+//Javascript Promise
+
+const promise = new Promise((resolve, reject) => {
+	const data = /*..async operations or other..*/
+	resolve(data);
+});
+
+//Futurable
+import Futurable from 'futurable';
+
+const futurable = new Futurable((resolve, reject) => {
+	const data = /*..async operations or other..*/
+	resolve(data);
+});
+```
+But it provides two more statements:
+
+1. Its constructor can receive a second parameter *signal*, an *AbortSignal*, usable to cancel the promise from the outside.
+
+```javascript
+const controller = new AbortController();
+
+const futurable = new Futurable((resolve, reject) => {
+	const data = /*..async operations or other..*/
+	resolve(data);
+}, controller.signal);
+```
+
+2. The executor function passed to the promise receives a third parameter, *utils*, optional.
+
+```javascript
+const controller = new AbortController();
+
+const futurable = new Futurable((resolve, reject, utils) => {
+	const data = /*..async operations or other..*/
+	resolve(data);
+});
+```
+Utils is an object with the following properties which mirror the methods described in the usage section and which will be described below:
+- cancel;
+- onCancel:
+- delay;
+- sleep;
+- fetch;
+- futurizable.
+
+In addition is has:
+- signal: internal futurable signal;
+
+### cancel()
+If invoked, it cancel the futurable if it is to be executed or if it is still executing.
+
+*Example*
+```javascript
+function asynchronousOperation() {
+	return new Futurable((res, rej) => {
+		// asynchornous code..
+		resolve(true);
+	});
+);
+
+//...code
+
+const futurable = asynchronousOperation();
+	futurable.then(value => {
+	//DO anything
+});
+
+//...code
+
+futurable.cancel();
+```
+
+### onCancel(cb: callback)
+If it is invoked, when the futurable is cancelled, it executes the callback passed as a parameter.
+
+*Example*
+```javascript
+const futurable = new Futurable((resolve, reject, utils) => {
+	utils.onCancel(() => console.log("Futurable cancelled"));
+	const data = /*..async operations or other..*/
+	resolve(data);
+});
+
+//...code
+
+futurable.cancel();
+
+//OR
+
+const futurable = new Futurable((res, rej) => {
+	// asynchornous code..
+	resolve(true);
+});
+
+//...code
+
+futurable
+.onCancel(() => console.log("Futurable cancelled"))
+.then(val => .......);
+
+//...code
+
+futurable.cancel();
+```
+```bash
+Output: Futurable cancelled
+```
+
+### sleep(timer: number)
+Waits for timer parameter (in milliseconds) before returning the value.
+
+*Example*
+```javascript
+const futurable = new Futurable((resolve, reject, utils) => {
+	const data = /*..async operations or other..*/
+	utils.sleep(3000);
+	resolve(data);
+});
+//...code
+
+//OR
+
+const futurable = new Futurable((res, rej) => {
+	// asynchornous code..
+	resolve(true);
+});
+
+//...code
+
+futurable
+.sleep(3000)
+.then(val => .......);
+
+//...code
+```
+
+### delay(cb: callback, timer: number)
+Waits for timer parameter (in milliseconds), then executes callback with the futurable value and returns the result obtained from the invocation.
+*Example*
+```javascript
+const futurable = new Futurable((resolve, reject, utils) => {
+	const data = /*..async operations or other..*/
+	utils.delay(()=>console.log("delayed"), 3000);
+	resolve(data);
+});
+
+//...code
+
+//OR
+
+const futurable = new Futurable((res, rej) => {
+	// asynchornous code..
+	resolve(true);
+});
+
+//...code
+
+futurable
+.delay((val)=> {
+	console.log("delayed val", val);
+	return val;
+},3000)
+.then(val => .......);
+
+//...code
+```
+
+### fetch(url: string | (val => string), opts: object | RequestInit)
+Extension of the fetch API with cancellation support. Url parameter can be a string or a function with receive value from futurable chaining as paremeter
+
+*Example*
+```javascript
+const futurable = new Futurable((resolve, reject, utils) => {
+	utils.fetch(/*string url to fetch..*/)
+	.then(val => resolve(val))
+});
+
+//...code
+
+//OR
+
+const futurable = new Futurable((res, rej) => {
+	// asynchornous code..
+	resolve(true);
+});
+
+//...code
+
+futurable
+.fetch(/*url to fetch..*/)
+.then(val => .......);
+
+//OR
+futurable
+.then(val => "https://...")
+.fetch((val /* val came from previous then*/) => ..., ..)
+
+//...code
+```
+
+<!---
+### promisify()
+Transforms the futurable into a normal promise in order to be able to use the async/await syntax but keeping possibility to cancel futurable until its invocation.
+
+*Example*
+```javascript
+async function op() {
+	...
+	...
+
+	await Futurable.sleep(3000).promisify();
+}
+```
+--->
+### futurizable(promise: Promise | (val => Promise))
+Takes a promise and transforms it into a futurizable. Promise can be also a function that receives value from futurable chaining as parameter.
+
+*Example*
+```javascript
+const futurable = new Futurable((resolve, reject, utils) => {
+	utils.futurizable(new Promise(res => {
+		//asynchronous code
+		res(data);
+	}))
+	.then(val => resolve(val))
+});
+
+//...code
+
+//OR
+
+const futurable = new Futurable((res, rej) => {
+	// asynchornous code..
+	resolve(true);
+});
+
+//...code
+
+futurable
+.futurizable(/*promise to futurizable*/)
+.then(val => .......);
+
+//OR
+futurable
+.then(val => 3)
+.futurizable((val /* val is 3 */) => new Promise(/*...*/) /*promise to futurizable*/, ..)
+
+//...code
+```
+
+### Futurable.onCancel(cb: callback | {cb: callback, signal?: AbortSignal})
+OnCancel static method. It accepts a callback or a object with cb property and an optional signal.
+
+*Example*
+```javascript
+const controller = new AbortController();
+
+//...code
+Futurable.onCancel({
+	cb: ()=>console.log("Cancelled"),
+	signal: controller.signal
+});
+//...code
+```
+
+### Futurable.sleep(timer: number | {timer: number, signal?: AbortSignal})
+Sleep static method. It accepts a timer or a object with timer property and an optional signal.
+
+*Example*
+```javascript
+//...code
+
+Futurable.sleep({
+	timer: 3000,
+	signal: signal
+});
+
+//...code
+```
+
+### Futurable.delay({cb: callback, timer: number, signal?: AbortSignal})
+Delay static method. It accepts a object with timer and cb properties and an optional signal property.
+
+*Example*
+```javascript
+const controller = new AbortController();
+//...code
+
+Futurable.delay({
+	cb: ()=>console.log("Cancelled"),
+	timer: 3000
+});
+
+//...code
+```
+
+### Futurable.fetch(url: string, opts: object | RequestInit)
+Fetch static method.
+
+*Example*
+```javascript
+//...code
+
+Futurable.fetch(/*url string..*/, {method: "POST"});
+
+//...code
+```
+
+### Futurable.futurizable({promise: Promise, signal: AbortSignal})
+Futurizable static method.
+
+*Example*
+```javascript
+const controller = new AbortController();
+//...code
+
+Futurable.futurizable({promise: /*promise to futurizable*/, signal: controller.signal});
+
+//...code
+```
+
+### Futurable.all(iterable: FuturableIterable[], signal?: AbortSignal)
+Extension of the static method all with cancellation support.
+
+*Example*
+```javascript
+const controller = new AbortController();
+
+//...code
+
+Futurable.all([
+	1,
+	Futurable.resolve(true),
+	new Futurable/*...*/
+], controller.signal);
+
+//...code
+```
+
+### Futurable.allSettled(iterable: FuturableIterable[], signal?: AbortSignal)
+Extension of the static method allSettled with cancellation support.
+
+*Example*
+```javascript
+const controller = new AbortController();
+
+//...code
+
+Futurable.allSettled([
+	1,
+	Futurable.resolve(true),
+	new Futurable/*...*/
+], controller.signal);
+
+//...code
+```
+
+### Futurable.any(iterable: FuturableIterable[], signal?: AbortSignal)
+Extension of the static method any with cancellation support.
+
+*Example*
+```javascript
+const controller = new AbortController();
+//...code
+
+Futurable.any([
+	1,
+	Futurable.resolve(true),
+	new Futurable/*...*/
+], controller.signal);
+
+//...code
+```
+
+### Futurable.race(iterable: FuturableIterable[], signal?: AbortSignal)
+Extension of the static method race with cancellation support.
+
+*Example*
+```javascript
+const controller = new AbortController();
+//...code
+
+Futurable.race([
+	1,
+	Futurable.resolve(true),
+	new Futurable/*...*/
+], controller.signal);
+
+//...code
+```
+
+
+## License
+
+
+
+Futurable is licensed under a [MIT License](./LICENSE).

package/dist/futurable.cjs

@@ -0,0 +1 @@
+"use strict";var I=(a,f,e)=>{if(!f.has(a))throw TypeError("Cannot "+e)};var l=(a,f,e)=>(I(a,f,"read from private field"),e?e.call(a):f.get(a)),C=(a,f,e)=>{if(f.has(a))throw TypeError("Cannot add the same private member more than once");f instanceof WeakSet?f.add(a):f.set(a,e)},p=(a,f,e,t)=>(I(a,f,"write to private field"),t?t.call(a,e):f.set(a,e),e);var w=(a,f,e)=>(I(a,f,"access private method"),e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var x=(a=>(a.PENDING="pending",a.FULFILLED="fulfilled",a.REJECTED="rejected",a))(x||{}),u,d,T,S,L,v,P;const i=class extends Promise{constructor(e,t){const n=t?null:new AbortController,r=t||n.signal,s=[],o=()=>{for(const h of s)clearTimeout(h)};let c;const y={signal:r,cancel:()=>{var h;return(h=l(this,u))==null?void 0:h.abort()},onCancel:h=>{c=h},delay:(h,b)=>new i(m=>{s.push(setTimeout(()=>{m(h())},b))},r),sleep:h=>y.delay(()=>{},h),fetch:(h,b)=>new i((m,N)=>{fetch(h,{...b||{},signal:r}).then(E=>m(E)).catch(E=>{E.name!=="AbortError"&&N(E)})},r),futurizable:h=>new i((b,m)=>{h.then(b).catch(m)},r)};let j="pending";const A=new Promise((h,b)=>{if(r.aborted){o(),j==="pending"&&c&&c();return}else{const m=typeof r.onabort=="function"?r.onabort:()=>{};r.onabort=()=>{m(),o(),j==="pending"&&c&&c()},e(D=>{j="fulfilled",h(D)},D=>{j="rejected",b(D)},y)}});super((h,b)=>{A.then(m=>h(m)).catch(b)});C(this,S);C(this,u,void 0);C(this,d,void 0);C(this,T,void 0);p(this,u,n),p(this,d,r),p(this,T,s)}static get[Symbol.species](){return this}get[Symbol.toStringTag](){return"Futurable"}get signal(){return l(this,d)}then(e,t){let n,r;const s=new i((o,c)=>{n=o,r=c},l(this,d));return p(s,u,l(this,u)),super.then(o=>{var c;if((c=l(this,d))!=null&&c.aborted){w(this,S,L).call(this);return}try{n(e?e(o):o)}catch(g){r(g)}},o=>{var c;if((c=l(this,d))!=null&&c.aborted){w(this,S,L).call(this);return}try{t?n(t(o)):r(o)}catch(g){r(g)}}),s}catch(e){return this.then(null,e)}finally(e){return this.then(()=>{e()},()=>{e()})}cancel(){var e,t;!((e=l(this,d))!=null&&e.aborted)&&((t=l(this,u))==null||t.abort())}delay(e,t){let n,r;const s=new i((o,c)=>{n=o,r=c},l(this,d));return p(s,u,l(this,u)),this.then(o=>{l(this,T).push(setTimeout(()=>n(e(o)),t))},o=>{r(o)}),s}sleep(e){return this.delay(t=>t,e)}fetch(e,t){let n,r;const s=new i((o,c)=>{n=o,r=c},l(this,d));return p(s,u,l(this,u)),this.then(o=>{const c=typeof e=="function"?e(o):e,g={...typeof t=="function"?t(o):t,signal:l(this,d)};fetch(c,g).then(y=>n(y)).catch(y=>{y.name!=="AbortError"&&r(y)})}),s}onCancel(e){let t,n;const r=new i((s,o,c)=>{c.onCancel(e),t=s,n=o},l(this,d));return p(r,u,l(this,u)),this.then(s=>t(s),s=>n(s)),r}futurizable(e){let t,n;const r=new i((s,o)=>{t=s,n=o},l(this,d));return p(r,u,l(this,u)),this.then(s=>{(typeof e=="function"?e(s):e).then(t).catch(n)}),r}static resolve(e,t){return new i(n=>n(e),t)}static reject(e,t){return new i((n,r)=>r(e),t)}static onCancel({cb:e,signal:t}){return new i((n,r,s)=>{s.onCancel(()=>n(e()))},t)}static delay({cb:e,timer:t,signal:n}){return i.resolve(!0,n).delay(e,t)}static sleep({timer:e,signal:t}){return i.delay({cb:()=>{},timer:e,signal:t})}static fetch(e,t){const n=(t==null?void 0:t.signal)||void 0;return t!=null&&t.signal&&delete t.signal,i.resolve(!0,n).fetch(e,t)}static futurizable({promise:e,signal:t}){return new i((n,r)=>{e.then(n).catch(r)},t)}static all(e,t){var c;const{f:n,resolve:r,reject:s,array:o}=w(c=i,v,P).call(c,e,t);return super.all(o).then(r).catch(s),n}static allSettled(e,t){var c;const{f:n,resolve:r,reject:s,array:o}=w(c=i,v,P).call(c,e,t);return super.allSettled(o).then(r).catch(s),n}static race(e,t){var c;const{f:n,resolve:r,reject:s,array:o}=w(c=i,v,P).call(c,e,t);return super.race(o).then(r).catch(s),n}static any(e,t){var c;const{f:n,resolve:r,reject:s,array:o}=w(c=i,v,P).call(c,e,t);return super.any(o).then(r).catch(s),n}};let z=i;u=new WeakMap,d=new WeakMap,T=new WeakMap,S=new WeakSet,L=function(){for(const e of l(this,T))clearTimeout(e)},v=new WeakSet,P=function(e,t){let n,r;const s=[],o=new i((c,g,y)=>{n=c,r=g,y.onCancel(()=>{for(const j of s)j.signal!==t&&j.cancel()})},t);t||(t=o.signal);for(const c in e)e[c]instanceof i?s.push(e[c]):e[c]instanceof Promise?s.push(new i((g,y)=>{e[c].then(g).catch(y)},t)):s.push(i.resolve(e[c]));return{f:o,resolve:n,reject:r,array:s}},C(z,v);exports.FUTURABLE_STATUS=x;exports.Futurable=z;

package/dist/futurable.mjs

@@ -0,0 +1,260 @@
+var I = (a, f, e) => {
+  if (!f.has(a))
+    throw TypeError("Cannot " + e);
+};
+var l = (a, f, e) => (I(a, f, "read from private field"), e ? e.call(a) : f.get(a)), C = (a, f, e) => {
+  if (f.has(a))
+    throw TypeError("Cannot add the same private member more than once");
+  f instanceof WeakSet ? f.add(a) : f.set(a, e);
+}, w = (a, f, e, t) => (I(a, f, "write to private field"), t ? t.call(a, e) : f.set(a, e), e);
+var j = (a, f, e) => (I(a, f, "access private method"), e);
+var L = /* @__PURE__ */ ((a) => (a.PENDING = "pending", a.FULFILLED = "fulfilled", a.REJECTED = "rejected", a))(L || {}), u, d, E, z, N, v, T;
+const i = class extends Promise {
+  constructor(e, t) {
+    const n = t ? null : new AbortController(), r = t || n.signal, s = [], o = () => {
+      for (const h of s)
+        clearTimeout(h);
+    };
+    let c;
+    const y = {
+      signal: r,
+      cancel: () => {
+        var h;
+        return (h = l(this, u)) == null ? void 0 : h.abort();
+      },
+      onCancel: (h) => {
+        c = h;
+      },
+      delay: (h, p) => new i((m) => {
+        s.push(setTimeout(() => {
+          m(h());
+        }, p));
+      }, r),
+      sleep: (h) => y.delay(() => {
+      }, h),
+      fetch: (h, p) => new i((m, G) => {
+        fetch(h, { ...p || {}, signal: r }).then((P) => m(P)).catch((P) => {
+          P.name !== "AbortError" && G(P);
+        });
+      }, r),
+      futurizable: (h) => new i((p, m) => {
+        h.then(p).catch(m);
+      }, r)
+    };
+    let b = "pending";
+    const J = new Promise((h, p) => {
+      if (r.aborted) {
+        o(), b === "pending" && c && c();
+        return;
+      } else {
+        const m = typeof r.onabort == "function" ? r.onabort : () => {
+        };
+        r.onabort = () => {
+          m(), o(), b === "pending" && c && c();
+        }, e((D) => {
+          b = "fulfilled", h(D);
+        }, (D) => {
+          b = "rejected", p(D);
+        }, y);
+      }
+    });
+    super((h, p) => {
+      J.then((m) => h(m)).catch(p);
+    });
+    C(this, z);
+    C(this, u, void 0);
+    C(this, d, void 0);
+    C(this, E, void 0);
+    w(this, u, n), w(this, d, r), w(this, E, s);
+  }
+  static get [Symbol.species]() {
+    return this;
+  }
+  get [Symbol.toStringTag]() {
+    return "Futurable";
+  }
+  get signal() {
+    return l(this, d);
+  }
+  then(e, t) {
+    let n, r;
+    const s = new i((o, c) => {
+      n = o, r = c;
+    }, l(this, d));
+    return w(s, u, l(this, u)), super.then((o) => {
+      var c;
+      if ((c = l(this, d)) != null && c.aborted) {
+        j(this, z, N).call(this);
+        return;
+      }
+      try {
+        n(e ? e(o) : o);
+      } catch (g) {
+        r(g);
+      }
+    }, (o) => {
+      var c;
+      if ((c = l(this, d)) != null && c.aborted) {
+        j(this, z, N).call(this);
+        return;
+      }
+      try {
+        t ? n(t(o)) : r(o);
+      } catch (g) {
+        r(g);
+      }
+    }), s;
+  }
+  catch(e) {
+    return this.then(null, e);
+  }
+  finally(e) {
+    return this.then(
+      () => {
+        e();
+      },
+      () => {
+        e();
+      }
+    );
+  }
+  cancel() {
+    var e, t;
+    !((e = l(this, d)) != null && e.aborted) && ((t = l(this, u)) == null || t.abort());
+  }
+  delay(e, t) {
+    let n, r;
+    const s = new i((o, c) => {
+      n = o, r = c;
+    }, l(this, d));
+    return w(s, u, l(this, u)), this.then(
+      (o) => {
+        l(this, E).push(setTimeout(() => n(e(o)), t));
+      },
+      (o) => {
+        r(o);
+      }
+    ), s;
+  }
+  sleep(e) {
+    return this.delay((t) => t, e);
+  }
+  fetch(e, t) {
+    let n, r;
+    const s = new i((o, c) => {
+      n = o, r = c;
+    }, l(this, d));
+    return w(s, u, l(this, u)), this.then((o) => {
+      const c = typeof e == "function" ? e(o) : e, g = { ...typeof t == "function" ? t(o) : t, signal: l(this, d) };
+      fetch(c, g).then((y) => n(y)).catch((y) => {
+        y.name !== "AbortError" && r(y);
+      });
+    }), s;
+  }
+  onCancel(e) {
+    let t, n;
+    const r = new i((s, o, c) => {
+      c.onCancel(e), t = s, n = o;
+    }, l(this, d));
+    return w(r, u, l(this, u)), this.then(
+      (s) => t(s),
+      (s) => n(s)
+    ), r;
+  }
+  // promisify<TResult1 = T, TResult2 = never>(): Promise<TResult1 | TResult2> {
+  // 	return new Promise((res, rej) => {
+  // 		if (this.#signal.aborted) {
+  // 			this.#clearTimeout();
+  // 			return;
+  // 		} else {
+  // 			this.then(
+  // 				val => res(val),
+  // 				reason => rej(reason)
+  // 			);
+  // 		}
+  // 	});
+  // }
+  futurizable(e) {
+    let t, n;
+    const r = new i((s, o) => {
+      t = s, n = o;
+    }, l(this, d));
+    return w(r, u, l(this, u)), this.then((s) => {
+      (typeof e == "function" ? e(s) : e).then(t).catch(n);
+    }), r;
+  }
+  static resolve(e, t) {
+    return new i((n) => n(e), t);
+  }
+  static reject(e, t) {
+    return new i((n, r) => r(e), t);
+  }
+  static onCancel({ cb: e, signal: t }) {
+    return new i((n, r, s) => {
+      s.onCancel(() => n(e()));
+    }, t);
+  }
+  static delay({ cb: e, timer: t, signal: n }) {
+    return i.resolve(!0, n).delay(e, t);
+  }
+  static sleep({ timer: e, signal: t }) {
+    return i.delay({
+      cb: () => {
+      },
+      timer: e,
+      signal: t
+    });
+  }
+  static fetch(e, t) {
+    const n = (t == null ? void 0 : t.signal) || void 0;
+    return t != null && t.signal && delete t.signal, i.resolve(!0, n).fetch(e, t);
+  }
+  static futurizable({ promise: e, signal: t }) {
+    return new i((n, r) => {
+      e.then(n).catch(r);
+    }, t);
+  }
+  static all(e, t) {
+    var c;
+    const { f: n, resolve: r, reject: s, array: o } = j(c = i, v, T).call(c, e, t);
+    return super.all(o).then(r).catch(s), n;
+  }
+  static allSettled(e, t) {
+    var c;
+    const { f: n, resolve: r, reject: s, array: o } = j(c = i, v, T).call(c, e, t);
+    return super.allSettled(o).then(r).catch(s), n;
+  }
+  static race(e, t) {
+    var c;
+    const { f: n, resolve: r, reject: s, array: o } = j(c = i, v, T).call(c, e, t);
+    return super.race(o).then(r).catch(s), n;
+  }
+  static any(e, t) {
+    var c;
+    const { f: n, resolve: r, reject: s, array: o } = j(c = i, v, T).call(c, e, t);
+    return super.any(o).then(r).catch(s), n;
+  }
+};
+let x = i;
+u = new WeakMap(), d = new WeakMap(), E = new WeakMap(), z = new WeakSet(), N = function() {
+  for (const e of l(this, E))
+    clearTimeout(e);
+}, v = new WeakSet(), T = function(e, t) {
+  let n, r;
+  const s = [], o = new i((c, g, y) => {
+    n = c, r = g, y.onCancel(() => {
+      for (const b of s)
+        b.signal !== t && b.cancel();
+    });
+  }, t);
+  t || (t = o.signal);
+  for (const c in e)
+    e[c] instanceof i ? s.push(e[c]) : e[c] instanceof Promise ? s.push(new i((g, y) => {
+      e[c].then(g).catch(y);
+    }, t)) : s.push(i.resolve(e[c]));
+  return { f: o, resolve: n, reject: r, array: s };
+}, C(x, v);
+export {
+  L as FUTURABLE_STATUS,
+  x as Futurable
+};

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+export type FuturableOnfulfilled<T, TResult2 = never> = ((value: any) => T | TResult2 | FuturableLike<T | TResult2> | PromiseLike<T | TResult2>) | undefined | null;
+export type FuturableOnrejected<TResult = never> = ((reason: any) => TResult | FuturableLike<TResult> | PromiseLike<TResult>) | undefined | null;
+export type FuturableResolveType<T> = T | FuturableLike<T> | PromiseLike<T>;
+export interface FuturableResolve<T> {
+    (value?: FuturableResolveType<T>): void;
+}
+export interface FuturableReject {
+    (reason?: any): void;
+}
+export interface FuturableUtils<T> {
+    signal: AbortSignal;
+    cancel: () => void;
+    onCancel: (cb: () => void) => void;
+    delay: (cb: () => any, timer: number) => Futurable<T>;
+    sleep: (timer: number) => Futurable<T>;
+    fetch: (url: string, opts?: RequestInit) => Futurable<T>;
+    futurizable: (promise: Promise<T>) => Futurable<T>;
+}
+export type FuturableExecutor<T> = (resolve: FuturableResolve<T>, reject: FuturableReject, utils: FuturableUtils<T>) => void;
+export type FuturableIterable = Futurable<any> | Promise<any> | any;
+export interface FuturableLike<T> {
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: FuturableOnfulfilled<TResult1, TResult2>, onrejected?: FuturableOnrejected<TResult2>): FuturableLike<TResult1 | TResult2>;
+}
+export declare enum FUTURABLE_STATUS {
+    PENDING = "pending",
+    FULFILLED = "fulfilled",
+    REJECTED = "rejected"
+}
+export declare class Futurable<T> extends Promise<T> {
+    #private;
+    constructor(executor: FuturableExecutor<T>, signal?: AbortSignal);
+    static get [Symbol.species](): typeof Futurable;
+    get [Symbol.toStringTag](): string;
+    get signal(): AbortSignal;
+    then<TResult1 = T, TResult2 = never>(onFulfilled: FuturableOnfulfilled<TResult1, TResult2>, onRejected?: FuturableOnrejected<TResult2>): Futurable<TResult1 | TResult2>;
+    catch<TResult = never>(onRejected: FuturableOnrejected<TResult>): Futurable<T | TResult>;
+    finally(onFinally: () => void): Futurable<void>;
+    cancel(): void;
+    delay<TResult1 = T, TResult2 = never>(cb: (val?: TResult1) => any, timer: number): Futurable<TResult1 | TResult2>;
+    sleep<TResult1 = T, TResult2 = never>(timer: number): Futurable<TResult1 | TResult2>;
+    fetch<TResult1 = T, TResult2 = never>(url: string | ((val?: TResult1) => string), opts?: object | RequestInit | ((val?: TResult1) => RequestInit)): Futurable<TResult1 | TResult2>;
+    onCancel<TResult1 = T, TResult2 = never>(cb: () => void): Futurable<TResult1 | TResult2>;
+    futurizable<TResult1 = T, TResult2 = never>(promise: Promise<TResult1> | ((val?: TResult1) => Promise<TResult1>)): Futurable<TResult1 | TResult2>;
+    static resolve(value?: any, signal?: AbortSignal): Futurable<any>;
+    static reject(reason?: any, signal?: AbortSignal): Futurable<any>;
+    static onCancel({ cb, signal }: {
+        cb: () => void;
+        signal?: AbortSignal;
+    }): Futurable<any>;
+    static delay({ cb, timer, signal }: {
+        cb: () => any;
+        timer: number;
+        signal?: AbortSignal;
+    }): Futurable<any>;
+    static sleep({ timer, signal }: {
+        timer: number;
+        signal?: AbortSignal;
+    }): Futurable<any>;
+    static fetch(url: string, opts?: RequestInit): Futurable<any>;
+    static futurizable<TResult1 = any, TResult2 = never>({ promise, signal }: {
+        promise: Promise<TResult1>;
+        signal?: AbortSignal;
+    }): Futurable<TResult1 | TResult2>;
+    static all(iterables: FuturableIterable[], signal?: AbortSignal): Futurable<any>;
+    static allSettled(iterables: FuturableIterable[], signal?: AbortSignal): Futurable<any>;
+    static race(iterables: FuturableIterable[], signal?: AbortSignal): Futurable<any>;
+    static any(iterables: FuturableIterable[], signal?: AbortSignal): Futurable<any>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,93 @@
+{
+	"name": "@ndriadev/futurable",
+	"description": "Extension Javascript's Promise API with more functionalities",
+	"private": false,
+	"version": "1.0.0",
+	"type": "module",
+	"engines": {
+		"node": ">=16.13.2"
+	},
+	"files": [
+		"dist/",
+		"scripts"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/futurable.mjs",
+			"require": "./dist/futurable.cjs",
+			"default": "./dist/futurable.mjs",
+			"node": {
+				"types": "./dist/index.d.ts",
+				"require": "./dist/futurable.cjs",
+				"import": "./dist/futurable.mjs",
+				"default": "./dist/futurable.cjs"
+			}
+		}
+	},
+	"main": "./src/index.ts",
+	"types": "./src/index.d.ts",
+	"scripts": {
+		"preinstall": "node ./scripts/preinstall.js --foreground-script",
+		"postinstall": "echo 'postinstall executed'",
+		"build": "tsc && vite build",
+		"test": "NODE_OPTIONS=--experimental-vm-modules jest",
+		"lint": "eslint 'src/**/*.{js,jsx,ts,tsx}'",
+		"lint:fix": "eslint --fix 'src/**/*.{jsx,ts,tsx}'",
+		"prepare": "pnpm run build",
+		"prepublishOnly": "pnpm test && pnpm run lint"
+	},
+	"devDependencies": {
+		"@babel/preset-typescript": "^7.21.5",
+		"@jest/globals": "^29.5.0",
+		"@types/node": "^20.1.1",
+		"@typescript-eslint/eslint-plugin": "^5.59.5",
+		"@typescript-eslint/parser": "^5.59.5",
+		"eslint": "^8.40.0",
+		"eslint-config-prettier": "^8.8.0",
+		"eslint-plugin-import": "^2.27.5",
+		"eslint-plugin-prettier": "^4.2.1",
+		"jest": "^29.5.0",
+		"prettier": "^2.8.8",
+		"ts-jest": "^29.1.0",
+		"ts-node": "^10.9.1",
+		"typescript": "^5.0.2",
+		"vite": "^4.3.2",
+		"vite-plugin-dts": "^2.3.0",
+		"vite-plugin-linter": "^2.0.2",
+		"vite-tsconfig-paths": "^4.2.0"
+	},
+	"keywords": [
+		"promise",
+		"promises",
+		"promises-a",
+		"promises-aplus",
+		"async",
+		"await",
+		"deferred",
+		"deferreds",
+		"future",
+		"cancel",
+		"abort",
+		"delay",
+		"sleep",
+		"abortable",
+		"cancelable",
+		"futurable"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/nDriaDev/futurable"
+	},
+	"author": {
+		"name": "Andrea Cosentino",
+		"email": "andreacosentino.work@gmail.com",
+		"url": "https://github.com/nDriaDev/"
+	},
+	"readmeFilename": "README.md",
+	"bugs": {
+		"url": "https://github.com/nDriaDev/futurable/issues"
+	},
+	"homepage": "https://github.com/nDriaDev/futurable",
+	"license": "MIT"
+}

package/scripts/preInstall.js

@@ -0,0 +1,17 @@
+import { exec } from 'child_process';
+
+const result = process.versions;
+
+if (result && result.node && parseInt(result.node) < 16) {
+	exec("npm install node-fetch", (err, stdout, sterr) => {
+		if (err) {
+			console.log("err", err.message);
+			process.exit(1);
+		} else if (sterr) {
+			console.log("stderr", sterr);
+			process.exit(1);
+		}
+		console.log("stdout", stdout);
+		process.exit(0);
+	});
+}