@ndriadev/futurable 2.3.2 → 2.3.5

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -0,0 +1,255 @@
+interface FuturableLike<T> {
+    /**
+     * Attaches callbacks for the resolution and/or rejection of the Futurable.
+     * @param onfulfilled The callback to execute when the Futurable is resolved.
+     * @param onrejected The callback to execute when the Futurable is rejected.
+     * @returns A Futurable for the completion of which ever callback is executed.
+     */
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null): FuturableLike<TResult1 | TResult2>;
+}
+interface FuturableResolve<T> {
+    (value: T | FuturableLike<T> | PromiseLike<T>): void;
+}
+interface FuturableReject {
+    (reason?: any): void;
+}
+interface FuturableUtils<T> {
+    /**
+     * Internal futurable signal
+     */
+    signal: AbortSignal;
+    /**
+     * Cancel the futurable if it is to be executed or if it is still executing.
+     */
+    cancel: () => void;
+    /**
+     * Executes the callback passed as a parameter when the futurable is cancelled.
+     * @param cb: callback
+     */
+    onCancel: (cb: () => void) => void;
+    /**
+     * Waits for timer, then executes callback with the futurable value and returns the result obtained from the invocation.
+     * @param cb: callback executed after timer
+     * @param timer: timer to wait (in milliseconds)
+     */
+    delay: <TResult = T, TResult2 = never>(cb: () => TResult, timer: number) => FuturableLike<TResult | TResult2>;
+    /**
+     * Waits for timer parameter (in milliseconds) before returning the value.
+     * @param timer: timer to wait (in milliseconds)
+     */
+    sleep: (timer: number) => FuturableLike<void>;
+    /**
+     * 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.
+     * @param url: url to fetch
+     * @param opts: fetch options
+     */
+    fetch: (url: string, opts?: RequestInit) => Futurable<Response>;
+    /**
+     * Takes a promise and transforms it into a futurizable. Promise can be also a function that receives value from futurable chaining as parameter.
+     * @param promise: Promise to futurize
+     */
+    futurizable: <TResult = any>(promise: Promise<TResult>) => Futurable<TResult>;
+}
+type FuturableExecutor<T> = (resolve: FuturableResolve<T>, reject: FuturableReject, 
+/**
+ * Object containing implemented functionalities.
+ */
+utils: FuturableUtils<T>) => void;
+type FuturableIterable<T = any> = Iterable<FuturableLike<T> | PromiseLike<T> | T>;
+interface FuturableWithResolvers<T> {
+    promise: Futurable<T> | Promise<T>;
+    resolve: (value: T | PromiseLike<T> | FuturableLike<T>) => void;
+    reject: (reason?: any) => void;
+    cancel: () => void;
+    utils: FuturableUtils<T>;
+}
+declare class Futurable<T> extends Promise<T> {
+    private controller;
+    private internalSignal;
+    private idsTimeout;
+    constructor(executor: FuturableExecutor<T>, signal?: AbortSignal);
+    static get [Symbol.species](): typeof Futurable;
+    get [Symbol.toStringTag](): string;
+    /**
+     * Return internal futurable signal
+     * @returns {AbortSignal}
+     */
+    get signal(): AbortSignal;
+    private clearTimeout;
+    /**
+     * Attaches callbacks for the resolution and/or rejection of the Futurable.
+     * @param {((value: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>) | undefined | null} onfulfilled
+     * @param {((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null} onrejected
+     * @returns {Futurable<TResult1 | TResult2>}
+     */
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null): Futurable<TResult1 | TResult2>;
+    /**
+     * Attaches a callback for only the rejection of the Futurable.
+     * @param {((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null} onRejected
+     * @returns {Futurable<T | TResult2>}
+     */
+    catch<TResult2 = never>(onRejected: ((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null): Futurable<T | TResult2>;
+    /**
+     * Attaches a callback that is invoked when the Futurable is settled (fulfilled or rejected).
+     * The resolved value cannot be modified from the callback.
+     * @param {() => void | undefined | null} onfinally
+     * @returns {Futurable<T>}
+     */
+    finally(onfinally: () => void | undefined | null): Futurable<T>;
+    /**
+     * Cancel the futurable if it is to be executed or if it is still executing.
+     */
+    cancel(): void;
+    /**
+     * Waits for timer, then executes callback with the futurable value and returns the result obtained from the invocation.
+     * @param {(val: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>} cb - callback executed after timer with futurable chain value as parameter
+     * @param {number} timer - timer to wait (in milliseconds)
+     */
+    delay<TResult1 = T, TResult2 = never>(cb: (val: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>, timer: number): Futurable<TResult1 | TResult2>;
+    /**
+     * Waits for timer parameter (in milliseconds) before returning the value.
+     * @param {number} timer - timer to wait (in milliseconds)
+     * @returns {Futurable<T>}
+     */
+    sleep(timer: number): Futurable<T>;
+    /**
+     * 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.
+     * @param {string| ((val?:T)=>string)} url - url to fetch or function with futurable chaining value that returns url to fetch
+     * @param {object | RequestInit | ((val?: T) => RequestInit)} opts - fetch options or function with futurable chaining value that return fetch options
+     * @returns {Futurable<Response>}
+     */
+    fetch(url: string | ((val?: T) => string), opts?: object | RequestInit | ((val?: T) => RequestInit)): Futurable<Response>;
+    /**
+     * Executes the callback passed as a parameter when the futurable is cancelled.
+     * @param {()=>void} cb
+     * @returns {Futurable<TResult1 | TResult2>}
+     */
+    onCancel<TResult1 = void, TResult2 = never>(cb: () => void): Futurable<TResult1 | TResult2>;
+    /**
+     * Takes a promise and transforms it into a futurizable. Promise can be also a function that receives value from futurable chaining as parameter.
+     * @param {Promise<TResult1> | ((val?: T) => Promise<TResult1>)} promise - Promise to futurize or function that return promise with futurable chaining value as parameter
+     * @returns {Futurable<TResult1 | TResult2>}
+     */
+    futurizable<TResult1 = T, TResult2 = never>(promise: Promise<TResult1> | ((val?: T) => Promise<TResult1>)): Futurable<TResult1 | TResult2>;
+    /**
+     * Creates a new resolved futurable. Creates a new resolved futurable for the provided value.
+     * @returns {Futurable<void>}
+     */
+    static resolve(): Futurable<void>;
+    /**
+     * @param {T | PromiseLike<T> | FuturableLike<T>} value
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<T>}
+     */
+    static resolve<T = any>(value: T | PromiseLike<T> | FuturableLike<T>, signal?: AbortSignal): Futurable<T>;
+    /**
+     * Creates a new rejected futurable for the provided reason.
+     * @param {any} [reason]
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<T>}
+     */
+    static reject<T = never>(reason?: any, signal?: AbortSignal): Futurable<T>;
+    /**
+     * OnCancel static method. It accepts a callback or a object with cb property and an optional signal.
+     * @param {{cb: () => T, signal: AbortSignal|undefined}} options
+     * @returns {Futurable<T>}
+ */
+    static onCancel<T = void>({ cb, signal }: {
+        cb: () => T;
+        signal?: AbortSignal;
+    }): Futurable<T>;
+    /**
+     * Delay static method. It accepts a object with timer and cb properties and an optional signal property.
+     * @param {{cb: () => T, timer: number, signal: AbortSignal|undefined}} options
+     * @returns {Futurable<T|TResult2>}
+     */
+    static delay<T = any, TResult2 = never>({ cb, timer, signal }: {
+        cb: () => T;
+        timer: number;
+        signal?: AbortSignal;
+    }): Futurable<T | TResult2>;
+    /**
+     * Sleep static method. It accepts a timer or a object with timer property and an optional signal.
+     * @param {{timer: number, signal: AbortSignal|undefined}} options
+     * @returns {Futurable<void>}
+     */
+    static sleep({ timer, signal }: {
+        timer: number;
+        signal?: AbortSignal;
+    }): Futurable<void>;
+    /**
+     * Fetch static method.
+     * @param {string} url
+     * @param {RequestInit} [opts]
+     * @returns {Futurable<Response>}
+     */
+    static fetch(url: string, opts?: RequestInit): Futurable<Response>;
+    /**
+     * Futurizable static method.
+     * @param {{promise: Promise<TResult1>, signal: AbortSignal|undefined}} options
+     * @returns {Futurable<TResult1 | TResult2>}
+     */
+    static futurizable<TResult1 = any, TResult2 = never>({ promise, signal }: {
+        promise: Promise<TResult1>;
+        signal?: AbortSignal;
+    }): Futurable<TResult1 | TResult2>;
+    private static handleValues;
+    /**
+     * Creates a Futurable with cancellation support that is resolved with an array of results when all of the provided Futurables resolve, or rejected when any Futurable is rejected.
+     * @param {T} values
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<{ -readonly [P in keyof T]: Awaited<T[P]>; }>}
+     */
+    static all<T extends readonly unknown[] | []>(values: T, signal?: AbortSignal): Futurable<{
+        -readonly [P in keyof T]: Awaited<T[P]>;
+    }>;
+    /**
+     * Creates a Futurable with cancellation support that is resolved with an array of results when all of the provided Futurables resolve or reject.
+     * @param {T} values
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<{ -readonly [P in keyof T]: PromiseSettledResult<Awaited<T[P]>> }>}
+     */
+    static allSettled<T extends readonly unknown[] | []>(values: T, signal?: AbortSignal): Futurable<{
+        -readonly [P in keyof T]: PromiseSettledResult<Awaited<T[P]>>;
+    }>;
+    /**
+     * Creates a Futurable with cancellation support that is resolved or rejected when any of the provided Futurables are resolved or rejected.
+     * @param {T} values
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<Awaited<T[number]>>}
+     */
+    static race<T extends readonly unknown[] | []>(values: T, signal?: AbortSignal): Futurable<Awaited<T[number]>>;
+    /**
+     * The any function returns a futurable with cancellation support that is fulfilled by the first given futurable to be fulfilled,
+     * or rejected with an AggregateError containing an array of rejection reasons if all of the
+     * given futurables are rejected. It resolves all elements of the passed iterable to futurables as
+     * it runs this algorithm.
+     * @param {T} values
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<Awaited<T[number]>>}
+     */
+    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. An optional param __immediate__ can be set _true_ if __fun__ must to be invoke immediatly.
+     * @param {()=> Futurable<T>} fun
+     * @param {{interval: number, signal?: AbortSignal, immediate?: boolean}} options
+     * @returns {{cancel: () => void, catch: (onrejected:(reason: unknown)=>void)=>void }}
+     */
+    static polling<T>(fun: () => Futurable<T> | Promise<T> | T, { interval, signal, immediate }: {
+        interval: number;
+        signal?: AbortSignal;
+        immediate?: boolean;
+    }): {
+        cancel: () => void;
+        catch: (onrejected: (reason: unknown) => void) => void;
+    };
+    /**
+     * Extension of _Promise.withResolvers_ static method. Creates a new Futurable and returns it in an object, along with its resolve, reject and cancel functions and utils object.
+     * @param {AbortSignal} [signal]
+     * @returns {{ resolve: null | FuturableResolve<T>, reject: null | FuturableReject, utils: null | FuturableUtils<T>, futurable: Futurable<T>, cancel: null | (() => void) }}
+     */
+    static withResolvers<T>(signal?: AbortSignal): FuturableWithResolvers<T>;
+}
+
+export { Futurable };
+export type { FuturableExecutor, FuturableIterable, FuturableLike, FuturableReject, FuturableResolve, FuturableUtils };

package/dist/index.d.mts

@@ -0,0 +1,255 @@
+interface FuturableLike<T> {
+    /**
+     * Attaches callbacks for the resolution and/or rejection of the Futurable.
+     * @param onfulfilled The callback to execute when the Futurable is resolved.
+     * @param onrejected The callback to execute when the Futurable is rejected.
+     * @returns A Futurable for the completion of which ever callback is executed.
+     */
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null): FuturableLike<TResult1 | TResult2>;
+}
+interface FuturableResolve<T> {
+    (value: T | FuturableLike<T> | PromiseLike<T>): void;
+}
+interface FuturableReject {
+    (reason?: any): void;
+}
+interface FuturableUtils<T> {
+    /**
+     * Internal futurable signal
+     */
+    signal: AbortSignal;
+    /**
+     * Cancel the futurable if it is to be executed or if it is still executing.
+     */
+    cancel: () => void;
+    /**
+     * Executes the callback passed as a parameter when the futurable is cancelled.
+     * @param cb: callback
+     */
+    onCancel: (cb: () => void) => void;
+    /**
+     * Waits for timer, then executes callback with the futurable value and returns the result obtained from the invocation.
+     * @param cb: callback executed after timer
+     * @param timer: timer to wait (in milliseconds)
+     */
+    delay: <TResult = T, TResult2 = never>(cb: () => TResult, timer: number) => FuturableLike<TResult | TResult2>;
+    /**
+     * Waits for timer parameter (in milliseconds) before returning the value.
+     * @param timer: timer to wait (in milliseconds)
+     */
+    sleep: (timer: number) => FuturableLike<void>;
+    /**
+     * 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.
+     * @param url: url to fetch
+     * @param opts: fetch options
+     */
+    fetch: (url: string, opts?: RequestInit) => Futurable<Response>;
+    /**
+     * Takes a promise and transforms it into a futurizable. Promise can be also a function that receives value from futurable chaining as parameter.
+     * @param promise: Promise to futurize
+     */
+    futurizable: <TResult = any>(promise: Promise<TResult>) => Futurable<TResult>;
+}
+type FuturableExecutor<T> = (resolve: FuturableResolve<T>, reject: FuturableReject, 
+/**
+ * Object containing implemented functionalities.
+ */
+utils: FuturableUtils<T>) => void;
+type FuturableIterable<T = any> = Iterable<FuturableLike<T> | PromiseLike<T> | T>;
+interface FuturableWithResolvers<T> {
+    promise: Futurable<T> | Promise<T>;
+    resolve: (value: T | PromiseLike<T> | FuturableLike<T>) => void;
+    reject: (reason?: any) => void;
+    cancel: () => void;
+    utils: FuturableUtils<T>;
+}
+declare class Futurable<T> extends Promise<T> {
+    private controller;
+    private internalSignal;
+    private idsTimeout;
+    constructor(executor: FuturableExecutor<T>, signal?: AbortSignal);
+    static get [Symbol.species](): typeof Futurable;
+    get [Symbol.toStringTag](): string;
+    /**
+     * Return internal futurable signal
+     * @returns {AbortSignal}
+     */
+    get signal(): AbortSignal;
+    private clearTimeout;
+    /**
+     * Attaches callbacks for the resolution and/or rejection of the Futurable.
+     * @param {((value: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>) | undefined | null} onfulfilled
+     * @param {((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null} onrejected
+     * @returns {Futurable<TResult1 | TResult2>}
+     */
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null): Futurable<TResult1 | TResult2>;
+    /**
+     * Attaches a callback for only the rejection of the Futurable.
+     * @param {((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null} onRejected
+     * @returns {Futurable<T | TResult2>}
+     */
+    catch<TResult2 = never>(onRejected: ((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null): Futurable<T | TResult2>;
+    /**
+     * Attaches a callback that is invoked when the Futurable is settled (fulfilled or rejected).
+     * The resolved value cannot be modified from the callback.
+     * @param {() => void | undefined | null} onfinally
+     * @returns {Futurable<T>}
+     */
+    finally(onfinally: () => void | undefined | null): Futurable<T>;
+    /**
+     * Cancel the futurable if it is to be executed or if it is still executing.
+     */
+    cancel(): void;
+    /**
+     * Waits for timer, then executes callback with the futurable value and returns the result obtained from the invocation.
+     * @param {(val: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>} cb - callback executed after timer with futurable chain value as parameter
+     * @param {number} timer - timer to wait (in milliseconds)
+     */
+    delay<TResult1 = T, TResult2 = never>(cb: (val: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>, timer: number): Futurable<TResult1 | TResult2>;
+    /**
+     * Waits for timer parameter (in milliseconds) before returning the value.
+     * @param {number} timer - timer to wait (in milliseconds)
+     * @returns {Futurable<T>}
+     */
+    sleep(timer: number): Futurable<T>;
+    /**
+     * 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.
+     * @param {string| ((val?:T)=>string)} url - url to fetch or function with futurable chaining value that returns url to fetch
+     * @param {object | RequestInit | ((val?: T) => RequestInit)} opts - fetch options or function with futurable chaining value that return fetch options
+     * @returns {Futurable<Response>}
+     */
+    fetch(url: string | ((val?: T) => string), opts?: object | RequestInit | ((val?: T) => RequestInit)): Futurable<Response>;
+    /**
+     * Executes the callback passed as a parameter when the futurable is cancelled.
+     * @param {()=>void} cb
+     * @returns {Futurable<TResult1 | TResult2>}
+     */
+    onCancel<TResult1 = void, TResult2 = never>(cb: () => void): Futurable<TResult1 | TResult2>;
+    /**
+     * Takes a promise and transforms it into a futurizable. Promise can be also a function that receives value from futurable chaining as parameter.
+     * @param {Promise<TResult1> | ((val?: T) => Promise<TResult1>)} promise - Promise to futurize or function that return promise with futurable chaining value as parameter
+     * @returns {Futurable<TResult1 | TResult2>}
+     */
+    futurizable<TResult1 = T, TResult2 = never>(promise: Promise<TResult1> | ((val?: T) => Promise<TResult1>)): Futurable<TResult1 | TResult2>;
+    /**
+     * Creates a new resolved futurable. Creates a new resolved futurable for the provided value.
+     * @returns {Futurable<void>}
+     */
+    static resolve(): Futurable<void>;
+    /**
+     * @param {T | PromiseLike<T> | FuturableLike<T>} value
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<T>}
+     */
+    static resolve<T = any>(value: T | PromiseLike<T> | FuturableLike<T>, signal?: AbortSignal): Futurable<T>;
+    /**
+     * Creates a new rejected futurable for the provided reason.
+     * @param {any} [reason]
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<T>}
+     */
+    static reject<T = never>(reason?: any, signal?: AbortSignal): Futurable<T>;
+    /**
+     * OnCancel static method. It accepts a callback or a object with cb property and an optional signal.
+     * @param {{cb: () => T, signal: AbortSignal|undefined}} options
+     * @returns {Futurable<T>}
+ */
+    static onCancel<T = void>({ cb, signal }: {
+        cb: () => T;
+        signal?: AbortSignal;
+    }): Futurable<T>;
+    /**
+     * Delay static method. It accepts a object with timer and cb properties and an optional signal property.
+     * @param {{cb: () => T, timer: number, signal: AbortSignal|undefined}} options
+     * @returns {Futurable<T|TResult2>}
+     */
+    static delay<T = any, TResult2 = never>({ cb, timer, signal }: {
+        cb: () => T;
+        timer: number;
+        signal?: AbortSignal;
+    }): Futurable<T | TResult2>;
+    /**
+     * Sleep static method. It accepts a timer or a object with timer property and an optional signal.
+     * @param {{timer: number, signal: AbortSignal|undefined}} options
+     * @returns {Futurable<void>}
+     */
+    static sleep({ timer, signal }: {
+        timer: number;
+        signal?: AbortSignal;
+    }): Futurable<void>;
+    /**
+     * Fetch static method.
+     * @param {string} url
+     * @param {RequestInit} [opts]
+     * @returns {Futurable<Response>}
+     */
+    static fetch(url: string, opts?: RequestInit): Futurable<Response>;
+    /**
+     * Futurizable static method.
+     * @param {{promise: Promise<TResult1>, signal: AbortSignal|undefined}} options
+     * @returns {Futurable<TResult1 | TResult2>}
+     */
+    static futurizable<TResult1 = any, TResult2 = never>({ promise, signal }: {
+        promise: Promise<TResult1>;
+        signal?: AbortSignal;
+    }): Futurable<TResult1 | TResult2>;
+    private static handleValues;
+    /**
+     * Creates a Futurable with cancellation support that is resolved with an array of results when all of the provided Futurables resolve, or rejected when any Futurable is rejected.
+     * @param {T} values
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<{ -readonly [P in keyof T]: Awaited<T[P]>; }>}
+     */
+    static all<T extends readonly unknown[] | []>(values: T, signal?: AbortSignal): Futurable<{
+        -readonly [P in keyof T]: Awaited<T[P]>;
+    }>;
+    /**
+     * Creates a Futurable with cancellation support that is resolved with an array of results when all of the provided Futurables resolve or reject.
+     * @param {T} values
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<{ -readonly [P in keyof T]: PromiseSettledResult<Awaited<T[P]>> }>}
+     */
+    static allSettled<T extends readonly unknown[] | []>(values: T, signal?: AbortSignal): Futurable<{
+        -readonly [P in keyof T]: PromiseSettledResult<Awaited<T[P]>>;
+    }>;
+    /**
+     * Creates a Futurable with cancellation support that is resolved or rejected when any of the provided Futurables are resolved or rejected.
+     * @param {T} values
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<Awaited<T[number]>>}
+     */
+    static race<T extends readonly unknown[] | []>(values: T, signal?: AbortSignal): Futurable<Awaited<T[number]>>;
+    /**
+     * The any function returns a futurable with cancellation support that is fulfilled by the first given futurable to be fulfilled,
+     * or rejected with an AggregateError containing an array of rejection reasons if all of the
+     * given futurables are rejected. It resolves all elements of the passed iterable to futurables as
+     * it runs this algorithm.
+     * @param {T} values
+     * @param {AbortSignal} [signal]
+     * @returns {Futurable<Awaited<T[number]>>}
+     */
+    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. An optional param __immediate__ can be set _true_ if __fun__ must to be invoke immediatly.
+     * @param {()=> Futurable<T>} fun
+     * @param {{interval: number, signal?: AbortSignal, immediate?: boolean}} options
+     * @returns {{cancel: () => void, catch: (onrejected:(reason: unknown)=>void)=>void }}
+     */
+    static polling<T>(fun: () => Futurable<T> | Promise<T> | T, { interval, signal, immediate }: {
+        interval: number;
+        signal?: AbortSignal;
+        immediate?: boolean;
+    }): {
+        cancel: () => void;
+        catch: (onrejected: (reason: unknown) => void) => void;
+    };
+    /**
+     * Extension of _Promise.withResolvers_ static method. Creates a new Futurable and returns it in an object, along with its resolve, reject and cancel functions and utils object.
+     * @param {AbortSignal} [signal]
+     * @returns {{ resolve: null | FuturableResolve<T>, reject: null | FuturableReject, utils: null | FuturableUtils<T>, futurable: Futurable<T>, cancel: null | (() => void) }}
+     */
+    static withResolvers<T>(signal?: AbortSignal): FuturableWithResolvers<T>;
+}
+
+export { Futurable };
+export type { FuturableExecutor, FuturableIterable, FuturableLike, FuturableReject, FuturableResolve, FuturableUtils };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export interface FuturableLike<T> {
+interface FuturableLike<T> {
     /**
      * Attaches callbacks for the resolution and/or rejection of the Futurable.
      * @param onfulfilled The callback to execute when the Futurable is resolved.
@@ -7,13 +7,13 @@ export interface FuturableLike<T> {
      */
     then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1> | FuturableLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2> | FuturableLike<TResult2>) | undefined | null): FuturableLike<TResult1 | TResult2>;
 }
-export interface FuturableResolve<T> {
+interface FuturableResolve<T> {
     (value: T | FuturableLike<T> | PromiseLike<T>): void;
 }
-export interface FuturableReject {
+interface FuturableReject {
     (reason?: any): void;
 }
-export interface FuturableUtils<T> {
+interface FuturableUtils<T> {
     /**
      * Internal futurable signal
      */
@@ -50,12 +50,12 @@ export interface FuturableUtils<T> {
      */
     futurizable: <TResult = any>(promise: Promise<TResult>) => Futurable<TResult>;
 }
-export type FuturableExecutor<T> = (resolve: FuturableResolve<T>, reject: FuturableReject, 
+type FuturableExecutor<T> = (resolve: FuturableResolve<T>, reject: FuturableReject, 
 /**
  * Object containing implemented functionalities.
  */
 utils: FuturableUtils<T>) => void;
-export type FuturableIterable<T = any> = Iterable<FuturableLike<T> | PromiseLike<T> | T>;
+type FuturableIterable<T = any> = Iterable<FuturableLike<T> | PromiseLike<T> | T>;
 interface FuturableWithResolvers<T> {
     promise: Futurable<T> | Promise<T>;
     resolve: (value: T | PromiseLike<T> | FuturableLike<T>) => void;
@@ -63,7 +63,7 @@ interface FuturableWithResolvers<T> {
     cancel: () => void;
     utils: FuturableUtils<T>;
 }
-export declare class Futurable<T> extends Promise<T> {
+declare class Futurable<T> extends Promise<T> {
     private controller;
     private internalSignal;
     private idsTimeout;
@@ -250,5 +250,6 @@ export declare class Futurable<T> extends Promise<T> {
      */
     static withResolvers<T>(signal?: AbortSignal): FuturableWithResolvers<T>;
 }
-export {};
-//# sourceMappingURL=index.d.ts.map
+
+export { Futurable };
+export type { FuturableExecutor, FuturableIterable, FuturableLike, FuturableReject, FuturableResolve, FuturableUtils };

package/dist/index.mjs

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