@daiso-tech/core 0.40.0 → 0.41.1

package/README.md

@@ -31,9 +31,15 @@
 - **EventBus:**
   Easily send events accross different applications or in-memory.
 
-- **Atomic lock:**
+- **Distributed lock:**
   Synchronize the access to a shared resource to prevents several processes, or concurrent code, from executing a section of code at the same time.
 
+- **Distributed semaphore:**
+  A semaphore is a concurrency control primitive used to limit the number of processes or systems that can access a shared resource of code concurrently.
+
+- **Distributed shared lock:**
+  A shared lock (a.k.a reader writer lock) is a concurrency primitive offering better concurrency than a lock by coordinating a reader semaphore for concurrent access and an writer lock for mutual exclusion, strictly preventing conflicting simultaneous access and maintaining data consistency.
+
 - **Serde:**
   Add custom serialization and deserialization logic that seamlessly integrates with all other components.
 
@@ -42,3 +48,4 @@
 
 - **Hooks:**
   Extend any sync and async function with agnostic hooks.@daiso-tech/core includes predefined retry, fallback, timeout and hedging hooks to easily allow handling transient failures.
+

package/dist/backoff-policies/_module-exports.d.ts

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

package/dist/backoff-policies/_module-exports.js

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

package/dist/backoff-policies/_module-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../src/backoff-policies/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uDAAuD,CAAC;AACtE,cAAc,0DAA0D,CAAC;AACzE,cAAc,qDAAqD,CAAC;AACpE,cAAc,yDAAyD,CAAC"}

package/dist/{async/backof-policies → backoff-policies}/_shared.d.ts

@@ -1,21 +1,20 @@
 /**
- * @module Async
+ * @module BackoffPolicy
  */
-import type { Invokable, TimeSpan } from "../../utilities/_module-exports.js";
+import type { ITimeSpan } from "../time-span/contracts/_module-exports.js";
+import type { Invokable } from "../utilities/_module-exports.js";
 /**
  * @returns Amount milliseconds to wait
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export type BackoffPolicy = Invokable<[
     attempt: number,
     error: unknown
-], TimeSpan>;
+], ITimeSpan>;
 /**
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export type DynamicBackoffPolicy<TSettings> = TSettings | Invokable<[error: unknown], TSettings | undefined>;
 /**

package/dist/{async/backof-policies → backoff-policies}/_shared.js

@@ -1,5 +1,5 @@
 /**
- * @module Async
+ * @module BackoffPolicy
  */
 /**
  * @internal

package/dist/backoff-policies/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../src/backoff-policies/_shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH;;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/backoff-policies/constant-backoff-policy/_module.d.ts

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

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

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

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

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

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

@@ -1,18 +1,17 @@
 /**
- * @module Async
+ * @module BackoffPolicy
  */
-import { TimeSpan } from "../../../utilities/_module-exports.js";
-import { type BackoffPolicy, type DynamicBackoffPolicy } from "../../../async/backof-policies/_shared.js";
+import { type BackoffPolicy, type DynamicBackoffPolicy } from "../../backoff-policies/_shared.js";
+import { type ITimeSpan } from "../../time-span/contracts/_module-exports.js";
 /**
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export type ConstantBackoffPolicySettings = {
     /**
      * @default 1000 milliseconds
      */
-    delay?: TimeSpan;
+    delay?: ITimeSpan;
     /**
      * @default 0.5
      */
@@ -26,7 +25,6 @@ export type ConstantBackoffPolicySettings = {
 /**
  * Constant backoff policy with jitter
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export declare function constantBackoffPolicy(settings?: DynamicBackoffPolicy<ConstantBackoffPolicySettings>): BackoffPolicy;

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

@@ -1,13 +1,14 @@
 /**
- * @module Async
+ * @module BackoffPolicy
  */
-import { callInvokable, isInvokable, TimeSpan, } from "../../../utilities/_module-exports.js";
-import { withJitter, } from "../../../async/backof-policies/_shared.js";
+import { callInvokable, isInvokable } from "../../utilities/_module-exports.js";
+import { withJitter, } from "../../backoff-policies/_shared.js";
+import { TO_MILLISECONDS, } from "../../time-span/contracts/_module-exports.js";
+import { TimeSpan } from "../../time-span/implementations/_module-exports.js";
 /**
  * Constant backoff policy with jitter
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export function constantBackoffPolicy(settings = {}) {
     return (_attempt, error) => {
@@ -20,12 +21,9 @@ export function constantBackoffPolicy(settings = {}) {
                 settings = dynamicSettings;
             }
         }
-        let { delay = 1000 } = settings;
-        if (delay instanceof TimeSpan) {
-            delay = delay.toMilliseconds();
-        }
+        const { delay = TimeSpan.fromMilliseconds(100) } = settings;
         const { jitter = 0.5, _mathRandom = Math.random } = settings;
-        return TimeSpan.fromMilliseconds(withJitter(jitter, delay, _mathRandom));
+        return TimeSpan.fromMilliseconds(withJitter(jitter, delay[TO_MILLISECONDS](), _mathRandom));
     };
 }
 //# sourceMappingURL=constant-backoff-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constant-backoff-policy.js","sourceRoot":"","sources":["../../../src/backoff-policies/constant-backoff-policy/constant-backoff-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EACH,UAAU,GAGb,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACH,eAAe,GAElB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAsB1E;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACjC,WAAgE,EAAE;IAElE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QACvB,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,MAAM,eAAe,GAAG,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBAChC,QAAQ,GAAG,EAAE,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACJ,QAAQ,GAAG,eAAe,CAAC;YAC/B,CAAC;QACL,CAAC;QACD,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,GAAG,QAAQ,CAAC;QAE5D,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC7D,OAAO,QAAQ,CAAC,gBAAgB,CAC5B,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,WAAW,CAAC,CAC5D,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}

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

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

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

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

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

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

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

@@ -1,22 +1,21 @@
 /**
- * @module Async
+ * @module BackoffPolicy
  */
-import { TimeSpan } from "../../../utilities/_module-exports.js";
-import type { BackoffPolicy, DynamicBackoffPolicy } from "../../../async/backof-policies/_shared.js";
+import type { BackoffPolicy, DynamicBackoffPolicy } from "../../backoff-policies/_shared.js";
+import { type ITimeSpan } from "../../time-span/contracts/_module-exports.js";
 /**
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export type ExponentialBackoffPolicySettings = {
     /**
      * @default 60_000 milliseconds
      */
-    maxDelay?: TimeSpan;
+    maxDelay?: ITimeSpan;
     /**
      * @default 1_000 milliseconds
      */
-    minDelay?: TimeSpan;
+    minDelay?: ITimeSpan;
     /**
      * @default 2
      */
@@ -34,7 +33,6 @@ export type ExponentialBackoffPolicySettings = {
 /**
  * Exponential backoff policy with jitter
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export declare function exponentialBackoffPolicy(settings?: DynamicBackoffPolicy<ExponentialBackoffPolicySettings>): BackoffPolicy;

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

@@ -0,0 +1,30 @@
+/**
+ * @module BackoffPolicy
+ */
+import { callInvokable, isInvokable } from "../../utilities/_module-exports.js";
+import { withJitter } from "../../backoff-policies/_shared.js";
+import { TO_MILLISECONDS, } from "../../time-span/contracts/_module-exports.js";
+import { TimeSpan } from "../../time-span/implementations/_module-exports.js";
+/**
+ * Exponential backoff policy with jitter
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
+ */
+export function exponentialBackoffPolicy(settings = {}) {
+    return (attempt, error) => {
+        if (isInvokable(settings)) {
+            const dynamicSettings = callInvokable(settings, error);
+            if (dynamicSettings === undefined) {
+                settings = {};
+            }
+            else {
+                settings = dynamicSettings;
+            }
+        }
+        const { maxDelay = TimeSpan.fromMilliseconds(60_000), minDelay = TimeSpan.fromMilliseconds(1_000), } = settings;
+        const { multiplier = 2, jitter = 0.5, _mathRandom = Math.random, } = settings;
+        const exponential = Math.min(maxDelay[TO_MILLISECONDS](), minDelay[TO_MILLISECONDS]() * Math.pow(multiplier, attempt));
+        return TimeSpan.fromMilliseconds(withJitter(jitter, exponential, _mathRandom));
+    };
+}
+//# sourceMappingURL=exponential-backoff-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exponential-backoff-policy.js","sourceRoot":"","sources":["../../../src/backoff-policies/exponential-backoff-policy/exponential-backoff-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK5E,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EACH,eAAe,GAElB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AA8B1E;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACpC,WAAmE,EAAE;IAErE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACtB,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,MAAM,eAAe,GAAG,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBAChC,QAAQ,GAAG,EAAE,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACJ,QAAQ,GAAG,eAAe,CAAC;YAC/B,CAAC;QACL,CAAC;QACD,MAAM,EACF,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAC5C,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAC9C,GAAG,QAAQ,CAAC;QAEb,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,CAAC,eAAe,CAAC,EAAE,EAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAC9D,CAAC;QACF,OAAO,QAAQ,CAAC,gBAAgB,CAC5B,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAC/C,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}

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

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

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

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

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

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

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

@@ -1,22 +1,21 @@
 /**
- * @module Async
+ * @module BackoffPolicy
  */
-import { TimeSpan } from "../../../utilities/_module-exports.js";
-import type { BackoffPolicy, DynamicBackoffPolicy } from "../../../async/backof-policies/_shared.js";
+import type { BackoffPolicy, DynamicBackoffPolicy } from "../../backoff-policies/_shared.js";
+import { type ITimeSpan } from "../../time-span/contracts/_module-exports.js";
 /**
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export type LinearBackoffPolicySettings = {
     /**
      * @default 6000 milliseconds
      */
-    maxDelay?: TimeSpan;
+    maxDelay?: ITimeSpan;
     /**
      * @default 1_000 milliseconds
      */
-    minDelay?: TimeSpan;
+    minDelay?: ITimeSpan;
     /**
      * @default 0.5
      */
@@ -30,7 +29,6 @@ export type LinearBackoffPolicySettings = {
 /**
  * Linear backoff policy with jitter
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export declare function linearBackoffPolicy(settings?: DynamicBackoffPolicy<LinearBackoffPolicySettings>): BackoffPolicy;

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

@@ -0,0 +1,30 @@
+/**
+ * @module BackoffPolicy
+ */
+import { callInvokable, isInvokable } from "../../utilities/_module-exports.js";
+import { withJitter } from "../../backoff-policies/_shared.js";
+import { TimeSpan } from "../../time-span/implementations/_module-exports.js";
+import { TO_MILLISECONDS, } from "../../time-span/contracts/_module-exports.js";
+/**
+ * Linear backoff policy with jitter
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
+ */
+export function linearBackoffPolicy(settings = {}) {
+    return (attempt, error) => {
+        if (isInvokable(settings)) {
+            const dynamicSettings = callInvokable(settings, error);
+            if (dynamicSettings === undefined) {
+                settings = {};
+            }
+            else {
+                settings = dynamicSettings;
+            }
+        }
+        const { maxDelay = TimeSpan.fromMilliseconds(6000), minDelay = TimeSpan.fromMilliseconds(1_000), } = settings;
+        const { jitter = 0.5, _mathRandom = Math.random } = settings;
+        const linear = Math.min(maxDelay[TO_MILLISECONDS](), minDelay[TO_MILLISECONDS]() * attempt);
+        return TimeSpan.fromMilliseconds(withJitter(jitter, linear, _mathRandom));
+    };
+}
+//# sourceMappingURL=linear-backoff-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linear-backoff-policy.js","sourceRoot":"","sources":["../../../src/backoff-policies/linear-backoff-policy/linear-backoff-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK5E,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EACH,eAAe,GAElB,MAAM,0CAA0C,CAAC;AA0BlD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAC/B,WAA8D,EAAE;IAEhE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACtB,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,MAAM,eAAe,GAAG,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBAChC,QAAQ,GAAG,EAAE,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACJ,QAAQ,GAAG,eAAe,CAAC;YAC/B,CAAC;QACL,CAAC;QACD,MAAM,EACF,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAC1C,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAC9C,GAAG,QAAQ,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CACnB,QAAQ,CAAC,eAAe,CAAC,EAAE,EAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,OAAO,CACxC,CAAC;QACF,OAAO,QAAQ,CAAC,gBAAgB,CAC5B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAC1C,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}

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

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

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

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

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

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

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

@@ -1,22 +1,21 @@
 /**
- * @module Async
+ * @module BackoffPolicy
  */
-import { TimeSpan } from "../../../utilities/_module-exports.js";
-import type { BackoffPolicy, DynamicBackoffPolicy } from "../../../async/backof-policies/_shared.js";
+import type { BackoffPolicy, DynamicBackoffPolicy } from "../../backoff-policies/_shared.js";
+import { type ITimeSpan } from "../../time-span/contracts/_module-exports.js";
 /**
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export type PolynomialBackoffPolicySettings = {
     /**
      * @default 60_000 milliseconds
      */
-    maxDelay?: TimeSpan;
+    maxDelay?: ITimeSpan;
     /**
      * @default 1_000 milliseconds
      */
-    minDelay?: TimeSpan;
+    minDelay?: ITimeSpan;
     /**
      * @default 2
      */
@@ -34,7 +33,6 @@ export type PolynomialBackoffPolicySettings = {
 /**
  * Polynomial backoff policy with jitter
  *
- * IMPORT_PATH: `"@daiso-tech/core/async"`
- * @group BackoffPolicies
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
  */
 export declare function polynomialBackoffPolicy(settings?: DynamicBackoffPolicy<PolynomialBackoffPolicySettings>): BackoffPolicy;

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

@@ -0,0 +1,30 @@
+/**
+ * @module BackoffPolicy
+ */
+import { callInvokable, isInvokable } from "../../utilities/_module-exports.js";
+import { withJitter } from "../../backoff-policies/_shared.js";
+import { TO_MILLISECONDS, } from "../../time-span/contracts/_module-exports.js";
+import { TimeSpan } from "../../time-span/implementations/_module-exports.js";
+/**
+ * Polynomial backoff policy with jitter
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/backoff-policies"`
+ */
+export function polynomialBackoffPolicy(settings = {}) {
+    return (attempt, error) => {
+        if (isInvokable(settings)) {
+            const dynamicSettings = callInvokable(settings, error);
+            if (dynamicSettings === undefined) {
+                settings = {};
+            }
+            else {
+                settings = dynamicSettings;
+            }
+        }
+        const { maxDelay = TimeSpan.fromMilliseconds(6000), minDelay = TimeSpan.fromMilliseconds(1_000), } = settings;
+        const { degree = 2, jitter = 0.5, _mathRandom = Math.random, } = settings;
+        const polynomial = Math.min(maxDelay[TO_MILLISECONDS](), minDelay[TO_MILLISECONDS]() * Math.pow(attempt, degree));
+        return TimeSpan.fromMilliseconds(withJitter(jitter, polynomial, _mathRandom));
+    };
+}
+//# sourceMappingURL=polynomial-backoff-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polynomial-backoff-policy.js","sourceRoot":"","sources":["../../../src/backoff-policies/polynomial-backoff-policy/polynomial-backoff-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK5E,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EACH,eAAe,GAElB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AA8B1E;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACnC,WAAkE,EAAE;IAEpE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACtB,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,MAAM,eAAe,GAAG,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBAChC,QAAQ,GAAG,EAAE,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACJ,QAAQ,GAAG,eAAe,CAAC;YAC/B,CAAC;QACL,CAAC;QACD,MAAM,EACF,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAC1C,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAC9C,GAAG,QAAQ,CAAC;QACb,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,CAAC,eAAe,CAAC,EAAE,EAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAC1D,CAAC;QACF,OAAO,QAAQ,CAAC,gBAAgB,CAC5B,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAC9C,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}

package/dist/cache/contracts/cache-adapter.contract.d.ts

@@ -1,9 +1,9 @@
 /**
  * @module Cache
  */
-import type { TimeSpan } from "../../utilities/_module-exports.js";
+import type { TimeSpan } from "../../time-span/implementations/_module-exports.js";
 /**
- * The `ICacheAdapter` contract defines a way for key-value pairs independent of data storage.
+ * The `ICacheAdapter` contract defines a way for storing key-value pairs with expiration independent of data storage.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Contracts
@@ -36,7 +36,7 @@ export type ICacheAdapter<TType = unknown> = {
      * The `increment` method increments the given `key` with given `value`. Returns true if the `key` where incremented otherwise false will be returned.
      * If `values` is not defined then it will increment the key with 1.
      * An error will thrown if the key is not a number.
-     * @throws {TypeCacheError} {@link TypeCacheError}
+     * @throws {TypeError} {@link TypeError}
      */
     increment(key: string, value: number): Promise<boolean>;
     /**

package/dist/cache/contracts/cache.contract.d.ts

@@ -1,11 +1,11 @@
 /**
  * @module Cache
  */
-import type { LazyPromise } from "../../async/_module-exports.js";
-import type { TimeSpan } from "../../utilities/_module-exports.js";
-import type { AsyncLazyable, NoneFunc, OneOrMore } from "../../utilities/_module-exports.js";
+import type { Task } from "../../task/_module-exports.js";
+import type { AsyncLazyable, NoneFunc } from "../../utilities/_module-exports.js";
 import type { CacheEventMap } from "../../cache/contracts/cache.events.js";
 import type { IEventListenable } from "../../event-bus/contracts/_module-exports.js";
+import type { ITimeSpan } from "../../time-span/contracts/_module-exports.js";
 /**
  * The `ICacheListenable` contract defines a way for listening {@link ICache | `ICache`} operation events.
  *
@@ -27,7 +27,7 @@ export type ICacheBase<TType = unknown> = {
      * If it's an `Iterable`, it will be joined into a single string.
      * Think of an `Iterable` as representing a path.
      */
-    exists(key: OneOrMore<string>): LazyPromise<boolean>;
+    exists(key: string): Task<boolean>;
     /**
      * The `missing` method returns true when `key` is not found otherwise false will be returned.
      *
@@ -35,7 +35,7 @@ export type ICacheBase<TType = unknown> = {
      * If it's an `Iterable`, it will be joined into a single string.
      * Think of an `Iterable` as representing a path.
      */
-    missing(key: OneOrMore<string>): LazyPromise<boolean>;
+    missing(key: string): Task<boolean>;
     /**
      * The `get` method returns the value when `key` is found otherwise null will be returned.
      *
@@ -43,7 +43,7 @@ export type ICacheBase<TType = unknown> = {
      * If it's an `Iterable`, it will be joined into a single string.
      * Think of an `Iterable` as representing a path.
      */
-    get(key: OneOrMore<string>): LazyPromise<TType | null>;
+    get(key: string): Task<TType | null>;
     /**
      * The `getOrFail` method returns the value when `key` is found otherwise an error will be thrown.
      *
@@ -53,7 +53,7 @@ export type ICacheBase<TType = unknown> = {
      *
      * @throws {KeyNotFoundCacheError} {@link KeyNotFoundCacheError}
      */
-    getOrFail(key: OneOrMore<string>): LazyPromise<TType>;
+    getOrFail(key: string): Task<TType>;
     /**
      * The `getAndRemove` method returns the value when `key` is found otherwise null will be returned.
      * The key will be removed after it is returned.
@@ -62,7 +62,7 @@ export type ICacheBase<TType = unknown> = {
      * If it's an `Iterable`, it will be joined into a single string.
      * Think of an `Iterable` as representing a path.
      */
-    getAndRemove(key: OneOrMore<string>): LazyPromise<TType | null>;
+    getAndRemove(key: string): Task<TType | null>;
     /**
      * The `getOr` method will retrieve the given `key` if found otherwise `defaultValue` will be returned.
      *
@@ -70,9 +70,9 @@ export type ICacheBase<TType = unknown> = {
      * If it's an `Iterable`, it will be joined into a single string.
      * Think of an `Iterable` as representing a path.
      *
-     * @param defaultValue - can be regular value, sync or async {@link Invokable | `Invokable`} value and {@link LazyPromise| `LazyPromise`} value.
+     * @param defaultValue - can be regular value, sync or async {@link Invokable | `Invokable`} value and {@link Task | `Task`} value.
      */
-    getOr(key: OneOrMore<string>, defaultValue: AsyncLazyable<NoneFunc<TType>>): LazyPromise<TType>;
+    getOr(key: string, defaultValue: AsyncLazyable<NoneFunc<TType>>): Task<TType>;
     /**
      * The `getOrAdd` method will retrieve the given `key` if found otherwise `valueToAdd` will be added and returned.
      *
@@ -80,9 +80,9 @@ export type ICacheBase<TType = unknown> = {
      * If it's an `Iterable`, it will be joined into a single string.
      * Think of an `Iterable` as representing a path.
      *
-     * @param valueToAdd - can be regular value, sync or async {@link Invokable | `Invokable`} value and {@link LazyPromise| `LazyPromise`} value.
+     * @param valueToAdd - can be regular value, sync or async {@link Invokable | `Invokable`} value and {@link Task | `Task`} value.
      */
-    getOrAdd(key: OneOrMore<string>, valueToAdd: AsyncLazyable<NoneFunc<TType>>, ttl?: TimeSpan | null): LazyPromise<TType>;
+    getOrAdd(key: string, valueToAdd: AsyncLazyable<NoneFunc<TType>>, ttl?: ITimeSpan | null): Task<TType>;
     /**
      * The `add` method adds a `key` with given `value` when key doesn't exists.
      *
@@ -94,7 +94,7 @@ export type ICacheBase<TType = unknown> = {
      *
      * @returns Returns true when key doesn't exists otherwise false will be returned.
      */
-    add(key: OneOrMore<string>, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;
+    add(key: string, value: TType, ttl?: ITimeSpan | null): Task<boolean>;
     /**
      * The `put` method replaces th given `key` with the given `value` and `ttl` if the `key` exists
      * othwerwise it will add the given `value` with the given `ttl`.
@@ -107,7 +107,7 @@ export type ICacheBase<TType = unknown> = {
      *
      * @returns Returns true if the `key` where replaced otherwise false is returned.
      */
-    put(key: OneOrMore<string>, value: TType, ttl?: TimeSpan | null): LazyPromise<boolean>;
+    put(key: string, value: TType, ttl?: ITimeSpan | null): Task<boolean>;
     /**
      * The `update` method updates the given `key` with given `value`.
      *
@@ -117,7 +117,7 @@ export type ICacheBase<TType = unknown> = {
      *
      * @returns Returns true if the `key` where updated otherwise false will be returned.
      */
-    update(key: OneOrMore<string>, value: TType): LazyPromise<boolean>;
+    update(key: string, value: TType): Task<boolean>;
     /**
      * The `increment` method increments the given `key` with given `value`.
      * An error will thrown if the key is not a number.
@@ -130,9 +130,9 @@ export type ICacheBase<TType = unknown> = {
      *
      * @returns Returns true if the `key` where incremented otherwise false will be returned.
      *
-     * @throws {TypeCacheError} {@link TypeCacheError}
+     * @throws {TypeError} {@link TypeError}
      */
-    increment(key: OneOrMore<string>, value?: Extract<TType, number>): LazyPromise<boolean>;
+    increment(key: string, value?: Extract<TType, number>): Task<boolean>;
     /**
      * The `decrement` method decrements the given `key` with given `value`.
      * An error will thrown if the key is not a number.
@@ -145,9 +145,9 @@ export type ICacheBase<TType = unknown> = {
      *
      * @returns Returns true if the `key` where decremented otherwise false will be returned.
      *
-     * @throws {TypeCacheError} {@link TypeCacheError}
+     * @throws {TypeError} {@link TypeError}
      */
-    decrement(key: OneOrMore<string>, value?: Extract<TType, number>): LazyPromise<boolean>;
+    decrement(key: string, value?: Extract<TType, number>): Task<boolean>;
     /**
      * The `remove` method removes the given `key`.
      *
@@ -157,7 +157,7 @@ export type ICacheBase<TType = unknown> = {
      *
      * @returns Returns true if the key is found otherwise false is returned.
      */
-    remove(key: OneOrMore<string>): LazyPromise<boolean>;
+    remove(key: string): Task<boolean>;
     /**
      * The `removeMany` method removes many keys.
      *
@@ -167,11 +167,11 @@ export type ICacheBase<TType = unknown> = {
      *
      * @returns Returns true if one of the keys where deleted otherwise false is returned.
      */
-    removeMany(keys: Iterable<OneOrMore<string>>): LazyPromise<boolean>;
+    removeMany(keys: Iterable<string>): Task<boolean>;
     /**
      * The `clear` method removes all the keys in the cache. If a cache is in a group then only the keys part of the group will be removed.
      */
-    clear(): LazyPromise<void>;
+    clear(): Task<void>;
 };
 /**
  * The `ICache` contract defines a way for as key-value pairs independent of data storage and listening to operation events.