@yildizpay/http-adapter 3.7.0 → 3.8.1

package/README.md

@@ -415,6 +415,78 @@ Node.js runs on a single-threaded event loop, but `async/await` introduces coope
 
 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
 
 Thanks to the **Interface Segregation Principle (ISP)**, you aren't forced to implement massive interfaces. You can hook into the exact lifecycle event you need by implementing `HttpRequestInterceptor`, `HttpResponseInterceptor`, or `HttpErrorInterceptor`.

package/README.tr.md

@@ -415,6 +415,78 @@ Node.js, tek iş parçacıklı (single-threaded) bir event loop üzerinde çalı
 
 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
 
 **Interface Segregation Principle (ISP)** sayesinde gereksiz metodları implement etmek zorunda kalmazsınız. Yalnızca ihtiyaç duyduğunuz lifecycle event'e göre `HttpRequestInterceptor`, `HttpResponseInterceptor` veya `HttpErrorInterceptor` interface'ini implement edebilirsiniz.

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/default-http-client.js

@@ -18,7 +18,9 @@ class FetchHttpClient {
                     'Content-Type': 'application/json',
                     ...config.headers,
                 },
-                body: config.data ? JSON.stringify(config.data) : undefined,
+                body: config.method !== 'GET' && config.method !== 'HEAD' && config.data
+                    ? JSON.stringify(config.data)
+                    : undefined,
                 signal: controller.signal,
             });
             let responseData = null;

package/dist/core/default-http-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-http-client.js","sourceRoot":"","sources":["../../src/core/default-http-client.ts"],"names":[],"mappings":";;;AAKA,uFAAkF;AAClF,iFAA4E;AAC5E,iFAA4E;AAQ5E,MAAa,eAAe;IACnB,KAAK,CAAC,OAAO,CAClB,MAA+B;QAE/B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,SAAqC,CAAC;QAE1C,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACzC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE;gBACvC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,GAAG,MAAM,CAAC,OAAO;iBAClB;gBACD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC3D,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,YAAY,GAAY,IAAI,CAAC;YACjC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAEzD,IAAI,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC9C,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACzD,CAAC;YAED,MAAM,eAAe,GAA2B,EAAE,CAAC;YACnD,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACtC,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC/B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,6CAAoB,CAAC,kBAAkB,CAC3C,QAAQ,CAAC,MAAM,EACf,YAAiB,EACjB,eAAe,EACf,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAChD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,YAAiB;gBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,eAAe;aACzB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,6CAAoB;gBAAE,MAAM,KAAK,CAAC;YACvD,MAAM,mDAAuB,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC7D,CAAC;gBAAS,CAAC;YACT,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA3DD,0CA2DC;AAEY,QAAA,iBAAiB,GAAG,IAAI,eAAe,EAAE,CAAC"}
+{"version":3,"file":"default-http-client.js","sourceRoot":"","sources":["../../src/core/default-http-client.ts"],"names":[],"mappings":";;;AAKA,uFAAkF;AAClF,iFAA4E;AAC5E,iFAA4E;AAQ5E,MAAa,eAAe;IACnB,KAAK,CAAC,OAAO,CAClB,MAA+B;QAE/B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,SAAqC,CAAC;QAE1C,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACzC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE;gBACvC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,GAAG,MAAM,CAAC,OAAO;iBAClB;gBACD,IAAI,EACF,MAAM,CAAC,MAAM,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI;oBAChE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;oBAC7B,CAAC,CAAC,SAAS;gBACf,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,YAAY,GAAY,IAAI,CAAC;YACjC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAEzD,IAAI,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC9C,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACzD,CAAC;YAED,MAAM,eAAe,GAA2B,EAAE,CAAC;YACnD,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACtC,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC/B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,6CAAoB,CAAC,kBAAkB,CAC3C,QAAQ,CAAC,MAAM,EACf,YAAiB,EACjB,eAAe,EACf,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAChD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,YAAiB;gBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,eAAe;aACzB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,6CAAoB;gBAAE,MAAM,KAAK,CAAC;YACvD,MAAM,mDAAuB,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC7D,CAAC;gBAAS,CAAC;YACT,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA9DD,0CA8DC;AAEY,QAAA,iBAAiB,GAAG,IAAI,eAAe,EAAE,CAAC"}

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

@@ -6,17 +6,19 @@ 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 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;

package/dist/core/http.adapter.js

@@ -10,34 +10,45 @@ 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) {
+    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;
+        }
+        catch (error) {
+            if (error instanceof base_adapter_exception_1.BaseAdapterException) {
+                this.observer?.onRequestFailure?.(error, Date.now() - startTime);
+            }
+            throw error;
         }
-        return this.circuitBreaker.execute(executePipeline);
     }
     async dispatch(request) {
         const processedRequest = await this.runRequestInterceptors(request);
@@ -51,6 +62,7 @@ class HttpAdapter {
             };
             processedRequest.setTimestamp(new Date());
             this.applyCorrelationIdHeader(processedRequest);
+            this.observer?.onRequestStart?.(processedRequest);
             const response = await this.executeHttpCall(processedRequest, url, requestContext);
             const interceptedResponse = await this.runResponseInterceptors(response);
             await this.runValidators(interceptedResponse, request);

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":"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"}

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,16 +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;

package/dist/resilience/circuit-breaker/circuit-breaker.js

@@ -15,6 +15,10 @@ class CircuitBreaker {
         this.successThreshold = options?.successThreshold ?? 1;
         this.isFailurePredicate = options?.isFailure ?? (() => true);
     }
+    observe(observer) {
+        this.observer = observer;
+        return this;
+    }
     getState() {
         if (this.state === circuit_state_enum_1.CircuitState.OPEN && Date.now() >= this.nextAttemptAt) {
             this.transitionTo(circuit_state_enum_1.CircuitState.HALF_OPEN);
@@ -27,18 +31,22 @@ class CircuitBreaker {
             throw new circuit_breaker_open_exception_1.CircuitBreakerOpenException(this.nextAttemptAt);
         }
         if (currentState === circuit_state_enum_1.CircuitState.HALF_OPEN) {
-            if (this.halfOpenProbeInFlight)
+            if (this.halfOpenProbeInFlight) {
+                this.observer?.onProbeRejected?.();
                 throw new circuit_breaker_open_exception_1.CircuitBreakerOpenException(0, 'Circuit Breaker is HALF_OPEN. A probe request is already in flight.');
+            }
             this.halfOpenProbeInFlight = true;
         }
         try {
             const result = await operation();
             this.recordSuccess();
+            this.observer?.onSuccess?.();
             return result;
         }
         catch (error) {
             if (this.isFailurePredicate(error)) {
                 this.recordFailure();
+                this.observer?.onFailure?.(error);
             }
             throw error;
         }
@@ -71,11 +79,13 @@ class CircuitBreaker {
         }
     }
     transitionTo(newState) {
+        const previousState = this.state;
         this.state = newState;
         this.failureCount = 0;
         this.successCount = 0;
         this.halfOpenProbeInFlight = false;
         this.nextAttemptAt = newState === circuit_state_enum_1.CircuitState.OPEN ? Date.now() + this.resetTimeoutMs : 0;
+        this.observer?.onStateChange?.(previousState, newState);
     }
 }
 exports.CircuitBreaker = CircuitBreaker;

package/dist/resilience/circuit-breaker/circuit-breaker.js.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../../src/resilience/circuit-breaker/circuit-breaker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../../src/resilience/circuit-breaker/circuit-breaker.ts"],"names":[],"mappings":"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"}

package/dist/resilience/retry-executor.d.ts

@@ -1,6 +1,8 @@
 import { RetryPolicy } from '../contracts/retry-policy.contract';
+import { HttpAdapterObserver } from '../observability/http-adapter-observer';
 export declare class RetryExecutor {
     private readonly policy;
-    constructor(policy: RetryPolicy);
+    private readonly observer?;
+    constructor(policy: RetryPolicy, observer?: HttpAdapterObserver | undefined);
     execute<T>(operation: () => Promise<T>): Promise<T>;
 }

package/dist/resilience/retry-executor.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetryExecutor = void 0;
+const base_adapter_exception_1 = require("../exceptions/base-adapter.exception");
 class RetryExecutor {
-    constructor(policy) {
+    constructor(policy, observer) {
         this.policy = policy;
+        this.observer = observer;
     }
     async execute(operation) {
         let attempt = 1;
@@ -17,6 +19,9 @@ class RetryExecutor {
                 if (attempt >= this.policy.maxAttempts)
                     throw err;
                 const delay = this.policy.backoffMs(attempt);
+                if (this.observer?.onRetry && err instanceof base_adapter_exception_1.BaseAdapterException) {
+                    this.observer.onRetry(attempt, err, delay);
+                }
                 await new Promise((resolve) => setTimeout(resolve, delay));
                 attempt++;
             }

package/dist/resilience/retry-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry-executor.js","sourceRoot":"","sources":["../../src/resilience/retry-executor.ts"],"names":[],"mappings":";;;AAYA,MAAa,aAAa;IAMxB,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAYpD,KAAK,CAAC,OAAO,CAAI,SAA2B;QAC1C,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC;gBAEH,OAAO,MAAM,SAAS,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBAEb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;oBAAE,MAAM,GAAG,CAAC;gBAGzC,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW;oBAAE,MAAM,GAAG,CAAC;gBAGlD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAG7C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBAE3D,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA1CD,sCA0CC"}
+{"version":3,"file":"retry-executor.js","sourceRoot":"","sources":["../../src/resilience/retry-executor.ts"],"names":[],"mappings":";;;AACA,iFAA4E;AAa5E,MAAa,aAAa;IAOxB,YACmB,MAAmB,EACnB,QAA8B;QAD9B,WAAM,GAAN,MAAM,CAAa;QACnB,aAAQ,GAAR,QAAQ,CAAsB;IAC9C,CAAC;IAYJ,KAAK,CAAC,OAAO,CAAI,SAA2B;QAC1C,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,OAAO,MAAM,SAAS,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;oBAAE,MAAM,GAAG,CAAC;gBAEzC,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW;oBAAE,MAAM,GAAG,CAAC;gBAElD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAE7C,IAAI,IAAI,CAAC,QAAQ,EAAE,OAAO,IAAI,GAAG,YAAY,6CAAoB,EAAE,CAAC;oBAClE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC7C,CAAC;gBAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBAE3D,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA7CD,sCA6CC"}