@yildizpay/http-adapter 3.1.0 → 3.3.0

package/README.md

@@ -1,10 +1,15 @@
-# @yildizpay/http-adapter
-
-**🇬🇧 English** | [🇹🇷 Türkçe](README.tr.md)
-
-![Build Status](https://github.com/yildizpay/http-adapter/actions/workflows/ci.yml/badge.svg)
-![NPM Version](https://img.shields.io/npm/v/@yildizpay/http-adapter)
-![License](https://img.shields.io/npm/l/@yildizpay/http-adapter)
+<p align="center">
+  <img src="assets/logo.png" width="20%" alt="@yildizpay/http-adapter" />
+  <h1 align="center">@yildizpay/http-adapter</h1>
+  <p align="center">
+    <b>🇬🇧 English</b> | <a href="README.tr.md">🇹🇷 Türkçe</a>
+  </p>
+  <p align="center">
+    <img src="https://github.com/yildizpay/http-adapter/actions/workflows/ci.yml/badge.svg" alt="Build Status" />
+    <img src="https://img.shields.io/npm/v/@yildizpay/http-adapter" alt="NPM Version" />
+    <img src="https://img.shields.io/npm/l/@yildizpay/http-adapter" alt="License" />
+  </p>
+</p>
 
 A professional, robust, and highly configurable HTTP client adapter designed for enterprise-grade Node.js applications. It provides a fluent API, built-in resilience patterns, and a powerful interceptor system, all natively sitting on top of the **Node.js Native Fetch API**, making it a zero-dependency library while allowing injection of custom HTTP clients.
 
@@ -12,6 +17,7 @@ A professional, robust, and highly configurable HTTP client adapter designed for
 
 - **Fluent Request Builder:** Construct complex HTTP requests with an intuitive, chainable API.
 - **Structured Exception Hierarchy:** Every HTTP status code and network failure maps to a dedicated, named exception class with rich metadata, `isRetryable()` signals, and structured `toJSON()` serialization.
+- **Response Validation:** Attach one or more `ResponseValidator` implementations to any request to enforce schema constraints or business rules automatically before the response reaches your code.
 - **Interceptor Architecture:** Easily implement middleware for logging, authentication, error handling, and data transformation.
 - **Resilience & Reliability:** Built-in support for retry policies (Exponential Backoff, etc.) and a generic **Circuit Breaker** to handle transient failures gracefully and prevent cascading failures in S2S communication.
 - **Type Safety:** Fully typed requests and responses using generics, ensuring type safety across your application.
@@ -47,23 +53,26 @@ const request = new RequestBuilder('https://api.example.com')
 
 ### 2. Creating the Adapter
 
-Instantiate the `HttpAdapter` with optional interceptors and retry policies.
+Instantiate the `HttpAdapter` using the fluent builder API.
 
 ```typescript
 import { HttpAdapter, RetryPolicies, CircuitBreaker } from '@yildizpay/http-adapter';
 
-const circuitBreaker = new CircuitBreaker({
-  failureThreshold: 5,
-  resetTimeoutMs: 60000,
-});
+const adapter = HttpAdapter.builder()
+  .withInterceptor(new AuthInterceptor(), new LoggingInterceptor())
+  .withRetryPolicy(RetryPolicies.exponential(3))
+  .withCircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 60000 })
+  .build();
+```
+
+You can also use `HttpAdapter.create()` directly if you prefer a single-call approach.
 
+```typescript
 const adapter = HttpAdapter.create(
-  [
-    /* interceptors */
-  ],
-  RetryPolicies.exponential(3), // Retry up to 3 times with exponential backoff
+  [new AuthInterceptor()],
+  RetryPolicies.exponential(3),
   undefined,                    // Optional custom HTTP client
-  circuitBreaker,               // Optional Circuit Breaker
+  new CircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 60000 }),
 );
 ```
 
@@ -231,6 +240,72 @@ Every exception automatically carries a `RequestContext` object (`method`, `url`
 }
 ```
 
+### Response Validators
+
+Attach validators to a request to automatically enforce schema constraints or business rules on the response before it reaches your code. Validators run sequentially after the HTTP call succeeds and before response-side interceptors. The first validator that throws halts the chain.
+
+```typescript
+import { ResponseValidator, ValidationException, Response } from '@yildizpay/http-adapter';
+
+class PaymentStatusValidator implements ResponseValidator<IyzicoResponse> {
+  validate(response: Response<IyzicoResponse>): void {
+    if (response.data.status !== 'success') {
+      throw new ValidationException(
+        `Payment failed: ${response.data.errorMessage}`,
+        response,
+      );
+    }
+  }
+}
+
+// Works with any schema validation library — zero coupling to Zod, Joi, etc.
+class PaymentSchemaValidator implements ResponseValidator<unknown> {
+  validate(response: Response<unknown>): void {
+    IyzicoResponseSchema.parse(response.data); // Zod throws on mismatch
+  }
+}
+
+const request = new RequestBuilder('https://api.iyzipay.com')
+  .setEndpoint('/payment/auth')
+  .setMethod(HttpMethod.POST)
+  .setBody(dto)
+  .validateWith(new PaymentSchemaValidator(), new PaymentStatusValidator())
+  .build();
+```
+
+Catching a validation failure:
+
+```typescript
+import { isValidationException } from '@yildizpay/http-adapter';
+
+} catch (error) {
+  if (isValidationException(error)) {
+    console.error('Validation failed:', error.message);
+    console.error('Raw response:', error.response.data);
+  }
+}
+```
+
+Non-`BaseAdapterException` errors thrown inside a validator (e.g. `ZodError`) are automatically wrapped in `ValidationException` with the original error available as `cause`. Use the generic parameter for typed access:
+
+```typescript
+} catch (error) {
+  if (isValidationException<ZodError>(error) && error.cause) {
+    console.error('Schema issues:', error.cause.issues);
+  }
+}
+```
+
+The full interceptor lifecycle when validators are registered:
+
+```
+onRequest → HTTP call → onResponse → validators → onResponseValidated → caller
+                                          ↓ (on failure)
+                                       onError
+```
+
+`onResponse` always fires. `onResponseValidated` only fires when all validators pass — ideal for caching or downstream side effects that require a business-valid response.
+
 ### Error Interceptor
 
 You can also catch and transform exceptions at the interceptor layer before they reach your business logic.

package/README.tr.md

@@ -1,10 +1,15 @@
-# @yildizpay/http-adapter
-
-[🇬🇧 English](README.md) | 🇹🇷 **Türkçe**
-
-![Build Status](https://github.com/yildizpay/http-adapter/actions/workflows/ci.yml/badge.svg)
-![NPM Version](https://img.shields.io/npm/v/@yildizpay/http-adapter)
-![License](https://img.shields.io/npm/l/@yildizpay/http-adapter)
+<p align="center">
+  <img src="assets/logo.png" width="20%" alt="@yildizpay/http-adapter" />
+  <h1 align="center">@yildizpay/http-adapter</h1>
+  <p align="center">
+    <a href="README.md">🇬🇧 English</a> | <b>🇹🇷 Türkçe</b>
+  </p>
+  <p align="center">
+    <img src="https://github.com/yildizpay/http-adapter/actions/workflows/ci.yml/badge.svg" alt="Build Status" />
+    <img src="https://img.shields.io/npm/v/@yildizpay/http-adapter" alt="NPM Version" />
+    <img src="https://img.shields.io/npm/l/@yildizpay/http-adapter" alt="License" />
+  </p>
+</p>
 
 Node.js tabanlı kurumsal uygulamalar için tasarlanmış profesyonel ve yüksek oranda yapılandırılabilir bir HTTP client adaptörü. Fluent API, built-in resilience pattern'ları, güçlü bir interceptor sistemi ve kapsamlı bir exception hiyerarşisi sunar. Zero-dependency olan paketin çekirdeği **Node.js Native Fetch API** kullanır; ancak istenen farklı custom HTTP client'lara da kolayca genişletilebilir.
 
@@ -12,6 +17,7 @@ Node.js tabanlı kurumsal uygulamalar için tasarlanmış profesyonel ve yüksek
 
 - **Fluent Request Builder:** Sezgisel ve zincirlenebilir bir API ile karmaşık HTTP isteklerini kolayca oluşturun.
 - **Structured Exception Hierarchy:** Her HTTP durum kodu ve ağ hatası, zengin metadata, `isRetryable()` sinyali ve `toJSON()` desteğiyle ayrı bir exception sınıfına dönüştürülür.
+- **Response Validation:** Herhangi bir request'e bir veya daha fazla `ResponseValidator` ekleyerek schema kısıtlamalarını veya business rule'ları response kodunuza ulaşmadan otomatik olarak denetleyebilirsiniz.
 - **Interceptor Mimarisi:** Loglama, kimlik doğrulama, hata yönetimi ve veri dönüşümü gibi middleware işlemlerini zahmetsizce entegre edin.
 - **Resilience & Reliability:** S2S entegrasyonlarında geçici hataları zarif bir şekilde yönetmek için Exponential Backoff gibi retry policy'ler ve built-in **Circuit Breaker** içerir.
 - **Type Safety:** Generic'ler kullanılarak tam olarak tiplendirilmiş request ve response'lar ile uygulama genelinde tip güvenliği sağlanır.
@@ -47,23 +53,26 @@ const request = new RequestBuilder('https://api.example.com')
 
 ### 2. Adapter'ı Başlatma
 
-İsteğe bağlı interceptor'lar, retry policy ve circuit breaker ile `HttpAdapter` oluşturun.
+Fluent builder API ile `HttpAdapter` oluşturun.
 
 ```typescript
-import { HttpAdapter, RetryPolicies, CircuitBreaker } from '@yildizpay/http-adapter';
+import { HttpAdapter, RetryPolicies } from '@yildizpay/http-adapter';
 
-const circuitBreaker = new CircuitBreaker({
-  failureThreshold: 5,
-  resetTimeoutMs: 60000,
-});
+const adapter = HttpAdapter.builder()
+  .withInterceptor(new AuthInterceptor(), new LoggingInterceptor())
+  .withRetryPolicy(RetryPolicies.exponential(3))
+  .withCircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 60000 })
+  .build();
+```
+
+Tek seferlik kurulum için `HttpAdapter.create()` de kullanılabilir.
 
+```typescript
 const adapter = HttpAdapter.create(
-  [
-    /* interceptors */
-  ],
-  RetryPolicies.exponential(3), // Exponential backoff ile 3 defaya kadar retry
+  [new AuthInterceptor()],
+  RetryPolicies.exponential(3),
   undefined,                    // Opsiyonel custom HTTP client
-  circuitBreaker,               // Opsiyonel Circuit Breaker
+  new CircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 60000 }),
 );
 ```
 
@@ -231,6 +240,72 @@ Her exception, kaynak request'ten alınan `RequestContext` objesini (`method`, `
 }
 ```
 
+### Response Validator'lar
+
+Request'e validator ekleyerek schema kısıtlamalarını veya business rule'ları response kodunuza ulaşmadan otomatik olarak denetleyebilirsiniz. Validator'lar HTTP çağrısı başarılı olduktan sonra, response-side interceptor'lardan önce sırayla çalışır. İlk hata veren validator chain'i durdurur.
+
+```typescript
+import { ResponseValidator, ValidationException, Response } from '@yildizpay/http-adapter';
+
+class PaymentStatusValidator implements ResponseValidator<IyzicoResponse> {
+  validate(response: Response<IyzicoResponse>): void {
+    if (response.data.status !== 'success') {
+      throw new ValidationException(
+        `Payment failed: ${response.data.errorMessage}`,
+        response,
+      );
+    }
+  }
+}
+
+// Zod, Joi gibi herhangi bir validation kütüphanesiyle çalışır
+class PaymentSchemaValidator implements ResponseValidator<unknown> {
+  validate(response: Response<unknown>): void {
+    IyzicoResponseSchema.parse(response.data); // Zod uyuşmazlıkta exception fırlatır
+  }
+}
+
+const request = new RequestBuilder('https://api.iyzipay.com')
+  .setEndpoint('/payment/auth')
+  .setMethod(HttpMethod.POST)
+  .setBody(dto)
+  .validateWith(new PaymentSchemaValidator(), new PaymentStatusValidator())
+  .build();
+```
+
+Validation hatasını yakalamak:
+
+```typescript
+import { isValidationException } from '@yildizpay/http-adapter';
+
+} catch (error) {
+  if (isValidationException(error)) {
+    console.error('Validation başarısız:', error.message);
+    console.error('Ham response:', error.response.data);
+  }
+}
+```
+
+Validator içinde fırlatılan `BaseAdapterException` olmayan hatalar (örn. `ZodError`) otomatik olarak `ValidationException`'a sarılır; orijinal hata `cause`'ta tutulur. Typed erişim için generic parametre kullanılabilir:
+
+```typescript
+} catch (error) {
+  if (isValidationException<ZodError>(error) && error.cause) {
+    console.error('Schema hataları:', error.cause.issues);
+  }
+}
+```
+
+Validator kayıtlıyken tam interceptor lifecycle'ı:
+
+```
+onRequest → HTTP call → onResponse → validators → onResponseValidated → caller
+                                          ↓ (hata durumunda)
+                                       onError
+```
+
+`onResponse` her zaman çalışır. `onResponseValidated` yalnızca tüm validator'lar geçtiğinde çalışır — business açısından geçerli bir response gerektiren cache veya side effect işlemleri için idealdir.
+
 ### Error Interceptor
 
 Exception'lar business logic'e ulaşmadan önce interceptor seviyesinde yakalanabilir ve dönüştürülebilir.

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

@@ -0,0 +1,17 @@
+import { HttpAdapter } from '../core/http.adapter';
+import { HttpInterceptor } from '../contracts/http-interceptor.contract';
+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';
+export declare class HttpAdapterBuilder {
+    private readonly interceptors;
+    private retryPolicy;
+    private httpClient;
+    private circuitBreaker;
+    withInterceptor(...interceptors: HttpInterceptor[]): this;
+    withRetryPolicy(policy: RetryPolicy): this;
+    withCircuitBreaker(breaker: CircuitBreaker | CircuitBreakerOptions): this;
+    withHttpClient(client: HttpClientContract): this;
+    build(): HttpAdapter;
+}

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpAdapterBuilder = void 0;
+const http_adapter_1 = require("../core/http.adapter");
+const circuit_breaker_1 = require("../resilience/circuit-breaker/circuit-breaker");
+class HttpAdapterBuilder {
+    constructor() {
+        this.interceptors = [];
+    }
+    withInterceptor(...interceptors) {
+        this.interceptors.push(...interceptors);
+        return this;
+    }
+    withRetryPolicy(policy) {
+        this.retryPolicy = policy;
+        return this;
+    }
+    withCircuitBreaker(breaker) {
+        this.circuitBreaker = breaker instanceof circuit_breaker_1.CircuitBreaker ? breaker : new circuit_breaker_1.CircuitBreaker(breaker);
+        return this;
+    }
+    withHttpClient(client) {
+        this.httpClient = client;
+        return this;
+    }
+    build() {
+        return http_adapter_1.HttpAdapter.create(this.interceptors, this.retryPolicy, this.httpClient, this.circuitBreaker);
+    }
+}
+exports.HttpAdapterBuilder = HttpAdapterBuilder;
+//# sourceMappingURL=http-adapter.builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.builder.js","sourceRoot":"","sources":["../../src/builders/http-adapter.builder.ts"],"names":[],"mappings":";;;AAAA,uDAAmD;AAInD,mFAA+E;AAmB/E,MAAa,kBAAkB;IAA/B;QACmB,iBAAY,GAAsB,EAAE,CAAC;IAiExD,CAAC;IAtDQ,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;IAOM,KAAK;QACV,OAAO,0BAAW,CAAC,MAAM,CACvB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,cAAc,CACpB,CAAC;IACJ,CAAC;CACF;AAlED,gDAkEC"}

package/dist/builders/request.builder.d.ts

@@ -2,6 +2,7 @@ import { HttpMethod } from '../common/enums/http-method.enum';
 import { HttpBody } from '../common/types/http.types';
 import { Request } from '../models/request';
 import { RequestOptions } from '../models/request-options';
+import { ResponseValidator } from '../contracts/response-validator.contract';
 export declare class RequestBuilder {
     private readonly baseUrl;
     private endpoint;
@@ -10,6 +11,7 @@ export declare class RequestBuilder {
     private body;
     private queryParams;
     private options;
+    private readonly validators;
     constructor(baseUrl: string);
     setEndpoint(endpoint: string): this;
     setMethod(method: HttpMethod): this;
@@ -33,5 +35,6 @@ export declare class RequestBuilder {
     resetQueryParams(): this;
     setTimeout(timeout: number): this;
     setOptions(options: RequestOptions): this;
+    validateWith(...validators: ResponseValidator[]): this;
     build(): Request;
 }

package/dist/builders/request.builder.js

@@ -13,6 +13,7 @@ class RequestBuilder {
         };
         this.body = {};
         this.queryParams = {};
+        this.validators = [];
         this.baseUrl = baseUrl;
         this.options = new request_options_1.RequestOptions();
     }
@@ -104,8 +105,12 @@ class RequestBuilder {
         this.options = options;
         return this;
     }
+    validateWith(...validators) {
+        this.validators.push(...validators);
+        return this;
+    }
     build() {
-        return new request_1.Request(this.baseUrl, this.endpoint, this.method, this.headers, this.queryParams, this.body ? { ...this.body } : undefined, this.options);
+        return new request_1.Request(this.baseUrl, this.endpoint, this.method, this.headers, this.queryParams, this.body ? { ...this.body } : undefined, this.options, this.validators);
     }
 }
 exports.RequestBuilder = RequestBuilder;

package/dist/builders/request.builder.js.map

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

package/dist/contracts/http-interceptor.contract.d.ts

@@ -7,7 +7,10 @@ export interface HttpRequestInterceptor {
 export interface HttpResponseInterceptor {
     onResponse(response: Response): Promise<Response>;
 }
+export interface HttpValidatedResponseInterceptor {
+    onResponseValidated(response: Response): Promise<Response>;
+}
 export interface HttpErrorInterceptor {
     onError(error: BaseAdapterException, request: Request): Promise<BaseAdapterException>;
 }
-export type HttpInterceptor = Partial<HttpRequestInterceptor> & Partial<HttpResponseInterceptor> & Partial<HttpErrorInterceptor>;
+export type HttpInterceptor = Partial<HttpRequestInterceptor> & Partial<HttpResponseInterceptor> & Partial<HttpValidatedResponseInterceptor> & Partial<HttpErrorInterceptor>;

package/dist/contracts/response-validator.contract.d.ts

@@ -0,0 +1,4 @@
+import { Response } from '../models/response';
+export interface ResponseValidator<T = unknown> {
+    validate(response: Response<T>): Promise<void> | void;
+}

package/dist/contracts/response-validator.contract.js

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

package/dist/contracts/response-validator.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-validator.contract.js","sourceRoot":"","sources":["../../src/contracts/response-validator.contract.ts"],"names":[],"mappings":""}

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

@@ -4,6 +4,7 @@ import { HttpInterceptor } from '../contracts/http-interceptor.contract';
 import { RetryPolicy } from '../contracts/retry-policy.contract';
 import { CircuitBreaker } from '../resilience/circuit-breaker/circuit-breaker';
 import { HttpClientContract } from '../contracts/http-client.contract';
+import { HttpAdapterBuilder } from '../builders/http-adapter.builder';
 export declare class HttpAdapter {
     private readonly interceptors;
     private readonly httpClient;
@@ -11,6 +12,7 @@ export declare class HttpAdapter {
     private readonly circuitBreaker?;
     private constructor();
     static create(interceptors: HttpInterceptor[], retryPolicy?: RetryPolicy, httpClient?: HttpClientContract, circuitBreaker?: CircuitBreaker): HttpAdapter;
+    static builder(): HttpAdapterBuilder;
     send<T = unknown>(request: Request): Promise<Response<T>>;
     private dispatch;
 }

package/dist/core/http.adapter.js

@@ -5,6 +5,9 @@ const default_http_client_1 = require("./default-http-client");
 const response_1 = require("../models/response");
 const retry_executor_1 = require("../resilience/retry-executor");
 const error_converter_1 = require("./error.converter");
+const base_adapter_exception_1 = require("../exceptions/base-adapter.exception");
+const validation_exception_1 = require("../exceptions/validation.exception");
+const http_adapter_builder_1 = require("../builders/http-adapter.builder");
 class HttpAdapter {
     constructor(interceptors, httpClient, retryPolicy, circuitBreaker) {
         this.interceptors = interceptors;
@@ -15,6 +18,9 @@ class HttpAdapter {
     static create(interceptors, retryPolicy, httpClient, circuitBreaker) {
         return new HttpAdapter(interceptors, httpClient ?? default_http_client_1.defaultHttpClient, retryPolicy, circuitBreaker);
     }
+    static builder() {
+        return new http_adapter_builder_1.HttpAdapterBuilder();
+    }
     async send(request) {
         const executePipeline = () => {
             if (!this.retryPolicy) {
@@ -61,6 +67,21 @@ class HttpAdapter {
                     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;
         }
         catch (error) {

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/exceptions/exception.guards.d.ts

@@ -3,6 +3,7 @@ import { CircuitBreakerOpenException } from './circuit-breaker-open.exception';
 import { HttpException } from './http-status.exceptions';
 import { NetworkException, TimeoutException, ConnectionRefusedException, DnsResolutionException, SocketResetException, HostUnreachableException } from './network.exceptions';
 import { UnknownException } from './unknown.exception';
+import { ValidationException } from './validation.exception';
 export declare function isBaseAdapterException(error: unknown): error is BaseAdapterException;
 export declare function isHttpException(error: unknown): error is HttpException;
 export declare function isNetworkException(error: unknown): error is NetworkException;
@@ -13,3 +14,4 @@ export declare function isSocketResetException(error: unknown): error is SocketR
 export declare function isHostUnreachableException(error: unknown): error is HostUnreachableException;
 export declare function isUnknownException(error: unknown): error is UnknownException;
 export declare function isCircuitBreakerOpenException(error: unknown): error is CircuitBreakerOpenException;
+export declare function isValidationException<TCause = unknown>(error: unknown): error is ValidationException<TCause>;

package/dist/exceptions/exception.guards.js

@@ -10,11 +10,13 @@ exports.isSocketResetException = isSocketResetException;
 exports.isHostUnreachableException = isHostUnreachableException;
 exports.isUnknownException = isUnknownException;
 exports.isCircuitBreakerOpenException = isCircuitBreakerOpenException;
+exports.isValidationException = isValidationException;
 const base_adapter_exception_1 = require("./base-adapter.exception");
 const circuit_breaker_open_exception_1 = require("./circuit-breaker-open.exception");
 const http_status_exceptions_1 = require("./http-status.exceptions");
 const network_exceptions_1 = require("./network.exceptions");
 const unknown_exception_1 = require("./unknown.exception");
+const validation_exception_1 = require("./validation.exception");
 function isBaseAdapterException(error) {
     return error instanceof base_adapter_exception_1.BaseAdapterException;
 }
@@ -45,4 +47,7 @@ function isUnknownException(error) {
 function isCircuitBreakerOpenException(error) {
     return error instanceof circuit_breaker_open_exception_1.CircuitBreakerOpenException;
 }
+function isValidationException(error) {
+    return error instanceof validation_exception_1.ValidationException;
+}
 //# sourceMappingURL=exception.guards.js.map

package/dist/exceptions/exception.guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"exception.guards.js","sourceRoot":"","sources":["../../src/exceptions/exception.guards.ts"],"names":[],"mappings":";;AAaA,wDAEC;AAED,0CAEC;AAED,gDAEC;AAED,gDAEC;AAED,oEAEC;AAED,4DAEC;AAED,wDAEC;AAED,gEAEC;AAED,gDAEC;AAED,sEAIC;AArDD,qEAAgE;AAChE,qFAA+E;AAC/E,qEAAyD;AACzD,6DAO8B;AAC9B,2DAAuD;AAEvD,SAAgB,sBAAsB,CAAC,KAAc;IACnD,OAAO,KAAK,YAAY,6CAAoB,CAAC;AAC/C,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,sCAAa,CAAC;AACxC,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,qCAAgB,CAAC;AAC3C,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,qCAAgB,CAAC;AAC3C,CAAC;AAED,SAAgB,4BAA4B,CAAC,KAAc;IACzD,OAAO,KAAK,YAAY,+CAA0B,CAAC;AACrD,CAAC;AAED,SAAgB,wBAAwB,CAAC,KAAc;IACrD,OAAO,KAAK,YAAY,2CAAsB,CAAC;AACjD,CAAC;AAED,SAAgB,sBAAsB,CAAC,KAAc;IACnD,OAAO,KAAK,YAAY,yCAAoB,CAAC;AAC/C,CAAC;AAED,SAAgB,0BAA0B,CAAC,KAAc;IACvD,OAAO,KAAK,YAAY,6CAAwB,CAAC;AACnD,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,oCAAgB,CAAC;AAC3C,CAAC;AAED,SAAgB,6BAA6B,CAC3C,KAAc;IAEd,OAAO,KAAK,YAAY,4DAA2B,CAAC;AACtD,CAAC"}
+{"version":3,"file":"exception.guards.js","sourceRoot":"","sources":["../../src/exceptions/exception.guards.ts"],"names":[],"mappings":";;AAcA,wDAEC;AAED,0CAEC;AAED,gDAEC;AAED,gDAEC;AAED,oEAEC;AAED,4DAEC;AAED,wDAEC;AAED,gEAEC;AAED,gDAEC;AAED,sEAIC;AAED,sDAIC;AA5DD,qEAAgE;AAChE,qFAA+E;AAC/E,qEAAyD;AACzD,6DAO8B;AAC9B,2DAAuD;AACvD,iEAA6D;AAE7D,SAAgB,sBAAsB,CAAC,KAAc;IACnD,OAAO,KAAK,YAAY,6CAAoB,CAAC;AAC/C,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,sCAAa,CAAC;AACxC,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,qCAAgB,CAAC;AAC3C,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,qCAAgB,CAAC;AAC3C,CAAC;AAED,SAAgB,4BAA4B,CAAC,KAAc;IACzD,OAAO,KAAK,YAAY,+CAA0B,CAAC;AACrD,CAAC;AAED,SAAgB,wBAAwB,CAAC,KAAc;IACrD,OAAO,KAAK,YAAY,2CAAsB,CAAC;AACjD,CAAC;AAED,SAAgB,sBAAsB,CAAC,KAAc;IACnD,OAAO,KAAK,YAAY,yCAAoB,CAAC;AAC/C,CAAC;AAED,SAAgB,0BAA0B,CAAC,KAAc;IACvD,OAAO,KAAK,YAAY,6CAAwB,CAAC;AACnD,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,oCAAgB,CAAC;AAC3C,CAAC;AAED,SAAgB,6BAA6B,CAC3C,KAAc;IAEd,OAAO,KAAK,YAAY,4DAA2B,CAAC;AACtD,CAAC;AAED,SAAgB,qBAAqB,CACnC,KAAc;IAEd,OAAO,KAAK,YAAY,0CAAmB,CAAC;AAC9C,CAAC"}

package/dist/exceptions/validation.exception.d.ts

@@ -0,0 +1,9 @@
+import { Response } from '../models/response';
+import { BaseAdapterException } from './base-adapter.exception';
+export declare class ValidationException<TCause = unknown> extends BaseAdapterException {
+    readonly name = "ValidationException";
+    readonly response: Response;
+    readonly cause: TCause | undefined;
+    constructor(message: string, response: Response, cause?: TCause);
+    toJSON(): Record<string, unknown>;
+}

package/dist/exceptions/validation.exception.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationException = void 0;
+const base_adapter_exception_1 = require("./base-adapter.exception");
+class ValidationException extends base_adapter_exception_1.BaseAdapterException {
+    constructor(message, response, cause) {
+        super(message, 'ERR_VALIDATION', cause);
+        this.name = 'ValidationException';
+        this.response = response;
+        this.cause = cause;
+        Object.setPrototypeOf(this, ValidationException.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            response: {
+                status: this.response.status,
+                data: this.response.data,
+                request: this.response.requestContext,
+            },
+        };
+    }
+}
+exports.ValidationException = ValidationException;
+//# sourceMappingURL=validation.exception.js.map

package/dist/exceptions/validation.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.exception.js","sourceRoot":"","sources":["../../src/exceptions/validation.exception.ts"],"names":[],"mappings":";;;AACA,qEAAgE;AAehE,MAAa,mBAAsC,SAAQ,6CAAoB;IAK7E,YAAmB,OAAe,EAAE,QAAkB,EAAE,KAAc;QACpE,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;QALjB,SAAI,GAAG,qBAAqB,CAAC;QAMpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAEe,MAAM;QACpB,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,QAAQ,EAAE;gBACR,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;gBAC5B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;gBACxB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc;aACtC;SACF,CAAC;IACJ,CAAC;CACF;AAtBD,kDAsBC"}

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 export * from './core/http.adapter';
 export * from './core/default-http-client';
 export * from './builders/request.builder';
+export * from './builders/http-adapter.builder';
 export * from './models/request';
 export * from './models/response';
 export * from './models/request-options';
 export * from './models/request-context';
 export * from './contracts/http-interceptor.contract';
 export * from './contracts/retry-policy.contract';
+export * from './contracts/response-validator.contract';
 export * from './resilience/retry.policies';
 export * from './resilience/circuit-breaker/circuit-state.enum';
 export * from './resilience/circuit-breaker/circuit-breaker-options';
@@ -20,5 +22,6 @@ export * from './exceptions/http-exception.factory';
 export * from './exceptions/network.exceptions';
 export * from './exceptions/network-exception.factory';
 export * from './exceptions/unknown.exception';
+export * from './exceptions/validation.exception';
 export * from './exceptions/exception.guards';
 export * from './core/error.converter';

package/dist/index.js

@@ -17,12 +17,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./core/http.adapter"), exports);
 __exportStar(require("./core/default-http-client"), exports);
 __exportStar(require("./builders/request.builder"), exports);
+__exportStar(require("./builders/http-adapter.builder"), exports);
 __exportStar(require("./models/request"), exports);
 __exportStar(require("./models/response"), exports);
 __exportStar(require("./models/request-options"), exports);
 __exportStar(require("./models/request-context"), exports);
 __exportStar(require("./contracts/http-interceptor.contract"), exports);
 __exportStar(require("./contracts/retry-policy.contract"), exports);
+__exportStar(require("./contracts/response-validator.contract"), exports);
 __exportStar(require("./resilience/retry.policies"), exports);
 __exportStar(require("./resilience/circuit-breaker/circuit-state.enum"), exports);
 __exportStar(require("./resilience/circuit-breaker/circuit-breaker-options"), exports);
@@ -36,6 +38,7 @@ __exportStar(require("./exceptions/http-exception.factory"), exports);
 __exportStar(require("./exceptions/network.exceptions"), exports);
 __exportStar(require("./exceptions/network-exception.factory"), exports);
 __exportStar(require("./exceptions/unknown.exception"), exports);
+__exportStar(require("./exceptions/validation.exception"), exports);
 __exportStar(require("./exceptions/exception.guards"), exports);
 __exportStar(require("./core/error.converter"), exports);
 //# sourceMappingURL=index.js.map