@creejs/commons-retrier 2.1.16 → 2.1.18

package/dist/cjs/index-dev.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let r$1 = class r extends Error{static isAggregatedErrorLike(t){return t&&Array.isArray(t.errors)}static isAggregatedError(t){return t instanceof r}constructor(t,r){super(t),this.errors=r??[];}addError(t){this.errors.push(t);}removeError(t){const r=this.errors.indexOf(t);return  -1!==r&&(this.errors.splice(r,1),true)}};var e$1={constructorName:n$1,defaults:function(t,...r){if(null==t)throw new TypeError('"target" must not be null or undefined');for(const e of r)if(null!=e)for(const r in e) void 0===t[r]&&(t[r]=e[r]);return t},extend:o$1,extends:o$1,equals:function(t,r){if(t===r)return  true;if("function"==typeof t?.equals)return t.equals(r);if("function"==typeof r?.equals)return r.equals(t);return  false},isBrowser:i$1,isNode:function(){return !i$1()},cloneToPlainObject:function(t){if(null==t)return t;if("object"!=typeof t)throw new Error("Only Object allowed to clone");return {...t}},deepCloneToPlainObject:function(t){if(null==t)return t;if("object"!=typeof t)throw new Error("Only Object allowed to clone");return JSON.parse(JSON.stringify(t))}};function n$1(t){return t?.constructor?.name}function o$1(t,...r){if(null==t)throw new TypeError('"target" must not be null or undefined');for(const e of r)if(null!=e)for(const r in e)t[r]=e[r];return t}function i$1(){return "undefined"!=typeof window&&"undefined"!=typeof document}var s$1={isArray:u$1,isBoolean:f$1,isBuffer:function(t){return null!=t&&Buffer.isBuffer(t)},isFunction:a$1,isInstance:c$1,isIterable:function(t){return null!=t&&"function"==typeof t[Symbol.iterator]},isDate:function(t){return null!=t&&t instanceof Date},isError:function(t){return null!=t&&t instanceof Error},isMap:function(t){return null!=t&&"object"==typeof t&&t.constructor===Map},isWeakMap:function(t){return null!=t&&"object"==typeof t&&t.constructor===WeakMap},isNumber:d$1,isPositive:y,isNegative:h$1,isNotNegative:p$1,isNil:l$1,isNullOrUndefined:function(t){return null==t},isNull:g$1,isUndefined:w$1,isPlainObject:b$1,isObject:m$1,isPromise:A,isRegExp:function(t){return null!=t&&"object"==typeof t&&t.constructor===RegExp},isSet:function(t){return null!=t&&"object"==typeof t&&t.constructor===Set},isWeakSet:function(t){return null!=t&&"object"==typeof t&&t.constructor===WeakSet},isStream:function(t){return null!=t&&"function"==typeof t.pipe},isString:E,isSymbol:N,isPrimitive:function(t){return null!==t&&("string"==typeof t||"number"==typeof t||"boolean"==typeof t)},isInt8Array:v$1,isUint8Array:O$1,isUint8ClampedArray:j,isInt16Array:P,isUint16Array:x,isInt32Array:S,isUint32Array:U,isFloat32Array:T,isFloat64Array:B,isBigInt64Array:I,isBigUint64Array:k$1,isTypedArray:$,isArrayBuffer:L$1};function u$1(t){return Array.isArray(t)}function f$1(t){return "boolean"==typeof t}function a$1(t){return "function"==typeof t}function c$1(t){return null!=t&&"object"==typeof t&&!b$1(t)}function l$1(t){return null==t}function y(t){return !!d$1(t)&&t>0}function p$1(t){return !!d$1(t)&&t>=0}function h$1(t){return !!d$1(t)&&t<0}function g$1(t){return null===t}function w$1(t){return void 0===t}function d$1(t){return null!=t&&"number"==typeof t}function m$1(t){return null!=t&&"object"==typeof t}function b$1(t){return null!==t&&"object"==typeof t&&(t.constructor===Object||void 0===t.constructor)}function A(t){return null!=t&&"function"==typeof t.then}function E(t){return null!=t&&"string"==typeof t}function N(t){return null!=t&&"symbol"==typeof t}function $(t){return ArrayBuffer.isView(t)&&t.constructor!==DataView}function v$1(t){return t instanceof Int8Array}function O$1(t){return t instanceof Uint8Array}function j(t){return t instanceof Uint8ClampedArray}function P(t){return t instanceof Int16Array}function x(t){return t instanceof Uint16Array}function S(t){return t instanceof Int32Array}function U(t){return t instanceof Uint32Array}function T(t){return t instanceof Float32Array}function B(t){return t instanceof Float64Array}function I(t){return t instanceof BigInt64Array}function k$1(t){return t instanceof BigUint64Array}function L$1(t){return t instanceof ArrayBuffer}var F={assertNumber:D,assertPositive:M,assertNotNegative:J,assertFunction:W,assertNotNil:V,assertString:q};function C(t,r){if(!Array.isArray(t))throw new Error(`${r?'"'+r+'" ':""}Not Array: type=${typeof t} value=${X(t)}`)}function q(t,r){if(!E(t))throw new Error(`${r?'"'+r+'" ':""}Not String: type=${typeof t} value=${X(t)}`)}function D(t,r){if(!d$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Number: type=${typeof t} value=${X(t)}`)}function M(t,r){if(!y(t))throw new Error(`${r?'"'+r+'" ':""}Not Positive: ${t}`)}function J(t,r){if(!p$1(t))throw new Error(`${r?'"'+r+'" ':""}Not "0 or Positive": ${t}`)}function W(t,r){if(!a$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Function: type=${typeof t} value=${X(t)}`)}function H(t,r){if(!A(t))throw new Error(`${r?'"'+r+'" ':""}Not Promise: type=${typeof t} value=${X(t)}`)}function V(t,r){if(l$1(t))throw new Error((r?'"'+r+'" ':"")+"Should Not Nil")}function X(t){if(null===t)return "null";if(void 0===t)return "undefined";let r;try{r=JSON.stringify(t);}catch(e){r=t.toString();}return r}var tt={any:function(t){if(C(t),0===t.length)throw new Error("Empty Tasks");const e=rt(),n=[];for(let o=0;o<t.length;o++){const i=t[o];let u;if(s$1.isPromise(i))u=i;else {if(!s$1.isFunction(i)){n.push(new Error(`Invalid Task at index ${o}/${t.length-1}: ${i}`));continue}u=nt(i);}u.then(t=>{e.resolve(t);}).catch(o=>{n.push(o),n.length>=t.length&&e.reject(new r$1("All Tasks Failed",n));});}n.length===t.length&&e.reject(new r$1("All Tasks Failed",n));return e.promise},defer:rt,delay:function(t,r){s$1.isNumber(t)?(r=t,t=Promise.resolve()):null==t&&null==r&&(r=1,t=Promise.resolve());null!=t&&H(t),D(r=r??1e3);const e=rt(),n=Date.now();return t.then((...t)=>{const o=Date.now()-n;o<r?setTimeout(()=>e.resolve(...t),r-o):e.resolve(...t);}).catch(t=>{const o=Date.now()-n;o<r?setTimeout(()=>e.reject(t),r-o):e.reject(t);}),e.promise},timeout:function(t,r,e){H(t),D(r=r??1);const n=rt(r,e),o=Date.now();return t.then((...t)=>{Date.now()-o<=r?n.resolve(...t):n.reject(new Error(e??`Promise Timeout: ${r}ms`));}).catch(t=>{!n.resolved&&!n.rejected&&n.reject(t);}),n.promise},allSettled:et,returnValuePromised:nt,series:async function(t){C(t);const r=[];for(const e of t)if(W(e),s$1.isFunction(e))r.push(await nt(e));else {if(!s$1.isPromise(e))throw new Error(`Invalid Task: ${e}`);r.push(await e);}return r},seriesAllSettled:async function(t){C(t);const r=[];for(const e of t){W(e);try{r.push({ok:!0,result:await e()});}catch(t){r.push({ok:false,result:t});}}return r},parallel:async function(t,r=5){if(C(t),D(r),r<=0)throw new Error(`Invalid maxParallel: ${r}, should > 0`);t.forEach(t=>W(t));const e=[];if(t.length<=r){const r=await Promise.all(t.map(t=>nt(t)));return e.push(...r),e}const n=[];for(const o of t)if(W(o),n.push(o),n.length>=r){const t=await Promise.all(n.map(t=>nt(t)));e.push(...t),n.length=0;}if(n.length>0&&n.length<r){const t=await Promise.all(n.map(t=>nt(t)));e.push(...t);}return e},parallelAny:async function(t,e=5){if(C(t,"tasks"),D(e),0===t.length)throw new Error("Empty Tasks");if(e<=0)throw new Error(`Invalid maxParallel: ${e}, should > 0`);const n=[];let o=0,i=0;const u=rt();function f(){if(o>=t.length)return;if(i>e)return;const a=t[o++];let c;if(i++,s$1.isPromise(a))c=a;else {if(!s$1.isFunction(a))return n.push(new TypeError(`Invalid task: ${a}`)),void f();c=nt(a);}c.then(t=>{u.resolve(t);}).catch(e=>{n.push(e),n.length>=t.length&&u.pending?u.reject(new r$1("All Tasks Failed",n)):f();}).finally(()=>{i--;});}for(;i<e;)f();return u.promise},parallelAllSettled:async function(t,r=5){if(C(t),D(r),r<=0)throw new Error(`Invalid maxParallel: ${r}, should > 0`);t.forEach(t=>W(t));const e=[];if(t.length<=r){const r=await et(t.map(t=>nt(t)));return e.push(...r),e}const n=[];for(const o of t)if(n.push(o),n.length>=r){const t=await et(n.map(t=>nt(t)));e.push(...t),n.length=0;}if(n.length>0&&n.length<r){const t=await et(n.map(t=>nt(t)));e.push(...t);}return e},wait:function(t){J(t);const r={};let e;return r.timerHandler=e=setTimeout(()=>{clearTimeout(e),r._resolve();},t),r.promise=new Promise((t,n)=>{r._resolve=r=>{null!=e&&clearTimeout(e),t(r);};}),r.wakeup=()=>{r._resolve();},r}};function rt(t=-1,r){D(t);const e={};let n;return e.pending=true,e.canceled=false,e.rejected=false,e.resolved=false,t>=0&&(e.timerCleared=false,e.timerHandler=n=setTimeout(()=>{clearTimeout(n),e.timerCleared=true,e.reject(new Error(r??`Promise Timeout: ${t}ms`));},t)),e.promise=new Promise((t,r)=>{e.resolve=r=>{e.resolved||e.rejected||e.canceled||(null!=n&&(clearTimeout(n),e.timerCleared=true),e.pending=false,e.canceled=false,e.rejected=false,e.resolved=true,t(r));},e.reject=t=>{e.resolved||e.rejected||e.canceled||(null!=n&&(clearTimeout(n),e.timerCleared=true),e.pending=false,e.canceled=false,e.resolved=false,e.rejected=true,r(t));};}),e.cancel=e.promise.cancel=t=>{e.resolved||e.rejected||e.canceled||(null!=n&&(clearTimeout(n),e.timerCleared=true),e.reject(t??new Error("Cancelled")),e.canceled=e.promise.canceled=true);},e}async function et(t){C(t);const r=await Promise.allSettled(t),e=[];for(const t of r)"fulfilled"===t.status&&e.push({ok:true,result:t.value}),"rejected"===t.status&&e.push({ok:false,result:t.reason});return e}function nt(t){try{const r=t();return s$1.isPromise(r)?r:Promise.resolve(r)}catch(t){return Promise.reject(t)}}new TextDecoder;new TextEncoder;
+let e$1 = class e extends Error{static isAggregatedErrorLike(t){return t&&Array.isArray(t.errors)}static isAggregatedError(t){return t instanceof e}constructor(t,r){super(t),this.errors=r??[];}addError(t){this.errors.push(t);}removeError(t){const r=this.errors.indexOf(t);return  -1!==r&&(this.errors.splice(r,1),true)}};var n$1={constructorName:o$1,defaults:function(t,...r){if(null==t)throw new TypeError('"target" Should Not Nil');for(const e of r)if(null!=e)for(const r in e) void 0===t[r]&&(t[r]=e[r]);return t},extend:i$1,extends:i$1,equals:function(t,r){if(t===r)return  true;if("function"==typeof t?.equals)return t.equals(r);if("function"==typeof r?.equals)return r.equals(t);return  false},isBrowser:s$1,isNode:function(){return !s$1()},cloneToPlainObject:function(t){if(null==t)return t;if("object"!=typeof t)throw new Error("Only Object allowed to clone");return {...t}},deepCloneToPlainObject:function(t){if(null==t)return t;if("object"!=typeof t)throw new Error("Only Object allowed to clone");return JSON.parse(JSON.stringify(t))}};function o$1(t){return t?.constructor?.name}function i$1(t,...r){if(null==t)throw new TypeError('"target" must not be null or undefined');for(const e of r)if(null!=e)for(const r in e)t[r]=e[r];return t}function s$1(){return "undefined"!=typeof window&&"undefined"!=typeof document}var u$1={isArray:f$1,isBoolean:a$1,isBuffer:function(t){return null!=t&&Buffer.isBuffer(t)},isFunction:c$1,isInstance:l$1,isIterable:function(t){return null!=t&&"function"==typeof t[Symbol.iterator]},isDate:function(t){return null!=t&&t instanceof Date},isError:function(t){return null!=t&&t instanceof Error},isMap:function(t){return null!=t&&"object"==typeof t&&t.constructor===Map},isWeakMap:function(t){return null!=t&&"object"==typeof t&&t.constructor===WeakMap},isNumber:m$1,isPositive:p$1,isNegative:g$1,isNotNegative:h$1,isNil:y,isNullOrUndefined:function(t){return null==t},isNull:w$1,isUndefined:d$1,isPlainObject:A,isObject:b$1,isPromise:E,isRegExp:function(t){return null!=t&&"object"==typeof t&&t.constructor===RegExp},isSet:function(t){return null!=t&&"object"==typeof t&&t.constructor===Set},isWeakSet:function(t){return null!=t&&"object"==typeof t&&t.constructor===WeakSet},isStream:function(t){return null!=t&&"function"==typeof t.pipe},isString:N,isSymbol:$,isPrimitive:function(t){return null!==t&&("string"==typeof t||"number"==typeof t||"boolean"==typeof t)},isInt8Array:O$1,isUint8Array:j,isUint8ClampedArray:P,isInt16Array:S,isUint16Array:x,isInt32Array:U,isUint32Array:T,isFloat32Array:I,isFloat64Array:B,isBigInt64Array:k$1,isBigUint64Array:L$1,isTypedArray:v$1,isArrayBuffer:F};function f$1(t){return Array.isArray(t)}function a$1(t){return "boolean"==typeof t}function c$1(t){return "function"==typeof t}function l$1(t){return null!=t&&"object"==typeof t&&!A(t)}function y(t){return null==t}function p$1(t){return !!m$1(t)&&t>0}function h$1(t){return !!m$1(t)&&t>=0}function g$1(t){return !!m$1(t)&&t<0}function w$1(t){return null===t}function d$1(t){return void 0===t}function m$1(t){return null!=t&&"number"==typeof t}function b$1(t){return null!=t&&"object"==typeof t}function A(t){return null!==t&&"object"==typeof t&&(t.constructor===Object||void 0===t.constructor)}function E(t){return null!=t&&"function"==typeof t.then}function N(t){return null!=t&&"string"==typeof t}function $(t){return null!=t&&"symbol"==typeof t}function v$1(t){return ArrayBuffer.isView(t)&&t.constructor!==DataView}function O$1(t){return t instanceof Int8Array}function j(t){return t instanceof Uint8Array}function P(t){return t instanceof Uint8ClampedArray}function S(t){return t instanceof Int16Array}function x(t){return t instanceof Uint16Array}function U(t){return t instanceof Int32Array}function T(t){return t instanceof Uint32Array}function I(t){return t instanceof Float32Array}function B(t){return t instanceof Float64Array}function k$1(t){return t instanceof BigInt64Array}function L$1(t){return t instanceof BigUint64Array}function F(t){return t instanceof ArrayBuffer}var C={assertNumber:q,assertPositive:_$1,assertNotNegative:J,assertFunction:W,assertNotNil:V,assertString:M};function D(t,r){if(!Array.isArray(t))throw new Error(`${r?'"'+r+'" ':""}Not Array: type=${typeof t} value=${Z(t)}`)}function M(t,r){if(!N(t))throw new Error(`${r?'"'+r+'" ':""}Not String: type=${typeof t} value=${Z(t)}`)}function q(t,r){if(!m$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Number: type=${typeof t} value=${Z(t)}`)}function _$1(t,r){if(!p$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Positive: ${t}`)}function J(t,r){if(!h$1(t))throw new Error(`${r?'"'+r+'" ':""}Not "0 or Positive": ${t}`)}function W(t,r){if(!c$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Function: type=${typeof t} value=${Z(t)}`)}function H(t,r){if(!E(t))throw new Error(`${r?'"'+r+'" ':""}Not Promise: type=${typeof t} value=${Z(t)}`)}function V(t,r){if(y(t))throw new Error((r?'"'+r+'" ':"")+"Should Not Nil")}function Z(t){if(null===t)return "null";if(void 0===t)return "undefined";let r;try{r=JSON.stringify(t);}catch(e){r=t.toString();}return r}var rt={any:function(t){if(D(t),0===t.length)throw new Error("Empty Tasks");const r=et(),n=[];for(let o=0;o<t.length;o++){const i=t[o];let s;if(u$1.isPromise(i))s=i;else {if(!u$1.isFunction(i)){n.push(new Error(`Invalid Task at index ${o}/${t.length-1}: ${i}`));continue}s=ot(i);}s.then(t=>{r.resolve(t);}).catch(o=>{n.push(o),n.length>=t.length&&r.reject(new e$1("All Tasks Failed",n));});}n.length===t.length&&r.reject(new e$1("All Tasks Failed",n));return r.promise},defer:et,delay:function(t,r){u$1.isNumber(t)?(r=t,t=Promise.resolve()):null==t&&null==r&&(r=1,t=Promise.resolve());null!=t&&H(t),q(r=r??1e3);const e=et(),n=Date.now();return t.then((...t)=>{const o=Date.now()-n;o<r?setTimeout(()=>e.resolve(...t),r-o):e.resolve(...t);}).catch(t=>{const o=Date.now()-n;o<r?setTimeout(()=>e.reject(t),r-o):e.reject(t);}),e.promise},timeout:function(t,r,e){H(t),q(r=r??1);const n=et(r,e),o=Date.now();return t.then((...t)=>{Date.now()-o<=r?n.resolve(...t):n.reject(new Error(e??`Promise Timeout: ${r}ms`));}).catch(t=>{!n.resolved&&!n.rejected&&n.reject(t);}),n.promise},allSettled:nt,returnValuePromised:ot,series:async function(t){D(t);const r=[];for(const e of t)if(W(e),u$1.isFunction(e))r.push(await ot(e));else {if(!u$1.isPromise(e))throw new Error(`Invalid Task: ${e}`);r.push(await e);}return r},seriesAllSettled:async function(t){D(t);const r=[];for(const e of t){W(e);try{r.push({ok:!0,result:await e()});}catch(t){r.push({ok:false,result:t});}}return r},parallel:async function(t,r=5){if(D(t),q(r),r<=0)throw new Error(`Invalid maxParallel: ${r}, should > 0`);t.forEach(t=>W(t));const e=[];if(t.length<=r){const r=await Promise.all(t.map(t=>ot(t)));return e.push(...r),e}const n=[];for(const o of t)if(W(o),n.push(o),n.length>=r){const t=await Promise.all(n.map(t=>ot(t)));e.push(...t),n.length=0;}if(n.length>0&&n.length<r){const t=await Promise.all(n.map(t=>ot(t)));e.push(...t);}return e},parallelAny:async function(t,r=5){if(D(t,"tasks"),q(r),0===t.length)throw new Error("Empty Tasks");if(r<=0)throw new Error(`Invalid maxParallel: ${r}, should > 0`);const n=[];let o=0,i=0;const s=et();function f(){if(o>=t.length)return;if(i>r)return;const a=t[o++];let c;if(i++,u$1.isPromise(a))c=a;else {if(!u$1.isFunction(a))return n.push(new TypeError(`Invalid task: ${a}`)),void f();c=ot(a);}c.then(t=>{s.resolve(t);}).catch(r=>{n.push(r),n.length>=t.length&&s.pending?s.reject(new e$1("All Tasks Failed",n)):f();}).finally(()=>{i--;});}for(;i<r;)f();return s.promise},parallelAllSettled:async function(t,r=5){if(D(t),q(r),r<=0)throw new Error(`Invalid maxParallel: ${r}, should > 0`);t.forEach(t=>W(t));const e=[];if(t.length<=r){const r=await nt(t.map(t=>ot(t)));return e.push(...r),e}const n=[];for(const o of t)if(n.push(o),n.length>=r){const t=await nt(n.map(t=>ot(t)));e.push(...t),n.length=0;}if(n.length>0&&n.length<r){const t=await nt(n.map(t=>ot(t)));e.push(...t);}return e},wait:function(t){J(t);const r={};let e;return r.timerHandler=e=setTimeout(()=>{clearTimeout(e),r._resolve();},t),r.promise=new Promise((t,n)=>{r._resolve=r=>{null!=e&&clearTimeout(e),t(r);};}),r.wakeup=()=>{r._resolve();},r}};function et(t=-1,r){q(t);const e={};let n;return e.pending=true,e.canceled=false,e.rejected=false,e.resolved=false,t>=0&&(e.timerCleared=false,e.timerHandler=n=setTimeout(()=>{clearTimeout(n),e.timerCleared=true,e.reject(new Error(r??`Promise Timeout: ${t}ms`));},t)),e.promise=new Promise((t,r)=>{e.resolve=r=>{e.resolved||e.rejected||e.canceled||(null!=n&&(clearTimeout(n),e.timerCleared=true),e.pending=false,e.canceled=false,e.rejected=false,e.resolved=true,t(r));},e.reject=t=>{e.resolved||e.rejected||e.canceled||(null!=n&&(clearTimeout(n),e.timerCleared=true),e.pending=false,e.canceled=false,e.resolved=false,e.rejected=true,r(t));};}),e.cancel=e.promise.cancel=t=>{e.resolved||e.rejected||e.canceled||(null!=n&&(clearTimeout(n),e.timerCleared=true),e.reject(t??new Error("Cancelled")),e.canceled=e.promise.canceled=true);},e}async function nt(t){D(t);const r=await Promise.allSettled(t),e=[];for(const t of r)"fulfilled"===t.status&&e.push({ok:true,result:t.value}),"rejected"===t.status&&e.push({ok:false,result:t.reason});return e}function ot(t){try{const r=t();return u$1.isPromise(r)?r:Promise.resolve(r)}catch(t){return Promise.reject(t)}}new TextDecoder;new TextEncoder;
 
 // module vars
 const DefaultMinInterval = 50;
@@ -12,8 +12,8 @@ const DefaultMaxRetries = 3;
 // internal
 
 // module vars
-const { assertPositive: assertPositive$5, assertNotNegative: assertNotNegative$3 } = F;
-const { isNumber } = s$1;
+const { assertPositive: assertPositive$5, assertNotNegative: assertNotNegative$3 } = C;
+const { isNumber } = u$1;
 
 class Policy {
   /**
@@ -181,7 +181,7 @@ var Event = {
 // 3rd
 // internal
 // module vars
-const { assertPositive: assertPositive$4 } = F;
+const { assertPositive: assertPositive$4 } = C;
 class FixedIntervalPolicy extends Policy {
   /**
    * Creates a fixed interval retry policy with the specified interval.
@@ -189,16 +189,25 @@ class FixedIntervalPolicy extends Policy {
    */
   constructor (interval) {
     super();
-    assertPositive$4(interval, 'interval');
-    this._interval = interval;
+    this.interval = interval;
   }
 
+  /**
+   * @param {number} interval - The fixed interval (in milliseconds) between retry attempts.
+   */
   set interval (interval) {
     assertPositive$4(interval, 'interval');
     this._interval = interval;
+    this._nextInterval = interval;
+    this._min = interval;
+    this._max = interval;
   }
 
+  /**
+   * @returns {number}
+   */
   get interval () {
+    // @ts-ignore not possible be undefined
     return this._interval
   }
 
@@ -216,7 +225,7 @@ class FixedIntervalPolicy extends Policy {
 // 3rd
 // internal
 // module vars
-const { assertPositive: assertPositive$3 } = F;
+const { assertPositive: assertPositive$3 } = C;
 class FixedIncreasePolicy extends Policy {
   /**
    * each call to _next() increases the interval by "increasement".
@@ -253,7 +262,7 @@ class FixedIncreasePolicy extends Policy {
 // 3rd
 // internal
 // module vars
-const { assertPositive: assertPositive$2 } = F;
+const { assertPositive: assertPositive$2 } = C;
 
 class FactoreIncreasePolicy extends Policy {
   /**
@@ -297,7 +306,7 @@ class FactoreIncreasePolicy extends Policy {
 // 3rd
 // internal
 // module vars
-const { assertPositive: assertPositive$1 } = F;
+const { assertPositive: assertPositive$1 } = C;
 
 class ShuttlePolicy extends Policy {
   /**
@@ -342,7 +351,7 @@ class ShuttlePolicy extends Policy {
 
 // internal
 // module vars
-const { assertNotNegative: assertNotNegative$2 } = F;
+const { assertNotNegative: assertNotNegative$2 } = C;
 /**
  * @class FixedBackoff
  */
@@ -362,7 +371,7 @@ class FixedBackoff extends FixedIntervalPolicy {
 // internal
 
 // module vars
-const { assertNotNegative: assertNotNegative$1 } = F;
+const { assertNotNegative: assertNotNegative$1 } = C;
 /**
  * @class ExponentialBackoffPolicy
  */
@@ -380,7 +389,7 @@ class ExponentialBackoffPolicy extends FactoreIncreasePolicy {
 
 // internal
 // module vars
-const { assertNotNegative } = F;
+const { assertNotNegative } = C;
 /**
  * @class LinearBackoff
  */
@@ -404,7 +413,7 @@ class LinearBackoff extends FixedIncreasePolicy {
  */
 
 // module vars
-const { assertNotNil, assertFunction: assertFunction$1 } = F;
+const { assertNotNil, assertFunction: assertFunction$1 } = C;
 class Task {
   /**
    * Creates a new Task instance.
@@ -496,6 +505,53 @@ class AlwaysTask extends Task {
   }
 }
 
+// owned
+
+/**
+ * @typedef {import('./retrier.js').default} Retrier
+ */
+
+/**
+ * The task will execute forever despite of failure or success.
+ * 1. Ignore Retrier total timeout setting
+ * 2. Ignore Retrier max retries setting
+ */
+class ForeverTask extends Task {
+  /**
+   * Checks if the given task is an instance of ForeverTask.
+   * @param {*} task - The task to check.
+   * @returns {boolean} True if the task is an instance of ForeverTask, false otherwise.
+   */
+  static isForeverTask (task) {
+    return task instanceof ForeverTask
+  }
+
+  /**
+   * Creates an ForeverTask instance.
+   * @param {Retrier} retrier - The retrier instance to use for retry logic
+   * @param {Function} task - The task function to execute
+   * @param {boolean} resetRetryPolicyAfterSuccess - Whether to reset retry policy after successful execution
+   */
+  constructor (retrier, task, resetRetryPolicyAfterSuccess) {
+    super(retrier, task);
+    this.resetPolicy = resetRetryPolicyAfterSuccess;
+  }
+
+  /**
+   * Executes the task with the given retry parameters.
+   * @param {number} retries - The number of retries attempted so far.
+   * @param {number} latence - The current latency ms.
+   * @param {number} nextInterval - The next interval ms.
+   * @returns {Promise<*>} The result of the task execution.
+   */
+  async execute (retries, latence, nextInterval) {
+    await super.execute(retries, latence, nextInterval);
+    if (this.succeeded && this.resetPolicy) {
+      this.retrier.resetRetryPolicy();
+    }
+  }
+}
+
 // internal
 
 /**
@@ -504,8 +560,8 @@ class AlwaysTask extends Task {
  */
 
 // module vars
-const { assertPositive, assertString, assertFunction, assertNumber } = F;
-const { isNil } = s$1;
+const { assertPositive, assertString, assertFunction, assertNumber } = C;
+const { isNil } = u$1;
 const TaskTimoutFlag = '!#@%$&^*';
 
 /**
@@ -752,7 +808,8 @@ class Retrier {
    * @returns {this} The retrier instance for chaining.
    */
   name (retrierName) {
-    assertString(retrierName, 'retrierName');
+    assertString(retrierName, 'name');
+    this._assertChangeable(retrierName);
     this._name = retrierName;
     return this
   }
@@ -762,6 +819,7 @@ class Retrier {
    * @returns {this} The retrier instance for chaining.
    */
   infinite () {
+    this._assertChangeable('infinite');
     this._maxRetries = Infinity;
     return this
   }
@@ -772,6 +830,7 @@ class Retrier {
    * @returns {this} The Retrier instance for chaining.
    */
   times (times) {
+    this._assertChangeable('times');
     return this.maxRetries(times)
   }
 
@@ -782,6 +841,7 @@ class Retrier {
    */
   maxRetries (maxRetries) {
     assertPositive(maxRetries, 'maxRetries');
+    this._assertChangeable('maxRetries');
     this._maxRetries = maxRetries;
     return this
   }
@@ -793,6 +853,7 @@ class Retrier {
    * @throws {Error} If min is not positive or is greater than/equal to max.
    */
   min (min) {
+    this._assertChangeable('min');
     this._policy.min(min);
     return this
   }
@@ -804,6 +865,7 @@ class Retrier {
    * @returns {this} The retrier instance for chaining.
    */
   max (max) {
+    this._assertChangeable('max');
     this._policy.max(max);
     return this
   }
@@ -816,6 +878,7 @@ class Retrier {
    * @throws {Error} If min is not less than max or if values are not positive
    */
   range (min, max) {
+    this._assertChangeable('range');
     this._policy.range(min, max);
     return this
   }
@@ -826,6 +889,7 @@ class Retrier {
    * @returns {Retrier} The Retrier instance for chaining.
    */
   fixedInterval (fixedInterval) {
+    this._assertChangeable('fixedInterval');
     const oldPolicy = this._policy;
     if (oldPolicy instanceof FixedIntervalPolicy) {
       oldPolicy.interval = fixedInterval;
@@ -845,6 +909,7 @@ class Retrier {
    * @returns {Retrier} A retrier instance configured with fixed backoff.
    */
   fixedBackoff (fixedInterval, jitter = 500) {
+    this._assertChangeable('fixedBackoff');
     const oldPolicy = this._policy;
     if (oldPolicy instanceof FixedIntervalPolicy) {
       oldPolicy.interval = fixedInterval;
@@ -864,6 +929,7 @@ class Retrier {
    * @returns {this} The retrier instance for chaining.
    */
   fixedIncrease (increasement) {
+    this._assertChangeable('fixedIncrease');
     const oldPolicy = this._policy;
     if (oldPolicy instanceof FixedIncreasePolicy) {
       oldPolicy.increasement = increasement;
@@ -883,6 +949,7 @@ class Retrier {
    * @returns {this} The retrier instance for chaining.
    */
   linearBackoff (increasement, jitter = 500) {
+    this._assertChangeable('linearBackoff');
     const oldPolicy = this._policy;
     if (oldPolicy instanceof LinearBackoff) {
       oldPolicy.increasement = increasement;
@@ -902,6 +969,7 @@ class Retrier {
    * @returns {this} The retrier instance for method chaining.
    */
   factorIncrease (factor) {
+    this._assertChangeable('factorIncrease');
     const oldPolicy = this._policy;
     if (oldPolicy instanceof FactoreIncreasePolicy) {
       oldPolicy.factor = factor;
@@ -920,6 +988,7 @@ class Retrier {
    * @returns {Retrier} A new Retrier instance
    */
   exponentialBackoff (jitter = 500) {
+    this._assertChangeable('exponentialBackoff');
     const oldPolicy = this._policy;
     if (oldPolicy instanceof ExponentialBackoffPolicy) {
       oldPolicy.jitter = jitter;
@@ -938,6 +1007,7 @@ class Retrier {
    * @returns {this} The Retrier instance for chaining.
    */
   shuttleInterval (stepLength) {
+    this._assertChangeable('shuttleInterval');
     const oldPolicy = this._policy;
     if (oldPolicy instanceof ShuttlePolicy) {
       oldPolicy.stepLength = stepLength;
@@ -957,7 +1027,8 @@ class Retrier {
    * @returns {this} The retrier instance for chaining.
    */
   taskTimeout (timeout) {
-    assertPositive(timeout, 'timeout');
+    assertPositive(timeout, 'taskTimeout');
+    this._assertChangeable('taskTimeout');
     this._taskTimeout = timeout;
     return this
   }
@@ -971,6 +1042,7 @@ class Retrier {
    */
   timeout (timeout) {
     assertNumber(timeout, 'timeout');
+    this._assertChangeable('timeout');
     this._timeout = timeout;
     return this
   }
@@ -979,7 +1051,8 @@ class Retrier {
    * Disables the timeout for the retrier.
    * @returns {this} The retrier instance for chaining.
    */
-  notimeout () {
+  noTimeout () {
+    this._assertChangeable('noTimeout');
     this._timeout = 0;
     return this
   }
@@ -991,6 +1064,7 @@ class Retrier {
    */
   task (task) {
     assertFunction(task, 'task');
+    this._assertChangeable('task');
     this._task = new Task(this, task);
     return this
   }
@@ -1001,6 +1075,7 @@ class Retrier {
    * @return {this}
    */
   retry (task) {
+    this._assertChangeable('retry');
     this.task(task);
     return this
   }
@@ -1010,14 +1085,31 @@ class Retrier {
    * 1. if the task fails, will retry it after the interval generated by RetryPolicy
    * 2. if the task succeeds, reset RetryPolicy to Minimum Interval and continue to run the task
    * @param {Function} task - The async function to execute and retry.
-   * @param {boolean} [resetAfterSuccess=false] - Whether to reset retry counters after success.
+   * @param {boolean} [resetAfterSuccess=true] - Whether to reset retry counters after success.
    * @returns {this} The Retrier instance for chaining.
    */
-  always (task, resetAfterSuccess = false) {
+  always (task, resetAfterSuccess = true) {
+    this._assertChangeable('always');
     this._task = new AlwaysTask(this, task, resetAfterSuccess);
     return this
   }
 
+  /**
+   *The task will execute forever despite of failure or success.
+   * 1. call notimeout(), override and ignore Retrier total timeout setting
+   * 2. call infinite(), override and ignore Retrier max retries setting
+   * @param {Function} task
+   * @param {boolean} [resetAfterSuccess=true]
+   * @returns
+   */
+  forever (task, resetAfterSuccess = true) {
+    this._assertChangeable('forever');
+    this.noTimeout();
+    this.infinite();
+    this._task = new ForeverTask(this, task, resetAfterSuccess);
+    return this
+  }
+
   /**
    * Starts the retry process.
    * @returns {Promise<*>}
@@ -1029,108 +1121,16 @@ class Retrier {
     if (this._taskingFlag != null) {
       return this._taskingFlag.promise
     }
-    const startAt = Date.now();
-    /** @type {Error|undefined} */
-    let lastError;
-    // @ts-ignore
-    this.emit(Event.Start, startAt);
-    this._taskingFlag = tt.defer();
-    let latency = null;
-
-    /**
-     * DO NOT worry about "while(true)", we will not be trapped in an infinite loop.
-     *
-     * "async" keyword ensures:
-     * 1. call start(), will enfore the first loop executed
-     * 2. when first "await" is encountered, "while(true)" loop hanged to wait
-     * 3. "async" will return a Promise when "while(true)" loop hanged
-     * 4. Returned "async" wrapper Promise, it is NOT "this._taskingFlag.promise"
-     */
-    while (true) {
-      // need to stop?
-      if (this._breakFlag != null) {
-        this._taskingFlag.reject(this._breakReason ?? new Error('Have Been Broken'));
-        break
-      }
-
-      latency = Date.now() - startAt;
-
-      // total timeout?
-      if (!isInfinite(this._timeout) && latency >= this._timeout) { // total timeout
-        // @ts-ignore
-        this.emit(Event.Timeout, this._currentRetries, latency, this._timeout);
-        // always task, treat as success, resolve the whole promise with <void>
-        if (AlwaysTask.isAlwaysTask(this._task)) {
-          this._taskingFlag.resolve();
-          break
-        }
-        this._taskingFlag.reject(lastError ?? new Error(`Timeout "${this._timeout}" Exceeded`));
-        break
-      }
-
-      // @ts-ignore
-      this.emit(Event.Retry, this._currentRetries, latency);
-      const task = this._task; // take task, it may be changed in events' callback functions
-      const nextDelay = this._policy.generate(this._currentRetries);
-      try {
-        try {
-          await tt.timeout(task.execute(this._currentRetries, latency, nextDelay), this._taskTimeout, TaskTimoutFlag);
-        } catch (err) {
-          // @ts-ignore
-          if (err.message === TaskTimoutFlag) {
-            // @ts-ignore
-            this.emit(Event.TaskTimeout, this._currentRetries, latency, this._taskTimeout);
-          }
-          throw err
-        }
-        // @ts-ignore
-        if (task.failed) {
-          lastError = task.error;
-          throw task.error
-        }
-        const rtnVal = task.result;
-        // @ts-ignore
-        this.emit(Event.Success, rtnVal, this._currentRetries, latency);
-
-        // Not AwaysTask, we can finish all the retries with success
-        if (!AlwaysTask.isAlwaysTask(task)) {
-          this._taskingFlag.resolve(rtnVal);
-          break
-        }
-        // AwaysTask, continue to run the task
-      } catch (e) {
-        // @ts-ignore
-        this.emit(Event.Failure, e, this._currentRetries, latency);
-      }
-      const nextRetries = ++this._currentRetries;
-      // next retry, max retries reached?
-      if (this._currentRetries > this._maxRetries) {
-        // @ts-ignore
-        this.emit(Event.MaxRetries, nextRetries, this._maxRetries);
-        // always task, treat as success, resolve the whole promise with <void>
-        if (AlwaysTask.isAlwaysTask(task)) {
-          this._taskingFlag.resolve();
-          break
-        }
-        this._taskingFlag.reject(lastError ?? new Error(`Max Retries Exceeded, Retring ${this._currentRetries} times > max ${this._maxRetries}`));
-        break
-      }
-      // use Waiter to introduce the ability to wakeup at any time
-      this._sleepWaiter = tt.wait(nextDelay);
-      await this._sleepWaiter.promise;
-      // await PromiseUtils.delay(nextDelay)
-    }
-    this._taskingFlag.promise.finally(() => {
-      this.resetRetryPolicy();
-      this._taskingFlag = undefined;
-      const spent = Date.now() - startAt;
-      // @ts-ignore
-      this.emit(Event.Completed, this._currentRetries, spent);
-    });
-    if (AlwaysTask.isAlwaysTask(this._task)) {
-      return // always task, resolve with <void>
+    this._taskingFlag = rt.defer();
+
+    if (ForeverTask.isForeverTask(this._task)) {
+      // DO NOT care ForeverTask's result
+      this._executeForeverTask(this._task);
+      this._taskingFlag.resolve();
+    } else {
+      // Resovle taskingFlag.promise in method _executeEndableTask()
+      this._executeEndableTask(this._task);
     }
-    // normal retry task, return the task's result
     return this._taskingFlag.promise
   }
 
@@ -1162,7 +1162,11 @@ class Retrier {
       // @ts-ignore
       return this._breakFlag.promise
     }
-    this._breakFlag = tt.defer();
+    // kick off
+    if (this._sleepWaiter != null) {
+      this._sleepWaiter.wakeup();
+    }
+    this._breakFlag = rt.defer();
     /** @type {Error|undefined} */
     this._breakReason = reason ?? new Error('Manually Stop');
     // @ts-ignore
@@ -1291,6 +1295,184 @@ class Retrier {
     this.on(Event.MaxRetries, listener);
     return this
   }
+
+  /**
+   *
+   * @param {Task} task
+   * @returns {Promise<void>}
+   */
+  async _executeForeverTask (task) {
+    if (this._taskingFlag == null) {
+      throw new Error('Must be called in start()')
+    }
+    const startAt = Date.now();
+    // @ts-ignore
+    this.emit(Event.Start, startAt);
+    let latency = null;
+
+    while (true) {
+      // need to stop?
+      if (this._breakFlag != null) {
+        const spent = Date.now() - startAt;
+        // @ts-ignore
+        this.emit(Event.Completed, this._currentRetries, spent);
+        break
+      }
+      latency = Date.now() - startAt;
+      // @ts-ignore
+      this.emit(Event.Retry, this._currentRetries, latency);
+      const nextDelay = this._policy.generate(this._currentRetries);
+      try {
+        try {
+          await rt.timeout(task.execute(this._currentRetries, latency, nextDelay), this._taskTimeout, TaskTimoutFlag);
+        } catch (err) {
+          // @ts-ignore
+          if (err.message === TaskTimoutFlag) {
+            // @ts-ignore
+            this.emit(Event.TaskTimeout, this._currentRetries, latency, this._taskTimeout);
+          }
+          throw err
+        }
+        // @ts-ignore
+        if (task.failed) {
+          throw task.error
+        }
+        const rtnVal = task.result;
+        // @ts-ignore
+        this.emit(Event.Success, rtnVal, this._currentRetries, latency);
+        // continue to run the task
+      } catch (e) {
+        // @ts-ignore
+        this.emit(Event.Failure, e, this._currentRetries, latency);
+      }
+      // compute next retry counter
+      ++this._currentRetries;
+      // use Waiter to introduce the ability to wakeup at any time
+      this._sleepWaiter = rt.wait(nextDelay);
+      await this._sleepWaiter.promise;
+    }
+  }
+
+  /**
+   * @param {Task} task
+   * @returns {Promise<any>}
+   */
+  async _executeEndableTask (task) {
+    if (this._taskingFlag == null) {
+      throw new Error('Must be called in start()')
+    }
+    const startAt = Date.now();
+    /** @type {Error|undefined} */
+    let lastError;
+    // @ts-ignore
+    this.emit(Event.Start, startAt);
+    let latency = null;
+
+    /**
+     * DO NOT worry about "while(true)", we will not be trapped in an infinite loop.
+     *
+     * "async" keyword ensures:
+     * 1. call start(), will enfore the first loop executed
+     * 2. when first "await" is encountered, "while(true)" loop hanged to wait
+     * 3. "async" will return a Promise when "while(true)" loop hanged
+     * 4. Returned "async" wrapper Promise, it is NOT "this._taskingFlag.promise"
+     */
+    while (true) {
+      // need to stop?
+      if (this._breakFlag != null) {
+        this._taskingFlag.reject(this._breakReason ?? new Error('Have Been Broken'));
+        break
+      }
+
+      latency = Date.now() - startAt;
+
+      // total timeout?
+      if (!isInfinite(this._timeout) && latency >= this._timeout) { // total timeout
+        // @ts-ignore
+        this.emit(Event.Timeout, this._currentRetries, latency, this._timeout);
+        // always task, treat as success, resolve the whole promise with <void>
+        if (AlwaysTask.isAlwaysTask(this._task)) {
+          this._taskingFlag.resolve();
+          break
+        }
+        this._taskingFlag.reject(lastError ?? new Error(`Timeout "${this._timeout}" Exceeded`));
+        break
+      }
+
+      // @ts-ignore
+      this.emit(Event.Retry, this._currentRetries, latency);
+      const nextDelay = this._policy.generate(this._currentRetries);
+      try {
+        try {
+          await rt.timeout(task.execute(this._currentRetries, latency, nextDelay), this._taskTimeout, TaskTimoutFlag);
+        } catch (err) {
+          // @ts-ignore
+          if (err.message === TaskTimoutFlag) {
+            // @ts-ignore
+            this.emit(Event.TaskTimeout, this._currentRetries, latency, this._taskTimeout);
+          }
+          throw err
+        }
+        // @ts-ignore
+        if (task.failed) {
+          lastError = task.error;
+          throw task.error
+        }
+        const rtnVal = task.result;
+        // @ts-ignore
+        this.emit(Event.Success, rtnVal, this._currentRetries, latency);
+
+        // Not AwaysTask, we can finish all the retries with success
+        if (!AlwaysTask.isAlwaysTask(task)) {
+          this._taskingFlag.resolve(rtnVal);
+          break
+        }
+        // AwaysTask, continue to run the task
+      } catch (e) {
+        // @ts-ignore
+        this.emit(Event.Failure, e, this._currentRetries, latency);
+      }
+      const nextRetries = ++this._currentRetries;
+      // next retry, max retries reached?
+      if (this._currentRetries > this._maxRetries) {
+        // @ts-ignore
+        this.emit(Event.MaxRetries, nextRetries, this._maxRetries);
+        // always task, treat as success, resolve the whole promise with <void>
+        if (AlwaysTask.isAlwaysTask(task)) {
+          this._taskingFlag.resolve();
+          break
+        }
+        this._taskingFlag.reject(lastError ?? new Error(`Max Retries Exceeded, Retring ${this._currentRetries} times > max ${this._maxRetries}`));
+        break
+      }
+      // use Waiter to introduce the ability to wakeup at any time
+      this._sleepWaiter = rt.wait(nextDelay);
+      await this._sleepWaiter.promise;
+      // await PromiseUtils.delay(nextDelay)
+    }
+    this._taskingFlag.promise.finally(() => {
+      this.resetRetryPolicy();
+      this._taskingFlag = undefined;
+      const spent = Date.now() - startAt;
+      // @ts-ignore
+      this.emit(Event.Completed, this._currentRetries, spent);
+    });
+    if (AlwaysTask.isAlwaysTask(this._task)) {
+      return // always task, resolve with <void>
+    }
+    // normal retry task, return the task's result
+    return this._taskingFlag.promise
+  }
+
+  /**
+   * Assert if can change param's value
+   * @param {string} param
+   */
+  _assertChangeable (param) {
+    if (this._taskingFlag != null) {
+      throw new Error(`No Change "${param}" After Retrier Started`)
+    }
+  }
 }
 
 /**
@@ -1524,7 +1706,7 @@ var RetrierFactory = {
  * ...
  * ```
  */
-e$1.defaults(Retrier, RetrierFactory);
+n$1.defaults(Retrier, RetrierFactory);
 
 /**
  * default export to support