@daiso-tech/core 0.33.0 → 0.35.0

package/README.md

@@ -1,51 +1,72 @@
 # @daiso-tech/core
 
-## Installation
+[![npm version](https://img.shields.io/npm/v/@daiso-tech/core)](https://www.npmjs.com/package/@daiso-tech/core)
+![NPM Downloads](https://img.shields.io/npm/dy/@daiso-tech/core)
+![Static Badge](https://img.shields.io/badge/TypeScript-3178C6?logo=TypeScript&logoColor=white)
+[![ES Modules](https://img.shields.io/badge/module%20type-ESM-blue)](https://nodejs.org/api/esm.html)
+[![License](https://img.shields.io/npm/l/@daiso-tech/core)](LICENSE)
+
+
+A modular, framework-agnostic library providing essential components for modern web applications. Stop reinventing the wheel - focus on building your application while the library handles the core functionalities.
+
+## ✨ Features
+
+### Current Features
+
+-   **Immutable Collections**:
+
+    -   `IterableCollection` - Simplifies work with `Iterable`
+    -   `ListCollection` - Simplifies work with `Array`
+    -   `AsyncIterableCollection` - Simplifies work with `AsyncIterable`
+
+-   **Middleware System**
+    -   Agnostic middlewares applicable to any async/sync functions.
+        -   `fallback`: Automatic recovery with default values on errors
+        -   `observe`: Monitor function execution and performance
+        -   `retry`: Smart retries with multiple backoff policies:
+            -   `constantBackoffPolicy`
+            -   `exponentialBackoffPolicy`
+            -   `linearBackoffPolicy`
+            -   `polynomialBackoffPolicy`
+        -   `sequentialHedging`: Runs fallbacks sequentially if the primary function fails, ensuring graceful failure handling.
+        -   `concurrentHedging`: Executes the primary function alongside fallbacks concurrently, returning the first successful result and aborting all remaining operations.
+        -   `timeout`: Guaranteed execution time limits
+-   **LazyPromise**:
+    -   Executes only when awaited
+    -   With middleware support
+-   **Pluggable Components**:
+    -   `Cache` with adapter support
+    -   `Lock` with adapter support
+    -   `EventBus` with adapter support
+    -   `Serde` (serializer, deserializer) adapters
+
+### Planned Features
+
+-   Query bus
+-   Command bus
+-   Semaphore component
+-   SharedLock (ReaderWriterLock)
+-   RateLimiter
+-   CircuitBreaker
+-   MessageQueue
+-   TaskScheduler
+-   Notification system
+-   Abstract file system
+
+## 🚀 Installation
+
 ```bash
 npm install @daiso-tech/core
 ```
 
-## Description
-The library provides modular solutions for the essential features needed in modern web applications. Stop wasting time searching for packages or reinventing the wheel — this framework-agnostic library, built on adaptable components, works well with popular frameworks like Express.js, Fastify, Next.js, Nuxt.js, SvelteKit, and Remix.
-
-### Current Library Features:
-- Immutable collection components:
-  - Immutable <i>IterableCollection</i> that simplifies working with <i>Iterable</i>.
-  - Immutable <i>ListCollection</i> that simplifies working with <i>Array</i>.
-  - Immutable <i>AsyncIterableCollection</i> that simplifies working with <i>AsyncIterable</i>.
-- LazyPromise with support for: 
-  - Aborting it manually by using <i>AbortSignal</i>.
-  - Aborting it by timeout.
-  - Easily retrying when it fails
-- Cache component with support for pluggable adapters.
-- Lock component with supports for pluggable adapters.
-- EventBus component with support for pluggable adapters.
-
-### In the future the following components will be added:
-- Command bus
-- Semaphore component
-- SharedLock (ReaderWriterLock) component
-- RateLimter component
-- CircuitBreaker component
-- MessageQueue component
-- TaskScheduler component
-- Notification component
-- Abstract file system component 
-
-#### NOTE !!: This library only supports ESM (ecmascript) module.
-
-#### NOTE !!: This library is under construction and breaking changes can occur.
-
-### Inspiration
-This library is inspired by [Laravel](https://laravel.com/docs/11.x/readme) and built with a modular design, so you can use only the parts you need.
-
-It also integrates ideas from other libraries:
-- [Symfony components](https://symfony.com/components), PHP
-- [Verrou](https://verrou.dev/docs/introduction), TypeScript
-- [Distributed lock](https://github.com/ZiggyCreatures/FusionCache), C#
-- [Bento cache](https://bentocache.dev/docs/introduction), TypeScript
-- [Fusion cache](https://github.com/ZiggyCreatures/FusionCache), C#
-- [Polly](https://www.pollydocs.org/), C#
-
-
-### Visit the [docs](https://yousif-khalil-abdulkarim.github.io/daiso-core/) for more information!
+## Inspired By
+
+Built with ideas from:
+
+-   [Laravel](https://laravel.com/docs/11.x/readme), PHP
+-   [Symfony components](https://symfony.com/components), PHP
+-   [Verrou](https://verrou.dev/docs/introduction), TypeScript
+-   [Distributed lock](https://github.com/ZiggyCreatures/FusionCache), C#
+-   [Bento cache](https://bentocache.dev/docs/introduction), TypeScript
+-   [Fusion cache](https://github.com/ZiggyCreatures/FusionCache), C#
+-   [Polly](https://www.pollydocs.org/), C#

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

@@ -1,4 +1,4 @@
 export * from "../async/backof-policies/_module.js";
+export * from "../async/middlewares/_module.js";
 export * from "../async/utilities/_module.js";
 export * from "../async/async.errors.js";
-export * from "../async/async.events.js";

package/dist/async/_module-exports.js

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

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

@@ -1 +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;AACxC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../src/async/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC"}

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

@@ -3,25 +3,15 @@
  */
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
 export declare class AsyncError extends Error {
     constructor(message: string, cause?: unknown);
 }
 /**
- * This error is thrown when the <i>LazyPromise</i> is aborted.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
- * @group Errors
- */
-export declare class AbortAsyncError extends AsyncError {
-    constructor(message: string, cause?: unknown);
-}
-/**
- * This error is thrown when the <i>LazyPromise</i> has exceeded the given time limit.
- *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
 export declare class TimeoutAsyncError extends AsyncError {
@@ -29,31 +19,49 @@ export declare class TimeoutAsyncError extends AsyncError {
 }
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
 export type RetryAsyncErrorData = {
-    cause?: unknown;
+    errors: unknown[];
     maxAttempts: number;
 };
 /**
- * This error is thrown when the <i>LazyPromise</i> has failed all retry attempts.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
 export declare class RetryAsyncError extends AsyncError {
     readonly maxAttempts: number;
-    constructor(message: string, { cause, maxAttempts }: RetryAsyncErrorData);
+    readonly errors: unknown[];
+    constructor(message: string, { errors, maxAttempts }: RetryAsyncErrorData);
+}
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Errors
+ */
+export declare class HedgingAsyncError extends AsyncError {
+    readonly errors: unknown[];
+    constructor(message: string, errors: unknown[]);
+}
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Errors
+ */
+export declare class CapacityFullAsyncError extends AsyncError {
+    constructor(message: string, cause?: unknown);
 }
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
 export declare const ASYNC_ERRORS: {
     readonly Base: typeof AsyncError;
-    readonly Abort: typeof AbortAsyncError;
     readonly Timeout: typeof TimeoutAsyncError;
     readonly Retry: typeof RetryAsyncError;
+    readonly Hedging: typeof HedgingAsyncError;
+    readonly CapacityFull: typeof CapacityFullAsyncError;
 };

package/dist/async/async.errors.js

@@ -3,7 +3,7 @@
  */
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
 export class AsyncError extends Error {
@@ -13,52 +13,65 @@ export class AsyncError extends Error {
     }
 }
 /**
- * This error is thrown when the <i>LazyPromise</i> is aborted.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
-export class AbortAsyncError extends AsyncError {
+export class TimeoutAsyncError extends AsyncError {
     constructor(message, cause) {
         super(message, cause);
-        this.name = AbortAsyncError.name;
+        this.name = TimeoutAsyncError.name;
     }
 }
 /**
- * This error is thrown when the <i>LazyPromise</i> has exceeded the given time limit.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
-export class TimeoutAsyncError extends AsyncError {
-    constructor(message, cause) {
-        super(message, cause);
-        this.name = TimeoutAsyncError.name;
+export class RetryAsyncError extends AsyncError {
+    maxAttempts;
+    errors = [];
+    constructor(message, { errors, maxAttempts }) {
+        super(message, errors);
+        this.errors = errors;
+        this.maxAttempts = maxAttempts;
+        this.name = RetryAsyncError.name;
     }
 }
 /**
- * This error is thrown when the <i>LazyPromise</i> has failed all retry attempts.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
-export class RetryAsyncError extends AsyncError {
-    maxAttempts;
-    constructor(message, { cause, maxAttempts }) {
+export class HedgingAsyncError extends AsyncError {
+    errors;
+    constructor(message, errors) {
+        super(message, errors);
+        this.errors = errors;
+        this.name = HedgingAsyncError.name;
+    }
+}
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Errors
+ */
+export class CapacityFullAsyncError extends AsyncError {
+    constructor(message, cause) {
         super(message, cause);
-        this.name = RetryAsyncError.name;
-        this.maxAttempts = maxAttempts;
+        this.name = CapacityFullAsyncError.name;
     }
 }
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group Errors
  */
 export const ASYNC_ERRORS = {
     Base: AsyncError,
-    Abort: AbortAsyncError,
     Timeout: TimeoutAsyncError,
     Retry: RetryAsyncError,
+    Hedging: HedgingAsyncError,
+    CapacityFull: CapacityFullAsyncError,
 };
 //# sourceMappingURL=async.errors.js.map

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

@@ -1 +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;;;;;GAKG;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;;;;;GAKG;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;;;;;GAKG;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;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,iBAAiB;IAC1B,KAAK,EAAE,eAAe;CAChB,CAAC"}
+{"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,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;IAEpB,MAAM,GAAc,EAAE,CAAC;IAEvC,YAAY,OAAe,EAAE,EAAE,MAAM,EAAE,WAAW,EAAuB;QACrE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACrC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAGzB;IAFpB,YACI,OAAe,EACC,MAAiB;QAEjC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAFP,WAAM,GAAN,MAAM,CAAW;QAGjC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACvC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IAClD,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAC5C,CAAC;CACJ;AACD;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,iBAAiB;IAC1B,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,iBAAiB;IAC1B,YAAY,EAAE,sBAAsB;CAC9B,CAAC"}

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

@@ -1,13 +1,17 @@
 /**
  * @module Async
  */
+import type { Invokable } from "../../utilities/_module-exports.js";
 /**
  * @returns Amount milliseconds to wait
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
-export type BackoffPolicy = (attempt: number, error: unknown) => number;
+export type BackoffPolicy = Invokable<[
+    attempt: number,
+    error: unknown
+], number>;
 /**
  * @internal
  */

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

@@ -1,6 +1,7 @@
 /**
  * @module Async
  */
+// (attempt: number, error: unknown) => number;
 /**
  * @internal
  */

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

@@ -1 +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"}
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/async/backof-policies/_shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,+CAA+C;AAE/C;;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/constant-backoff-policy.d.ts

@@ -5,7 +5,7 @@ import { TimeSpan } from "../../../utilities/_module-exports.js";
 import { type BackoffPolicy } from "../../../async/backof-policies/_shared.js";
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export type ConstantBackoffPolicySettings = {
@@ -26,7 +26,7 @@ export type ConstantBackoffPolicySettings = {
 /**
  * Constant backoff policy with jitter
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export declare function constantBackoffPolicy(settings?: ConstantBackoffPolicySettings | ((error: unknown) => ConstantBackoffPolicySettings)): BackoffPolicy;

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

@@ -6,7 +6,7 @@ import { withJitter, } from "../../../async/backof-policies/_shared.js";
 /**
  * Constant backoff policy with jitter
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export function constantBackoffPolicy(settings = {}) {

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

@@ -5,7 +5,7 @@ import { TimeSpan } from "../../../utilities/_module-exports.js";
 import type { BackoffPolicy } from "../../../async/backof-policies/_shared.js";
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export type ExponentialBackoffPolicySettings = {
@@ -34,7 +34,7 @@ export type ExponentialBackoffPolicySettings = {
 /**
  * Exponential backoff policy with jitter
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export declare function exponentialBackoffPolicy(settings?: ExponentialBackoffPolicySettings | ((error: unknown) => ExponentialBackoffPolicySettings)): BackoffPolicy;

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

@@ -6,7 +6,7 @@ import { withJitter } from "../../../async/backof-policies/_shared.js";
 /**
  * Exponential backoff policy with jitter
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export function exponentialBackoffPolicy(settings = {}) {

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

@@ -5,7 +5,7 @@ import { TimeSpan } from "../../../utilities/_module-exports.js";
 import type { BackoffPolicy } from "../../../async/backof-policies/_shared.js";
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export type LinearBackoffPolicySettings = {
@@ -30,7 +30,7 @@ export type LinearBackoffPolicySettings = {
 /**
  * Linear backoff policy with jitter
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export declare function linearBackoffPolicy(settings?: LinearBackoffPolicySettings | ((error: unknown) => LinearBackoffPolicySettings)): BackoffPolicy;

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

@@ -6,7 +6,7 @@ import { withJitter } from "../../../async/backof-policies/_shared.js";
 /**
  * Linear backoff policy with jitter
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export function linearBackoffPolicy(settings = {}) {

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

@@ -5,7 +5,7 @@ import { TimeSpan } from "../../../utilities/_module-exports.js";
 import type { BackoffPolicy } from "../../../async/backof-policies/_shared.js";
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export type PolynomialBackoffPolicySettings = {
@@ -34,7 +34,7 @@ export type PolynomialBackoffPolicySettings = {
 /**
  * Polynomial backoff policy with jitter
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export declare function polynomialBackoffPolicy(settings?: PolynomialBackoffPolicySettings | ((error: unknown) => PolynomialBackoffPolicySettings)): BackoffPolicy;

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

@@ -6,7 +6,7 @@ import { withJitter } from "../../../async/backof-policies/_shared.js";
 /**
  * Polynomial backoff policy with jitter
  *
- * IMPORT_PATH: ```"@daiso-tech/core/async"```
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
  * @group BackoffPolicies
  */
 export function polynomialBackoffPolicy(settings = {}) {

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

@@ -0,0 +1,8 @@
+export * from "../../async/middlewares/bulkhead/_module.js";
+export * from "../../async/middlewares/dynamic/_module.js";
+export * from "../../async/middlewares/fallback/_module.js";
+export * from "../../async/middlewares/hedging/_module.js";
+export * from "../../async/middlewares/observe/_module.js";
+export * from "../../async/middlewares/retry/_module.js";
+export * from "../../async/middlewares/timeout/_module.js";
+export * from "../../async/middlewares/_shared.js";

package/dist/async/middlewares/_module.js

@@ -0,0 +1,9 @@
+export * from "../../async/middlewares/bulkhead/_module.js";
+export * from "../../async/middlewares/dynamic/_module.js";
+export * from "../../async/middlewares/fallback/_module.js";
+export * from "../../async/middlewares/hedging/_module.js";
+export * from "../../async/middlewares/observe/_module.js";
+export * from "../../async/middlewares/retry/_module.js";
+export * from "../../async/middlewares/timeout/_module.js";
+export * from "../../async/middlewares/_shared.js";
+//# sourceMappingURL=_module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/async/middlewares/_module.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,gCAAgC,CAAC"}

package/dist/async/middlewares/_shared.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @module Async
+ */
+import { type Invokable } from "../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type ErrorPolicy = Invokable<[error: unknown], boolean>;

package/dist/async/middlewares/_shared.js

@@ -0,0 +1,5 @@
+/**
+ * @module Async
+ */
+import {} from "../../utilities/_module-exports.js";
+//# sourceMappingURL=_shared.js.map

package/dist/async/middlewares/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/async/middlewares/_shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAkB,MAAM,gCAAgC,CAAC"}

package/dist/async/middlewares/bulkhead/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../async/middlewares/bulkhead/bulkhead.middleware.js";

package/dist/async/middlewares/bulkhead/_module.js

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

package/dist/async/middlewares/bulkhead/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/async/middlewares/bulkhead/_module.ts"],"names":[],"mappings":"AAAA,cAAc,qDAAqD,CAAC"}

package/dist/async/middlewares/bulkhead/bulkhead.middleware.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @module Async
+ */
+import { TimeSpan, type AsyncMiddlewareFn, type HookContext, type Invokable } from "../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type OnProcessingData<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    args: TParameters;
+    context: TContext;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type OnProcessing<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = Invokable<[data: OnProcessingData<TParameters, TContext>]>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type BulkheadCallbacks<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = {
+    onProcessing?: OnProcessing<TParameters, TContext>;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ */
+export type BulkheadSettings<TParameters extends unknown[] = unknown[], TContext extends HookContext = HookContext> = BulkheadCallbacks<TParameters, TContext> & {
+    /**
+     * The maximum number of promises allowed to run concurrently. If this limit is exceeded, additional promises will be queued until a slot becomes available.
+     *
+     * @default {25}
+     */
+    maxConcurrency?: number;
+    /**
+     * The maximum capacity of the promise queue. If null, the queue can grow indefinitely.
+     * If a number is provided and the queue exceeds this limit, an error will be thrown, and no further promises will be enqueued.
+     *
+     * @default {null}
+     */
+    maxCapacity?: number | null;
+    /**
+     * @default
+     * ```ts
+     * import { TimeSpan } from "@daiso-tech/core/utilities";
+     *
+     * TimeSpan.fromMilliseconds(0)
+     * ```
+     */
+    interval?: TimeSpan;
+};
+/**
+ * The `bulkhead` middlewares ensures that a given amount of {@link Promiselike | `PromiseLike`} objects run at the same time concurrently and the rest will be queued up.
+ * You can provide {@link BulkheadSettings | `settings.maxCapacity`}
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/async"`
+ * @group Middleware
+ * @throws {CapacityFullAsyncError} {@link CapacityFullAsyncError}
+ * ```ts
+ * import { bulkhead } from "@daiso-tech/core/async";
+ * import { AsyncHooks } from "@daiso-tech/core/utilities";
+ *
+ * const fetchData = new AsyncHooks(async (url: string): Promise<unknown> => {
+ *   const response = await fetch(url);
+ *   const json = await response.json();
+ *   return json;
+ * }, [
+ *   bulkhead()
+ * ]);
+ *
+ * // Will run only 25 promises concurrently by default.
+ * await Promise.all(Array(50).fill("").map(() => fetchData.invoke("URL")));
+ * ```
+ */
+export declare function bulkhead<TParameters extends unknown[], TReturn, TContext extends HookContext>(settings?: BulkheadSettings<TParameters, TContext>): AsyncMiddlewareFn<TParameters, TReturn, TContext>;