celitech-sdk 1.1.71 → 1.1.73

package/dist/services/purchases/purchases.js

@@ -0,0 +1,162 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PurchasesService = void 0;
+const zod_1 = require("zod");
+const base_service_1 = require("../base-service");
+const http_1 = require("../../http");
+const request_builder_1 = require("../../http/transport/request-builder");
+const list_purchases_ok_response_1 = require("./models/list-purchases-ok-response");
+const create_purchase_request_1 = require("./models/create-purchase-request");
+const create_purchase_ok_response_1 = require("./models/create-purchase-ok-response");
+const top_up_esim_request_1 = require("./models/top-up-esim-request");
+const top_up_esim_ok_response_1 = require("./models/top-up-esim-ok-response");
+const edit_purchase_request_1 = require("./models/edit-purchase-request");
+const edit_purchase_ok_response_1 = require("./models/edit-purchase-ok-response");
+const get_purchase_consumption_ok_response_1 = require("./models/get-purchase-consumption-ok-response");
+class PurchasesService extends base_service_1.BaseService {
+    /**
+     * This endpoint can be used to list all the successful purchases made between a given interval.
+     * @param {string} [iccid] - ID of the eSIM
+     * @param {string} [afterDate] - Start date of the interval for filtering purchases in the format 'yyyy-MM-dd'
+     * @param {string} [beforeDate] - End date of the interval for filtering purchases in the format 'yyyy-MM-dd'
+     * @param {string} [referenceId] - The referenceId that was provided by the partner during the purchase or topup flow.
+     * @param {string} [afterCursor] - To get the next batch of results, use this parameter. It tells the API where to start fetching data after the last item you received. It helps you avoid repeats and efficiently browse through large sets of data.
+     * @param {number} [limit] - Maximum number of purchases to be returned in the response. The value must be greater than 0 and less than or equal to 100. If not provided, the default value is 20
+     * @param {number} [after] - Epoch value representing the start of the time interval for filtering purchases
+     * @param {number} [before] - Epoch value representing the end of the time interval for filtering purchases
+     * @returns {Promise<HttpResponse<ListPurchasesOkResponse>>} Successful Response
+     */
+    listPurchases(params, requestConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const request = new request_builder_1.RequestBuilder()
+                .setConfig(this.config)
+                .setBaseUrl(this.config)
+                .setMethod('GET')
+                .setPath('/purchases')
+                .setRequestSchema(zod_1.z.any())
+                .setResponseSchema(list_purchases_ok_response_1.listPurchasesOkResponseResponse)
+                .setRequestContentType(http_1.ContentType.Json)
+                .setResponseContentType(http_1.ContentType.Json)
+                .setRetryAttempts(this.config, requestConfig)
+                .setRetryDelayMs(this.config, requestConfig)
+                .setResponseValidation(this.config, requestConfig)
+                .addQueryParam('iccid', params === null || params === void 0 ? void 0 : params.iccid)
+                .addQueryParam('afterDate', params === null || params === void 0 ? void 0 : params.afterDate)
+                .addQueryParam('beforeDate', params === null || params === void 0 ? void 0 : params.beforeDate)
+                .addQueryParam('referenceId', params === null || params === void 0 ? void 0 : params.referenceId)
+                .addQueryParam('afterCursor', params === null || params === void 0 ? void 0 : params.afterCursor)
+                .addQueryParam('limit', params === null || params === void 0 ? void 0 : params.limit)
+                .addQueryParam('after', params === null || params === void 0 ? void 0 : params.after)
+                .addQueryParam('before', params === null || params === void 0 ? void 0 : params.before)
+                .build();
+            return this.client.call(request);
+        });
+    }
+    /**
+     * This endpoint is used to purchase a new eSIM by providing the package details.
+     * @returns {Promise<HttpResponse<CreatePurchaseOkResponse>>} Successful Response
+     */
+    createPurchase(body, requestConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const request = new request_builder_1.RequestBuilder()
+                .setConfig(this.config)
+                .setBaseUrl(this.config)
+                .setMethod('POST')
+                .setPath('/purchases')
+                .setRequestSchema(create_purchase_request_1.createPurchaseRequestRequest)
+                .setResponseSchema(create_purchase_ok_response_1.createPurchaseOkResponseResponse)
+                .setRequestContentType(http_1.ContentType.Json)
+                .setResponseContentType(http_1.ContentType.Json)
+                .setRetryAttempts(this.config, requestConfig)
+                .setRetryDelayMs(this.config, requestConfig)
+                .setResponseValidation(this.config, requestConfig)
+                .addHeaderParam('Content-Type', 'application/json')
+                .addBody(body)
+                .build();
+            return this.client.call(request);
+        });
+    }
+    /**
+     * This endpoint is used to top-up an eSIM with the previously associated destination by providing an existing ICCID and the package details. The top-up is not feasible for eSIMs in "DELETED" or "ERROR" state.
+     * @returns {Promise<HttpResponse<TopUpEsimOkResponse>>} Successful Response
+     */
+    topUpEsim(body, requestConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const request = new request_builder_1.RequestBuilder()
+                .setConfig(this.config)
+                .setBaseUrl(this.config)
+                .setMethod('POST')
+                .setPath('/purchases/topup')
+                .setRequestSchema(top_up_esim_request_1.topUpEsimRequestRequest)
+                .setResponseSchema(top_up_esim_ok_response_1.topUpEsimOkResponseResponse)
+                .setRequestContentType(http_1.ContentType.Json)
+                .setResponseContentType(http_1.ContentType.Json)
+                .setRetryAttempts(this.config, requestConfig)
+                .setRetryDelayMs(this.config, requestConfig)
+                .setResponseValidation(this.config, requestConfig)
+                .addHeaderParam('Content-Type', 'application/json')
+                .addBody(body)
+                .build();
+            return this.client.call(request);
+        });
+    }
+    /**
+     * This endpoint allows you to modify the dates of an existing package with a future activation start time. Editing can only be performed for packages that have not been activated, and it cannot change the package size. The modification must not change the package duration category to ensure pricing consistency.
+     * @returns {Promise<HttpResponse<EditPurchaseOkResponse>>} Successful Response
+     */
+    editPurchase(body, requestConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const request = new request_builder_1.RequestBuilder()
+                .setConfig(this.config)
+                .setBaseUrl(this.config)
+                .setMethod('POST')
+                .setPath('/purchases/edit')
+                .setRequestSchema(edit_purchase_request_1.editPurchaseRequestRequest)
+                .setResponseSchema(edit_purchase_ok_response_1.editPurchaseOkResponseResponse)
+                .setRequestContentType(http_1.ContentType.Json)
+                .setResponseContentType(http_1.ContentType.Json)
+                .setRetryAttempts(this.config, requestConfig)
+                .setRetryDelayMs(this.config, requestConfig)
+                .setResponseValidation(this.config, requestConfig)
+                .addHeaderParam('Content-Type', 'application/json')
+                .addBody(body)
+                .build();
+            return this.client.call(request);
+        });
+    }
+    /**
+     * This endpoint can be called for consumption notifications (e.g. every 1 hour or when the user clicks a button). It returns the data balance (consumption) of purchased packages.
+     * @param {string} purchaseId - ID of the purchase
+     * @returns {Promise<HttpResponse<GetPurchaseConsumptionOkResponse>>} Successful Response
+     */
+    getPurchaseConsumption(purchaseId, requestConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const request = new request_builder_1.RequestBuilder()
+                .setConfig(this.config)
+                .setBaseUrl(this.config)
+                .setMethod('GET')
+                .setPath('/purchases/{purchaseId}/consumption')
+                .setRequestSchema(zod_1.z.any())
+                .setResponseSchema(get_purchase_consumption_ok_response_1.getPurchaseConsumptionOkResponseResponse)
+                .setRequestContentType(http_1.ContentType.Json)
+                .setResponseContentType(http_1.ContentType.Json)
+                .setRetryAttempts(this.config, requestConfig)
+                .setRetryDelayMs(this.config, requestConfig)
+                .setResponseValidation(this.config, requestConfig)
+                .addPathParam('purchaseId', purchaseId)
+                .build();
+            return this.client.call(request);
+        });
+    }
+}
+exports.PurchasesService = PurchasesService;
+//# sourceMappingURL=purchases.js.map

package/dist/services/purchases/purchases.js.map

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

package/dist/services/purchases/request-params.d.ts

@@ -0,0 +1,11 @@
+export interface ListPurchasesParams {
+    iccid?: string;
+    afterDate?: string;
+    beforeDate?: string;
+    referenceId?: string;
+    afterCursor?: string;
+    limit?: number;
+    after?: number;
+    before?: number;
+}
+//# sourceMappingURL=request-params.d.ts.map

package/dist/services/purchases/request-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-params.d.ts","sourceRoot":"","sources":["../../../src/services/purchases/request-params.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/services/purchases/request-params.js

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

package/dist/services/purchases/request-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-params.js","sourceRoot":"","sources":["../../../src/services/purchases/request-params.ts"],"names":[],"mappings":""}

package/examples/package.json

@@ -1,6 +1,6 @@
 {
   "name": "Celitech",
-  "version": "1.1.71",
+  "version": "1.1.73",
   "private": true,
   "dependencies": {
     "celitech-sdk": "file:../",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "celitech-sdk",
-  "version": "1.1.71",
+  "version": "1.1.73",
   "description": "Welcome to the CELITECH API documentation!  Useful links: [Homepage](https://www.celitech.com) | [Support email](mailto:support@celitech.com) | [Blog](https://www.celitech.com/blog/) ",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/http/handlers/hook-handler.ts

@@ -20,18 +20,20 @@ export class HookHandler implements RequestHandler {
     const response = await this.next.handle(nextRequest);
 
     if (response.metadata.status < 400) {
-      return await this.hook.afterResponse(request, response, hookParams);
+      return await this.hook.afterResponse(request.toHookRequest(), response, hookParams);
     }
 
-    const error = await this.hook.onError(request, response, hookParams);
+    const error = await this.hook.onError(request.toHookRequest(), response, hookParams);
 
     throw new HttpError(error.metadata, error.error);
   }
 
   private async beforeRequest<T>(request: Request<T>, hookParams: Map<string, string>): Promise<Request<T>> {
-    const hookRequest = await this.hook.beforeRequest(request, hookParams);
+    const hookRequest = request.toHookRequest();
 
-    request.updateFromHookRequest(hookRequest);
+    const newRequest = await this.hook.beforeRequest(hookRequest, hookParams);
+
+    request.updateFromHookRequest(newRequest);
 
     return request;
   }

package/src/http/handlers/response-validation-handler.ts

@@ -57,7 +57,7 @@ export class ResponseValidationHandler implements RequestHandler {
   }
 
   private validate<T>(request: Request<T>, data: any): T {
-    if (request.config.validation?.responseValidation) {
+    if (request.validation?.responseValidation) {
       return request.responseSchema.parse(data);
     }
     return data;

package/src/http/handlers/retry-handler.ts

@@ -10,15 +10,14 @@ export class RetryHandler implements RequestHandler {
       throw new Error('No next handler set in retry handler.');
     }
 
-    const retry = request.getRetry();
-    for (let attempt = 1; attempt <= retry.attempts; attempt++) {
+    for (let attempt = 1; attempt <= request.retry.attempts; attempt++) {
       try {
         return await this.next.handle(request);
       } catch (error: any) {
-        if (!this.shouldRetry(error) || attempt === retry.attempts) {
+        if (!this.shouldRetry(error) || attempt === request.retry.attempts) {
           throw error;
         }
-        await this.delay(retry.delayMs);
+        await this.delay(request.retry.delayMs);
       }
     }
 
@@ -29,7 +28,11 @@ export class RetryHandler implements RequestHandler {
     return error instanceof HttpError && (error.metadata.status >= 500 || error.metadata.status === 408);
   }
 
-  private delay(delayMs: number): Promise<void> {
+  private delay(delayMs: number | undefined): Promise<void> {
+    if (!delayMs) {
+      return Promise.resolve();
+    }
+
     return new Promise((resolve, reject) => {
       setTimeout(() => resolve(), delayMs);
     });

package/src/http/hooks/hook.ts

@@ -1,12 +1,13 @@
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 
 export interface HttpRequest {
+  baseUrl: string;
   method: HttpMethod;
   path: string;
-  headers?: Map<string, unknown>;
+  headers: Map<string, unknown>;
   body?: BodyInit;
   abortSignal?: AbortSignal;
-  queryParams?: Map<string, unknown>;
+  queryParams: Map<string, unknown>;
 }
 
 interface HttpMetadata {

package/src/http/serializer.ts

@@ -25,7 +25,7 @@ export function serializeQuery(
   _style = SerializationStyle.FORM,
   explode = true,
 ): string {
-  if (!queryParams || !Object.entries(queryParams)) {
+  if (!queryParams || !Object.entries(queryParams).length) {
     return '';
   }
 
@@ -58,9 +58,12 @@ export function serializeQuery(
   return `?${query}`;
 }
 
-export function serializeHeader(headers?: Record<string, unknown>, explode = false): Record<string, string> {
-  if (!headers) {
-    return {};
+export function serializeHeader(
+  headers?: Record<string, unknown>,
+  explode = false,
+): Record<string, string> | undefined {
+  if (!headers || !Object.entries(headers).length) {
+    return undefined;
   }
 
   return Object.entries(headers).reduce((acc, [key, value]) => {

package/src/http/transport/request-builder.ts

@@ -0,0 +1,145 @@
+import z, { ZodType } from 'zod';
+import { Request, CreateRequestParameters } from './request';
+import { ContentType, HttpMethod, SdkConfig, RequestConfig, RetryOptions, ValidationOptions } from '../types';
+import { Environment } from '../environment';
+
+export class RequestBuilder<T> {
+  private params: CreateRequestParameters<T>;
+
+  constructor() {
+    this.params = {
+      baseUrl: Environment.DEFAULT,
+      method: 'GET',
+      path: '',
+      config: {},
+      responseSchema: z.any(),
+      requestSchema: z.any(),
+      requestContentType: ContentType.Json,
+      responseContentType: ContentType.Json,
+      retry: {
+        attempts: 3,
+        delayMs: 150,
+      },
+      validation: {
+        responseValidation: true,
+      },
+      pathParams: new Map(),
+      queryParams: new Map(),
+      headers: new Map(),
+    };
+  }
+
+  setRetryAttempts(sdkConfig?: SdkConfig, requestConfig?: RequestConfig): RequestBuilder<T> {
+    if (requestConfig?.retry?.attempts !== undefined) {
+      this.params.retry.attempts = requestConfig.retry.attempts;
+    } else if (sdkConfig?.retry?.attempts !== undefined) {
+      this.params.retry.attempts = sdkConfig.retry.attempts;
+    }
+
+    return this;
+  }
+
+  setRetryDelayMs(sdkConfig?: SdkConfig, requestConfig?: RequestConfig): RequestBuilder<T> {
+    if (requestConfig?.retry?.delayMs !== undefined) {
+      this.params.retry.delayMs = requestConfig.retry.delayMs;
+    } else if (sdkConfig?.retry?.delayMs !== undefined) {
+      this.params.retry.delayMs = sdkConfig.retry.delayMs;
+    }
+
+    return this;
+  }
+
+  setResponseValidation(sdkConfig: SdkConfig, requestConfig?: RequestConfig): RequestBuilder<T> {
+    if (requestConfig?.validation?.responseValidation !== undefined) {
+      this.params.validation.responseValidation = requestConfig.validation.responseValidation;
+    } else if (sdkConfig?.validation?.responseValidation !== undefined) {
+      this.params.validation.responseValidation = sdkConfig.validation.responseValidation;
+    }
+
+    return this;
+  }
+
+  setBaseUrl(sdkConfig: SdkConfig): RequestBuilder<T> {
+    if (sdkConfig?.baseUrl !== undefined) {
+      this.params.baseUrl = sdkConfig.baseUrl;
+    }
+
+    return this;
+  }
+
+  setMethod(method: HttpMethod): RequestBuilder<T> {
+    this.params.method = method;
+    return this;
+  }
+
+  setPath(path: string): RequestBuilder<T> {
+    this.params.path = path;
+    return this;
+  }
+
+  setConfig(config: SdkConfig): RequestBuilder<T> {
+    this.params.config = config;
+    return this;
+  }
+
+  setRequestContentType(contentType: ContentType): RequestBuilder<T> {
+    this.params.requestContentType = contentType;
+    return this;
+  }
+
+  setResponseContentType(contentType: ContentType): RequestBuilder<T> {
+    this.params.responseContentType = contentType;
+    return this;
+  }
+
+  setRequestSchema(requestSchema: ZodType): RequestBuilder<T> {
+    this.params.requestSchema = requestSchema;
+    return this;
+  }
+
+  setResponseSchema(responseSchema: ZodType): RequestBuilder<T> {
+    this.params.responseSchema = responseSchema;
+    return this;
+  }
+
+  addBody(body?: any): RequestBuilder<T> {
+    if (body !== undefined) {
+      this.params.body = body;
+    }
+    return this;
+  }
+
+  addPathParam(key: string, value: unknown): RequestBuilder<T> {
+    if (value === undefined) {
+      return this;
+    }
+
+    this.params.pathParams.set(key, value);
+
+    return this;
+  }
+
+  addQueryParam(key: string, value: unknown): RequestBuilder<T> {
+    if (value === undefined) {
+      return this;
+    }
+
+    this.params.queryParams.set(key, value);
+
+    return this;
+  }
+
+  addHeaderParam(key: string, value: unknown): RequestBuilder<T> {
+    if (value === undefined) {
+      return this;
+    }
+
+    this.params.headers.set(key, value);
+
+    return this;
+  }
+
+  public build(): Request<T> {
+    return new Request<T>(this.params);
+  }
+}

package/src/http/transport/request.ts

@@ -1,21 +1,28 @@
 import { ZodType } from 'zod';
-import { ContentType, HttpMethod, SdkConfig, RetryOptions, RequestConfig } from '../types';
+import { ContentType, HttpMethod, SdkConfig, RetryOptions, RequestConfig, ValidationOptions } from '../types';
 import { serializeHeader, serializePath, serializeQuery } from '../serializer';
 import { HttpRequest } from '../hooks/hook';
 
-interface CreateRequestParameters<T> {
+export interface CreateRequestParameters<T> {
+  baseUrl: string;
   method: HttpMethod;
   body?: any;
+  headers: Map<string, unknown>;
+  queryParams: Map<string, unknown>;
+  pathParams: Map<string, unknown>;
   path: string;
   config: SdkConfig;
   responseSchema: ZodType<T, any, any>;
   requestSchema: ZodType;
   requestContentType: ContentType;
   responseContentType: ContentType;
-  requestConfig?: RequestConfig;
+  validation: ValidationOptions;
+  retry: RetryOptions;
 }
 
 export class Request<T> {
+  public baseUrl: string = '';
+
   public headers: Map<string, unknown> = new Map();
 
   public queryParams: Map<string, unknown> = new Map();
@@ -40,23 +47,33 @@ export class Request<T> {
 
   private readonly pathPattern: string;
 
+  public validation: ValidationOptions = {} as any;
+
+  public retry: RetryOptions = {} as any;
+
   constructor(params: CreateRequestParameters<T>) {
+    this.baseUrl = params.baseUrl;
     this.method = params.method;
     this.pathPattern = params.path;
     this.body = params.body;
     this.path = this.constructPath();
     this.config = params.config;
+    this.pathParams = params.pathParams;
+    this.headers = params.headers;
+    this.queryParams = params.queryParams;
     this.responseSchema = params.responseSchema;
     this.requestSchema = params.requestSchema;
     this.requestContentType = params.requestContentType;
     this.responseContentType = params.responseContentType;
-    this.applyRequestConfig(params.requestConfig);
+    this.retry = params.retry;
+    this.validation = params.validation;
   }
 
   addHeaderParam(key: string, value: unknown): void {
     if (value === undefined) {
       return;
     }
+
     this.headers.set(key, value);
   }
 
@@ -64,6 +81,7 @@ export class Request<T> {
     if (value === undefined) {
       return;
     }
+
     this.queryParams.set(key, value);
   }
 
@@ -71,6 +89,7 @@ export class Request<T> {
     if (value === undefined) {
       return;
     }
+
     this.pathParams.set(key, value);
   }
 
@@ -78,14 +97,8 @@ export class Request<T> {
     if (body === undefined) {
       return;
     }
-    this.body = body;
-  }
 
-  getRetry(): Required<RetryOptions> {
-    return {
-      attempts: this.config.retry?.attempts ?? 3,
-      delayMs: this.config.retry?.delayMs ?? 150,
-    };
+    this.body = body;
   }
 
   getFetchArgs(): { url: string; requestInit: RequestInit } {
@@ -94,10 +107,14 @@ export class Request<T> {
       requestInit: {
         method: this.method,
         body: this.body,
-        headers: this.constructHeadersInit(),
       },
     };
 
+    const headersInit = this.constructHeadersInit();
+    if (!!headersInit) {
+      fetchArgs.requestInit['headers'] = headersInit;
+    }
+
     if (this.config.timeout !== undefined) {
       fetchArgs.requestInit = {
         ...fetchArgs.requestInit,
@@ -109,39 +126,28 @@ export class Request<T> {
   }
 
   public updateFromHookRequest(hookRequest: HttpRequest) {
+    this.baseUrl = hookRequest.baseUrl;
     this.method = hookRequest.method;
     this.path = hookRequest.path;
     this.body = hookRequest.body;
-    this.headers = hookRequest.headers || new Map();
-    this.queryParams = hookRequest.queryParams || new Map();
+    this.headers = hookRequest.headers;
+    this.queryParams = hookRequest.queryParams;
   }
 
-  private applyRequestConfig(requestConfig: RequestConfig | undefined) {
-    this.config = {
-      ...this.config,
-      retry: {
-        attempts: requestConfig?.retry?.attempts || this.config.retry?.attempts || 3,
-        delayMs: requestConfig?.retry?.delayMs || this.config.retry?.delayMs || 150,
-      },
-      validation: {
-        responseValidation: this.applyResponseValidation(requestConfig),
-      },
+  public toHookRequest(): HttpRequest {
+    return {
+      baseUrl: this.baseUrl,
+      method: this.method,
+      path: this.path,
+      headers: this.headers,
+      body: this.body,
+      queryParams: this.queryParams,
     };
   }
 
-  private applyResponseValidation(requestConfig: RequestConfig | undefined): boolean {
-    if (requestConfig?.validation?.responseValidation !== undefined) {
-      return requestConfig?.validation.responseValidation;
-    }
-    if (this.config?.validation?.responseValidation !== undefined) {
-      return this.config?.validation?.responseValidation;
-    }
-    return true;
-  }
-
   private constructFullUrl(): string {
     const queryString = this.constructQueryString();
-    return `${this.config.baseUrl}${this.constructPath()}${queryString}`;
+    return `${this.baseUrl}${this.constructPath()}${queryString}`;
   }
 
   private constructPath(): string {
@@ -149,8 +155,11 @@ export class Request<T> {
     return serializePath(this.pathPattern, pathParamsRecord);
   }
 
-  private constructHeadersInit(): HeadersInit {
+  private constructHeadersInit(): HeadersInit | undefined {
     const headerParamsRecord: Record<string, unknown> = this.constructParamsRecord(this.headers);
+    if (Object.entries(headerParamsRecord).length === 0) {
+      return undefined;
+    }
     return serializeHeader(headerParamsRecord);
   }