@daiso-tech/core 0.22.2 → 0.24.0

package/README.md

@@ -29,4 +29,6 @@ The library provides modular solutions for the essential features needed in mode
 
 This library is heavily inspired laravel but built in modular way where you can choose which part to use.
 
+#### NOTE: This library only a ESM (ecmascript) module.
+
 ### Visit the [docs](https://yousif-khalil-abdulkarim.github.io/daiso-core/) for more information!

package/dist/async/_module-exports.d.ts

@@ -0,0 +1,3 @@
+export * from "../async/backof-policies/_module.js";
+export * from "../async/utilities/_module.js";
+export * from "../async/async.errors.js";

package/dist/async/_module-exports.js

@@ -0,0 +1,4 @@
+export * from "../async/backof-policies/_module.js";
+export * from "../async/utilities/_module.js";
+export * from "../async/async.errors.js";
+//# sourceMappingURL=_module-exports.js.map

package/dist/async/_module-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../src/async/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC"}

package/dist/async/async.errors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @module Async
+ */
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Errors
+ */
+export declare class AsyncError extends Error {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Errors
+ */
+export declare class AbortAsyncError extends AsyncError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Errors
+ */
+export declare class TimeoutAsyncError extends AsyncError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Errors
+ */
+export type RetryAsyncErrorData = {
+    cause?: unknown;
+    maxAttempts: number;
+};
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Errors
+ */
+export declare class RetryAsyncError extends AsyncError {
+    readonly maxAttempts: number;
+    constructor(message: string, { cause, maxAttempts }: RetryAsyncErrorData);
+}

package/dist/async/async.errors.js

@@ -0,0 +1,50 @@
+/**
+ * @module Async
+ */
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Errors
+ */
+export class AsyncError extends Error {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = AsyncError.name;
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Errors
+ */
+export class AbortAsyncError extends AsyncError {
+    constructor(message, cause) {
+        super(message, cause);
+        this.name = AbortAsyncError.name;
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Errors
+ */
+export class TimeoutAsyncError extends AsyncError {
+    constructor(message, cause) {
+        super(message, cause);
+        this.name = TimeoutAsyncError.name;
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Errors
+ */
+export class RetryAsyncError extends AsyncError {
+    maxAttempts;
+    constructor(message, { cause, maxAttempts }) {
+        super(message, cause);
+        this.name = RetryAsyncError.name;
+        this.maxAttempts = maxAttempts;
+    }
+}
+//# sourceMappingURL=async.errors.js.map

package/dist/async/async.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.errors.js","sourceRoot":"","sources":["../../src/async/async.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACjC,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAChC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC3C,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACrC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC7C,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACvC,CAAC;CACJ;AAYD;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC3B,WAAW,CAAS;IAEpC,YAAY,OAAe,EAAE,EAAE,KAAK,EAAE,WAAW,EAAuB;QACpE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;CACJ"}

package/dist/async/backof-policies/_module.d.ts

@@ -0,0 +1,5 @@
+export * from "../../async/backof-policies/_shared.js";
+export * from "../../async/backof-policies/constant-backoff-policy/_module.js";
+export * from "../../async/backof-policies/exponential-backoff-policy/_module.js";
+export * from "../../async/backof-policies/linear-backoff-policy/_module.js";
+export * from "../../async/backof-policies/polynomial-backoff-policy/_module.js";

package/dist/async/backof-policies/_module.js

@@ -0,0 +1,6 @@
+export * from "../../async/backof-policies/_shared.js";
+export * from "../../async/backof-policies/constant-backoff-policy/_module.js";
+export * from "../../async/backof-policies/exponential-backoff-policy/_module.js";
+export * from "../../async/backof-policies/linear-backoff-policy/_module.js";
+export * from "../../async/backof-policies/polynomial-backoff-policy/_module.js";
+//# sourceMappingURL=_module.js.map

package/dist/async/backof-policies/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/async/backof-policies/_module.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,4DAA4D,CAAC;AAC3E,cAAc,+DAA+D,CAAC;AAC9E,cAAc,0DAA0D,CAAC;AACzE,cAAc,8DAA8D,CAAC"}

package/dist/async/backof-policies/_shared.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @module Async
+ */
+/**
+ * @returns Amount milliseconds to wait
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export type BackoffPolicy = (attempt: number, error: unknown) => number;
+/**
+ * @internal
+ */
+export declare function withJitter(jitter: number, value: number, mathRandom: () => number): number;

package/dist/async/backof-policies/_shared.js

@@ -0,0 +1,10 @@
+/**
+ * @module Async
+ */
+/**
+ * @internal
+ */
+export function withJitter(jitter, value, mathRandom) {
+    return (1 - jitter * mathRandom()) * value;
+}
+//# sourceMappingURL=_shared.js.map

package/dist/async/backof-policies/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/async/backof-policies/_shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;GAEG;AACH,MAAM,UAAU,UAAU,CACtB,MAAc,EACd,KAAa,EACb,UAAwB;IAExB,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,UAAU,EAAE,CAAC,GAAG,KAAK,CAAC;AAC/C,CAAC"}

package/dist/async/backof-policies/constant-backoff-policy/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../async/backof-policies/constant-backoff-policy/constant-backoff-policy.js";

package/dist/async/backof-policies/constant-backoff-policy/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../async/backof-policies/constant-backoff-policy/constant-backoff-policy.js";
+//# sourceMappingURL=_module.js.map

package/dist/async/backof-policies/constant-backoff-policy/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/backof-policies/constant-backoff-policy/_module.ts"],"names":[],"mappings":"AAAA,cAAc,4EAA4E,CAAC"}

package/dist/async/backof-policies/constant-backoff-policy/constant-backoff-policy.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @module Async
+ */
+import { TimeSpan } from "../../../utilities/_module-exports.js";
+import { type BackoffPolicy } from "../../../async/backof-policies/_shared.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export type ConstantBackoffPolicySettings = {
+    /**
+     * @default 1000 milliseconds
+     */
+    delay?: TimeSpan;
+    /**
+     * @default {0.5}
+     */
+    jitter?: number;
+    /**
+     * Used only for testing
+     * @internal
+     */
+    _mathRandom?: () => number;
+};
+/**
+ * Constant backoff policy with jitter
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export declare function constantBackoffPolicy(settings?: ConstantBackoffPolicySettings | ((error: unknown) => ConstantBackoffPolicySettings)): BackoffPolicy;

package/dist/async/backof-policies/constant-backoff-policy/constant-backoff-policy.js

@@ -0,0 +1,25 @@
+/**
+ * @module Async
+ */
+import { TimeSpan } from "../../../utilities/_module-exports.js";
+import { withJitter, } from "../../../async/backof-policies/_shared.js";
+/**
+ * Constant backoff policy with jitter
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export function constantBackoffPolicy(settings = {}) {
+    return (_attempt, error) => {
+        if (typeof settings === "function") {
+            settings = settings(error);
+        }
+        let { delay = 1000 } = settings;
+        if (delay instanceof TimeSpan) {
+            delay = delay.toMilliseconds();
+        }
+        const { jitter = 0.5, _mathRandom = Math.random } = settings;
+        return withJitter(jitter, delay, _mathRandom);
+    };
+}
+//# sourceMappingURL=constant-backoff-policy.js.map

package/dist/async/backof-policies/constant-backoff-policy/constant-backoff-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant-backoff-policy.js","sourceRoot":"","sources":["../../../../src/async/backof-policies/constant-backoff-policy/constant-backoff-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EACH,UAAU,GAEb,MAAM,oCAAoC,CAAC;AAuB5C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACjC,WAE4D,EAAE;IAE9D,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QACvB,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACjC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;QAChC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC5B,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC7D,OAAO,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC,CAAC;AACN,CAAC"}

package/dist/async/backof-policies/exponential-backoff-policy/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../async/backof-policies/exponential-backoff-policy/exponential-backoff-policy.js";

package/dist/async/backof-policies/exponential-backoff-policy/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../async/backof-policies/exponential-backoff-policy/exponential-backoff-policy.js";
+//# sourceMappingURL=_module.js.map

package/dist/async/backof-policies/exponential-backoff-policy/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/backof-policies/exponential-backoff-policy/_module.ts"],"names":[],"mappings":"AAAA,cAAc,kFAAkF,CAAC"}

package/dist/async/backof-policies/exponential-backoff-policy/exponential-backoff-policy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module Async
+ */
+import { TimeSpan } from "../../../utilities/_module-exports.js";
+import type { BackoffPolicy } from "../../../async/backof-policies/_shared.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export type ExponentialBackoffPolicySettings = {
+    /**
+     * @default 60_000 milliseconds
+     */
+    maxDelay?: TimeSpan;
+    /**
+     * @default 1_000 milliseconds
+     */
+    minDelay?: TimeSpan;
+    /**
+     * @default {2}
+     */
+    multiplier?: number;
+    /**
+     * @default {0.5}
+     */
+    jitter?: number;
+    /**
+     * Used only for testing
+     * @internal
+     */
+    _mathRandom?: () => number;
+};
+/**
+ * Exponential backoff policy with jitter
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export declare function exponentialBackoffPolicy(settings?: ExponentialBackoffPolicySettings | ((error: unknown) => ExponentialBackoffPolicySettings)): BackoffPolicy;

package/dist/async/backof-policies/exponential-backoff-policy/exponential-backoff-policy.js

@@ -0,0 +1,29 @@
+/**
+ * @module Async
+ */
+import { TimeSpan } from "../../../utilities/_module-exports.js";
+import { withJitter } from "../../../async/backof-policies/_shared.js";
+/**
+ * Exponential backoff policy with jitter
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export function exponentialBackoffPolicy(settings = {}) {
+    return (attempt, error) => {
+        if (typeof settings === "function") {
+            settings = settings(error);
+        }
+        let { maxDelay = 60_000, minDelay = 1_000 } = settings;
+        if (maxDelay instanceof TimeSpan) {
+            maxDelay = maxDelay.toMilliseconds();
+        }
+        if (minDelay instanceof TimeSpan) {
+            minDelay = minDelay.toMilliseconds();
+        }
+        const { multiplier = 2, jitter = 0.5, _mathRandom = Math.random, } = settings;
+        const exponential = Math.min(maxDelay, minDelay * Math.pow(multiplier, attempt));
+        return withJitter(jitter, exponential, _mathRandom);
+    };
+}
+//# sourceMappingURL=exponential-backoff-policy.js.map

package/dist/async/backof-policies/exponential-backoff-policy/exponential-backoff-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exponential-backoff-policy.js","sourceRoot":"","sources":["../../../../src/async/backof-policies/exponential-backoff-policy/exponential-backoff-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AA+BhE;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACpC,WAE+D,EAAE;IAEjE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACtB,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACjC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC;QACvD,IAAI,QAAQ,YAAY,QAAQ,EAAE,CAAC;YAC/B,QAAQ,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;QACD,IAAI,QAAQ,YAAY,QAAQ,EAAE,CAAC;YAC/B,QAAQ,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,EACF,UAAU,GAAG,CAAC,EACd,MAAM,GAAG,GAAG,EACZ,WAAW,GAAG,IAAI,CAAC,MAAM,GAC5B,GAAG,QAAQ,CAAC;QACb,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CACxB,QAAQ,EACR,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAC3C,CAAC;QACF,OAAO,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC,CAAC;AACN,CAAC"}

package/dist/async/backof-policies/linear-backoff-policy/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../async/backof-policies/linear-backoff-policy/linear-backoff-policy.js";

package/dist/async/backof-policies/linear-backoff-policy/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../async/backof-policies/linear-backoff-policy/linear-backoff-policy.js";
+//# sourceMappingURL=_module.js.map

package/dist/async/backof-policies/linear-backoff-policy/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/backof-policies/linear-backoff-policy/_module.ts"],"names":[],"mappings":"AAAA,cAAc,wEAAwE,CAAC"}

package/dist/async/backof-policies/linear-backoff-policy/linear-backoff-policy.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @module Async
+ */
+import { TimeSpan } from "../../../utilities/_module-exports.js";
+import type { BackoffPolicy } from "../../../async/backof-policies/_shared.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export type LinearBackoffPolicySettings = {
+    /**
+     * @default 6000 milliseconds
+     */
+    maxDelay?: TimeSpan;
+    /**
+     * @default 1_000 milliseconds
+     */
+    minDelay?: TimeSpan;
+    /**
+     * @default {0.5}
+     */
+    jitter?: number;
+    /**
+     * Used only for testing
+     * @internal
+     */
+    _mathRandom?: () => number;
+};
+/**
+ * Linear backoff policy with jitter
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export declare function linearBackoffPolicy(settings?: LinearBackoffPolicySettings | ((error: unknown) => LinearBackoffPolicySettings)): BackoffPolicy;

package/dist/async/backof-policies/linear-backoff-policy/linear-backoff-policy.js

@@ -0,0 +1,29 @@
+/**
+ * @module Async
+ */
+import { TimeSpan } from "../../../utilities/_module-exports.js";
+import { withJitter } from "../../../async/backof-policies/_shared.js";
+/**
+ * Linear backoff policy with jitter
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export function linearBackoffPolicy(settings = {}) {
+    return (attempt, error) => {
+        if (typeof settings === "function") {
+            settings = settings(error);
+        }
+        let { maxDelay = 6000, minDelay = 1_000 } = settings;
+        if (maxDelay instanceof TimeSpan) {
+            maxDelay = maxDelay.toMilliseconds();
+        }
+        if (minDelay instanceof TimeSpan) {
+            minDelay = minDelay.toMilliseconds();
+        }
+        const { jitter = 0.5, _mathRandom = Math.random } = settings;
+        const linear = Math.min(maxDelay, minDelay * attempt);
+        return withJitter(jitter, linear, _mathRandom);
+    };
+}
+//# sourceMappingURL=linear-backoff-policy.js.map

package/dist/async/backof-policies/linear-backoff-policy/linear-backoff-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-backoff-policy.js","sourceRoot":"","sources":["../../../../src/async/backof-policies/linear-backoff-policy/linear-backoff-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AA2BhE;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAC/B,WAE0D,EAAE;IAE5D,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACtB,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACjC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC;QACrD,IAAI,QAAQ,YAAY,QAAQ,EAAE,CAAC;YAC/B,QAAQ,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;QACD,IAAI,QAAQ,YAAY,QAAQ,EAAE,CAAC;YAC/B,QAAQ,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC;QACtD,OAAO,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC,CAAC;AACN,CAAC"}

package/dist/async/backof-policies/polynomial-backoff-policy/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../async/backof-policies/polynomial-backoff-policy/polynomial-backoff-policy.js";

package/dist/async/backof-policies/polynomial-backoff-policy/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../async/backof-policies/polynomial-backoff-policy/polynomial-backoff-policy.js";
+//# sourceMappingURL=_module.js.map

package/dist/async/backof-policies/polynomial-backoff-policy/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/backof-policies/polynomial-backoff-policy/_module.ts"],"names":[],"mappings":"AAAA,cAAc,gFAAgF,CAAC"}

package/dist/async/backof-policies/polynomial-backoff-policy/polynomial-backoff-policy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module Async
+ */
+import { TimeSpan } from "../../../utilities/_module-exports.js";
+import type { BackoffPolicy } from "../../../async/backof-policies/_shared.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export type PolynomialBackoffPolicySettings = {
+    /**
+     * @default 60_000 milliseconds
+     */
+    maxDelay?: TimeSpan;
+    /**
+     * @default 1_000 milliseconds
+     */
+    minDelay?: TimeSpan;
+    /**
+     * @default {2}
+     */
+    degree?: number;
+    /**
+     * @default {0.5}
+     */
+    jitter?: number;
+    /**
+     * Used only for testing
+     * @internal
+     */
+    _mathRandom?: () => number;
+};
+/**
+ * Polynomial backoff policy with jitter
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export declare function polynomialBackoffPolicy(settings?: PolynomialBackoffPolicySettings | ((error: unknown) => PolynomialBackoffPolicySettings)): BackoffPolicy;

package/dist/async/backof-policies/polynomial-backoff-policy/polynomial-backoff-policy.js

@@ -0,0 +1,29 @@
+/**
+ * @module Async
+ */
+import { TimeSpan } from "../../../utilities/_module-exports.js";
+import { withJitter } from "../../../async/backof-policies/_shared.js";
+/**
+ * Polynomial backoff policy with jitter
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * @group Backoff policies
+ */
+export function polynomialBackoffPolicy(settings = {}) {
+    return (attempt, error) => {
+        if (typeof settings === "function") {
+            settings = settings(error);
+        }
+        let { maxDelay = 6000, minDelay = 1_000 } = settings;
+        if (maxDelay instanceof TimeSpan) {
+            maxDelay = maxDelay.toMilliseconds();
+        }
+        if (minDelay instanceof TimeSpan) {
+            minDelay = minDelay.toMilliseconds();
+        }
+        const { degree = 2, jitter = 0.5, _mathRandom = Math.random, } = settings;
+        const polynomial = Math.min(maxDelay, minDelay * Math.pow(attempt, degree));
+        return withJitter(jitter, polynomial, _mathRandom);
+    };
+}
+//# sourceMappingURL=polynomial-backoff-policy.js.map

package/dist/async/backof-policies/polynomial-backoff-policy/polynomial-backoff-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polynomial-backoff-policy.js","sourceRoot":"","sources":["../../../../src/async/backof-policies/polynomial-backoff-policy/polynomial-backoff-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AA+BhE;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACnC,WAE8D,EAAE;IAEhE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACtB,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACjC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC;QACrD,IAAI,QAAQ,YAAY,QAAQ,EAAE,CAAC;YAC/B,QAAQ,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;QACD,IAAI,QAAQ,YAAY,QAAQ,EAAE,CAAC;YAC/B,QAAQ,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,EACF,MAAM,GAAG,CAAC,EACV,MAAM,GAAG,GAAG,EACZ,WAAW,GAAG,IAAI,CAAC,MAAM,GAC5B,GAAG,QAAQ,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACvB,QAAQ,EACR,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CACvC,CAAC;QACF,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC,CAAC;AACN,CAAC"}

package/dist/async/utilities/_module.d.ts

@@ -0,0 +1,5 @@
+export * from "../../async/utilities/abort/_module.js";
+export * from "../../async/utilities/delay/_module.js";
+export * from "../../async/utilities/lazy-promise/_module.js";
+export * from "../../async/utilities/retry/_module.js";
+export * from "../../async/utilities/timeout/_module.js";

package/dist/async/utilities/_module.js

@@ -0,0 +1,6 @@
+export * from "../../async/utilities/abort/_module.js";
+export * from "../../async/utilities/delay/_module.js";
+export * from "../../async/utilities/lazy-promise/_module.js";
+export * from "../../async/utilities/retry/_module.js";
+export * from "../../async/utilities/timeout/_module.js";
+//# sourceMappingURL=_module.js.map

package/dist/async/utilities/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/async/utilities/_module.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC"}

package/dist/async/utilities/abort/_module.d.ts

@@ -0,0 +1,2 @@
+export * from "../../../async/utilities/abort/abort-and-fail.js";
+export * from "../../../async/utilities/abort/abort.js";

package/dist/async/utilities/abort/_module.js

@@ -0,0 +1,3 @@
+export * from "../../../async/utilities/abort/abort-and-fail.js";
+export * from "../../../async/utilities/abort/abort.js";
+//# sourceMappingURL=_module.js.map

package/dist/async/utilities/abort/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/utilities/abort/_module.ts"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC"}

package/dist/async/utilities/abort/abort-and-fail.js

@@ -0,0 +1,51 @@
+/**
+ * @module Async
+ */
+import { AbortAsyncError } from "../../../async/async.errors.js";
+/**
+ * @internal
+ */
+function abortSignalToPromise(abortSignal) {
+    let reject_ = null;
+    function abort() {
+        if (reject_ === null) {
+            return;
+        }
+        reject_(new AbortAsyncError(`Promise was aborted with reason of "${String(abortSignal.reason)}"`, abortSignal.reason));
+    }
+    if (abortSignal.aborted) {
+        return {
+            promise: Promise.reject(new AbortAsyncError(`Promise was aborted with reason of "${String(abortSignal.aborted)}"`, abortSignal.reason)),
+            abort,
+        };
+    }
+    return {
+        promise: new Promise((_resolve, reject) => {
+            reject_ = reject;
+            if (abortSignal.aborted) {
+                abort();
+                return;
+            }
+            abortSignal.addEventListener("abort", abort, {
+                once: true,
+            });
+        }),
+        abort,
+    };
+}
+/**
+ * @internal
+ */
+export async function abortAndFail(asyncFn, abortSignal) {
+    if (abortSignal.aborted) {
+        throw new AbortAsyncError(`Promise was aborted with reason of "${String(abortSignal.reason)}"`, abortSignal.reason);
+    }
+    const { promise: abortSignalPromise, abort } = abortSignalToPromise(abortSignal);
+    try {
+        return await Promise.race([asyncFn(), abortSignalPromise]);
+    }
+    finally {
+        abortSignal.removeEventListener("abort", abort);
+    }
+}
+//# sourceMappingURL=abort-and-fail.js.map

package/dist/async/utilities/abort/abort-and-fail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-and-fail.js","sourceRoot":"","sources":["../../../../src/async/utilities/abort/abort-and-fail.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;GAEG;AACH,SAAS,oBAAoB,CACzB,WAAwB;IAKxB,IAAI,OAAO,GAAsC,IAAI,CAAC;IACtD,SAAS,KAAK;QACV,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO;QACX,CAAC;QACD,OAAO,CACH,IAAI,eAAe,CACf,uCAAuC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EACpE,WAAW,CAAC,MAAM,CACrB,CACJ,CAAC;IACN,CAAC;IAED,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO;YACH,OAAO,EAAE,OAAO,CAAC,MAAM,CACnB,IAAI,eAAe,CACf,uCAAuC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EACrE,WAAW,CAAC,MAAM,CACrB,CACJ;YACD,KAAK;SACR,CAAC;IACN,CAAC;IAED,OAAO;QACH,OAAO,EAAE,IAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACtC,OAAO,GAAG,MAAM,CAAC;YACjB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACtB,KAAK,EAAE,CAAC;gBACR,OAAO;YACX,CAAC;YACD,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE;gBACzC,IAAI,EAAE,IAAI;aACb,CAAC,CAAC;QACP,CAAC,CAAC;QACF,KAAK;KACR,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,OAAkC,EAClC,WAAwB;IAExB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,eAAe,CACrB,uCAAuC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EACpE,WAAW,CAAC,MAAM,CACrB,CAAC;IACN,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,GACxC,oBAAoB,CAAS,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC/D,CAAC;YAAS,CAAC;QACP,WAAW,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;AACL,CAAC"}

package/dist/async/utilities/abort/abort.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @module Async
+ */
+import type { Result } from "../../../utilities/types.js";
+import { AbortAsyncError } from "../../../async/async.errors.js";
+/**
+ * @internal
+ */
+export declare function abort<TValue>(asyncFn: () => PromiseLike<TValue>, abortSignal: AbortSignal): Promise<Result<TValue, AbortAsyncError>>;

package/dist/async/utilities/abort/abort.js

@@ -0,0 +1,18 @@
+import { AbortAsyncError } from "../../../async/async.errors.js";
+import { abortAndFail } from "../../../async/utilities/abort/abort-and-fail.js";
+/**
+ * @internal
+ */
+export async function abort(asyncFn, abortSignal) {
+    try {
+        const value = await abortAndFail(asyncFn, abortSignal);
+        return [value, null];
+    }
+    catch (error) {
+        if (error instanceof AbortAsyncError) {
+            return [null, error];
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=abort.js.map

package/dist/async/utilities/abort/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../../../src/async/utilities/abort/abort.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACvB,OAAkC,EAClC,WAAwB;IAExB,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC"}

package/dist/async/utilities/delay/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../async/utilities/delay/delay.js";

package/dist/async/utilities/delay/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../async/utilities/delay/delay.js";
+//# sourceMappingURL=_module.js.map