@yildizpay/http-adapter 3.6.1 → 3.8.0

package/README.md

@@ -381,13 +381,110 @@ const policy = RetryPolicies.fullJitter(3).retryIf(new BusinessRetryPredicate())
 To protect your system from waiting for a completely down downstream service, you can employ the `CircuitBreaker`. It opens the circuit after a configured amount of consecutive failures and replies instantaneously with `CircuitBreakerOpenException` without hitting the unresponsive server.
 
 ```typescript
-import { CircuitBreaker } from '@yildizpay/http-adapter';
+import { CircuitBreaker, CircuitBreakerOpenException } from '@yildizpay/http-adapter';
 
 const breaker = new CircuitBreaker({
   failureThreshold: 5,         // Trip after 5 failures
   resetTimeoutMs: 30000,       // Try a 'half-open' request after 30 seconds
   successThreshold: 1,         // Close circuit after 1 successful half-open request
 });
+
+// CircuitBreakerOpenException carries when the circuit will allow the next probe
+try {
+  await adapter.send(request);
+} catch (err) {
+  if (err instanceof CircuitBreakerOpenException) {
+    console.warn(`Circuit is open. Retry after ${err.retryAfterMs()}ms`);
+  }
+}
+```
+
+#### State machine
+
+```
+  [CLOSED] ──(failureThreshold reached)──▶ [OPEN]
+     ▲                                        │
+     │                                (resetTimeoutMs)
+     │                                        │
+     └──(successThreshold met)──── [HALF_OPEN] ──(failure)──▶ [OPEN]
+```
+
+#### Why only one probe in HALF_OPEN?
+
+Node.js runs on a single-threaded event loop, but `async/await` introduces cooperative multitasking: while one coroutine is suspended at an `await`, the event loop is free to start other coroutines. Without a guard, every request arriving during `HALF_OPEN` would read the same state and proceed concurrently — potentially overwhelming a service that has only just started to recover.
+
+To prevent this, the circuit breaker uses a **probe flag**: only the first caller gets the probe slot; all subsequent concurrent callers receive `CircuitBreakerOpenException` until the probe resolves. This is a deliberate trade-off — a few requests are rejected in exchange for a controlled, safe recovery test.
+
+## Observability
+
+The adapter ships with a two-tier observability system. **Observers are read-only** — they cannot modify requests or responses. Use them for metrics, structured logging, and distributed tracing. Use interceptors when you need to mutate the pipeline.
+
+### `HttpAdapterObserver`
+
+Attach a single observer to the adapter via `.withObserver()` on the builder.
+
+| Hook | When it fires |
+|---|---|
+| `onRequestStart(request)` | After all request interceptors, immediately before the HTTP call |
+| `onRequestSuccess(response, durationMs)` | After a successful response (includes retry time if retries occurred) |
+| `onRequestFailure(error, durationMs)` | When the final error is propagated to the caller |
+| `onRetry(attempt, error, delayMs)` | Each time a retry is scheduled, before the backoff delay |
+
+```typescript
+import { HttpAdapterObserver, HttpAdapter, RetryPolicies } from '@yildizpay/http-adapter';
+
+class MetricsObserver implements HttpAdapterObserver {
+  onRequestSuccess(_response: Response, durationMs: number): void {
+    metrics.histogram('http.request.duration', durationMs);
+  }
+
+  onRequestFailure(error: BaseAdapterException, durationMs: number): void {
+    metrics.increment('http.request.error', { type: error.name });
+  }
+
+  onRetry(attempt: number, _error: BaseAdapterException, delayMs: number): void {
+    logger.warn(`Retry attempt ${attempt} in ${delayMs}ms`);
+  }
+}
+
+const adapter = HttpAdapter.builder()
+  .withRetryPolicy(RetryPolicies.exponential(3))
+  .withObserver(new MetricsObserver())
+  .build();
+```
+
+### `CircuitBreakerObserver`
+
+Attach an observer to a `CircuitBreaker` instance via the fluent `.observe()` method.
+
+| Hook | When it fires |
+|---|---|
+| `onStateChange(from, to)` | On every state transition (CLOSED↔OPEN↔HALF_OPEN) |
+| `onSuccess()` | After every successful execution |
+| `onFailure(error)` | When a failure is counted (i.e. `isFailure` predicate returned `true`) |
+| `onProbeRejected()` | When a concurrent caller is turned away in HALF_OPEN |
+
+```typescript
+import { CircuitBreaker, CircuitBreakerObserver, CircuitState } from '@yildizpay/http-adapter';
+
+class CircuitMetricsObserver implements CircuitBreakerObserver {
+  onStateChange(from: CircuitState, to: CircuitState): void {
+    logger.warn(`Circuit breaker: ${from} → ${to}`);
+    metrics.increment('circuit_breaker.state_change', { from, to });
+  }
+
+  onProbeRejected(): void {
+    metrics.increment('circuit_breaker.probe_rejected');
+  }
+}
+
+const adapter = HttpAdapter.builder()
+  .withCircuitBreaker(
+    new CircuitBreaker({ failureThreshold: 5 })
+      .observe(new CircuitMetricsObserver()),
+  )
+  .withObserver(new MetricsObserver())
+  .build();
 ```
 
 ## Interceptors

package/README.tr.md

@@ -381,13 +381,110 @@ const policy = RetryPolicies.fullJitter(3).retryIf(new BusinessRetryPredicate())
 Tamamen çökmüş bir downstream servisi beklemeye karşı sisteminizi korumak için `CircuitBreaker` kullanabilirsiniz. Belirli sayıda ardışık hata alındığında circuit açılır ve yanıt vermeyen servise gereksiz istek göndermeksizin anında `CircuitBreakerOpenException` fırlatır.
 
 ```typescript
-import { CircuitBreaker } from '@yildizpay/http-adapter';
+import { CircuitBreaker, CircuitBreakerOpenException } from '@yildizpay/http-adapter';
 
 const breaker = new CircuitBreaker({
   failureThreshold: 5,         // 5 hatadan sonra circuit'i aç
   resetTimeoutMs: 30000,       // 30 saniye sonra half-open test isteği gönder
   successThreshold: 1,         // 1 başarılı half-open request sonrası circuit'i kapat
 });
+
+// CircuitBreakerOpenException bir sonraki deneme zamanını taşır
+try {
+  await adapter.send(request);
+} catch (err) {
+  if (err instanceof CircuitBreakerOpenException) {
+    console.warn(`Circuit açık. ${err.retryAfterMs()}ms sonra tekrar dene`);
+  }
+}
+```
+
+#### Durum makinesi
+
+```
+  [CLOSED] ──(failureThreshold aşıldı)──▶ [OPEN]
+     ▲                                        │
+     │                               (resetTimeoutMs)
+     │                                        │
+     └──(successThreshold karşılandı)── [HALF_OPEN] ──(hata)──▶ [OPEN]
+```
+
+#### HALF_OPEN'da neden sadece bir probe isteği geçer?
+
+Node.js, tek iş parçacıklı (single-threaded) bir event loop üzerinde çalışır; ancak `async/await` yapısı **kooperatif çoklu görev** (cooperative multitasking) modelini hayata geçirir: bir coroutine `await` noktasında askıya alındığında, event loop diğer coroutine'leri çalıştırmaya devam edebilir. Bu davranış, `HALF_OPEN` durumunda kritik bir risk yaratır: herhangi bir guard mekanizması olmaksızın, o anda gelen tüm istekler aynı `HALF_OPEN` durumunu okuyup eş zamanlı olarak ilerleyebilir — yeni toparlanmaya başlayan bir servisi bir anda çok sayıda istekle boğabilir.
+
+Bunu önlemek için circuit breaker bir **probe flag** kullanır: yalnızca ilk çağıran probe slotunu alır; probe tamamlanana kadar diğer tüm eş zamanlı çağrılar `CircuitBreakerOpenException` ile reddedilir. Bu bilinçli bir tasarım kararıdır — birkaç isteği feda ederek servisin gerçekten sağlıklı olup olmadığı güvenli biçimde doğrulanır.
+
+## Observability
+
+Adaptör, iki katmanlı bir observability sistemiyle birlikte gelir. **Observer'lar salt okunurdur** — request veya response'u değiştiremezler. Metrics, yapılandırılmış loglama ve dağıtık izleme için observer'ları, pipeline'ı değiştirmeniz gerektiğinde ise interceptor'ları kullanın.
+
+### `HttpAdapterObserver`
+
+Builder üzerindeki `.withObserver()` metoduyla adaptöre tek bir observer bağlanır.
+
+| Hook | Ne zaman tetiklenir |
+|---|---|
+| `onRequestStart(request)` | Tüm request interceptor'larından sonra, HTTP çağrısından hemen önce |
+| `onRequestSuccess(response, durationMs)` | Başarılı yanıt sonrasında (retry süresi dahil) |
+| `onRequestFailure(error, durationMs)` | Son hata çağırana iletildiğinde |
+| `onRetry(attempt, error, delayMs)` | Her retry planlandığında, backoff gecikmesinden önce |
+
+```typescript
+import { HttpAdapterObserver, HttpAdapter, RetryPolicies } from '@yildizpay/http-adapter';
+
+class MetricsObserver implements HttpAdapterObserver {
+  onRequestSuccess(_response: Response, durationMs: number): void {
+    metrics.histogram('http.request.duration', durationMs);
+  }
+
+  onRequestFailure(error: BaseAdapterException, durationMs: number): void {
+    metrics.increment('http.request.error', { type: error.name });
+  }
+
+  onRetry(attempt: number, _error: BaseAdapterException, delayMs: number): void {
+    logger.warn(`Retry denemesi ${attempt}, ${delayMs}ms sonra`);
+  }
+}
+
+const adapter = HttpAdapter.builder()
+  .withRetryPolicy(RetryPolicies.exponential(3))
+  .withObserver(new MetricsObserver())
+  .build();
+```
+
+### `CircuitBreakerObserver`
+
+Fluent `.observe()` metodu aracılığıyla bir `CircuitBreaker` instance'ına observer bağlanır.
+
+| Hook | Ne zaman tetiklenir |
+|---|---|
+| `onStateChange(from, to)` | Her state geçişinde (CLOSED↔OPEN↔HALF_OPEN) |
+| `onSuccess()` | Her başarılı çalıştırma sonrasında |
+| `onFailure(error)` | Bir hata sayıldığında (`isFailure` predicate `true` döndürdüğünde) |
+| `onProbeRejected()` | HALF_OPEN'da eş zamanlı bir çağıran reddedildiğinde |
+
+```typescript
+import { CircuitBreaker, CircuitBreakerObserver, CircuitState } from '@yildizpay/http-adapter';
+
+class CircuitMetricsObserver implements CircuitBreakerObserver {
+  onStateChange(from: CircuitState, to: CircuitState): void {
+    logger.warn(`Circuit breaker: ${from} → ${to}`);
+    metrics.increment('circuit_breaker.state_change', { from, to });
+  }
+
+  onProbeRejected(): void {
+    metrics.increment('circuit_breaker.probe_rejected');
+  }
+}
+
+const adapter = HttpAdapter.builder()
+  .withCircuitBreaker(
+    new CircuitBreaker({ failureThreshold: 5 })
+      .observe(new CircuitMetricsObserver()),
+  )
+  .withObserver(new MetricsObserver())
+  .build();
 ```
 
 ## Interceptors

package/dist/builders/http-adapter.builder.d.ts

@@ -4,16 +4,19 @@ import { RetryPolicy } from '../contracts/retry-policy.contract';
 import { HttpClientContract } from '../contracts/http-client.contract';
 import { CircuitBreaker } from '../resilience/circuit-breaker/circuit-breaker';
 import { CircuitBreakerOptions } from '../resilience/circuit-breaker/circuit-breaker-options';
+import { HttpAdapterObserver } from '../observability/http-adapter-observer';
 export declare class HttpAdapterBuilder {
     private readonly interceptors;
     private retryPolicy;
     private httpClient;
     private circuitBreaker;
     private correlationIdConfig;
+    private observer;
     withInterceptor(...interceptors: HttpInterceptor[]): this;
     withRetryPolicy(policy: RetryPolicy): this;
     withCircuitBreaker(breaker: CircuitBreaker | CircuitBreakerOptions): this;
     withHttpClient(client: HttpClientContract): this;
     withCorrelationId(header?: string): this;
+    withObserver(observer: HttpAdapterObserver): this;
     build(): HttpAdapter;
 }

package/dist/builders/http-adapter.builder.js

@@ -28,8 +28,12 @@ class HttpAdapterBuilder {
         this.correlationIdConfig = { enabled: true, header: header ?? correlation_id_config_1.DEFAULT_CORRELATION_ID_HEADER };
         return this;
     }
+    withObserver(observer) {
+        this.observer = observer;
+        return this;
+    }
     build() {
-        return http_adapter_1.HttpAdapter.create(this.interceptors, this.retryPolicy, this.httpClient, this.circuitBreaker, this.correlationIdConfig);
+        return http_adapter_1.HttpAdapter.create(this.interceptors, this.retryPolicy, this.httpClient, this.circuitBreaker, this.correlationIdConfig, this.observer);
     }
 }
 exports.HttpAdapterBuilder = HttpAdapterBuilder;

package/dist/builders/http-adapter.builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-adapter.builder.js","sourceRoot":"","sources":["../../src/builders/http-adapter.builder.ts"],"names":[],"mappings":";;;AAAA,uDAAmD;AAInD,mFAA+E;AAE/E,2EAGyC;AAmBzC,MAAa,kBAAkB;IAA/B;QACmB,iBAAY,GAAsB,EAAE,CAAC;IA0FxD,CAAC;IA9EQ,eAAe,CAAC,GAAG,YAA+B;QACvD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAOM,eAAe,CAAC,MAAmB;QACxC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAWM,kBAAkB,CAAC,OAA+C;QACvE,IAAI,CAAC,cAAc,GAAG,OAAO,YAAY,gCAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,gCAAc,CAAC,OAAO,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC;IACd,CAAC;IASM,cAAc,CAAC,MAA0B;QAC9C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAoBM,iBAAiB,CAAC,MAAe;QACtC,IAAI,CAAC,mBAAmB,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,qDAA6B,EAAE,CAAC;QAC9F,OAAO,IAAI,CAAC;IACd,CAAC;IAOM,KAAK;QACV,OAAO,0BAAW,CAAC,MAAM,CACvB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,mBAAmB,CACzB,CAAC;IACJ,CAAC;CACF;AA3FD,gDA2FC"}
+{"version":3,"file":"http-adapter.builder.js","sourceRoot":"","sources":["../../src/builders/http-adapter.builder.ts"],"names":[],"mappings":";;;AAAA,uDAAmD;AAInD,mFAA+E;AAE/E,2EAGyC;AAoBzC,MAAa,kBAAkB;IAA/B;QACmB,iBAAY,GAAsB,EAAE,CAAC;IA+GxD,CAAC;IAlGQ,eAAe,CAAC,GAAG,YAA+B;QACvD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAOM,eAAe,CAAC,MAAmB;QACxC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAWM,kBAAkB,CAAC,OAA+C;QACvE,IAAI,CAAC,cAAc,GAAG,OAAO,YAAY,gCAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,gCAAc,CAAC,OAAO,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC;IACd,CAAC;IASM,cAAc,CAAC,MAA0B;QAC9C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAoBM,iBAAiB,CAAC,MAAe;QACtC,IAAI,CAAC,mBAAmB,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,qDAA6B,EAAE,CAAC;QAC9F,OAAO,IAAI,CAAC;IACd,CAAC;IAgBM,YAAY,CAAC,QAA6B;QAC/C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAOM,KAAK;QACV,OAAO,0BAAW,CAAC,MAAM,CACvB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,QAAQ,CACd,CAAC;IACJ,CAAC;CACF;AAhHD,gDAgHC"}

package/dist/core/http.adapter.d.ts

@@ -6,16 +6,28 @@ import { CircuitBreaker } from '../resilience/circuit-breaker/circuit-breaker';
 import { HttpClientContract } from '../contracts/http-client.contract';
 import { HttpAdapterBuilder } from '../builders/http-adapter.builder';
 import { CorrelationIdConfig } from '../models/correlation-id-config';
+import { HttpAdapterObserver } from '../observability/http-adapter-observer';
 export declare class HttpAdapter {
-    private readonly interceptors;
     private readonly httpClient;
     private readonly retryPolicy?;
     private readonly circuitBreaker?;
     private readonly correlationIdConfig?;
+    private readonly observer?;
+    private readonly requestInterceptors;
+    private readonly responseInterceptors;
+    private readonly validatedResponseInterceptors;
+    private readonly errorInterceptors;
     private constructor();
-    static create(interceptors: HttpInterceptor[], retryPolicy?: RetryPolicy, httpClient?: HttpClientContract, circuitBreaker?: CircuitBreaker, correlationIdConfig?: CorrelationIdConfig): HttpAdapter;
+    static create(interceptors: HttpInterceptor[], retryPolicy?: RetryPolicy, httpClient?: HttpClientContract, circuitBreaker?: CircuitBreaker, correlationIdConfig?: CorrelationIdConfig, observer?: HttpAdapterObserver): HttpAdapter;
     static builder(): HttpAdapterBuilder;
     send<T = unknown>(request: Request): Promise<Response<T>>;
     private dispatch;
+    private runRequestInterceptors;
+    private buildRequestUrl;
+    private executeHttpCall;
+    private runResponseInterceptors;
+    private runValidators;
+    private runPostValidationInterceptors;
+    private runErrorInterceptors;
     private applyCorrelationIdHeader;
 }

package/dist/core/http.adapter.js

@@ -10,46 +10,51 @@ const validation_exception_1 = require("../exceptions/validation.exception");
 const http_adapter_builder_1 = require("../builders/http-adapter.builder");
 const correlation_id_config_1 = require("../models/correlation-id-config");
 class HttpAdapter {
-    constructor(interceptors, httpClient, retryPolicy, circuitBreaker, correlationIdConfig) {
-        this.interceptors = interceptors;
+    constructor(interceptors, httpClient, retryPolicy, circuitBreaker, correlationIdConfig, observer) {
         this.httpClient = httpClient;
         this.retryPolicy = retryPolicy;
         this.circuitBreaker = circuitBreaker;
         this.correlationIdConfig = correlationIdConfig;
+        this.observer = observer;
+        this.requestInterceptors = interceptors.filter((i) => typeof i.onRequest === 'function');
+        this.responseInterceptors = interceptors.filter((i) => typeof i.onResponse === 'function');
+        this.validatedResponseInterceptors = interceptors.filter((i) => typeof i.onResponseValidated === 'function');
+        this.errorInterceptors = interceptors.filter((i) => typeof i.onError === 'function');
     }
-    static create(interceptors, retryPolicy, httpClient, circuitBreaker, correlationIdConfig) {
-        return new HttpAdapter(interceptors, httpClient ?? default_http_client_1.defaultHttpClient, retryPolicy, circuitBreaker, correlationIdConfig);
+    static create(interceptors, retryPolicy, httpClient, circuitBreaker, correlationIdConfig, observer) {
+        return new HttpAdapter(interceptors, httpClient ?? default_http_client_1.defaultHttpClient, retryPolicy, circuitBreaker, correlationIdConfig, observer);
     }
     static builder() {
         return new http_adapter_builder_1.HttpAdapterBuilder();
     }
     async send(request) {
+        const startTime = Date.now();
         const executePipeline = () => {
             if (!this.retryPolicy) {
                 return this.dispatch(request);
             }
-            const executor = new retry_executor_1.RetryExecutor(this.retryPolicy);
+            const executor = new retry_executor_1.RetryExecutor(this.retryPolicy, this.observer);
             return executor.execute(() => this.dispatch(request));
         };
-        if (!this.circuitBreaker) {
-            return executePipeline();
+        try {
+            const response = await (this.circuitBreaker
+                ? this.circuitBreaker.execute(executePipeline)
+                : executePipeline());
+            this.observer?.onRequestSuccess?.(response, Date.now() - startTime);
+            return response;
         }
-        return this.circuitBreaker.execute(executePipeline);
-    }
-    async dispatch(request) {
-        let processedRequest = request;
-        for (const interceptor of this.interceptors) {
-            if (interceptor.onRequest) {
-                processedRequest = await interceptor.onRequest(processedRequest);
+        catch (error) {
+            if (error instanceof base_adapter_exception_1.BaseAdapterException) {
+                this.observer?.onRequestFailure?.(error, Date.now() - startTime);
             }
+            throw error;
         }
+    }
+    async dispatch(request) {
+        const processedRequest = await this.runRequestInterceptors(request);
         let requestContext;
         try {
-            const url = new URL(processedRequest.endpoint, processedRequest.baseUrl);
-            const searchParams = new URLSearchParams(processedRequest.queryParams);
-            if (searchParams.toString()) {
-                url.search = searchParams.toString();
-            }
+            const url = this.buildRequestUrl(processedRequest);
             requestContext = {
                 method: processedRequest.method,
                 url: url.toString(),
@@ -57,46 +62,75 @@ class HttpAdapter {
             };
             processedRequest.setTimestamp(new Date());
             this.applyCorrelationIdHeader(processedRequest);
-            const clientResponse = await this.httpClient.request({
-                url: requestContext.url,
-                method: processedRequest.method,
-                data: processedRequest.body,
-                headers: processedRequest.headers,
-                timeout: processedRequest.options?.timeout,
-            });
-            let response = response_1.Response.create(clientResponse.data, clientResponse.status, clientResponse.headers ?? null, requestContext);
-            for (const interceptor of this.interceptors) {
-                if (interceptor.onResponse) {
-                    response = (await interceptor.onResponse(response));
-                }
-            }
-            for (const validator of request.validators) {
-                try {
-                    await validator.validate(response);
-                }
-                catch (err) {
-                    if (err instanceof base_adapter_exception_1.BaseAdapterException)
-                        throw err;
-                    throw new validation_exception_1.ValidationException('Response validation failed', response, err);
-                }
-            }
-            for (const interceptor of this.interceptors) {
-                if (interceptor.onResponseValidated) {
-                    response = (await interceptor.onResponseValidated(response));
-                }
-            }
-            return response;
+            this.observer?.onRequestStart?.(processedRequest);
+            const response = await this.executeHttpCall(processedRequest, url, requestContext);
+            const interceptedResponse = await this.runResponseInterceptors(response);
+            await this.runValidators(interceptedResponse, request);
+            return await this.runPostValidationInterceptors(interceptedResponse);
         }
         catch (error) {
-            let propagatedError = error_converter_1.ErrorConverter.toAdapterException(error, requestContext);
-            for (const interceptor of this.interceptors) {
-                if (interceptor.onError) {
-                    propagatedError = await interceptor.onError(propagatedError, processedRequest);
-                }
-            }
+            const propagatedError = await this.runErrorInterceptors(error_converter_1.ErrorConverter.toAdapterException(error, requestContext), processedRequest);
             throw propagatedError;
         }
     }
+    async runRequestInterceptors(request) {
+        let processedRequest = request;
+        for (const interceptor of this.requestInterceptors) {
+            processedRequest = await interceptor.onRequest(processedRequest);
+        }
+        return processedRequest;
+    }
+    buildRequestUrl(request) {
+        const url = new URL(request.endpoint, request.baseUrl);
+        const searchParams = new URLSearchParams(request.queryParams);
+        if (searchParams.toString()) {
+            url.search = searchParams.toString();
+        }
+        return url;
+    }
+    async executeHttpCall(request, url, requestContext) {
+        const clientResponse = await this.httpClient.request({
+            url: url.toString(),
+            method: request.method,
+            data: request.body,
+            headers: request.headers,
+            timeout: request.options?.timeout,
+        });
+        return response_1.Response.create(clientResponse.data, clientResponse.status, clientResponse.headers ?? null, requestContext);
+    }
+    async runResponseInterceptors(response) {
+        let result = response;
+        for (const interceptor of this.responseInterceptors) {
+            result = (await interceptor.onResponse(result));
+        }
+        return result;
+    }
+    async runValidators(response, request) {
+        for (const validator of request.validators) {
+            try {
+                await validator.validate(response);
+            }
+            catch (err) {
+                if (err instanceof base_adapter_exception_1.BaseAdapterException)
+                    throw err;
+                throw new validation_exception_1.ValidationException('Response validation failed', response, err);
+            }
+        }
+    }
+    async runPostValidationInterceptors(response) {
+        let result = response;
+        for (const interceptor of this.validatedResponseInterceptors) {
+            result = (await interceptor.onResponseValidated(result));
+        }
+        return result;
+    }
+    async runErrorInterceptors(error, request) {
+        let propagatedError = error;
+        for (const interceptor of this.errorInterceptors) {
+            propagatedError = await interceptor.onError(propagatedError, request);
+        }
+        return propagatedError;
+    }
     applyCorrelationIdHeader(request) {
         const effectiveConfig = request.correlationIdConfig ?? this.correlationIdConfig;
         if (!effectiveConfig?.enabled)

package/dist/core/http.adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.adapter.js","sourceRoot":"","sources":["../../src/core/http.adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http.adapter.js","sourceRoot":"","sources":["../../src/core/http.adapter.ts"],"names":[],"mappings":";;;AAAA,+DAA0D;AAE1D,iDAA8C;AAU9C,iEAA6D;AAG7D,uDAAmD;AACnD,iFAA4E;AAC5E,6EAAyE;AACzE,2EAAsE;AACtE,2EAGyC;AAczC,MAAa,WAAW;IAgBtB,YACE,YAA+B,EACd,UAA8B,EAC9B,WAAyB,EACzB,cAA+B,EAC/B,mBAAyC,EACzC,QAA8B;QAJ9B,eAAU,GAAV,UAAU,CAAoB;QAC9B,gBAAW,GAAX,WAAW,CAAc;QACzB,mBAAc,GAAd,cAAc,CAAiB;QAC/B,wBAAmB,GAAnB,mBAAmB,CAAsB;QACzC,aAAQ,GAAR,QAAQ,CAAsB;QAE/C,IAAI,CAAC,mBAAmB,GAAG,YAAY,CAAC,MAAM,CAC5C,CAAC,CAAC,EAA+B,EAAE,CAAC,OAAO,CAAC,CAAC,SAAS,KAAK,UAAU,CACtE,CAAC;QACF,IAAI,CAAC,oBAAoB,GAAG,YAAY,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAgC,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,KAAK,UAAU,CACxE,CAAC;QACF,IAAI,CAAC,6BAA6B,GAAG,YAAY,CAAC,MAAM,CACtD,CAAC,CAAC,EAAyC,EAAE,CAAC,OAAO,CAAC,CAAC,mBAAmB,KAAK,UAAU,CAC1F,CAAC;QACF,IAAI,CAAC,iBAAiB,GAAG,YAAY,CAAC,MAAM,CAC1C,CAAC,CAAC,EAA6B,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU,CAClE,CAAC;IACJ,CAAC;IAaM,MAAM,CAAC,MAAM,CAClB,YAA+B,EAC/B,WAAyB,EACzB,UAA+B,EAC/B,cAA+B,EAC/B,mBAAyC,EACzC,QAA8B;QAE9B,OAAO,IAAI,WAAW,CACpB,YAAY,EACZ,UAAU,IAAI,uCAAiB,EAC/B,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,QAAQ,CACT,CAAC;IACJ,CAAC;IAmBM,MAAM,CAAC,OAAO;QACnB,OAAO,IAAI,yCAAkB,EAAE,CAAC;IAClC,CAAC;IAUM,KAAK,CAAC,IAAI,CAAc,OAAgB;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,eAAe,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC,QAAQ,CAAI,OAAO,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,8BAAa,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpE,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAI,OAAO,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc;gBACzC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,eAAe,CAAC;gBAC9C,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;YAEvB,IAAI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;YACpE,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,6CAAoB,EAAE,CAAC;gBAC1C,IAAI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;YACnE,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAOO,KAAK,CAAC,QAAQ,CAAc,OAAgB;QAClD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAEpE,IAAI,cAA0C,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;YAEnD,cAAc,GAAG;gBACf,MAAM,EAAE,gBAAgB,CAAC,MAAgB;gBACzC,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;gBACnB,aAAa,EAAE,gBAAgB,CAAC,mBAAmB;aACpD,CAAC;YAEF,gBAAgB,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;YAEhD,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC,gBAAgB,CAAC,CAAC;YAElD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAI,gBAAgB,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;YACtF,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAI,QAAQ,CAAC,CAAC;YAC5E,MAAM,IAAI,CAAC,aAAa,CAAI,mBAAmB,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO,MAAM,IAAI,CAAC,6BAA6B,CAAI,mBAAmB,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,oBAAoB,CACrD,gCAAc,CAAC,kBAAkB,CAAC,KAAK,EAAE,cAAc,CAAC,EACxD,gBAAgB,CACjB,CAAC;YACF,MAAM,eAAe,CAAC;QACxB,CAAC;IACH,CAAC;IAOO,KAAK,CAAC,sBAAsB,CAAC,OAAgB;QACnD,IAAI,gBAAgB,GAAG,OAAO,CAAC;QAC/B,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACnD,gBAAgB,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAOO,eAAe,CAAC,OAAgB;QACtC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9D,IAAI,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC5B,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAOO,KAAK,CAAC,eAAe,CAC3B,OAAgB,EAChB,GAAQ,EACR,cAA8B;QAE9B,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAI;YACtD,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;YACnB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO;SAClC,CAAC,CAAC;QAEH,OAAO,mBAAQ,CAAC,MAAM,CACpB,cAAc,CAAC,IAAI,EACnB,cAAc,CAAC,MAAM,EACrB,cAAc,CAAC,OAAO,IAAI,IAAI,EAC9B,cAAc,CACf,CAAC;IACJ,CAAC;IAQO,KAAK,CAAC,uBAAuB,CAAI,QAAqB;QAC5D,IAAI,MAAM,GAAG,QAAQ,CAAC;QACtB,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACpD,MAAM,GAAG,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAgB,CAAC;QACjE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAQO,KAAK,CAAC,aAAa,CAAI,QAAqB,EAAE,OAAgB;QACpE,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,6CAAoB;oBAAE,MAAM,GAAG,CAAC;gBACnD,MAAM,IAAI,0CAAmB,CAAC,4BAA4B,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IAOO,KAAK,CAAC,6BAA6B,CAAI,QAAqB;QAClE,IAAI,MAAM,GAAG,QAAQ,CAAC;QACtB,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,6BAA6B,EAAE,CAAC;YAC7D,MAAM,GAAG,CAAC,MAAM,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAgB,CAAC;QAC1E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAOO,KAAK,CAAC,oBAAoB,CAChC,KAA2B,EAC3B,OAAgB;QAEhB,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACjD,eAAe,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAcO,wBAAwB,CAAC,OAAgB;QAC/C,MAAM,eAAe,GAAG,OAAO,CAAC,mBAAmB,IAAI,IAAI,CAAC,mBAAmB,CAAC;QAEhF,IAAI,CAAC,eAAe,EAAE,OAAO;YAAE,OAAO;QAEtC,MAAM,UAAU,GACd,OAAO,CAAC,mBAAmB,EAAE,MAAM;YACnC,IAAI,CAAC,mBAAmB,EAAE,MAAM;YAChC,qDAA6B,CAAC;QAEhC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7D,CAAC;CACF;AAxSD,kCAwSC"}

package/dist/exceptions/circuit-breaker-open.exception.d.ts

@@ -1,4 +1,6 @@
 import { BaseAdapterException } from './base-adapter.exception';
 export declare class CircuitBreakerOpenException extends BaseAdapterException {
-    constructor(message?: string);
+    readonly nextAttemptAt: number;
+    constructor(nextAttemptAt?: number, message?: string);
+    retryAfterMs(): number;
 }

package/dist/exceptions/circuit-breaker-open.exception.js

@@ -3,11 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CircuitBreakerOpenException = void 0;
 const base_adapter_exception_1 = require("./base-adapter.exception");
 class CircuitBreakerOpenException extends base_adapter_exception_1.BaseAdapterException {
-    constructor(message = 'Circuit Breaker is OPEN. Execution denied.') {
+    constructor(nextAttemptAt = 0, message = 'Circuit Breaker is OPEN. Execution denied.') {
         super(message);
         this.name = 'CircuitBreakerOpenException';
+        this.nextAttemptAt = nextAttemptAt;
         Object.setPrototypeOf(this, CircuitBreakerOpenException.prototype);
     }
+    retryAfterMs() {
+        return Math.max(0, this.nextAttemptAt - Date.now());
+    }
 }
 exports.CircuitBreakerOpenException = CircuitBreakerOpenException;
 //# sourceMappingURL=circuit-breaker-open.exception.js.map

package/dist/exceptions/circuit-breaker-open.exception.js.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-breaker-open.exception.js","sourceRoot":"","sources":["../../src/exceptions/circuit-breaker-open.exception.ts"],"names":[],"mappings":";;;AAAA,qEAAgE;AAKhE,MAAa,2BAA4B,SAAQ,6CAAoB;IACnE,YAAY,UAAkB,4CAA4C;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC;CACF;AAND,kEAMC"}
+{"version":3,"file":"circuit-breaker-open.exception.js","sourceRoot":"","sources":["../../src/exceptions/circuit-breaker-open.exception.ts"],"names":[],"mappings":";;;AAAA,qEAAgE;AAahE,MAAa,2BAA4B,SAAQ,6CAAoB;IAOnE,YACE,gBAAwB,CAAC,EACzB,UAAkB,4CAA4C;QAE9D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC;IAMM,YAAY;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;CACF;AAxBD,kEAwBC"}

package/dist/index.d.ts

@@ -20,6 +20,8 @@ export * from './resilience/policies/decorrelated-jitter.retry-policy';
 export * from './resilience/circuit-breaker/circuit-state.enum';
 export * from './resilience/circuit-breaker/circuit-breaker-options';
 export * from './resilience/circuit-breaker/circuit-breaker';
+export * from './observability/http-adapter-observer';
+export * from './observability/circuit-breaker-observer';
 export * from './auth/token-provider';
 export * from './auth/bearer-auth.interceptor';
 export * from './auth/basic-auth.interceptor';

package/dist/index.js

@@ -36,6 +36,8 @@ __exportStar(require("./resilience/policies/decorrelated-jitter.retry-policy"),
 __exportStar(require("./resilience/circuit-breaker/circuit-state.enum"), exports);
 __exportStar(require("./resilience/circuit-breaker/circuit-breaker-options"), exports);
 __exportStar(require("./resilience/circuit-breaker/circuit-breaker"), exports);
+__exportStar(require("./observability/http-adapter-observer"), exports);
+__exportStar(require("./observability/circuit-breaker-observer"), exports);
 __exportStar(require("./auth/token-provider"), exports);
 __exportStar(require("./auth/bearer-auth.interceptor"), exports);
 __exportStar(require("./auth/basic-auth.interceptor"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,sDAAoC;AACpC,6DAA2C;AAG3C,6DAA2C;AAC3C,kEAAgD;AAGhD,mDAAiC;AACjC,oDAAkC;AAClC,2DAAyC;AACzC,2DAAyC;AACzC,iEAA+C;AAG/C,wEAAsD;AACtD,oEAAkD;AAClD,uEAAqD;AACrD,0EAAwD;AAGxD,8DAA4C;AAC5C,yFAAuE;AACvE,iFAA+D;AAC/D,oFAAkE;AAClE,iFAA+D;AAC/D,yFAAuE;AACvE,kFAAgE;AAChE,uFAAqE;AACrE,+EAA6D;AAG7D,wDAAsC;AACtC,iEAA+C;AAC/C,gEAA8C;AAC9C,6DAA2C;AAG3C,kEAAgD;AAChD,4DAA0C;AAG1C,8EAA4D;AAC5D,sEAAoD;AACpD,sEAAoD;AACpD,sEAAoD;AACpD,kEAAgD;AAChD,yEAAuD;AACvD,iEAA+C;AAC/C,oEAAkD;AAClD,gEAA8C;AAC9C,yDAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,sDAAoC;AACpC,6DAA2C;AAG3C,6DAA2C;AAC3C,kEAAgD;AAGhD,mDAAiC;AACjC,oDAAkC;AAClC,2DAAyC;AACzC,2DAAyC;AACzC,iEAA+C;AAG/C,wEAAsD;AACtD,oEAAkD;AAClD,uEAAqD;AACrD,0EAAwD;AAGxD,8DAA4C;AAC5C,yFAAuE;AACvE,iFAA+D;AAC/D,oFAAkE;AAClE,iFAA+D;AAC/D,yFAAuE;AACvE,kFAAgE;AAChE,uFAAqE;AACrE,+EAA6D;AAG7D,wEAAsD;AACtD,2EAAyD;AAGzD,wDAAsC;AACtC,iEAA+C;AAC/C,gEAA8C;AAC9C,6DAA2C;AAG3C,kEAAgD;AAChD,4DAA0C;AAG1C,8EAA4D;AAC5D,sEAAoD;AACpD,sEAAoD;AACpD,sEAAoD;AACpD,kEAAgD;AAChD,yEAAuD;AACvD,iEAA+C;AAC/C,oEAAkD;AAClD,gEAA8C;AAC9C,yDAAuC"}

package/dist/observability/circuit-breaker-observer.d.ts

@@ -0,0 +1,7 @@
+import { CircuitState } from '../resilience/circuit-breaker/circuit-state.enum';
+export interface CircuitBreakerObserver {
+    onStateChange?(from: CircuitState, to: CircuitState): void;
+    onSuccess?(): void;
+    onFailure?(error: unknown): void;
+    onProbeRejected?(): void;
+}

package/dist/observability/circuit-breaker-observer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=circuit-breaker-observer.js.map

package/dist/observability/circuit-breaker-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker-observer.js","sourceRoot":"","sources":["../../src/observability/circuit-breaker-observer.ts"],"names":[],"mappings":""}

package/dist/observability/http-adapter-observer.d.ts

@@ -0,0 +1,9 @@
+import { Request } from '../models/request';
+import { Response } from '../models/response';
+import { BaseAdapterException } from '../exceptions/base-adapter.exception';
+export interface HttpAdapterObserver {
+    onRequestStart?(request: Request): void;
+    onRequestSuccess?(response: Response, durationMs: number): void;
+    onRequestFailure?(error: BaseAdapterException, durationMs: number): void;
+    onRetry?(attempt: number, error: BaseAdapterException, delayMs: number): void;
+}

package/dist/observability/http-adapter-observer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=http-adapter-observer.js.map

package/dist/observability/http-adapter-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter-observer.js","sourceRoot":"","sources":["../../src/observability/http-adapter-observer.ts"],"names":[],"mappings":""}

package/dist/resilience/circuit-breaker/circuit-breaker.d.ts

@@ -1,15 +1,19 @@
 import { CircuitState } from './circuit-state.enum';
 import { CircuitBreakerOptions } from './circuit-breaker-options';
+import { CircuitBreakerObserver } from '../../observability/circuit-breaker-observer';
 export declare class CircuitBreaker {
     private state;
     private failureCount;
     private successCount;
     private nextAttemptAt;
+    private halfOpenProbeInFlight;
+    private observer;
     private readonly failureThreshold;
     private readonly resetTimeoutMs;
     private readonly successThreshold;
     private readonly isFailurePredicate;
     constructor(options?: CircuitBreakerOptions);
+    observe(observer: CircuitBreakerObserver): this;
     getState(): CircuitState;
     execute<T>(operation: () => Promise<T>): Promise<T>;
     private recordSuccess;