@creejs/commons-retrier 2.0.0 → 2.0.2

package/lib/policy.js

@@ -1,131 +0,0 @@
-'use strict'
-// internal
-const {
-  TypeAssert: { assertPositive },
-  TypeUtils: { isNumber }
-} = require('@creejs/commons-lang')
-// owned
-const { DefaultMaxInterval, DefaultMinInterval } = require('./constants')
-// module vars
-
-class Policy {
-  /**
-   * Creates a new Policy instance with specified retry bounds.
-   */
-  constructor () {
-    this._min = DefaultMinInterval
-    this._max = DefaultMaxInterval
-    this._nextInterval = this._min
-  }
-
-  /**
-   * Copies settings to target policy.
-   * @param {Policy} targetPolicy - The policy to modify.
-   */
-  copyPolicySetting (targetPolicy) {
-    targetPolicy.range(this._min, this._max)
-    targetPolicy._nextInterval = this._nextInterval
-  }
-
-  /**
-   * Sets a fixed interval retry policy.
-  }
-
-  /**
-   * Sets the minimum and maximum intervals for retries.
-   * @param {number} min - Minimum delay in milliseconds (must be positive and less than max)
-   * @param {number} max - Maximum delay in milliseconds (must be positive and greater than min)
-   * @returns {this} Returns the Retrier instance for chaining
-   * @throws {Error} If min is not less than max or if values are not positive
-   */
-  range (min, max) {
-    assertPositive(min, 'min')
-    assertPositive(max, 'max')
-    if (min >= max) {
-      throw new Error('min must < max')
-    }
-    this._min = min
-    if (this._nextInterval < this._min) {
-      this._nextInterval = this._min
-    }
-    this._max = max
-    if (this._nextInterval > this._max) {
-      this._nextInterval = this._max
-    }
-    return this
-  }
-
-  /**
-   * Sets the minimum retry delay in milliseconds.
-   * 1. will change currentInterval to min
-   * @param {number} min - The minimum delay (must be positive and less than max).
-   * @returns {this} The retrier instance for chaining.
-   * @throws {Error} If min is not positive or is greater than/equal to max.
-   */
-  min (min) {
-    assertPositive(min, 'min')
-    if (min >= this._max) {
-      throw new Error('min must < max')
-    }
-    this._min = min
-    this._nextInterval = this._min
-    return this
-  }
-
-  /**
-   * Sets the maximum retry retry delay in milliseconds.
-   * @param {number} max - The maximum delay (must be positive and greater than min).
-   * @throws {Error} If max is not greater than min.
-   * @returns {this} The retrier instance for chaining.
-   */
-  max (max) {
-    assertPositive(max, 'max')
-    if (max <= this._min) {
-      throw new Error('max must > min')
-    }
-    this._max = max
-    if (this._nextInterval > this._max) {
-      this._nextInterval = this._max
-    }
-    return this
-  }
-
-  reset () {
-    this._nextInterval = this._min
-    return this
-  }
-
-  /**
-   * Interval ms of next execution
-   * @returns {number}
-   * @throws {Error} Always throws "Not Implemented Yet" error.
-   */
-  generate () {
-    const rtnVal = this._nextInterval
-    this._increase()
-    return rtnVal
-  }
-
-  _increase () {
-    const nextInterval = this._next()
-    if (!isNumber(nextInterval)) {
-      throw new Error('Generated Next Interval Not Number')
-    }
-    if (nextInterval < this._min) {
-      return (this._nextInterval = this._min)
-    } else if (nextInterval > this._max) {
-      return (this._nextInterval = this._max)
-    }
-    return (this._nextInterval = nextInterval)
-  }
-
-  /**
-   * subclass should implement this method
-   * @returns {number} The interval in milliseconds to wait before the next retry attempt.
-   * @protected
-   */
-  _next () {
-    throw new Error('Not Impled Yet')
-  }
-}
-module.exports = Policy

package/lib/retrier-factory.js

@@ -1,173 +0,0 @@
-'use strict'
-// owned
-const Retrier = require('./retrier')
-/**
- * Creates a new Retrier instance with the specified name.
- * @param {string} name - The name to assign to the retrier.
- * @returns {Retrier} A new Retrier instance with the given name.
- */
-function name (name) {
-  const retrier = new Retrier()
-  retrier.name(name)
-  return retrier
-}
-
-/**
- * Creates and returns a Retrier instance configured for infinite retries.
- * @returns {Retrier} A Retrier instance with infinite retry behavior.
- */
-function infinite () {
-  const retrier = new Retrier()
-  retrier.infinite()
-  return retrier
-}
-
-/**
- * Creates a retrier configured to attempt an operation a specified number of times.
- * @param {number} times - The maximum number of retry attempts.
- * @returns {Retrier} A configured Retrier instance with the specified max retries.
- */
-function times (times) {
-  const retrier = new Retrier()
-  retrier.times(times)
-  return retrier
-}
-
-/**
- * Alias for times.
- * @param {number} maxRetries - The maximum number of retry attempts.
- * @returns {Retrier} A configured Retrier instance with the specified max retries.
- */
-function maxRetries (maxRetries) {
-  const retrier = new Retrier()
-  retrier.maxRetries(maxRetries)
-  return retrier
-}
-
-/**
- * Sets the minimum Interval for the retrier and returns the instance.
- * @param {number} min - The minimum Interval in milliseconds.
- * @returns {Retrier} The retrier instance with updated minimum Interval.
- */
-function min (min) {
-  const retrier = new Retrier()
-  retrier.min(min)
-  return retrier
-}
-
-/**
- * Sets the maximum Interval for the retrier and returns the instance.
- * @param {number} max - The maximum Interval in milliseconds.
- * @returns {Retrier} The retrier instance with updated maximum Interval.
- */
-function max (max) {
-  const retrier = new Retrier()
-  retrier.max(max)
-  return retrier
-}
-
-/**
- * Creates a retrier with the specified Interval range.
- * @param {number} min - Minimum Interval.
- * @param {number} max - Maximum Interval.
- * @returns {Retrier} A new Retrier instance configured with specified Interval range.
- */
-function range (min, max) {
-  const retrier = new Retrier()
-  retrier.range(min, max)
-  return retrier
-}
-
-/**
- * Creates a retrier with a fixed interval between attempts.
- * @param {number} fixedInterval - The fixed interval in milliseconds between retry attempts.
- * @returns {Retrier} A new Retrier instance configured with the specified fixed interval.
- */
-function fixedInterval (fixedInterval) {
-  const retrier = new Retrier()
-  retrier.fixedInterval(fixedInterval)
-  return retrier
-}
-
-/**
- * Creates a retrier with a fixed increase strategy.
- * @param {number} increasement - The fixed amount to increase on each retry.
- * @returns {Retrier} A retrier instance configured with fixed increase.
- */
-function fixedIncrease (increasement) {
-  const retrier = new Retrier()
-  retrier.fixedIncrease(increasement)
-  return retrier
-}
-
-/**
- * Creates a new Retrier instance with factor-increase strategy.
- * @param {number} factor - The factor by which to increase the interval on each retry.
- * @returns {Retrier} A new Retrier instance with factor-increase strategy.
- */
-function factorIncrease (factor) {
-  const retrier = new Retrier()
-  retrier.factorIncrease(factor)
-  return retrier
-}
-
-/**
- * Creates a Retrier instance with a shuttle-interval strategt.
- * @param {number} stepLength - The interval step length of each change
- * @returns {Retrier} A configured Retrier instance with shuttle-interval strategt.
- */
-function shuttleInterval (stepLength) {
-  const retrier = new Retrier()
-  retrier.shuttleInterval(stepLength)
-  return retrier
-}
-
-/**
- * Creates a Retrier instance with a total-opertion timeout.
- * @param {number} timeout - The timeout value in milliseconds.
- * @returns {Retrier} A Retrier instance configured with the given timeout.
- */
-function timeout (timeout) {
-  const retrier = new Retrier()
-  retrier.timeout(timeout)
-  return retrier
-}
-
-/**
- * Creates a retrier instance with a single-task timeout.
- * @param {number} timeout - The timeout duration in milliseconds for the retrier task.
- * @returns {Retrier} A Retrier instance configured with the given task timeout.
- */
-function taskTimeout (timeout) {
-  const retrier = new Retrier()
-  retrier.taskTimeout(timeout)
-  return retrier
-}
-
-/**
- * Creates a new Retrier instance, sets the task to be retried, and starts the retry process.
- * @param {Function} task - The asynchronous task function to be retried.
- * @returns {Promise<*>} A promise that resolves when the retry process completes.
- */
-function start (task) {
-  const retrier = new Retrier()
-  retrier.task(task)
-  return retrier.start()
-}
-
-module.exports = {
-  name,
-  infinite,
-  times,
-  maxRetries,
-  min,
-  max,
-  range,
-  fixedInterval,
-  fixedIncrease,
-  factorIncrease,
-  shuttleInterval,
-  timeout,
-  taskTimeout,
-  start
-}