@backendkit-labs/bulkhead 0.1.2 → 0.1.3

package/README.md

@@ -1,337 +1,338 @@
-# @backendkit-labs/bulkhead
-
-[![npm version](https://img.shields.io/npm/v/@backendkit-labs/bulkhead?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@backendkit-labs/bulkhead)
-[![CI](https://img.shields.io/github/actions/workflow/status/backendkit-dev/backendkit-monorepo/ci.yml?style=flat-square&label=CI)](https://github.com/backendkit-dev/backendkit-monorepo/actions/workflows/ci.yml)
-[![License](https://img.shields.io/npm/l/@backendkit-labs/bulkhead?style=flat-square)](LICENSE)
-[![Node](https://img.shields.io/node/v/@backendkit-labs/bulkhead?style=flat-square)](package.json)
-
-> Bulkhead concurrency limiting for Node.js — inspired by Resilience4j. Framework-agnostic core with optional NestJS integration.
-
-Prevents resource exhaustion and cascading failures by limiting how many operations run simultaneously on a given resource.
-
----
-
-## Installation
-
-```bash
-npm install @backendkit-labs/bulkhead
-```
-
----
-
-## TypeScript Configuration
-
-### Subpath exports (`/nestjs`)
-
-This package uses the `exports` field in `package.json` to expose the `/nestjs` subpath. TypeScript's ability to resolve it depends on the `moduleResolution` setting in your `tsconfig.json`.
-
-**Modern resolution (recommended) — no extra config needed:**
-
-```json
-{
-  "compilerOptions": {
-    "moduleResolution": "bundler"
-  }
-}
-```
-
-`"bundler"`, `"node16"`, and `"nodenext"` all understand the `exports` field natively. This is the recommended setting for any project using a bundler or NestJS on TypeScript ≥ 5.
-
-**Legacy resolution (`"node"`) — add a `paths` alias:**
-
-NestJS projects generated before ~2024 default to `"moduleResolution": "node"`, which ignores the `exports` field. Add an explicit alias so TypeScript can find the types:
-
-```json
-{
-  "compilerOptions": {
-    "moduleResolution": "node",
-    "paths": {
-      "@backendkit-labs/bulkhead/nestjs": [
-        "./node_modules/@backendkit-labs/bulkhead/dist/nestjs/index"
-      ]
-    }
-  }
-}
-```
-
-> **Why?** The `"node"` resolver was designed before subpath exports existed and only reads `main`/`types` at the package root — it ignores the `exports` map entirely. The `paths` alias manually points TypeScript to the correct `.d.ts` file.
-
-### NestJS decorator support
-
-```json
-{
-  "compilerOptions": {
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true
-  }
-}
-```
-
-And import `reflect-metadata` once at application startup:
-
-```typescript
-// main.ts
-import 'reflect-metadata';
-```
-
-> NestJS CLI scaffolds these automatically. You only need to verify them if setting up a project manually.
-
----
-
-## Quick Start — Framework-agnostic
-
-```typescript
-import { Bulkhead } from '@backendkit-labs/bulkhead';
-
-const bulkhead = new Bulkhead({
-  name: 'payments',
-  maxConcurrentCalls: 10,
-  maxQueueSize: 50,
-  queueTimeoutMs: 5000,
-  rejectWhenFull: true,
-});
-
-const result = await bulkhead.execute(() => callPaymentApi());
-```
-
----
-
-## Core API
-
-### `Bulkhead`
-
-```typescript
-const bulkhead = new Bulkhead(config);
-
-// Execute a task — waits in queue if at capacity
-await bulkhead.execute(async () => { ... });
-
-// Check if capacity is available before executing
-if (bulkhead.canAccept()) { ... }
-
-// Current metrics snapshot
-const metrics = bulkhead.getMetrics();
-
-// Reset all counters
-bulkhead.resetMetrics();
-```
-
-### `BulkheadConfig`
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `name` | `string` | Identifier for metrics and error messages |
-| `maxConcurrentCalls` | `number` | Max simultaneous executions |
-| `maxQueueSize` | `number` | Max tasks waiting in queue |
-| `queueTimeoutMs` | `number` | Max time a task can wait in queue (ms) |
-| `rejectWhenFull` | `boolean` | Throw immediately when full; if `false`, retries with exponential backoff |
-
-### `BulkheadMetrics`
-
-```typescript
-{
-  name: string;
-  activeCalls: number;
-  queuedCalls: number;
-  maxConcurrentCalls: number;
-  maxQueueSize: number;
-  totalCalls: number;
-  successfulCalls: number;
-  failedCalls: number;
-  rejectedCalls: number;
-  timedOutCalls: number;
-  averageDurationMs: number;
-}
-```
-
-### Errors
-
-```typescript
-import { BulkheadRejectedError, BulkheadTimeoutError } from '@backendkit-labs/bulkhead';
-
-try {
-  await bulkhead.execute(task);
-} catch (error) {
-  if (error instanceof BulkheadRejectedError) {
-    // Queue was full — task was not queued
-  }
-  if (error instanceof BulkheadTimeoutError) {
-    // Task waited too long in queue
-  }
-}
-```
-
----
-
-## BulkheadRegistry
-
-Manages named bulkhead instances with sensible defaults for common resource types:
-
-```typescript
-import { BulkheadRegistry } from '@backendkit-labs/bulkhead';
-
-const registry = new BulkheadRegistry();
-
-// Custom
-const bh = registry.getOrCreate({ name: 'my-service', maxConcurrentCalls: 15 });
-
-// Pre-configured factory methods
-const clientBh   = registry.getForClient('client-123', '/api/orders');   // 5 concurrent, 20 queued
-const serviceBh  = registry.getForService('inventory-service');           // 20 concurrent, 200 queued
-const dbBh       = registry.getForDatabase('orders_schema');              // 15 concurrent, 150 queued
-const externalBh = registry.getForHttpExternal('stripe-api');             // 8 concurrent, 50 queued, 10s timeout
-
-// Observability
-const all        = registry.getAllMetrics();
-const overloaded = registry.getOverloadedBulkheads(); // ≥80% active capacity
-registry.resetAllMetrics();
-```
-
-| Method | Concurrent | Queue | Timeout |
-|--------|-----------|-------|---------|
-| `getForClient(id, endpoint?)` | 5 | 20 | 30s |
-| `getForService(name)` | 20 | 200 | 30s |
-| `getForDatabase(schema)` | 15 | 150 | 30s |
-| `getForHttpExternal(name)` | 8 | 50 | 10s |
-
----
-
-## NestJS Integration
-
-```bash
-npm install @backendkit-labs/bulkhead
-```
-
-Import `BulkheadModule` into your NestJS application:
-
-```typescript
-import { BulkheadModule } from '@backendkit-labs/bulkhead/nestjs';
-
-@Module({
-  imports: [BulkheadModule],
-})
-export class AppModule {}
-```
-
-### Guard — declarative per-route protection
-
-```typescript
-import { UseBulkhead, BulkheadGuard } from '@backendkit-labs/bulkhead/nestjs';
-
-@Controller('orders')
-export class OrdersController {
-  // Shared service-level limit
-  @UseBulkhead({ name: 'orders-service' })
-  @UseGuards(BulkheadGuard)
-  @Get()
-  findAll() { ... }
-
-  // Per-client isolation (reads x-client-id header)
-  @UseBulkhead({ name: 'orders-create', perClient: true })
-  @UseGuards(BulkheadGuard)
-  @Post()
-  create() { ... }
-}
-```
-
-Returns `503 Service Unavailable` when at capacity.
-
-### Interceptor — wraps handler execution inside the bulkhead
-
-```typescript
-import { BulkheadInterceptor } from '@backendkit-labs/bulkhead/nestjs';
-
-// Apply globally
-app.useGlobalInterceptors(new BulkheadInterceptor(registry));
-
-// Or per controller / route
-@UseInterceptors(BulkheadInterceptor)
-@Controller('reports')
-export class ReportsController { ... }
-```
-
-Returns `503` on rejection, `408` on timeout.
-
-### Middleware — global HTTP concurrency limit
-
-Protects the entire service from being overwhelmed before requests even reach your handlers:
-
-```typescript
-import { HttpBulkheadMiddleware } from '@backendkit-labs/bulkhead/nestjs';
-
-@Module({ imports: [BulkheadModule] })
-export class AppModule implements NestModule {
-  configure(consumer: MiddlewareConsumer) {
-    consumer.apply(HttpBulkheadMiddleware).forRoutes('*');
-  }
-}
-```
-
-Configure via environment variables:
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `HTTP_BULKHEAD_CONCURRENCY` | `50` | Max concurrent requests |
-| `HTTP_BULKHEAD_MAX_QUEUE` | `100` | Max queued requests |
-
-Returns `429 Too Many Requests` when the queue is full.
-
-### Method Decorator
-
-```typescript
-import { WithBulkhead } from '@backendkit-labs/bulkhead/nestjs';
-
-@Injectable()
-export class ReportService {
-  // Must have bulkheadRegistry injected
-  constructor(public readonly bulkheadRegistry: BulkheadRegistry) {}
-
-  @WithBulkhead({ name: 'report-generation', maxConcurrent: 3 })
-  async generateReport(id: string) { ... }
-}
-```
-
-### Monitoring — BulkheadService
-
-```typescript
-import { BulkheadService } from '@backendkit-labs/bulkhead/nestjs';
-
-@Controller('health')
-export class HealthController {
-  constructor(private readonly bulkheads: BulkheadService) {}
-
-  @Get('bulkheads')
-  getMetrics() {
-    return {
-      all: this.bulkheads.getAllMetrics(),
-      critical: this.bulkheads.getCriticalBulkheads(), // ≥90% active
-    };
-  }
-}
-```
-
-`BulkheadService` also logs a warning every 60 seconds when any bulkhead reaches 90%+ utilization.
-
----
-
-## Architecture
-
-```
-@backendkit-labs/bulkhead         (core — no framework deps)
-  Bulkhead                        queue-based concurrency limiter
-  BulkheadRegistry                named instances + factory methods
-
-@backendkit-labs/bulkhead/nestjs  (optional NestJS layer)
-  BulkheadModule                  NestJS module
-  BulkheadGuard                   @UseBulkhead() per-route decorator
-  BulkheadInterceptor             wraps handler in execute()
-  HttpBulkheadMiddleware          global HTTP request limiter
-  WithBulkhead                    method-level decorator
-  BulkheadService                 metrics + auto-monitoring
-```
-
----
-
-## License
-
-Apache-2.0 — [BackendKit Labs](https://github.com/backendkit-dev)
+# @backendkit-labs/bulkhead
+
+[![npm version](https://img.shields.io/npm/v/@backendkit-labs/bulkhead?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@backendkit-labs/bulkhead)
+[![CI](https://img.shields.io/github/actions/workflow/status/BackendKit-labs/backendkit-monorepo/ci.yml?style=flat-square&label=CI)](https://github.com/BackendKit-labs/backendkit-monorepo/actions/workflows/ci.yml)
+[![License](https://img.shields.io/npm/l/@backendkit-labs/bulkhead?style=flat-square)](LICENSE)
+[![Node](https://img.shields.io/node/v/@backendkit-labs/bulkhead?style=flat-square)](package.json)
+[![Docs](https://img.shields.io/badge/docs-backendkitlabs.dev-4f7eff?style=flat-square)](https://backendkitlabs.dev/docs/bulkhead/)
+
+> Bulkhead concurrency limiting for Node.js — inspired by Resilience4j. Framework-agnostic core with optional NestJS integration.
+
+Prevents resource exhaustion and cascading failures by limiting how many operations run simultaneously on a given resource.
+
+---
+
+## Installation
+
+```bash
+npm install @backendkit-labs/bulkhead
+```
+
+---
+
+## TypeScript Configuration
+
+### Subpath exports (`/nestjs`)
+
+This package uses the `exports` field in `package.json` to expose the `/nestjs` subpath. TypeScript's ability to resolve it depends on the `moduleResolution` setting in your `tsconfig.json`.
+
+**Modern resolution (recommended) — no extra config needed:**
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+`"bundler"`, `"node16"`, and `"nodenext"` all understand the `exports` field natively. This is the recommended setting for any project using a bundler or NestJS on TypeScript ≥ 5.
+
+**Legacy resolution (`"node"`) — add a `paths` alias:**
+
+NestJS projects generated before ~2024 default to `"moduleResolution": "node"`, which ignores the `exports` field. Add an explicit alias so TypeScript can find the types:
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "node",
+    "paths": {
+      "@backendkit-labs/bulkhead/nestjs": [
+        "./node_modules/@backendkit-labs/bulkhead/dist/nestjs/index"
+      ]
+    }
+  }
+}
+```
+
+> **Why?** The `"node"` resolver was designed before subpath exports existed and only reads `main`/`types` at the package root — it ignores the `exports` map entirely. The `paths` alias manually points TypeScript to the correct `.d.ts` file.
+
+### NestJS decorator support
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+And import `reflect-metadata` once at application startup:
+
+```typescript
+// main.ts
+import 'reflect-metadata';
+```
+
+> NestJS CLI scaffolds these automatically. You only need to verify them if setting up a project manually.
+
+---
+
+## Quick Start — Framework-agnostic
+
+```typescript
+import { Bulkhead } from '@backendkit-labs/bulkhead';
+
+const bulkhead = new Bulkhead({
+  name: 'payments',
+  maxConcurrentCalls: 10,
+  maxQueueSize: 50,
+  queueTimeoutMs: 5000,
+  rejectWhenFull: true,
+});
+
+const result = await bulkhead.execute(() => callPaymentApi());
+```
+
+---
+
+## Core API
+
+### `Bulkhead`
+
+```typescript
+const bulkhead = new Bulkhead(config);
+
+// Execute a task — waits in queue if at capacity
+await bulkhead.execute(async () => { ... });
+
+// Check if capacity is available before executing
+if (bulkhead.canAccept()) { ... }
+
+// Current metrics snapshot
+const metrics = bulkhead.getMetrics();
+
+// Reset all counters
+bulkhead.resetMetrics();
+```
+
+### `BulkheadConfig`
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `name` | `string` | Identifier for metrics and error messages |
+| `maxConcurrentCalls` | `number` | Max simultaneous executions |
+| `maxQueueSize` | `number` | Max tasks waiting in queue |
+| `queueTimeoutMs` | `number` | Max time a task can wait in queue (ms) |
+| `rejectWhenFull` | `boolean` | Throw immediately when full; if `false`, retries with exponential backoff |
+
+### `BulkheadMetrics`
+
+```typescript
+{
+  name: string;
+  activeCalls: number;
+  queuedCalls: number;
+  maxConcurrentCalls: number;
+  maxQueueSize: number;
+  totalCalls: number;
+  successfulCalls: number;
+  failedCalls: number;
+  rejectedCalls: number;
+  timedOutCalls: number;
+  averageDurationMs: number;
+}
+```
+
+### Errors
+
+```typescript
+import { BulkheadRejectedError, BulkheadTimeoutError } from '@backendkit-labs/bulkhead';
+
+try {
+  await bulkhead.execute(task);
+} catch (error) {
+  if (error instanceof BulkheadRejectedError) {
+    // Queue was full — task was not queued
+  }
+  if (error instanceof BulkheadTimeoutError) {
+    // Task waited too long in queue
+  }
+}
+```
+
+---
+
+## BulkheadRegistry
+
+Manages named bulkhead instances with sensible defaults for common resource types:
+
+```typescript
+import { BulkheadRegistry } from '@backendkit-labs/bulkhead';
+
+const registry = new BulkheadRegistry();
+
+// Custom
+const bh = registry.getOrCreate({ name: 'my-service', maxConcurrentCalls: 15 });
+
+// Pre-configured factory methods
+const clientBh   = registry.getForClient('client-123', '/api/orders');   // 5 concurrent, 20 queued
+const serviceBh  = registry.getForService('inventory-service');           // 20 concurrent, 200 queued
+const dbBh       = registry.getForDatabase('orders_schema');              // 15 concurrent, 150 queued
+const externalBh = registry.getForHttpExternal('stripe-api');             // 8 concurrent, 50 queued, 10s timeout
+
+// Observability
+const all        = registry.getAllMetrics();
+const overloaded = registry.getOverloadedBulkheads(); // ≥80% active capacity
+registry.resetAllMetrics();
+```
+
+| Method | Concurrent | Queue | Timeout |
+|--------|-----------|-------|---------|
+| `getForClient(id, endpoint?)` | 5 | 20 | 30s |
+| `getForService(name)` | 20 | 200 | 30s |
+| `getForDatabase(schema)` | 15 | 150 | 30s |
+| `getForHttpExternal(name)` | 8 | 50 | 10s |
+
+---
+
+## NestJS Integration
+
+```bash
+npm install @backendkit-labs/bulkhead
+```
+
+Import `BulkheadModule` into your NestJS application:
+
+```typescript
+import { BulkheadModule } from '@backendkit-labs/bulkhead/nestjs';
+
+@Module({
+  imports: [BulkheadModule],
+})
+export class AppModule {}
+```
+
+### Guard — declarative per-route protection
+
+```typescript
+import { UseBulkhead, BulkheadGuard } from '@backendkit-labs/bulkhead/nestjs';
+
+@Controller('orders')
+export class OrdersController {
+  // Shared service-level limit
+  @UseBulkhead({ name: 'orders-service' })
+  @UseGuards(BulkheadGuard)
+  @Get()
+  findAll() { ... }
+
+  // Per-client isolation (reads x-client-id header)
+  @UseBulkhead({ name: 'orders-create', perClient: true })
+  @UseGuards(BulkheadGuard)
+  @Post()
+  create() { ... }
+}
+```
+
+Returns `503 Service Unavailable` when at capacity.
+
+### Interceptor — wraps handler execution inside the bulkhead
+
+```typescript
+import { BulkheadInterceptor } from '@backendkit-labs/bulkhead/nestjs';
+
+// Apply globally
+app.useGlobalInterceptors(new BulkheadInterceptor(registry));
+
+// Or per controller / route
+@UseInterceptors(BulkheadInterceptor)
+@Controller('reports')
+export class ReportsController { ... }
+```
+
+Returns `503` on rejection, `408` on timeout.
+
+### Middleware — global HTTP concurrency limit
+
+Protects the entire service from being overwhelmed before requests even reach your handlers:
+
+```typescript
+import { HttpBulkheadMiddleware } from '@backendkit-labs/bulkhead/nestjs';
+
+@Module({ imports: [BulkheadModule] })
+export class AppModule implements NestModule {
+  configure(consumer: MiddlewareConsumer) {
+    consumer.apply(HttpBulkheadMiddleware).forRoutes('*');
+  }
+}
+```
+
+Configure via environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `HTTP_BULKHEAD_CONCURRENCY` | `50` | Max concurrent requests |
+| `HTTP_BULKHEAD_MAX_QUEUE` | `100` | Max queued requests |
+
+Returns `429 Too Many Requests` when the queue is full.
+
+### Method Decorator
+
+```typescript
+import { WithBulkhead } from '@backendkit-labs/bulkhead/nestjs';
+
+@Injectable()
+export class ReportService {
+  // Must have bulkheadRegistry injected
+  constructor(public readonly bulkheadRegistry: BulkheadRegistry) {}
+
+  @WithBulkhead({ name: 'report-generation', maxConcurrent: 3 })
+  async generateReport(id: string) { ... }
+}
+```
+
+### Monitoring — BulkheadService
+
+```typescript
+import { BulkheadService } from '@backendkit-labs/bulkhead/nestjs';
+
+@Controller('health')
+export class HealthController {
+  constructor(private readonly bulkheads: BulkheadService) {}
+
+  @Get('bulkheads')
+  getMetrics() {
+    return {
+      all: this.bulkheads.getAllMetrics(),
+      critical: this.bulkheads.getCriticalBulkheads(), // ≥90% active
+    };
+  }
+}
+```
+
+`BulkheadService` also logs a warning every 60 seconds when any bulkhead reaches 90%+ utilization.
+
+---
+
+## Architecture
+
+```
+@backendkit-labs/bulkhead         (core — no framework deps)
+  Bulkhead                        queue-based concurrency limiter
+  BulkheadRegistry                named instances + factory methods
+
+@backendkit-labs/bulkhead/nestjs  (optional NestJS layer)
+  BulkheadModule                  NestJS module
+  BulkheadGuard                   @UseBulkhead() per-route decorator
+  BulkheadInterceptor             wraps handler in execute()
+  HttpBulkheadMiddleware          global HTTP request limiter
+  WithBulkhead                    method-level decorator
+  BulkheadService                 metrics + auto-monitoring
+```
+
+---
+
+## License
+
+Apache-2.0 — [BackendKit Labs](https://github.com/BackendKit-labs)

package/dist/{chunk-SRWDZPTJ.js → chunk-3BBY4GMC.js}

@@ -37,6 +37,9 @@ var Bulkhead = class {
   rejectedCalls = 0;
   timedOutCalls = 0;
   totalDurationMs = 0;
+  updateConfig(partial) {
+    this.config = { ...this.config, ...partial };
+  }
   async execute(task) {
     const startTime = Date.now();
     this.totalCalls++;
@@ -232,5 +235,5 @@ var BulkheadRegistry = class {
 };
 
 export { Bulkhead, BulkheadRegistry, BulkheadRejectedError, BulkheadTimeoutError, __decorateClass, __decorateParam };
-//# sourceMappingURL=chunk-SRWDZPTJ.js.map
-//# sourceMappingURL=chunk-SRWDZPTJ.js.map
+//# sourceMappingURL=chunk-3BBY4GMC.js.map
+//# sourceMappingURL=chunk-3BBY4GMC.js.map

package/dist/chunk-3BBY4GMC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bulkhead/bulkhead.ts","../src/bulkhead/bulkhead.registry.ts"],"names":[],"mappings":";;;;;;;;;;;;;AA2BO,IAAM,qBAAA,GAAN,cAAoC,KAAA,CAAM;AAAA,EAC/C,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,uBAAA;AAAA,EACd;AACF;AAEO,IAAM,oBAAA,GAAN,cAAmC,KAAA,CAAM;AAAA,EAC9C,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AAAA,EACd;AACF;AAEO,IAAM,WAAN,MAAe;AAAA,EAkBpB,YAAoB,MAAA,EAAwB;AAAxB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAAyB;AAAA,EAAzB,MAAA;AAAA,EAjBZ,WAAA,GAAc,CAAA;AAAA,EACd,MAAA,GAAS,CAAA;AAAA,EACT,QAMH,EAAC;AAAA,EAEE,UAAA,GAAa,CAAA;AAAA,EACb,eAAA,GAAkB,CAAA;AAAA,EAClB,WAAA,GAAc,CAAA;AAAA,EACd,aAAA,GAAgB,CAAA;AAAA,EAChB,aAAA,GAAgB,CAAA;AAAA,EAChB,eAAA,GAAkB,CAAA;AAAA,EAI1B,aAAa,OAAA,EAAsD;AACjE,IAAA,IAAA,CAAK,SAAS,EAAE,GAAG,IAAA,CAAK,MAAA,EAAQ,GAAG,OAAA,EAAQ;AAAA,EAC7C;AAAA,EAEA,MAAM,QAAW,IAAA,EAAoC;AACnD,IAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAC3B,IAAA,IAAA,CAAK,UAAA,EAAA;AAEL,IAAA,IAAI,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,MAAA,CAAO,kBAAA,EAAoB;AACrD,MAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,SAAS,CAAA;AAAA,IACrC;AAEA,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,MAAA,IAAU,IAAA,CAAK,OAAO,YAAA,EAAc;AACjD,MAAA,IAAI,IAAA,CAAK,OAAO,cAAA,EAAgB;AAC9B,QAAA,IAAA,CAAK,aAAA,EAAA;AACL,QAAA,MAAM,IAAI,qBAAA;AAAA,UACR,CAAA,UAAA,EAAa,IAAA,CAAK,MAAA,CAAO,IAAI,sBAChB,IAAA,CAAK,WAAW,CAAA,SAAA,EAAY,IAAA,CAAK,KAAA,CAAM,MAAM,CAAA,OAAA,EAAU,IAAA,CAAK,OAAO,kBAAkB,CAAA;AAAA,SACpG;AAAA,MACF;AACA,MAAA,OAAO,IAAA,CAAK,YAAA,CAAa,IAAA,EAAM,SAAS,CAAA;AAAA,IAC1C;AAEA,IAAA,MAAM,UAAU,IAAA,CAAK,MAAA,EAAA;AACrB,IAAA,OAAO,IAAI,OAAA,CAAW,CAAC,OAAA,EAAS,MAAA,KAAW;AACzC,MAAA,MAAM,SAAA,GAAY,WAAW,MAAM;AACjC,QAAA,MAAM,QAAQ,IAAA,CAAK,KAAA,CAAM,UAAU,CAAA,IAAA,KAAQ,IAAA,CAAK,OAAO,OAAO,CAAA;AAC9D,QAAA,IAAI,UAAU,EAAA,EAAI,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,OAAO,CAAC,CAAA;AAC5C,QAAA,IAAA,CAAK,aAAA,EAAA;AACL,QAAA,MAAA;AAAA,UACE,IAAI,oBAAA;AAAA,YACF,aAAa,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,gBAAA,EAAmB,IAAA,CAAK,OAAO,cAAc,CAAA,EAAA;AAAA;AAC5E,SACF;AAAA,MACF,CAAA,EAAG,IAAA,CAAK,MAAA,CAAO,cAAc,CAAA;AAE7B,MAAA,IAAA,CAAK,MAAM,IAAA,CAAK;AAAA,QACd,EAAA,EAAI,OAAA;AAAA,QACJ,IAAA;AAAA,QACA,SAAS,CAAA,KAAA,KAAS;AAChB,UAAA,YAAA,CAAa,SAAS,CAAA;AACtB,UAAA,OAAA,CAAQ,KAAU,CAAA;AAAA,QACpB,CAAA;AAAA,QACA,QAAQ,CAAA,MAAA,KAAU;AAChB,UAAA,YAAA,CAAa,SAAS,CAAA;AACtB,UAAA,MAAA,CAAO,MAAM,CAAA;AAAA,QACf,CAAA;AAAA,QACA,QAAA,EAAU;AAAA,OACX,CAAA;AAED,MAAA,IAAA,CAAK,YAAA,EAAa;AAAA,IACpB,CAAC,CAAA;AAAA,EACH;AAAA,EAEA,MAAc,OAAA,CAAW,IAAA,EAAwB,SAAA,EAA+B;AAC9E,IAAA,IAAA,CAAK,WAAA,EAAA;AACL,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,EAAK;AAC1B,MAAA,IAAA,CAAK,eAAA,EAAA;AACL,MAAA,IAAA,CAAK,eAAA,IAAmB,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA;AACrC,MAAA,OAAO,MAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,IAAA,CAAK,WAAA,EAAA;AACL,MAAA,MAAM,KAAA;AAAA,IACR,CAAA,SAAE;AACA,MAAA,IAAA,CAAK,WAAA,EAAA;AACL,MAAA,IAAA,CAAK,YAAA,EAAa;AAAA,IACpB;AAAA,EACF;AAAA,EAEA,MAAc,YAAA,CAAgB,IAAA,EAAwB,SAAA,EAA+B;AACnF,IAAA,MAAM,UAAA,GAAa,CAAA;AACnB,IAAA,MAAM,SAAA,GAAY,GAAA;AAElB,IAAA,KAAA,IAAS,OAAA,GAAU,CAAA,EAAG,OAAA,IAAW,UAAA,EAAY,OAAA,EAAA,EAAW;AACtD,MAAA,IAAI,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,MAAA,CAAO,kBAAA,EAAoB;AACrD,QAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,SAAS,CAAA;AAAA,MACrC;AACA,MAAA,MAAM,IAAI,OAAA,CAAQ,CAAA,OAAA,KAAW,UAAA,CAAW,OAAA,EAAS,SAAA,GAAY,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,OAAA,GAAU,CAAC,CAAC,CAAC,CAAA;AAAA,IACxF;AAEA,IAAA,IAAA,CAAK,aAAA,EAAA;AACL,IAAA,MAAM,IAAI,qBAAA;AAAA,MACR,CAAA,UAAA,EAAa,IAAA,CAAK,MAAA,CAAO,IAAI,oBAAoB,UAAU,CAAA,QAAA;AAAA,KAC7D;AAAA,EACF;AAAA,EAEQ,YAAA,GAAqB;AAC3B,IAAA,OAAO,IAAA,CAAK,cAAc,IAAA,CAAK,MAAA,CAAO,sBAAsB,IAAA,CAAK,KAAA,CAAM,SAAS,CAAA,EAAG;AACjF,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,KAAA,EAAM;AAC9B,MAAA,IAAI,CAAC,IAAA,EAAM;AAEX,MAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,IAAA,CAAK,QAAA;AACnC,MAAA,IAAI,QAAA,GAAW,IAAA,CAAK,MAAA,CAAO,cAAA,EAAgB;AACzC,QAAA,IAAA,CAAK,OAAO,IAAI,oBAAA,CAAqB,CAAA,qBAAA,EAAwB,QAAQ,aAAa,CAAC,CAAA;AACnF,QAAA,IAAA,CAAK,aAAA,EAAA;AACL,QAAA;AAAA,MACF;AAEA,MAAA,IAAA,CAAK,WAAA,EAAA;AACL,MAAA,IAAA,CACG,IAAA,EAAK,CACL,IAAA,CAAK,CAAA,MAAA,KAAU;AACd,QAAA,IAAA,CAAK,eAAA,EAAA;AACL,QAAA,IAAA,CAAK,QAAQ,MAAM,CAAA;AAAA,MACrB,CAAC,CAAA,CACA,KAAA,CAAM,CAAA,KAAA,KAAS;AACd,QAAA,IAAA,CAAK,WAAA,EAAA;AACL,QAAA,IAAA,CAAK,OAAO,KAAK,CAAA;AAAA,MACnB,CAAC,CAAA,CACA,OAAA,CAAQ,MAAM;AACb,QAAA,IAAA,CAAK,WAAA,EAAA;AACL,QAAA,IAAA,CAAK,YAAA,EAAa;AAAA,MACpB,CAAC,CAAA;AAAA,IACL;AAAA,EACF;AAAA,EAEA,UAAA,GAA8B;AAC5B,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,KAAK,MAAA,CAAO,IAAA;AAAA,MAClB,aAAa,IAAA,CAAK,WAAA;AAAA,MAClB,WAAA,EAAa,KAAK,KAAA,CAAM,MAAA;AAAA,MACxB,kBAAA,EAAoB,KAAK,MAAA,CAAO,kBAAA;AAAA,MAChC,YAAA,EAAc,KAAK,MAAA,CAAO,YAAA;AAAA,MAC1B,YAAY,IAAA,CAAK,UAAA;AAAA,MACjB,iBAAiB,IAAA,CAAK,eAAA;AAAA,MACtB,aAAa,IAAA,CAAK,WAAA;AAAA,MAClB,eAAe,IAAA,CAAK,aAAA;AAAA,MACpB,eAAe,IAAA,CAAK,aAAA;AAAA,MACpB,iBAAA,EACE,IAAA,CAAK,eAAA,GAAkB,CAAA,GAAI,IAAA,CAAK,MAAM,IAAA,CAAK,eAAA,GAAkB,IAAA,CAAK,eAAe,CAAA,GAAI;AAAA,KACzF;AAAA,EACF;AAAA,EAEA,SAAA,GAAqB;AACnB,IAAA,OACE,IAAA,CAAK,cAAc,IAAA,CAAK,MAAA,CAAO,sBAC/B,IAAA,CAAK,KAAA,CAAM,MAAA,GAAS,IAAA,CAAK,MAAA,CAAO,YAAA;AAAA,EAEpC;AAAA,EAEA,YAAA,GAAqB;AACnB,IAAA,IAAA,CAAK,UAAA,GAAa,CAAA;AAClB,IAAA,IAAA,CAAK,eAAA,GAAkB,CAAA;AACvB,IAAA,IAAA,CAAK,WAAA,GAAc,CAAA;AACnB,IAAA,IAAA,CAAK,aAAA,GAAgB,CAAA;AACrB,IAAA,IAAA,CAAK,aAAA,GAAgB,CAAA;AACrB,IAAA,IAAA,CAAK,eAAA,GAAkB,CAAA;AAAA,EACzB;AACF;;;AC5MA,IAAM,cAAA,GAA+C;AAAA,EACnD,kBAAA,EAAoB,EAAA;AAAA,EACpB,YAAA,EAAc,GAAA;AAAA,EACd,cAAA,EAAgB,GAAA;AAAA,EAChB,cAAA,EAAgB;AAClB,CAAA;AAEO,IAAM,mBAAN,MAAuB;AAAA,EACX,SAAA,uBAAgB,GAAA,EAAsB;AAAA,EAEvD,YAAY,OAAA,EAAoC;AAC9C,IAAA,IAAI,CAAC,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,OAAA,CAAQ,IAAI,CAAA,EAAG;AACrC,MAAA,MAAM,MAAA,GAAyB,EAAE,GAAG,cAAA,EAAgB,GAAG,OAAA,EAAS,IAAA,EAAM,QAAQ,IAAA,EAAK;AACnF,MAAA,IAAA,CAAK,UAAU,GAAA,CAAI,OAAA,CAAQ,MAAM,IAAI,QAAA,CAAS,MAAM,CAAC,CAAA;AAAA,IACvD;AACA,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,OAAA,CAAQ,IAAI,CAAA;AAAA,EACxC;AAAA;AAAA,EAGA,YAAA,CAAa,UAAkB,QAAA,EAA6B;AAC1D,IAAA,MAAM,IAAA,GAAO,WAAW,CAAA,OAAA,EAAU,QAAQ,IAAI,QAAQ,CAAA,CAAA,GAAK,UAAU,QAAQ,CAAA,CAAA;AAC7E,IAAA,OAAO,IAAA,CAAK,YAAY,EAAE,IAAA,EAAM,oBAAoB,CAAA,EAAG,YAAA,EAAc,IAAI,CAAA;AAAA,EAC3E;AAAA;AAAA,EAGA,cAAc,WAAA,EAA+B;AAC3C,IAAA,OAAO,KAAK,WAAA,CAAY;AAAA,MACtB,IAAA,EAAM,WAAW,WAAW,CAAA,CAAA;AAAA,MAC5B,kBAAA,EAAoB,EAAA;AAAA,MACpB,YAAA,EAAc;AAAA,KACf,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,eAAe,MAAA,EAA0B;AACvC,IAAA,OAAO,KAAK,WAAA,CAAY;AAAA,MACtB,IAAA,EAAM,YAAY,MAAM,CAAA,CAAA;AAAA,MACxB,kBAAA,EAAoB,EAAA;AAAA,MACpB,YAAA,EAAc;AAAA,KACf,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,mBAAmB,WAAA,EAA+B;AAChD,IAAA,OAAO,KAAK,WAAA,CAAY;AAAA,MACtB,IAAA,EAAM,QAAQ,WAAW,CAAA,CAAA;AAAA,MACzB,kBAAA,EAAoB,CAAA;AAAA,MACpB,YAAA,EAAc,EAAA;AAAA,MACd,cAAA,EAAgB;AAAA,KACjB,CAAA;AAAA,EACH;AAAA,EAEA,aAAA,GAAiD;AAC/C,IAAA,MAAM,UAA2C,EAAC;AAClD,IAAA,KAAA,MAAW,CAAC,IAAA,EAAM,QAAQ,CAAA,IAAK,KAAK,SAAA,EAAW;AAC7C,MAAA,OAAA,CAAQ,IAAI,CAAA,GAAI,QAAA,CAAS,UAAA,EAAW;AAAA,IACtC;AACA,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA,EAGA,sBAAA,GAA4C;AAC1C,IAAA,MAAM,aAAgC,EAAC;AACvC,IAAA,KAAA,MAAW,QAAA,IAAY,IAAA,CAAK,SAAA,CAAU,MAAA,EAAO,EAAG;AAC9C,MAAA,MAAM,CAAA,GAAI,SAAS,UAAA,EAAW;AAC9B,MAAA,IAAI,CAAA,CAAE,WAAA,IAAe,CAAA,CAAE,kBAAA,GAAqB,GAAA,EAAK;AAC/C,QAAA,UAAA,CAAW,KAAK,CAAC,CAAA;AAAA,MACnB;AAAA,IACF;AACA,IAAA,OAAO,UAAA;AAAA,EACT;AAAA,EAEA,eAAA,GAAwB;AACtB,IAAA,KAAA,MAAW,QAAA,IAAY,IAAA,CAAK,SAAA,CAAU,MAAA,EAAO,EAAG;AAC9C,MAAA,QAAA,CAAS,YAAA,EAAa;AAAA,IACxB;AAAA,EACF;AACF","file":"chunk-3BBY4GMC.js","sourcesContent":["export interface BulkheadConfig {\n  /** Max number of concurrent executions */\n  maxConcurrentCalls: number;\n  /** Max queue size for waiting tasks */\n  maxQueueSize: number;\n  /** Max time a task can wait in queue (ms) */\n  queueTimeoutMs: number;\n  /** Reject immediately when queue is full; if false, retries with backoff */\n  rejectWhenFull: boolean;\n  /** Identifier used in metrics and error messages */\n  name: string;\n}\n\nexport interface BulkheadMetrics {\n  name: string;\n  activeCalls: number;\n  queuedCalls: number;\n  maxConcurrentCalls: number;\n  maxQueueSize: number;\n  totalCalls: number;\n  successfulCalls: number;\n  failedCalls: number;\n  rejectedCalls: number;\n  timedOutCalls: number;\n  averageDurationMs: number;\n}\n\nexport class BulkheadRejectedError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BulkheadRejectedError';\n  }\n}\n\nexport class BulkheadTimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BulkheadTimeoutError';\n  }\n}\n\nexport class Bulkhead {\n  private activeCalls = 0;\n  private nextId = 0;\n  private queue: Array<{\n    id: number;\n    task: () => Promise<unknown>;\n    resolve: (value: unknown) => void;\n    reject: (reason: unknown) => void;\n    queuedAt: number;\n  }> = [];\n\n  private totalCalls = 0;\n  private successfulCalls = 0;\n  private failedCalls = 0;\n  private rejectedCalls = 0;\n  private timedOutCalls = 0;\n  private totalDurationMs = 0;\n\n  constructor(private config: BulkheadConfig) {}\n\n  updateConfig(partial: Partial<Omit<BulkheadConfig, 'name'>>): void {\n    this.config = { ...this.config, ...partial };\n  }\n\n  async execute<T>(task: () => Promise<T>): Promise<T> {\n    const startTime = Date.now();\n    this.totalCalls++;\n\n    if (this.activeCalls < this.config.maxConcurrentCalls) {\n      return this.runTask(task, startTime);\n    }\n\n    if (this.queue.length >= this.config.maxQueueSize) {\n      if (this.config.rejectWhenFull) {\n        this.rejectedCalls++;\n        throw new BulkheadRejectedError(\n          `Bulkhead '${this.config.name}' is full. ` +\n            `Active: ${this.activeCalls}, Queue: ${this.queue.length}, Max: ${this.config.maxConcurrentCalls}`,\n        );\n      }\n      return this.waitAndRetry(task, startTime);\n    }\n\n    const entryId = this.nextId++;\n    return new Promise<T>((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        const index = this.queue.findIndex(item => item.id === entryId);\n        if (index !== -1) this.queue.splice(index, 1);\n        this.timedOutCalls++;\n        reject(\n          new BulkheadTimeoutError(\n            `Bulkhead '${this.config.name}' timeout after ${this.config.queueTimeoutMs}ms`,\n          ),\n        );\n      }, this.config.queueTimeoutMs);\n\n      this.queue.push({\n        id: entryId,\n        task: task as () => Promise<unknown>,\n        resolve: value => {\n          clearTimeout(timeoutId);\n          resolve(value as T);\n        },\n        reject: reason => {\n          clearTimeout(timeoutId);\n          reject(reason);\n        },\n        queuedAt: startTime,\n      });\n\n      this.processQueue();\n    });\n  }\n\n  private async runTask<T>(task: () => Promise<T>, startTime: number): Promise<T> {\n    this.activeCalls++;\n    try {\n      const result = await task();\n      this.successfulCalls++;\n      this.totalDurationMs += Date.now() - startTime;\n      return result;\n    } catch (error) {\n      this.failedCalls++;\n      throw error;\n    } finally {\n      this.activeCalls--;\n      this.processQueue();\n    }\n  }\n\n  private async waitAndRetry<T>(task: () => Promise<T>, startTime: number): Promise<T> {\n    const maxRetries = 3;\n    const baseDelay = 100;\n\n    for (let attempt = 1; attempt <= maxRetries; attempt++) {\n      if (this.activeCalls < this.config.maxConcurrentCalls) {\n        return this.runTask(task, startTime);\n      }\n      await new Promise(resolve => setTimeout(resolve, baseDelay * Math.pow(2, attempt - 1)));\n    }\n\n    this.rejectedCalls++;\n    throw new BulkheadRejectedError(\n      `Bulkhead '${this.config.name}' rejected after ${maxRetries} retries`,\n    );\n  }\n\n  private processQueue(): void {\n    while (this.activeCalls < this.config.maxConcurrentCalls && this.queue.length > 0) {\n      const next = this.queue.shift();\n      if (!next) break;\n\n      const waitTime = Date.now() - next.queuedAt;\n      if (waitTime > this.config.queueTimeoutMs) {\n        next.reject(new BulkheadTimeoutError(`Task timed out after ${waitTime}ms in queue`));\n        this.timedOutCalls++;\n        continue;\n      }\n\n      this.activeCalls++;\n      next\n        .task()\n        .then(result => {\n          this.successfulCalls++;\n          next.resolve(result);\n        })\n        .catch(error => {\n          this.failedCalls++;\n          next.reject(error);\n        })\n        .finally(() => {\n          this.activeCalls--;\n          this.processQueue();\n        });\n    }\n  }\n\n  getMetrics(): BulkheadMetrics {\n    return {\n      name: this.config.name,\n      activeCalls: this.activeCalls,\n      queuedCalls: this.queue.length,\n      maxConcurrentCalls: this.config.maxConcurrentCalls,\n      maxQueueSize: this.config.maxQueueSize,\n      totalCalls: this.totalCalls,\n      successfulCalls: this.successfulCalls,\n      failedCalls: this.failedCalls,\n      rejectedCalls: this.rejectedCalls,\n      timedOutCalls: this.timedOutCalls,\n      averageDurationMs:\n        this.successfulCalls > 0 ? Math.round(this.totalDurationMs / this.successfulCalls) : 0,\n    };\n  }\n\n  canAccept(): boolean {\n    return (\n      this.activeCalls < this.config.maxConcurrentCalls ||\n      this.queue.length < this.config.maxQueueSize\n    );\n  }\n\n  resetMetrics(): void {\n    this.totalCalls = 0;\n    this.successfulCalls = 0;\n    this.failedCalls = 0;\n    this.rejectedCalls = 0;\n    this.timedOutCalls = 0;\n    this.totalDurationMs = 0;\n  }\n}\n","import { Bulkhead, BulkheadConfig, BulkheadMetrics } from './bulkhead.js';\n\nexport interface BulkheadOptions extends Partial<BulkheadConfig> {\n  name: string;\n}\n\nconst DEFAULT_CONFIG: Omit<BulkheadConfig, 'name'> = {\n  maxConcurrentCalls: 10,\n  maxQueueSize: 100,\n  queueTimeoutMs: 30000,\n  rejectWhenFull: true,\n};\n\nexport class BulkheadRegistry {\n  private readonly bulkheads = new Map<string, Bulkhead>();\n\n  getOrCreate(options: BulkheadOptions): Bulkhead {\n    if (!this.bulkheads.has(options.name)) {\n      const config: BulkheadConfig = { ...DEFAULT_CONFIG, ...options, name: options.name };\n      this.bulkheads.set(options.name, new Bulkhead(config));\n    }\n    return this.bulkheads.get(options.name)!;\n  }\n\n  /** Per-client isolation — 5 concurrent, 20 queued */\n  getForClient(clientId: string, endpoint?: string): Bulkhead {\n    const name = endpoint ? `client:${clientId}:${endpoint}` : `client:${clientId}`;\n    return this.getOrCreate({ name, maxConcurrentCalls: 5, maxQueueSize: 20 });\n  }\n\n  /** Service-level limiting — 20 concurrent, 200 queued */\n  getForService(serviceName: string): Bulkhead {\n    return this.getOrCreate({\n      name: `service:${serviceName}`,\n      maxConcurrentCalls: 20,\n      maxQueueSize: 200,\n    });\n  }\n\n  /** Database connection limiting — 15 concurrent, 150 queued */\n  getForDatabase(schema: string): Bulkhead {\n    return this.getOrCreate({\n      name: `database:${schema}`,\n      maxConcurrentCalls: 15,\n      maxQueueSize: 150,\n    });\n  }\n\n  /** External HTTP calls — 8 concurrent, 50 queued, 10s timeout */\n  getForHttpExternal(serviceName: string): Bulkhead {\n    return this.getOrCreate({\n      name: `http:${serviceName}`,\n      maxConcurrentCalls: 8,\n      maxQueueSize: 50,\n      queueTimeoutMs: 10000,\n    });\n  }\n\n  getAllMetrics(): Record<string, BulkheadMetrics> {\n    const metrics: Record<string, BulkheadMetrics> = {};\n    for (const [name, bulkhead] of this.bulkheads) {\n      metrics[name] = bulkhead.getMetrics();\n    }\n    return metrics;\n  }\n\n  /** Returns bulkheads at or above 80% active capacity */\n  getOverloadedBulkheads(): BulkheadMetrics[] {\n    const overloaded: BulkheadMetrics[] = [];\n    for (const bulkhead of this.bulkheads.values()) {\n      const m = bulkhead.getMetrics();\n      if (m.activeCalls >= m.maxConcurrentCalls * 0.8) {\n        overloaded.push(m);\n      }\n    }\n    return overloaded;\n  }\n\n  resetAllMetrics(): void {\n    for (const bulkhead of this.bulkheads.values()) {\n      bulkhead.resetMetrics();\n    }\n  }\n}\n"]}

package/dist/{chunk-LXXCDKHB.cjs → chunk-455MFZTI.cjs}

@@ -39,6 +39,9 @@ var Bulkhead = class {
   rejectedCalls = 0;
   timedOutCalls = 0;
   totalDurationMs = 0;
+  updateConfig(partial) {
+    this.config = { ...this.config, ...partial };
+  }
   async execute(task) {
     const startTime = Date.now();
     this.totalCalls++;
@@ -239,5 +242,5 @@ exports.BulkheadRejectedError = BulkheadRejectedError;
 exports.BulkheadTimeoutError = BulkheadTimeoutError;
 exports.__decorateClass = __decorateClass;
 exports.__decorateParam = __decorateParam;
-//# sourceMappingURL=chunk-LXXCDKHB.cjs.map
-//# sourceMappingURL=chunk-LXXCDKHB.cjs.map
+//# sourceMappingURL=chunk-455MFZTI.cjs.map
+//# sourceMappingURL=chunk-455MFZTI.cjs.map

package/dist/chunk-455MFZTI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bulkhead/bulkhead.ts","../src/bulkhead/bulkhead.registry.ts"],"names":[],"mappings":"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","file":"chunk-455MFZTI.cjs","sourcesContent":["export interface BulkheadConfig {\n  /** Max number of concurrent executions */\n  maxConcurrentCalls: number;\n  /** Max queue size for waiting tasks */\n  maxQueueSize: number;\n  /** Max time a task can wait in queue (ms) */\n  queueTimeoutMs: number;\n  /** Reject immediately when queue is full; if false, retries with backoff */\n  rejectWhenFull: boolean;\n  /** Identifier used in metrics and error messages */\n  name: string;\n}\n\nexport interface BulkheadMetrics {\n  name: string;\n  activeCalls: number;\n  queuedCalls: number;\n  maxConcurrentCalls: number;\n  maxQueueSize: number;\n  totalCalls: number;\n  successfulCalls: number;\n  failedCalls: number;\n  rejectedCalls: number;\n  timedOutCalls: number;\n  averageDurationMs: number;\n}\n\nexport class BulkheadRejectedError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BulkheadRejectedError';\n  }\n}\n\nexport class BulkheadTimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BulkheadTimeoutError';\n  }\n}\n\nexport class Bulkhead {\n  private activeCalls = 0;\n  private nextId = 0;\n  private queue: Array<{\n    id: number;\n    task: () => Promise<unknown>;\n    resolve: (value: unknown) => void;\n    reject: (reason: unknown) => void;\n    queuedAt: number;\n  }> = [];\n\n  private totalCalls = 0;\n  private successfulCalls = 0;\n  private failedCalls = 0;\n  private rejectedCalls = 0;\n  private timedOutCalls = 0;\n  private totalDurationMs = 0;\n\n  constructor(private config: BulkheadConfig) {}\n\n  updateConfig(partial: Partial<Omit<BulkheadConfig, 'name'>>): void {\n    this.config = { ...this.config, ...partial };\n  }\n\n  async execute<T>(task: () => Promise<T>): Promise<T> {\n    const startTime = Date.now();\n    this.totalCalls++;\n\n    if (this.activeCalls < this.config.maxConcurrentCalls) {\n      return this.runTask(task, startTime);\n    }\n\n    if (this.queue.length >= this.config.maxQueueSize) {\n      if (this.config.rejectWhenFull) {\n        this.rejectedCalls++;\n        throw new BulkheadRejectedError(\n          `Bulkhead '${this.config.name}' is full. ` +\n            `Active: ${this.activeCalls}, Queue: ${this.queue.length}, Max: ${this.config.maxConcurrentCalls}`,\n        );\n      }\n      return this.waitAndRetry(task, startTime);\n    }\n\n    const entryId = this.nextId++;\n    return new Promise<T>((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        const index = this.queue.findIndex(item => item.id === entryId);\n        if (index !== -1) this.queue.splice(index, 1);\n        this.timedOutCalls++;\n        reject(\n          new BulkheadTimeoutError(\n            `Bulkhead '${this.config.name}' timeout after ${this.config.queueTimeoutMs}ms`,\n          ),\n        );\n      }, this.config.queueTimeoutMs);\n\n      this.queue.push({\n        id: entryId,\n        task: task as () => Promise<unknown>,\n        resolve: value => {\n          clearTimeout(timeoutId);\n          resolve(value as T);\n        },\n        reject: reason => {\n          clearTimeout(timeoutId);\n          reject(reason);\n        },\n        queuedAt: startTime,\n      });\n\n      this.processQueue();\n    });\n  }\n\n  private async runTask<T>(task: () => Promise<T>, startTime: number): Promise<T> {\n    this.activeCalls++;\n    try {\n      const result = await task();\n      this.successfulCalls++;\n      this.totalDurationMs += Date.now() - startTime;\n      return result;\n    } catch (error) {\n      this.failedCalls++;\n      throw error;\n    } finally {\n      this.activeCalls--;\n      this.processQueue();\n    }\n  }\n\n  private async waitAndRetry<T>(task: () => Promise<T>, startTime: number): Promise<T> {\n    const maxRetries = 3;\n    const baseDelay = 100;\n\n    for (let attempt = 1; attempt <= maxRetries; attempt++) {\n      if (this.activeCalls < this.config.maxConcurrentCalls) {\n        return this.runTask(task, startTime);\n      }\n      await new Promise(resolve => setTimeout(resolve, baseDelay * Math.pow(2, attempt - 1)));\n    }\n\n    this.rejectedCalls++;\n    throw new BulkheadRejectedError(\n      `Bulkhead '${this.config.name}' rejected after ${maxRetries} retries`,\n    );\n  }\n\n  private processQueue(): void {\n    while (this.activeCalls < this.config.maxConcurrentCalls && this.queue.length > 0) {\n      const next = this.queue.shift();\n      if (!next) break;\n\n      const waitTime = Date.now() - next.queuedAt;\n      if (waitTime > this.config.queueTimeoutMs) {\n        next.reject(new BulkheadTimeoutError(`Task timed out after ${waitTime}ms in queue`));\n        this.timedOutCalls++;\n        continue;\n      }\n\n      this.activeCalls++;\n      next\n        .task()\n        .then(result => {\n          this.successfulCalls++;\n          next.resolve(result);\n        })\n        .catch(error => {\n          this.failedCalls++;\n          next.reject(error);\n        })\n        .finally(() => {\n          this.activeCalls--;\n          this.processQueue();\n        });\n    }\n  }\n\n  getMetrics(): BulkheadMetrics {\n    return {\n      name: this.config.name,\n      activeCalls: this.activeCalls,\n      queuedCalls: this.queue.length,\n      maxConcurrentCalls: this.config.maxConcurrentCalls,\n      maxQueueSize: this.config.maxQueueSize,\n      totalCalls: this.totalCalls,\n      successfulCalls: this.successfulCalls,\n      failedCalls: this.failedCalls,\n      rejectedCalls: this.rejectedCalls,\n      timedOutCalls: this.timedOutCalls,\n      averageDurationMs:\n        this.successfulCalls > 0 ? Math.round(this.totalDurationMs / this.successfulCalls) : 0,\n    };\n  }\n\n  canAccept(): boolean {\n    return (\n      this.activeCalls < this.config.maxConcurrentCalls ||\n      this.queue.length < this.config.maxQueueSize\n    );\n  }\n\n  resetMetrics(): void {\n    this.totalCalls = 0;\n    this.successfulCalls = 0;\n    this.failedCalls = 0;\n    this.rejectedCalls = 0;\n    this.timedOutCalls = 0;\n    this.totalDurationMs = 0;\n  }\n}\n","import { Bulkhead, BulkheadConfig, BulkheadMetrics } from './bulkhead.js';\n\nexport interface BulkheadOptions extends Partial<BulkheadConfig> {\n  name: string;\n}\n\nconst DEFAULT_CONFIG: Omit<BulkheadConfig, 'name'> = {\n  maxConcurrentCalls: 10,\n  maxQueueSize: 100,\n  queueTimeoutMs: 30000,\n  rejectWhenFull: true,\n};\n\nexport class BulkheadRegistry {\n  private readonly bulkheads = new Map<string, Bulkhead>();\n\n  getOrCreate(options: BulkheadOptions): Bulkhead {\n    if (!this.bulkheads.has(options.name)) {\n      const config: BulkheadConfig = { ...DEFAULT_CONFIG, ...options, name: options.name };\n      this.bulkheads.set(options.name, new Bulkhead(config));\n    }\n    return this.bulkheads.get(options.name)!;\n  }\n\n  /** Per-client isolation — 5 concurrent, 20 queued */\n  getForClient(clientId: string, endpoint?: string): Bulkhead {\n    const name = endpoint ? `client:${clientId}:${endpoint}` : `client:${clientId}`;\n    return this.getOrCreate({ name, maxConcurrentCalls: 5, maxQueueSize: 20 });\n  }\n\n  /** Service-level limiting — 20 concurrent, 200 queued */\n  getForService(serviceName: string): Bulkhead {\n    return this.getOrCreate({\n      name: `service:${serviceName}`,\n      maxConcurrentCalls: 20,\n      maxQueueSize: 200,\n    });\n  }\n\n  /** Database connection limiting — 15 concurrent, 150 queued */\n  getForDatabase(schema: string): Bulkhead {\n    return this.getOrCreate({\n      name: `database:${schema}`,\n      maxConcurrentCalls: 15,\n      maxQueueSize: 150,\n    });\n  }\n\n  /** External HTTP calls — 8 concurrent, 50 queued, 10s timeout */\n  getForHttpExternal(serviceName: string): Bulkhead {\n    return this.getOrCreate({\n      name: `http:${serviceName}`,\n      maxConcurrentCalls: 8,\n      maxQueueSize: 50,\n      queueTimeoutMs: 10000,\n    });\n  }\n\n  getAllMetrics(): Record<string, BulkheadMetrics> {\n    const metrics: Record<string, BulkheadMetrics> = {};\n    for (const [name, bulkhead] of this.bulkheads) {\n      metrics[name] = bulkhead.getMetrics();\n    }\n    return metrics;\n  }\n\n  /** Returns bulkheads at or above 80% active capacity */\n  getOverloadedBulkheads(): BulkheadMetrics[] {\n    const overloaded: BulkheadMetrics[] = [];\n    for (const bulkhead of this.bulkheads.values()) {\n      const m = bulkhead.getMetrics();\n      if (m.activeCalls >= m.maxConcurrentCalls * 0.8) {\n        overloaded.push(m);\n      }\n    }\n    return overloaded;\n  }\n\n  resetAllMetrics(): void {\n    for (const bulkhead of this.bulkheads.values()) {\n      bulkhead.resetMetrics();\n    }\n  }\n}\n"]}

package/dist/index.cjs

@@ -1,24 +1,24 @@
 'use strict';
 
-var chunkLXXCDKHB_cjs = require('./chunk-LXXCDKHB.cjs');
+var chunk455MFZTI_cjs = require('./chunk-455MFZTI.cjs');
 
 
 
 Object.defineProperty(exports, "Bulkhead", {
   enumerable: true,
-  get: function () { return chunkLXXCDKHB_cjs.Bulkhead; }
+  get: function () { return chunk455MFZTI_cjs.Bulkhead; }
 });
 Object.defineProperty(exports, "BulkheadRegistry", {
   enumerable: true,
-  get: function () { return chunkLXXCDKHB_cjs.BulkheadRegistry; }
+  get: function () { return chunk455MFZTI_cjs.BulkheadRegistry; }
 });
 Object.defineProperty(exports, "BulkheadRejectedError", {
   enumerable: true,
-  get: function () { return chunkLXXCDKHB_cjs.BulkheadRejectedError; }
+  get: function () { return chunk455MFZTI_cjs.BulkheadRejectedError; }
 });
 Object.defineProperty(exports, "BulkheadTimeoutError", {
   enumerable: true,
-  get: function () { return chunkLXXCDKHB_cjs.BulkheadTimeoutError; }
+  get: function () { return chunk455MFZTI_cjs.BulkheadTimeoutError; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -30,7 +30,7 @@ declare class BulkheadTimeoutError extends Error {
     constructor(message: string);
 }
 declare class Bulkhead {
-    private readonly config;
+    private config;
     private activeCalls;
     private nextId;
     private queue;
@@ -41,6 +41,7 @@ declare class Bulkhead {
     private timedOutCalls;
     private totalDurationMs;
     constructor(config: BulkheadConfig);
+    updateConfig(partial: Partial<Omit<BulkheadConfig, 'name'>>): void;
     execute<T>(task: () => Promise<T>): Promise<T>;
     private runTask;
     private waitAndRetry;

package/dist/index.d.ts

@@ -30,7 +30,7 @@ declare class BulkheadTimeoutError extends Error {
     constructor(message: string);
 }
 declare class Bulkhead {
-    private readonly config;
+    private config;
     private activeCalls;
     private nextId;
     private queue;
@@ -41,6 +41,7 @@ declare class Bulkhead {
     private timedOutCalls;
     private totalDurationMs;
     constructor(config: BulkheadConfig);
+    updateConfig(partial: Partial<Omit<BulkheadConfig, 'name'>>): void;
     execute<T>(task: () => Promise<T>): Promise<T>;
     private runTask;
     private waitAndRetry;

package/dist/index.js

@@ -1,3 +1,3 @@
-export { Bulkhead, BulkheadRegistry, BulkheadRejectedError, BulkheadTimeoutError } from './chunk-SRWDZPTJ.js';
+export { Bulkhead, BulkheadRegistry, BulkheadRejectedError, BulkheadTimeoutError } from './chunk-3BBY4GMC.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/nestjs/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkLXXCDKHB_cjs = require('../chunk-LXXCDKHB.cjs');
+var chunk455MFZTI_cjs = require('../chunk-455MFZTI.cjs');
 var common = require('@nestjs/common');
 var core = require('@nestjs/core');
 var rxjs = require('rxjs');
@@ -50,9 +50,9 @@ exports.BulkheadService = class BulkheadService {
     }, 6e4);
   }
 };
-exports.BulkheadService = chunkLXXCDKHB_cjs.__decorateClass([
+exports.BulkheadService = chunk455MFZTI_cjs.__decorateClass([
   common.Injectable(),
-  chunkLXXCDKHB_cjs.__decorateParam(0, common.Inject(chunkLXXCDKHB_cjs.BulkheadRegistry))
+  chunk455MFZTI_cjs.__decorateParam(0, common.Inject(chunk455MFZTI_cjs.BulkheadRegistry))
 ], exports.BulkheadService);
 var UseBulkhead = (options = {}) => core.Reflector.createDecorator({ key: "bulkhead", transform: () => options });
 exports.BulkheadGuard = class BulkheadGuard {
@@ -75,10 +75,10 @@ exports.BulkheadGuard = class BulkheadGuard {
     return true;
   }
 };
-exports.BulkheadGuard = chunkLXXCDKHB_cjs.__decorateClass([
+exports.BulkheadGuard = chunk455MFZTI_cjs.__decorateClass([
   common.Injectable(),
-  chunkLXXCDKHB_cjs.__decorateParam(0, common.Inject(core.Reflector)),
-  chunkLXXCDKHB_cjs.__decorateParam(1, common.Inject(chunkLXXCDKHB_cjs.BulkheadRegistry))
+  chunk455MFZTI_cjs.__decorateParam(0, common.Inject(core.Reflector)),
+  chunk455MFZTI_cjs.__decorateParam(1, common.Inject(chunk455MFZTI_cjs.BulkheadRegistry))
 ], exports.BulkheadGuard);
 exports.BulkheadInterceptor = class BulkheadInterceptor {
   constructor(registry) {
@@ -97,12 +97,12 @@ exports.BulkheadInterceptor = class BulkheadInterceptor {
         subscriber.complete();
       });
     } catch (error) {
-      if (error instanceof chunkLXXCDKHB_cjs.BulkheadRejectedError) {
+      if (error instanceof chunk455MFZTI_cjs.BulkheadRejectedError) {
         throw new common.ServiceUnavailableException(
           "Service at capacity \u2014 please retry in a moment"
         );
       }
-      if (error instanceof chunkLXXCDKHB_cjs.BulkheadTimeoutError) {
+      if (error instanceof chunk455MFZTI_cjs.BulkheadTimeoutError) {
         throw new common.RequestTimeoutException(
           "Request timed out waiting for processing \u2014 please retry"
         );
@@ -111,9 +111,9 @@ exports.BulkheadInterceptor = class BulkheadInterceptor {
     }
   }
 };
-exports.BulkheadInterceptor = chunkLXXCDKHB_cjs.__decorateClass([
+exports.BulkheadInterceptor = chunk455MFZTI_cjs.__decorateClass([
   common.Injectable(),
-  chunkLXXCDKHB_cjs.__decorateParam(0, common.Inject(chunkLXXCDKHB_cjs.BulkheadRegistry))
+  chunk455MFZTI_cjs.__decorateParam(0, common.Inject(chunk455MFZTI_cjs.BulkheadRegistry))
 ], exports.BulkheadInterceptor);
 var DEFAULT_CONCURRENCY = 50;
 var DEFAULT_MAX_QUEUE = 100;
@@ -129,7 +129,7 @@ exports.HttpBulkheadMiddleware = class HttpBulkheadMiddleware {
       process.env["HTTP_BULKHEAD_MAX_QUEUE"] ?? String(DEFAULT_MAX_QUEUE),
       10
     );
-    this.bulkhead = new chunkLXXCDKHB_cjs.Bulkhead({
+    this.bulkhead = new chunk455MFZTI_cjs.Bulkhead({
       name: "http:global",
       maxConcurrentCalls: concurrency,
       maxQueueSize,
@@ -149,7 +149,7 @@ exports.HttpBulkheadMiddleware = class HttpBulkheadMiddleware {
       })
     ).catch((error) => {
       if (res.headersSent) return;
-      if (error instanceof chunkLXXCDKHB_cjs.BulkheadRejectedError) {
+      if (error instanceof chunk455MFZTI_cjs.BulkheadRejectedError) {
         const m = this.bulkhead.getMetrics();
         this.logger.warn(
           `HTTP Bulkhead saturated [active=${m.activeCalls} queued=${m.queuedCalls}] \u2014 rejecting ${req.method} ${req.path}`
@@ -159,7 +159,7 @@ exports.HttpBulkheadMiddleware = class HttpBulkheadMiddleware {
           error: "Too Many Requests",
           message: "Service temporarily overloaded. Please retry in a few seconds."
         });
-      } else if (error instanceof chunkLXXCDKHB_cjs.BulkheadTimeoutError) {
+      } else if (error instanceof chunk455MFZTI_cjs.BulkheadTimeoutError) {
         res.status(503).json({
           statusCode: 503,
           error: "Service Unavailable",
@@ -172,24 +172,24 @@ exports.HttpBulkheadMiddleware = class HttpBulkheadMiddleware {
     return this.bulkhead.getMetrics();
   }
 };
-exports.HttpBulkheadMiddleware = chunkLXXCDKHB_cjs.__decorateClass([
+exports.HttpBulkheadMiddleware = chunk455MFZTI_cjs.__decorateClass([
   common.Injectable()
 ], exports.HttpBulkheadMiddleware);
 
 // src/nestjs/bulkhead.module.ts
 exports.BulkheadModule = class BulkheadModule {
 };
-exports.BulkheadModule = chunkLXXCDKHB_cjs.__decorateClass([
+exports.BulkheadModule = chunk455MFZTI_cjs.__decorateClass([
   common.Module({
     providers: [
-      chunkLXXCDKHB_cjs.BulkheadRegistry,
+      chunk455MFZTI_cjs.BulkheadRegistry,
       exports.BulkheadService,
       exports.BulkheadGuard,
       exports.BulkheadInterceptor,
       exports.HttpBulkheadMiddleware
     ],
     exports: [
-      chunkLXXCDKHB_cjs.BulkheadRegistry,
+      chunk455MFZTI_cjs.BulkheadRegistry,
       exports.BulkheadService,
       exports.BulkheadGuard,
       exports.BulkheadInterceptor,

package/dist/nestjs/index.js

@@ -1,4 +1,4 @@
-import { __decorateClass, __decorateParam, BulkheadRegistry, BulkheadRejectedError, BulkheadTimeoutError, Bulkhead } from '../chunk-SRWDZPTJ.js';
+import { __decorateClass, __decorateParam, BulkheadRegistry, BulkheadRejectedError, BulkheadTimeoutError, Bulkhead } from '../chunk-3BBY4GMC.js';
 import { Injectable, Inject, Module, Logger, ServiceUnavailableException, RequestTimeoutException } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
 import { firstValueFrom, Observable } from 'rxjs';

package/package.json

@@ -1,103 +1,103 @@
-{
-  "name": "@backendkit-labs/bulkhead",
-  "version": "0.1.2",
-  "license": "Apache-2.0",
-  "author": {
-    "name": "BackendKit Labs",
-    "email": "backendkit.dev@gmail.com"
-  },
-  "homepage": "https://github.com/backendkit-dev/backendkit-monorepo",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/backendkit-dev/backendkit-monorepo.git",
-    "directory": "packages/bulkhead"
-  },
-  "description": "Bulkhead concurrency limiting for Node.js — inspired by Resilience4j, with optional NestJS integration",
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./nestjs": {
-      "types": "./dist/nestjs/index.d.ts",
-      "import": "./dist/nestjs/index.js",
-      "require": "./dist/nestjs/index.cjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src/",
-    "format": "prettier --write src/",
-    "prepublishOnly": "npm run build && npm run test && npm run lint"
-  },
-  "keywords": [
-    "resilience",
-    "bulkhead",
-    "concurrency",
-    "rate-limiting",
-    "circuit-breaker",
-    "nestjs",
-    "node",
-    "backend"
-  ],
-  "bugs": {
-    "url": "https://github.com/backendkit-dev/backendkit-monorepo/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "peerDependencies": {
-    "@nestjs/common": ">=10.0.0",
-    "@nestjs/core": ">=10.0.0",
-    "express": ">=4.0.0",
-    "rxjs": ">=7.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@nestjs/common": {
-      "optional": true
-    },
-    "@nestjs/core": {
-      "optional": true
-    },
-    "express": {
-      "optional": true
-    },
-    "rxjs": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.4",
-    "@nestjs/common": "^10.0.0",
-    "@nestjs/core": "^10.0.0",
-    "@types/express": "^4.17.21",
-    "@types/node": "^22.0.0",
-    "eslint": "^9.0.0",
-    "prettier": "^3.0.0",
-    "reflect-metadata": "^0.2.0",
-    "rxjs": "^7.8.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.5.0",
-    "typescript-eslint": "^8.59.3",
-    "vitest": "^2.0.0"
-  }
-}
+{
+  "name": "@backendkit-labs/bulkhead",
+  "version": "0.1.3",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "BackendKit Labs",
+    "email": "hello@backendkitlabs.dev"
+  },
+  "homepage": "https://backendkitlabs.dev/docs/bulkhead/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BackendKit-labs/backendkit-monorepo.git",
+    "directory": "packages/bulkhead"
+  },
+  "description": "Bulkhead concurrency limiting for Node.js — inspired by Resilience4j, with optional NestJS integration",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./nestjs": {
+      "types": "./dist/nestjs/index.d.ts",
+      "import": "./dist/nestjs/index.js",
+      "require": "./dist/nestjs/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "format": "prettier --write src/",
+    "prepublishOnly": "npm run build && npm run test && npm run lint"
+  },
+  "keywords": [
+    "resilience",
+    "bulkhead",
+    "concurrency",
+    "rate-limiting",
+    "circuit-breaker",
+    "nestjs",
+    "node",
+    "backend"
+  ],
+  "bugs": {
+    "url": "https://github.com/BackendKit-labs/backendkit-monorepo/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/core": ">=10.0.0",
+    "express": ">=4.0.0",
+    "rxjs": ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "typescript-eslint": "^8.59.3",
+    "vitest": "^2.0.0"
+  }
+}

package/dist/chunk-LXXCDKHB.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/bulkhead/bulkhead.ts","../src/bulkhead/bulkhead.registry.ts"],"names":[],"mappings":"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","file":"chunk-LXXCDKHB.cjs","sourcesContent":["export interface BulkheadConfig {\n  /** Max number of concurrent executions */\n  maxConcurrentCalls: number;\n  /** Max queue size for waiting tasks */\n  maxQueueSize: number;\n  /** Max time a task can wait in queue (ms) */\n  queueTimeoutMs: number;\n  /** Reject immediately when queue is full; if false, retries with backoff */\n  rejectWhenFull: boolean;\n  /** Identifier used in metrics and error messages */\n  name: string;\n}\n\nexport interface BulkheadMetrics {\n  name: string;\n  activeCalls: number;\n  queuedCalls: number;\n  maxConcurrentCalls: number;\n  maxQueueSize: number;\n  totalCalls: number;\n  successfulCalls: number;\n  failedCalls: number;\n  rejectedCalls: number;\n  timedOutCalls: number;\n  averageDurationMs: number;\n}\n\nexport class BulkheadRejectedError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BulkheadRejectedError';\n  }\n}\n\nexport class BulkheadTimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BulkheadTimeoutError';\n  }\n}\n\nexport class Bulkhead {\n  private activeCalls = 0;\n  private nextId = 0;\n  private queue: Array<{\n    id: number;\n    task: () => Promise<unknown>;\n    resolve: (value: unknown) => void;\n    reject: (reason: unknown) => void;\n    queuedAt: number;\n  }> = [];\n\n  private totalCalls = 0;\n  private successfulCalls = 0;\n  private failedCalls = 0;\n  private rejectedCalls = 0;\n  private timedOutCalls = 0;\n  private totalDurationMs = 0;\n\n  constructor(private readonly config: BulkheadConfig) {}\n\n  async execute<T>(task: () => Promise<T>): Promise<T> {\n    const startTime = Date.now();\n    this.totalCalls++;\n\n    if (this.activeCalls < this.config.maxConcurrentCalls) {\n      return this.runTask(task, startTime);\n    }\n\n    if (this.queue.length >= this.config.maxQueueSize) {\n      if (this.config.rejectWhenFull) {\n        this.rejectedCalls++;\n        throw new BulkheadRejectedError(\n          `Bulkhead '${this.config.name}' is full. ` +\n            `Active: ${this.activeCalls}, Queue: ${this.queue.length}, Max: ${this.config.maxConcurrentCalls}`,\n        );\n      }\n      return this.waitAndRetry(task, startTime);\n    }\n\n    const entryId = this.nextId++;\n    return new Promise<T>((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        const index = this.queue.findIndex(item => item.id === entryId);\n        if (index !== -1) this.queue.splice(index, 1);\n        this.timedOutCalls++;\n        reject(\n          new BulkheadTimeoutError(\n            `Bulkhead '${this.config.name}' timeout after ${this.config.queueTimeoutMs}ms`,\n          ),\n        );\n      }, this.config.queueTimeoutMs);\n\n      this.queue.push({\n        id: entryId,\n        task: task as () => Promise<unknown>,\n        resolve: value => {\n          clearTimeout(timeoutId);\n          resolve(value as T);\n        },\n        reject: reason => {\n          clearTimeout(timeoutId);\n          reject(reason);\n        },\n        queuedAt: startTime,\n      });\n\n      this.processQueue();\n    });\n  }\n\n  private async runTask<T>(task: () => Promise<T>, startTime: number): Promise<T> {\n    this.activeCalls++;\n    try {\n      const result = await task();\n      this.successfulCalls++;\n      this.totalDurationMs += Date.now() - startTime;\n      return result;\n    } catch (error) {\n      this.failedCalls++;\n      throw error;\n    } finally {\n      this.activeCalls--;\n      this.processQueue();\n    }\n  }\n\n  private async waitAndRetry<T>(task: () => Promise<T>, startTime: number): Promise<T> {\n    const maxRetries = 3;\n    const baseDelay = 100;\n\n    for (let attempt = 1; attempt <= maxRetries; attempt++) {\n      if (this.activeCalls < this.config.maxConcurrentCalls) {\n        return this.runTask(task, startTime);\n      }\n      await new Promise(resolve => setTimeout(resolve, baseDelay * Math.pow(2, attempt - 1)));\n    }\n\n    this.rejectedCalls++;\n    throw new BulkheadRejectedError(\n      `Bulkhead '${this.config.name}' rejected after ${maxRetries} retries`,\n    );\n  }\n\n  private processQueue(): void {\n    while (this.activeCalls < this.config.maxConcurrentCalls && this.queue.length > 0) {\n      const next = this.queue.shift();\n      if (!next) break;\n\n      const waitTime = Date.now() - next.queuedAt;\n      if (waitTime > this.config.queueTimeoutMs) {\n        next.reject(new BulkheadTimeoutError(`Task timed out after ${waitTime}ms in queue`));\n        this.timedOutCalls++;\n        continue;\n      }\n\n      this.activeCalls++;\n      next\n        .task()\n        .then(result => {\n          this.successfulCalls++;\n          next.resolve(result);\n        })\n        .catch(error => {\n          this.failedCalls++;\n          next.reject(error);\n        })\n        .finally(() => {\n          this.activeCalls--;\n          this.processQueue();\n        });\n    }\n  }\n\n  getMetrics(): BulkheadMetrics {\n    return {\n      name: this.config.name,\n      activeCalls: this.activeCalls,\n      queuedCalls: this.queue.length,\n      maxConcurrentCalls: this.config.maxConcurrentCalls,\n      maxQueueSize: this.config.maxQueueSize,\n      totalCalls: this.totalCalls,\n      successfulCalls: this.successfulCalls,\n      failedCalls: this.failedCalls,\n      rejectedCalls: this.rejectedCalls,\n      timedOutCalls: this.timedOutCalls,\n      averageDurationMs:\n        this.successfulCalls > 0 ? Math.round(this.totalDurationMs / this.successfulCalls) : 0,\n    };\n  }\n\n  canAccept(): boolean {\n    return (\n      this.activeCalls < this.config.maxConcurrentCalls ||\n      this.queue.length < this.config.maxQueueSize\n    );\n  }\n\n  resetMetrics(): void {\n    this.totalCalls = 0;\n    this.successfulCalls = 0;\n    this.failedCalls = 0;\n    this.rejectedCalls = 0;\n    this.timedOutCalls = 0;\n    this.totalDurationMs = 0;\n  }\n}\n","import { Bulkhead, BulkheadConfig, BulkheadMetrics } from './bulkhead.js';\n\nexport interface BulkheadOptions extends Partial<BulkheadConfig> {\n  name: string;\n}\n\nconst DEFAULT_CONFIG: Omit<BulkheadConfig, 'name'> = {\n  maxConcurrentCalls: 10,\n  maxQueueSize: 100,\n  queueTimeoutMs: 30000,\n  rejectWhenFull: true,\n};\n\nexport class BulkheadRegistry {\n  private readonly bulkheads = new Map<string, Bulkhead>();\n\n  getOrCreate(options: BulkheadOptions): Bulkhead {\n    if (!this.bulkheads.has(options.name)) {\n      const config: BulkheadConfig = { ...DEFAULT_CONFIG, ...options, name: options.name };\n      this.bulkheads.set(options.name, new Bulkhead(config));\n    }\n    return this.bulkheads.get(options.name)!;\n  }\n\n  /** Per-client isolation — 5 concurrent, 20 queued */\n  getForClient(clientId: string, endpoint?: string): Bulkhead {\n    const name = endpoint ? `client:${clientId}:${endpoint}` : `client:${clientId}`;\n    return this.getOrCreate({ name, maxConcurrentCalls: 5, maxQueueSize: 20 });\n  }\n\n  /** Service-level limiting — 20 concurrent, 200 queued */\n  getForService(serviceName: string): Bulkhead {\n    return this.getOrCreate({\n      name: `service:${serviceName}`,\n      maxConcurrentCalls: 20,\n      maxQueueSize: 200,\n    });\n  }\n\n  /** Database connection limiting — 15 concurrent, 150 queued */\n  getForDatabase(schema: string): Bulkhead {\n    return this.getOrCreate({\n      name: `database:${schema}`,\n      maxConcurrentCalls: 15,\n      maxQueueSize: 150,\n    });\n  }\n\n  /** External HTTP calls — 8 concurrent, 50 queued, 10s timeout */\n  getForHttpExternal(serviceName: string): Bulkhead {\n    return this.getOrCreate({\n      name: `http:${serviceName}`,\n      maxConcurrentCalls: 8,\n      maxQueueSize: 50,\n      queueTimeoutMs: 10000,\n    });\n  }\n\n  getAllMetrics(): Record<string, BulkheadMetrics> {\n    const metrics: Record<string, BulkheadMetrics> = {};\n    for (const [name, bulkhead] of this.bulkheads) {\n      metrics[name] = bulkhead.getMetrics();\n    }\n    return metrics;\n  }\n\n  /** Returns bulkheads at or above 80% active capacity */\n  getOverloadedBulkheads(): BulkheadMetrics[] {\n    const overloaded: BulkheadMetrics[] = [];\n    for (const bulkhead of this.bulkheads.values()) {\n      const m = bulkhead.getMetrics();\n      if (m.activeCalls >= m.maxConcurrentCalls * 0.8) {\n        overloaded.push(m);\n      }\n    }\n    return overloaded;\n  }\n\n  resetAllMetrics(): void {\n    for (const bulkhead of this.bulkheads.values()) {\n      bulkhead.resetMetrics();\n    }\n  }\n}\n"]}

package/dist/chunk-SRWDZPTJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/bulkhead/bulkhead.ts","../src/bulkhead/bulkhead.registry.ts"],"names":[],"mappings":"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","file":"chunk-SRWDZPTJ.js","sourcesContent":["export interface BulkheadConfig {\n  /** Max number of concurrent executions */\n  maxConcurrentCalls: number;\n  /** Max queue size for waiting tasks */\n  maxQueueSize: number;\n  /** Max time a task can wait in queue (ms) */\n  queueTimeoutMs: number;\n  /** Reject immediately when queue is full; if false, retries with backoff */\n  rejectWhenFull: boolean;\n  /** Identifier used in metrics and error messages */\n  name: string;\n}\n\nexport interface BulkheadMetrics {\n  name: string;\n  activeCalls: number;\n  queuedCalls: number;\n  maxConcurrentCalls: number;\n  maxQueueSize: number;\n  totalCalls: number;\n  successfulCalls: number;\n  failedCalls: number;\n  rejectedCalls: number;\n  timedOutCalls: number;\n  averageDurationMs: number;\n}\n\nexport class BulkheadRejectedError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BulkheadRejectedError';\n  }\n}\n\nexport class BulkheadTimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BulkheadTimeoutError';\n  }\n}\n\nexport class Bulkhead {\n  private activeCalls = 0;\n  private nextId = 0;\n  private queue: Array<{\n    id: number;\n    task: () => Promise<unknown>;\n    resolve: (value: unknown) => void;\n    reject: (reason: unknown) => void;\n    queuedAt: number;\n  }> = [];\n\n  private totalCalls = 0;\n  private successfulCalls = 0;\n  private failedCalls = 0;\n  private rejectedCalls = 0;\n  private timedOutCalls = 0;\n  private totalDurationMs = 0;\n\n  constructor(private readonly config: BulkheadConfig) {}\n\n  async execute<T>(task: () => Promise<T>): Promise<T> {\n    const startTime = Date.now();\n    this.totalCalls++;\n\n    if (this.activeCalls < this.config.maxConcurrentCalls) {\n      return this.runTask(task, startTime);\n    }\n\n    if (this.queue.length >= this.config.maxQueueSize) {\n      if (this.config.rejectWhenFull) {\n        this.rejectedCalls++;\n        throw new BulkheadRejectedError(\n          `Bulkhead '${this.config.name}' is full. ` +\n            `Active: ${this.activeCalls}, Queue: ${this.queue.length}, Max: ${this.config.maxConcurrentCalls}`,\n        );\n      }\n      return this.waitAndRetry(task, startTime);\n    }\n\n    const entryId = this.nextId++;\n    return new Promise<T>((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        const index = this.queue.findIndex(item => item.id === entryId);\n        if (index !== -1) this.queue.splice(index, 1);\n        this.timedOutCalls++;\n        reject(\n          new BulkheadTimeoutError(\n            `Bulkhead '${this.config.name}' timeout after ${this.config.queueTimeoutMs}ms`,\n          ),\n        );\n      }, this.config.queueTimeoutMs);\n\n      this.queue.push({\n        id: entryId,\n        task: task as () => Promise<unknown>,\n        resolve: value => {\n          clearTimeout(timeoutId);\n          resolve(value as T);\n        },\n        reject: reason => {\n          clearTimeout(timeoutId);\n          reject(reason);\n        },\n        queuedAt: startTime,\n      });\n\n      this.processQueue();\n    });\n  }\n\n  private async runTask<T>(task: () => Promise<T>, startTime: number): Promise<T> {\n    this.activeCalls++;\n    try {\n      const result = await task();\n      this.successfulCalls++;\n      this.totalDurationMs += Date.now() - startTime;\n      return result;\n    } catch (error) {\n      this.failedCalls++;\n      throw error;\n    } finally {\n      this.activeCalls--;\n      this.processQueue();\n    }\n  }\n\n  private async waitAndRetry<T>(task: () => Promise<T>, startTime: number): Promise<T> {\n    const maxRetries = 3;\n    const baseDelay = 100;\n\n    for (let attempt = 1; attempt <= maxRetries; attempt++) {\n      if (this.activeCalls < this.config.maxConcurrentCalls) {\n        return this.runTask(task, startTime);\n      }\n      await new Promise(resolve => setTimeout(resolve, baseDelay * Math.pow(2, attempt - 1)));\n    }\n\n    this.rejectedCalls++;\n    throw new BulkheadRejectedError(\n      `Bulkhead '${this.config.name}' rejected after ${maxRetries} retries`,\n    );\n  }\n\n  private processQueue(): void {\n    while (this.activeCalls < this.config.maxConcurrentCalls && this.queue.length > 0) {\n      const next = this.queue.shift();\n      if (!next) break;\n\n      const waitTime = Date.now() - next.queuedAt;\n      if (waitTime > this.config.queueTimeoutMs) {\n        next.reject(new BulkheadTimeoutError(`Task timed out after ${waitTime}ms in queue`));\n        this.timedOutCalls++;\n        continue;\n      }\n\n      this.activeCalls++;\n      next\n        .task()\n        .then(result => {\n          this.successfulCalls++;\n          next.resolve(result);\n        })\n        .catch(error => {\n          this.failedCalls++;\n          next.reject(error);\n        })\n        .finally(() => {\n          this.activeCalls--;\n          this.processQueue();\n        });\n    }\n  }\n\n  getMetrics(): BulkheadMetrics {\n    return {\n      name: this.config.name,\n      activeCalls: this.activeCalls,\n      queuedCalls: this.queue.length,\n      maxConcurrentCalls: this.config.maxConcurrentCalls,\n      maxQueueSize: this.config.maxQueueSize,\n      totalCalls: this.totalCalls,\n      successfulCalls: this.successfulCalls,\n      failedCalls: this.failedCalls,\n      rejectedCalls: this.rejectedCalls,\n      timedOutCalls: this.timedOutCalls,\n      averageDurationMs:\n        this.successfulCalls > 0 ? Math.round(this.totalDurationMs / this.successfulCalls) : 0,\n    };\n  }\n\n  canAccept(): boolean {\n    return (\n      this.activeCalls < this.config.maxConcurrentCalls ||\n      this.queue.length < this.config.maxQueueSize\n    );\n  }\n\n  resetMetrics(): void {\n    this.totalCalls = 0;\n    this.successfulCalls = 0;\n    this.failedCalls = 0;\n    this.rejectedCalls = 0;\n    this.timedOutCalls = 0;\n    this.totalDurationMs = 0;\n  }\n}\n","import { Bulkhead, BulkheadConfig, BulkheadMetrics } from './bulkhead.js';\n\nexport interface BulkheadOptions extends Partial<BulkheadConfig> {\n  name: string;\n}\n\nconst DEFAULT_CONFIG: Omit<BulkheadConfig, 'name'> = {\n  maxConcurrentCalls: 10,\n  maxQueueSize: 100,\n  queueTimeoutMs: 30000,\n  rejectWhenFull: true,\n};\n\nexport class BulkheadRegistry {\n  private readonly bulkheads = new Map<string, Bulkhead>();\n\n  getOrCreate(options: BulkheadOptions): Bulkhead {\n    if (!this.bulkheads.has(options.name)) {\n      const config: BulkheadConfig = { ...DEFAULT_CONFIG, ...options, name: options.name };\n      this.bulkheads.set(options.name, new Bulkhead(config));\n    }\n    return this.bulkheads.get(options.name)!;\n  }\n\n  /** Per-client isolation — 5 concurrent, 20 queued */\n  getForClient(clientId: string, endpoint?: string): Bulkhead {\n    const name = endpoint ? `client:${clientId}:${endpoint}` : `client:${clientId}`;\n    return this.getOrCreate({ name, maxConcurrentCalls: 5, maxQueueSize: 20 });\n  }\n\n  /** Service-level limiting — 20 concurrent, 200 queued */\n  getForService(serviceName: string): Bulkhead {\n    return this.getOrCreate({\n      name: `service:${serviceName}`,\n      maxConcurrentCalls: 20,\n      maxQueueSize: 200,\n    });\n  }\n\n  /** Database connection limiting — 15 concurrent, 150 queued */\n  getForDatabase(schema: string): Bulkhead {\n    return this.getOrCreate({\n      name: `database:${schema}`,\n      maxConcurrentCalls: 15,\n      maxQueueSize: 150,\n    });\n  }\n\n  /** External HTTP calls — 8 concurrent, 50 queued, 10s timeout */\n  getForHttpExternal(serviceName: string): Bulkhead {\n    return this.getOrCreate({\n      name: `http:${serviceName}`,\n      maxConcurrentCalls: 8,\n      maxQueueSize: 50,\n      queueTimeoutMs: 10000,\n    });\n  }\n\n  getAllMetrics(): Record<string, BulkheadMetrics> {\n    const metrics: Record<string, BulkheadMetrics> = {};\n    for (const [name, bulkhead] of this.bulkheads) {\n      metrics[name] = bulkhead.getMetrics();\n    }\n    return metrics;\n  }\n\n  /** Returns bulkheads at or above 80% active capacity */\n  getOverloadedBulkheads(): BulkheadMetrics[] {\n    const overloaded: BulkheadMetrics[] = [];\n    for (const bulkhead of this.bulkheads.values()) {\n      const m = bulkhead.getMetrics();\n      if (m.activeCalls >= m.maxConcurrentCalls * 0.8) {\n        overloaded.push(m);\n      }\n    }\n    return overloaded;\n  }\n\n  resetAllMetrics(): void {\n    for (const bulkhead of this.bulkheads.values()) {\n      bulkhead.resetMetrics();\n    }\n  }\n}\n"]}