@ndriadev/futurable 2.0.10 → 2.1.0

package/README.md

@@ -18,7 +18,6 @@
 
 
 #  Summary
-- [ToDo](#TODO)
 - [Introduction](#introduction)
 	- [Installation](#Installation)
 - [Usage](#Usage)
@@ -41,14 +40,10 @@
 	- [Futurable.allSettled](#futurableallsettledvalues-t-signal-abortsignal)
 	- [Futurable.any](#futurableanyvalues-t-signal-abortsignal)
 	- [Futurable.race](#futurableracevalues-t-signal-abortsignal)
+- [ToDo](#TODO)
 - [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.
-- Extends fetch api support to third library like axios.
-
-
 #  Introduction
 Futurable is a library that extends Javascript's Promise and Fetch APIs, adding a number of useful features and with support for Typescirpt. It can be used on both browser and node.
 
@@ -593,6 +588,12 @@ f.cancel();
 ```
 
 
+#  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.
+- Extends fetch api support to third library like axios.
+- Implement promise cache.
+
+
 ## License
 
 

package/dist/futurable.cjs

@@ -1 +1 @@
-"use strict";var T=Object.defineProperty;var C=(w,g,t)=>g in w?T(w,g,{enumerable:!0,configurable:!0,writable:!0,value:t}):w[g]=t;var S=(w,g,t)=>(C(w,typeof g!="symbol"?g+"":g,t),t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class l extends Promise{constructor(t,e){const r=e?null:new AbortController,n=e||r.signal,o=[],c=()=>{for(const s of o)clearTimeout(s)};let i;const a={signal:n,cancel:()=>{var s;return(s=this.controller)==null?void 0:s.abort()},onCancel:s=>{i=s},delay:(s,u)=>new l(d=>{o.push(setTimeout(()=>{d(s())},u))},n),sleep:s=>a.delay(()=>{},s),fetch:(s,u)=>new l((d,j)=>{fetch(s,{...u||{},signal:n}).then(y=>d(y)).catch(y=>{y.name!=="AbortError"&&j(y)})},n),futurizable:s=>new l((u,d)=>{s.then(u).catch(d)},n)};let f="pending";const p=new Promise((s,u)=>{if(n.aborted){c(),f==="pending"&&i&&i();return}else{const d=typeof n.onabort=="function"?n.onabort:()=>{};n.onabort=()=>{d(),c(),f==="pending"&&i&&i()},t(m=>{f="fulfilled",s(m)},m=>{f="rejected",u(m)},a)}});super((s,u)=>{p.then(d=>s(d)).catch(u)});S(this,"controller");S(this,"internalSignal");S(this,"idsTimeout");this.controller=r,this.internalSignal=n,this.idsTimeout=o}static get[Symbol.species](){return this}get[Symbol.toStringTag](){return"Futurable"}get signal(){return this.internalSignal}clearTimeout(){for(const t of this.idsTimeout)clearTimeout(t)}then(t,e){let r,n;const o=new l((c,i)=>{r=c,n=i},this.internalSignal);return o.controller=this.controller,super.then(c=>{var i;if((i=this.internalSignal)!=null&&i.aborted){this.clearTimeout();return}try{r(t?t(c):c)}catch(h){n(h)}},c=>{var i;if((i=this.internalSignal)!=null&&i.aborted){this.clearTimeout();return}try{e?r(e(c)):n(c)}catch(h){n(h)}}),o}catch(t){return this.then(null,t)}finally(t){return this.then(e=>(t(),e),e=>{if(t(),e instanceof Error)throw e;return e})}cancel(){var t,e;!((t=this.internalSignal)!=null&&t.aborted)&&((e=this.controller)==null||e.abort())}delay(t,e){let r,n;const o=new l((c,i)=>{r=c,n=i},this.internalSignal);return o.controller=this.controller,this.then(c=>{this.idsTimeout.push(setTimeout(()=>r(t(c)),e))},c=>{n(c)}),o}sleep(t){return this.delay(e=>e,t)}fetch(t,e){let r,n;const o=new l((c,i)=>{r=c,n=i},this.internalSignal);return o.controller=this.controller,this.then(c=>{const i=typeof t=="function"?t(c):t,h={...typeof e=="function"?e(c):e,signal:this.internalSignal};fetch(i,h).then(a=>r(a)).catch(a=>{a.name!=="AbortError"&&n(a)})}),o}onCancel(t){let e,r;const n=new l((o,c,i)=>{i.onCancel(t),e=o,r=c},this.internalSignal);return n.controller=this.controller,this.then(o=>e(o),o=>r(o)),n}futurizable(t){let e,r;const n=new l((o,c)=>{e=o,r=c},this.internalSignal);return n.controller=this.controller,this.then(o=>{(typeof t=="function"?t(o):t).then(e).catch(r)}),n}static resolve(t,e){return t?new l(r=>r(t),e):new l(r=>r(),e)}static reject(t,e){return new l((r,n)=>n(t),e)}static onCancel({cb:t,signal:e}){return new l((r,n,o)=>{o.onCancel(()=>r(t()))},e)}static delay({cb:t,timer:e,signal:r}){return new l((n,o,c)=>{c.delay(t,e).then(n,o)},r)}static sleep({timer:t,signal:e}){return l.delay({cb:()=>{},timer:t,signal:e})}static fetch(t,e){const r=(e==null?void 0:e.signal)||void 0;return e!=null&&e.signal&&delete e.signal,new l((n,o,c)=>{c.fetch(t,e).then(n)},r)}static futurizable({promise:t,signal:e}){return new l((r,n)=>{t.then(r).catch(n)},e)}static handleValues(t,e){const r=[];for(const n in t)t[n]instanceof l?r.push(t[n]):t[n]instanceof Promise?r.push(new l((o,c)=>{t[n].then(i=>o(i)).catch(c)},e)):r.push(new l(o=>o(t[n]),e));return r}static all(t,e){let r,n;const o=new l((i,h,a)=>{r=i,n=h,a.onCancel(()=>{for(const f of c)f.cancel()})},e);e||(e=o.internalSignal);const c=l.handleValues(t,e);return super.all(c).then(i=>r(i)).catch(i=>n(i)),o}static allSettled(t,e){let r;const n=new l((c,i,h)=>{r=c,h.onCancel(()=>{for(const a of o)a.cancel()})},e);e||(e=n.internalSignal);const o=l.handleValues(t,e);return super.allSettled(o).then(c=>r(c)),n}static race(t,e){let r,n;const o=new l((i,h,a)=>{r=i,n=h,a.onCancel(()=>{for(const f of c)f.cancel()})},e);e||(e=o.internalSignal);const c=l.handleValues(t,e);return super.race(c).then(i=>r(i)).catch(i=>n(i)),o}static any(t,e){let r,n;const o=new l((i,h,a)=>{r=i,n=h,a.onCancel(()=>{for(const f of c)f.cancel()})},e);e||(e=o.internalSignal);const c=l.handleValues(t,e);return super.any(c).then(i=>r(i)).catch(i=>n(i)),o}}exports.Futurable=l;
+"use strict";var T=Object.defineProperty;var C=(w,g,t)=>g in w?T(w,g,{enumerable:!0,configurable:!0,writable:!0,value:t}):w[g]=t;var S=(w,g,t)=>(C(w,typeof g!="symbol"?g+"":g,t),t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class i extends Promise{constructor(t,e){const r=e?null:new AbortController,n=e||r.signal,o=[],c=()=>{for(const a of o)clearTimeout(a)};let l;const h={signal:n,cancel:()=>{var a;return(a=this.controller)==null?void 0:a.abort()},onCancel:a=>{l=a},delay:(a,u)=>new i(d=>{o.push(setTimeout(()=>{d(a())},u))},n),sleep:a=>h.delay(()=>{},a),fetch:(a,u)=>new i((d,p)=>{fetch(a,{...u||{},signal:n}).then(y=>d(y)).catch(y=>{y.name!=="AbortError"&&p(y)})},n),futurizable:a=>new i((u,d)=>{a.then(u).catch(d)},n)};let f="pending";const m=new Promise((a,u)=>{if(n.aborted){c(),f==="pending"&&l&&l();return}else{const d=typeof n.onabort=="function"?n.onabort:()=>{};n.onabort=()=>{d(),c(),f==="pending"&&l&&l()},t(j=>{f="fulfilled",a(j)},j=>{f="rejected",u(j)},h)}});super((a,u)=>{m.then(d=>a(d)).catch(u)});S(this,"controller");S(this,"internalSignal");S(this,"idsTimeout");this.controller=r,this.internalSignal=n,this.idsTimeout=o}static get[Symbol.species](){return this}get[Symbol.toStringTag](){return"Futurable"}get signal(){return this.internalSignal}clearTimeout(){for(const t of this.idsTimeout)clearTimeout(t)}then(t,e){let r,n;const o=new i((c,l)=>{r=c,n=l},this.internalSignal);return o.controller=this.controller,super.then(c=>{var l;if((l=this.internalSignal)!=null&&l.aborted){this.clearTimeout();return}try{r(t?t(c):c)}catch(s){n(s)}},c=>{var l;if((l=this.internalSignal)!=null&&l.aborted){this.clearTimeout();return}try{e?r(e(c)):n(c)}catch(s){n(s)}}),o}catch(t){return this.then(null,t)}finally(t){return this.then(e=>(t(),e),e=>{if(t(),e instanceof Error)throw e;return e})}cancel(){var t,e;!((t=this.internalSignal)!=null&&t.aborted)&&((e=this.controller)==null||e.abort())}delay(t,e){let r,n;const o=new i((c,l)=>{r=c,n=l},this.internalSignal);return o.controller=this.controller,this.then(c=>{this.idsTimeout.push(setTimeout(()=>r(t(c)),e))},c=>{n(c)}),o}sleep(t){return this.delay(e=>e,t)}fetch(t,e){let r,n;const o=new i((c,l)=>{r=c,n=l},this.internalSignal);return o.controller=this.controller,this.then(c=>{const l=typeof t=="function"?t(c):t,s={...typeof e=="function"?e(c):e,signal:this.internalSignal};fetch(l,s).then(h=>r(h)).catch(h=>{h.name!=="AbortError"&&n(h)})}),o}onCancel(t){let e,r;const n=new i((o,c,l)=>{l.onCancel(t),e=o,r=c},this.internalSignal);return n.controller=this.controller,this.then(o=>e(o),o=>r(o)),n}futurizable(t){let e,r;const n=new i((o,c)=>{e=o,r=c},this.internalSignal);return n.controller=this.controller,this.then(o=>{(typeof t=="function"?t(o):t).then(e).catch(r)}),n}static resolve(t,e){return t?new i(r=>r(t),e):new i(r=>r(),e)}static reject(t,e){return new i((r,n)=>n(t),e)}static onCancel({cb:t,signal:e}){return new i((r,n,o)=>{o.onCancel(()=>r(t()))},e)}static delay({cb:t,timer:e,signal:r}){return new i((n,o,c)=>{c.delay(t,e).then(n,o)},r)}static sleep({timer:t,signal:e}){return i.delay({cb:()=>{},timer:t,signal:e})}static fetch(t,e){const r=(e==null?void 0:e.signal)||void 0;return e!=null&&e.signal&&delete e.signal,new i((n,o,c)=>{c.fetch(t,e).then(n)},r)}static futurizable({promise:t,signal:e}){return new i((r,n)=>{t.then(r).catch(n)},e)}static handleValues(t,e){const r=[];for(const n in t)t[n]instanceof i?r.push(t[n]):t[n]instanceof Promise?r.push(new i((o,c)=>{t[n].then(l=>o(l)).catch(c)},e)):r.push(new i(o=>o(t[n]),e));return r}static all(t,e){let r,n;const o=new i((l,s,h)=>{r=l,n=s,h.onCancel(()=>{for(const f of c)f.cancel()})},e);e||(e=o.internalSignal);const c=i.handleValues(t,e);return super.all(c).then(l=>r(l)).catch(l=>n(l)),o}static allSettled(t,e){let r;const n=new i((c,l,s)=>{r=c,s.onCancel(()=>{for(const h of o)h.cancel()})},e);e||(e=n.internalSignal);const o=i.handleValues(t,e);return super.allSettled(o).then(c=>r(c)),n}static race(t,e){let r,n;const o=new i((l,s,h)=>{r=l,n=s,h.onCancel(()=>{for(const f of c)f.cancel()})},e);e||(e=o.internalSignal);const c=i.handleValues(t,e);return super.race(c).then(l=>r(l)).catch(l=>n(l)),o}static any(t,e){let r,n;const o=new i((l,s,h)=>{r=l,n=s,h.onCancel(()=>{for(const f of c)f.cancel()})},e);e||(e=o.internalSignal);const c=i.handleValues(t,e);return super.any(c).then(l=>r(l)).catch(l=>n(l)),o}static polling(t,{interval:e,signal:r}){let n,o,c;const l=setInterval(()=>{n&&n.cancel(),n=new i((s,h,f)=>{f.onCancel(()=>{o&&o.cancel()}),o=t().then(()=>s()).catch(m=>c&&c(m))},r)},e);return{cancel:()=>{l&&clearInterval(l),n&&n.cancel()},catch:s=>{c=s}}}}exports.Futurable=i;

package/dist/futurable.mjs

@@ -1,57 +1,57 @@
 var T = Object.defineProperty;
 var C = (g, w, t) => w in g ? T(g, w, { enumerable: !0, configurable: !0, writable: !0, value: t }) : g[w] = t;
 var S = (g, w, t) => (C(g, typeof w != "symbol" ? w + "" : w, t), t);
-class l extends Promise {
+class i extends Promise {
   constructor(t, e) {
     const r = e ? null : new AbortController(), n = e || r.signal, o = [], c = () => {
-      for (const s of o)
-        clearTimeout(s);
+      for (const a of o)
+        clearTimeout(a);
     };
-    let i;
-    const a = {
+    let l;
+    const h = {
       signal: n,
       cancel: () => {
-        var s;
-        return (s = this.controller) == null ? void 0 : s.abort();
+        var a;
+        return (a = this.controller) == null ? void 0 : a.abort();
       },
-      onCancel: (s) => {
-        i = s;
+      onCancel: (a) => {
+        l = a;
       },
-      delay: (s, u) => new l((d) => {
+      delay: (a, u) => new i((d) => {
         o.push(setTimeout(() => {
-          d(s());
+          d(a());
         }, u));
       }, n),
-      sleep: (s) => a.delay(() => {
-      }, s),
-      fetch: (s, u) => new l((d, p) => {
-        fetch(s, { ...u || {}, signal: n }).then((y) => d(y)).catch((y) => {
-          y.name !== "AbortError" && p(y);
+      sleep: (a) => h.delay(() => {
+      }, a),
+      fetch: (a, u) => new i((d, j) => {
+        fetch(a, { ...u || {}, signal: n }).then((y) => d(y)).catch((y) => {
+          y.name !== "AbortError" && j(y);
         });
       }, n),
-      futurizable: (s) => new l((u, d) => {
-        s.then(u).catch(d);
+      futurizable: (a) => new i((u, d) => {
+        a.then(u).catch(d);
       }, n)
     };
     let f = "pending";
-    const j = new Promise((s, u) => {
+    const m = new Promise((a, u) => {
       if (n.aborted) {
-        c(), f === "pending" && i && i();
+        c(), f === "pending" && l && l();
         return;
       } else {
         const d = typeof n.onabort == "function" ? n.onabort : () => {
         };
         n.onabort = () => {
-          d(), c(), f === "pending" && i && i();
-        }, t((m) => {
-          f = "fulfilled", s(m);
-        }, (m) => {
-          f = "rejected", u(m);
-        }, a);
+          d(), c(), f === "pending" && l && l();
+        }, t((p) => {
+          f = "fulfilled", a(p);
+        }, (p) => {
+          f = "rejected", u(p);
+        }, h);
       }
     });
-    super((s, u) => {
-      j.then((d) => s(d)).catch(u);
+    super((a, u) => {
+      m.then((d) => a(d)).catch(u);
     });
     S(this, "controller");
     S(this, "internalSignal");
@@ -79,30 +79,30 @@ class l extends Promise {
    */
   then(t, e) {
     let r, n;
-    const o = new l((c, i) => {
-      r = c, n = i;
+    const o = new i((c, l) => {
+      r = c, n = l;
     }, this.internalSignal);
     return o.controller = this.controller, super.then((c) => {
-      var i;
-      if ((i = this.internalSignal) != null && i.aborted) {
+      var l;
+      if ((l = this.internalSignal) != null && l.aborted) {
         this.clearTimeout();
         return;
       }
       try {
         r(t ? t(c) : c);
-      } catch (h) {
-        n(h);
+      } catch (s) {
+        n(s);
       }
     }, (c) => {
-      var i;
-      if ((i = this.internalSignal) != null && i.aborted) {
+      var l;
+      if ((l = this.internalSignal) != null && l.aborted) {
         this.clearTimeout();
         return;
       }
       try {
         e ? r(e(c)) : n(c);
-      } catch (h) {
-        n(h);
+      } catch (s) {
+        n(s);
       }
     }), o;
   }
@@ -140,8 +140,8 @@ class l extends Promise {
    */
   delay(t, e) {
     let r, n;
-    const o = new l((c, i) => {
-      r = c, n = i;
+    const o = new i((c, l) => {
+      r = c, n = l;
     }, this.internalSignal);
     return o.controller = this.controller, this.then(
       (c) => {
@@ -166,13 +166,13 @@ class l extends Promise {
    */
   fetch(t, e) {
     let r, n;
-    const o = new l((c, i) => {
-      r = c, n = i;
+    const o = new i((c, l) => {
+      r = c, n = l;
     }, this.internalSignal);
     return o.controller = this.controller, this.then((c) => {
-      const i = typeof t == "function" ? t(c) : t, h = { ...typeof e == "function" ? e(c) : e, signal: this.internalSignal };
-      fetch(i, h).then((a) => r(a)).catch((a) => {
-        a.name !== "AbortError" && n(a);
+      const l = typeof t == "function" ? t(c) : t, s = { ...typeof e == "function" ? e(c) : e, signal: this.internalSignal };
+      fetch(l, s).then((h) => r(h)).catch((h) => {
+        h.name !== "AbortError" && n(h);
       });
     }), o;
   }
@@ -182,8 +182,8 @@ class l extends Promise {
    */
   onCancel(t) {
     let e, r;
-    const n = new l((o, c, i) => {
-      i.onCancel(t), e = o, r = c;
+    const n = new i((o, c, l) => {
+      l.onCancel(t), e = o, r = c;
     }, this.internalSignal);
     return n.controller = this.controller, this.then(
       (o) => e(o),
@@ -209,7 +209,7 @@ class l extends Promise {
    */
   futurizable(t) {
     let e, r;
-    const n = new l((o, c) => {
+    const n = new i((o, c) => {
       e = o, r = c;
     }, this.internalSignal);
     return n.controller = this.controller, this.then((o) => {
@@ -217,16 +217,16 @@ class l extends Promise {
     }), n;
   }
   static resolve(t, e) {
-    return t ? new l((r) => r(t), e) : new l((r) => r(), e);
+    return t ? new i((r) => r(t), e) : new i((r) => r(), e);
   }
   static reject(t, e) {
-    return new l((r, n) => n(t), e);
+    return new i((r, n) => n(t), e);
   }
   /**
    * OnCancel static method. It accepts a callback or a object with cb property and an optional signal.
    */
   static onCancel({ cb: t, signal: e }) {
-    return new l((r, n, o) => {
+    return new i((r, n, o) => {
       o.onCancel(() => r(t()));
     }, e);
   }
@@ -234,7 +234,7 @@ class l extends Promise {
    * Delay static method. It accepts a object with timer and cb properties and an optional signal property.
    */
   static delay({ cb: t, timer: e, signal: r }) {
-    return new l((n, o, c) => {
+    return new i((n, o, c) => {
       c.delay(t, e).then(n, o);
     }, r);
   }
@@ -242,7 +242,7 @@ class l extends Promise {
    * Sleep static method. It accepts a timer or a object with timer property and an optional signal.
    */
   static sleep({ timer: t, signal: e }) {
-    return l.delay({
+    return i.delay({
       cb: () => {
       },
       timer: t,
@@ -254,7 +254,7 @@ class l extends Promise {
    */
   static fetch(t, e) {
     const r = (e == null ? void 0 : e.signal) || void 0;
-    return e != null && e.signal && delete e.signal, new l((n, o, c) => {
+    return e != null && e.signal && delete e.signal, new i((n, o, c) => {
       c.fetch(t, e).then(n);
     }, r);
   }
@@ -262,22 +262,22 @@ class l extends Promise {
    * Futurizable static method.
    */
   static futurizable({ promise: t, signal: e }) {
-    return new l((r, n) => {
+    return new i((r, n) => {
       t.then(r).catch(n);
     }, e);
   }
   static handleValues(t, e) {
     const r = [];
     for (const n in t)
-      t[n] instanceof l ? r.push(t[n]) : t[n] instanceof Promise ? r.push(
-        new l(
+      t[n] instanceof i ? r.push(t[n]) : t[n] instanceof Promise ? r.push(
+        new i(
           (o, c) => {
-            t[n].then((i) => o(i)).catch(c);
+            t[n].then((l) => o(l)).catch(c);
           },
           e
         )
       ) : r.push(
-        new l(
+        new i(
           (o) => o(t[n]),
           e
         )
@@ -289,29 +289,29 @@ class l extends Promise {
    */
   static all(t, e) {
     let r, n;
-    const o = new l((i, h, a) => {
-      r = i, n = h, a.onCancel(() => {
+    const o = new i((l, s, h) => {
+      r = l, n = s, h.onCancel(() => {
         for (const f of c)
           f.cancel();
       });
     }, e);
     e || (e = o.internalSignal);
-    const c = l.handleValues(t, e);
-    return super.all(c).then((i) => r(i)).catch((i) => n(i)), o;
+    const c = i.handleValues(t, e);
+    return super.all(c).then((l) => r(l)).catch((l) => n(l)), o;
   }
   /**
    * Creates a Futurable with cancellation support that is resolved with an array of results when all of the provided Futurables resolve or reject.
    */
   static allSettled(t, e) {
     let r;
-    const n = new l((c, i, h) => {
-      r = c, h.onCancel(() => {
-        for (const a of o)
-          a.cancel();
+    const n = new i((c, l, s) => {
+      r = c, s.onCancel(() => {
+        for (const h of o)
+          h.cancel();
       });
     }, e);
     e || (e = n.internalSignal);
-    const o = l.handleValues(t, e);
+    const o = i.handleValues(t, e);
     return super.allSettled(o).then((c) => r(c)), n;
   }
   /**
@@ -319,15 +319,15 @@ class l extends Promise {
    */
   static race(t, e) {
     let r, n;
-    const o = new l((i, h, a) => {
-      r = i, n = h, a.onCancel(() => {
+    const o = new i((l, s, h) => {
+      r = l, n = s, h.onCancel(() => {
         for (const f of c)
           f.cancel();
       });
     }, e);
     e || (e = o.internalSignal);
-    const c = l.handleValues(t, e);
-    return super.race(c).then((i) => r(i)).catch((i) => n(i)), o;
+    const c = i.handleValues(t, e);
+    return super.race(c).then((l) => r(l)).catch((l) => n(l)), o;
   }
   /**
    * The any function returns a futurable with cancellation support that is fulfilled by the first given futurable to be fulfilled,
@@ -337,17 +337,38 @@ class l extends Promise {
    */
   static any(t, e) {
     let r, n;
-    const o = new l((i, h, a) => {
-      r = i, n = h, a.onCancel(() => {
+    const o = new i((l, s, h) => {
+      r = l, n = s, h.onCancel(() => {
         for (const f of c)
           f.cancel();
       });
     }, e);
     e || (e = o.internalSignal);
-    const c = l.handleValues(t, e);
-    return super.any(c).then((i) => r(i)).catch((i) => n(i)), o;
+    const c = i.handleValues(t, e);
+    return super.any(c).then((l) => r(l)).catch((l) => n(l)), o;
+  }
+  /**
+   * Creates a polling service with cancellation support and possibility to handle error.
+   */
+  static polling(t, { interval: e, signal: r }) {
+    let n, o, c;
+    const l = setInterval(() => {
+      n && n.cancel(), n = new i((s, h, f) => {
+        f.onCancel(() => {
+          o && o.cancel();
+        }), o = t().then(() => s()).catch((m) => c && c(m));
+      }, r);
+    }, e);
+    return {
+      cancel: () => {
+        l && clearInterval(l), n && n.cancel();
+      },
+      catch: (s) => {
+        c = s;
+      }
+    };
   }
 }
 export {
-  l as Futurable
+  i as Futurable
 };

package/dist/index.d.ts

@@ -172,4 +172,15 @@ export declare class Futurable<T> extends Promise<T> {
      * it runs this algorithm.
      */
     static any<T extends readonly unknown[] | []>(values: T, signal?: AbortSignal): Futurable<Awaited<T[number]>>;
+    /**
+     * Creates a polling service with cancellation support and possibility to handle error.
+     */
+    static polling<T>(value: () => Futurable<T>, { interval, signal }: {
+        interval: number;
+        signal?: AbortSignal;
+    }): {
+        cancel: () => void;
+        catch: (onrejected: (reason: unknown) => void) => void;
+    };
 }
+//# 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":"AAAA,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAClC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,EAC3G,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAC3G,aAAa,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;CACtC;AACD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAClC,CAAC,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,eAAe;IAC/B,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACnC;;;;OAIG;IACH,KAAK,EAAE,CAAC,OAAO,GAAC,CAAC,EAAE,QAAQ,GAAC,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,aAAa,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;IAC1G;;;OAGG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,CAAC,IAAI,CAAC,CAAC;IAC9C;;;;OAIG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChE;;;OAGG;IACH,WAAW,EAAE,CAAC,OAAO,GAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC;CAC5E;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAClC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC5B,MAAM,EAAE,eAAe;AACvB;;GAEG;AACH,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KACpB,IAAI,CAAC;AAEV,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAQzF,qBAAa,SAAS,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC;IACnB,OAAO,CAAC,cAAc,CAAC;IACvB,OAAO,CAAC,UAAU,CAAC;gBAEP,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW;IA4FhE,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,qBAE1B;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAEvB;IAED;;OAEG;IACH,IAAI,MAAM,gBAET;IAED,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAuChS;;OAEG;IACH,KAAK,CAAC,QAAQ,GAAG,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,QAAQ,CAAC;IAI9J;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC;IAgB/D;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;;;OAIG;IACH,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAkBhK;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAIlC;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,WAAW,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC;IAsBzH;;;OAGG;IACH,QAAQ,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IA8B3F;;;OAGG;IACH,WAAW,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAgB1I,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC;IACjC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAC,GAAG,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC;IAQvG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC;IAI1E;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAC,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;QAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAM1F;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,GAAG,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC,GAAG,QAAQ,CAAC;IAM7I;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,SAAS,CAAC,IAAI,CAAC;IAQzF;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC;IAQlE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,GAAC,GAAG,EAAE,QAAQ,GAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAQ3J,OAAO,CAAC,MAAM,CAAC,YAAY;IA+B3B;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;QAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAG,CAAC;IAmBvI;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;QAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAkBnK;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAmB9G;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAmB7G;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAC,GAAG;QAAC,MAAM,EAAE,MAAM,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,UAAU,EAAC,CAAC,MAAM,EAAE,OAAO,KAAG,IAAI,KAAG,IAAI,CAAA;KAAE;CAqBpL"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@ndriadev/futurable",
   "description": "Extension Javascript's Promise API with more functionalities",
   "private": false,
-  "version": "2.0.10",
+  "version": "2.1.0",
   "type": "module",
   "files": [
     "dist/",
@@ -23,25 +23,25 @@
     "postinstall": "echo 'postinstall executed'"
   },
   "devDependencies": {
-    "@babel/preset-typescript": "^7.22.5",
-    "@jest/globals": "^29.6.2",
-    "@types/node": "^20.4.7",
-    "@typescript-eslint/eslint-plugin": "^6.2.1",
-    "@typescript-eslint/parser": "^6.2.1",
-    "eslint": "^8.46.0",
-    "eslint-config-prettier": "^8.10.0",
-    "eslint-plugin-import": "^2.28.0",
-    "eslint-plugin-prettier": "^5.0.0",
-    "jest": "^29.6.2",
-    "prettier": "^3.0.1",
-    "ts-jest": "^29.1.1",
-    "ts-node": "^10.9.1",
-    "typedoc": "^0.24.8",
-    "typescript": "^5.1.6",
-    "vite": "^4.4.8",
-    "vite-plugin-dts": "^3.5.0",
-    "vite-plugin-linter": "^2.0.2",
-    "vite-tsconfig-paths": "^4.2.0"
+    "@babel/preset-typescript": "^7.23.3",
+    "@jest/globals": "^29.7.0",
+    "@types/node": "^20.11.16",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-prettier": "^5.1.3",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "ts-jest": "^29.1.2",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.25.7",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.12",
+    "vite-plugin-dts": "^3.7.2",
+    "vite-plugin-linter": "^2.1.1",
+    "vite-tsconfig-paths": "^4.3.1"
   },
   "keywords": [
     "promise",