@xeno-js/shared 2.0.1 → 3.0.0

package/dist/ihttp-client.contracts-DX2hDTW6.d.ts

@@ -0,0 +1,299 @@
+import { O as Optional, D as Dictionary, M as Maybe } from './common.types-DT8JtZ0E.js';
+
+/**
+ * @description Supported HTTP methods.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+/**
+ * @description Header map used by agnostic HTTP clients.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+type HttpHeaders = Dictionary<Optional<string | string[]>>;
+/**
+ * @description Query string value accepted by the HTTP contract.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+type HttpQueryValue = Maybe<string | number | boolean>;
+/**
+ * @description Agnostic contract used to execute HTTP calls independently
+ * from concrete transport libraries (fetch, axios, undici, etc.).
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+type HttpOptions = 'url' | 'method' | 'body';
+/**
+ * @description Base Request options accepted by the agnostic HTTP client.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface HttpBaseRequest {
+    /** @description Optional query string parameters.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly query?: Optional<Dictionary<HttpQueryValue>>;
+    /** @description Optional request headers.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly headers?: Optional<HttpHeaders>;
+    /** @description Optional abort signal used to cancel the request.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly signal: Optional<AbortSignal>;
+    /** @description Optional request timeout in milliseconds.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly timeoutMs?: Optional<number>;
+    /**
+     * @description Optional response type for the request.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly responseType?: Optional<HttpResponseType>;
+}
+/**
+ * @description Represents the structure of an HTTP response.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+type HttpResponseType = 'json' | 'blob' | 'text' | 'arraybuffer';
+/**
+ * @description Request options accepted by the agnostic HTTP client.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface HttpRequest<TBody = unknown> extends HttpBaseRequest {
+    /** @description HTTP method used for the outgoing call.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly method: HttpMethod;
+    /** @description Optional request body.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly body?: Optional<TBody>;
+    /** @description Absolute or relative target URL.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly url?: string;
+}
+/**
+ * @description Normalized response returned by an agnostic HTTP client.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface HttpResponse<TData = unknown> {
+    /** @description HTTP status code returned by the server.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly status: number;
+    /** @description Indicates if the response status is in the 2xx range.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly ok: boolean;
+    /** @description Response headers normalized as a dictionary.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly headers: HttpHeaders;
+    /** @description Parsed response payload.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly data: TData;
+}
+/**
+ * @description Represents the CookieOptions interface.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface CookieOptions {
+    /** @description The path for which the cookie is valid. Defaults to '/'. */
+    path?: Optional<string>;
+    /** @description The value of the maximum age in seconds. If not specified, the cookie will expire when the browser session ends. */
+    maxAge?: Optional<number>;
+    /** @description The domain for which the cookie is valid. Defaults to the domain of the current document host. */
+    domain?: Optional<string>;
+    /** @description Whether the cookie is only transmitted over secure (HTTPS) connections. Defaults to true in production. */
+    secure?: Optional<boolean>;
+    /** @description Controls whether the cookie is withheld on cross-site requests, providing some protection against cross-site request forgery attacks. */
+    sameSite?: Optional<'lax' | 'strict' | 'none' | boolean>;
+}
+/**
+ * @description Represents an extended Request object that includes additional properties
+ * required by the Xeno-js framework, such as custom path handling.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface ExtendedRequest extends Request {
+    /**
+     * @description The path of the request, which may be modified by middleware.
+     * Example: '/api/v1/user'
+     */
+    path: string;
+}
+
+/**
+ * @description Agnostic contract used to execute HTTP calls independently from concrete transport libraries (fetch, axios, undici, etc.).
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface IHttpClient {
+    /**
+     * @description Executes an HTTP GET request to the specified URL with optional request options.
+     * @param url The URL to which the GET request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    get<TResponse = unknown>(url: string, options: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP POST request to the specified URL with the provided request body and optional request options.
+     * @param url The URL to which the POST request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param body The request body to be sent with the POST request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    post<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP PUT request to the specified URL with the provided request body and optional request options.
+     * @param url The URL to which the PUT request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param body The request body to be sent with the PUT request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    put<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP PATCH request to the specified URL with the provided request body and optional request options.
+     * @param url The URL to which the PATCH request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param body The request body to be sent with the PATCH request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    patch<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP DELETE request to the specified URL with optional request options.
+     * @param url The URL to which the DELETE request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    delete<TResponse = unknown>(url: string, options: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+}
+
+export type { CookieOptions as C, ExtendedRequest as E, HttpRequest as H, IHttpClient as I, HttpOptions as a, HttpResponse as b, HttpHeaders as c, HttpBaseRequest as d, HttpMethod as e, HttpQueryValue as f, HttpResponseType as g };

package/dist/ihttp-client.contracts-KMkYuIHH.d.cts

@@ -0,0 +1,299 @@
+import { O as Optional, D as Dictionary, M as Maybe } from './common.types-DT8JtZ0E.cjs';
+
+/**
+ * @description Supported HTTP methods.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+/**
+ * @description Header map used by agnostic HTTP clients.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+type HttpHeaders = Dictionary<Optional<string | string[]>>;
+/**
+ * @description Query string value accepted by the HTTP contract.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+type HttpQueryValue = Maybe<string | number | boolean>;
+/**
+ * @description Agnostic contract used to execute HTTP calls independently
+ * from concrete transport libraries (fetch, axios, undici, etc.).
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+type HttpOptions = 'url' | 'method' | 'body';
+/**
+ * @description Base Request options accepted by the agnostic HTTP client.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface HttpBaseRequest {
+    /** @description Optional query string parameters.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly query?: Optional<Dictionary<HttpQueryValue>>;
+    /** @description Optional request headers.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly headers?: Optional<HttpHeaders>;
+    /** @description Optional abort signal used to cancel the request.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly signal: Optional<AbortSignal>;
+    /** @description Optional request timeout in milliseconds.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly timeoutMs?: Optional<number>;
+    /**
+     * @description Optional response type for the request.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly responseType?: Optional<HttpResponseType>;
+}
+/**
+ * @description Represents the structure of an HTTP response.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+type HttpResponseType = 'json' | 'blob' | 'text' | 'arraybuffer';
+/**
+ * @description Request options accepted by the agnostic HTTP client.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface HttpRequest<TBody = unknown> extends HttpBaseRequest {
+    /** @description HTTP method used for the outgoing call.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly method: HttpMethod;
+    /** @description Optional request body.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly body?: Optional<TBody>;
+    /** @description Absolute or relative target URL.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly url?: string;
+}
+/**
+ * @description Normalized response returned by an agnostic HTTP client.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface HttpResponse<TData = unknown> {
+    /** @description HTTP status code returned by the server.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly status: number;
+    /** @description Indicates if the response status is in the 2xx range.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly ok: boolean;
+    /** @description Response headers normalized as a dictionary.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly headers: HttpHeaders;
+    /** @description Parsed response payload.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly data: TData;
+}
+/**
+ * @description Represents the CookieOptions interface.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface CookieOptions {
+    /** @description The path for which the cookie is valid. Defaults to '/'. */
+    path?: Optional<string>;
+    /** @description The value of the maximum age in seconds. If not specified, the cookie will expire when the browser session ends. */
+    maxAge?: Optional<number>;
+    /** @description The domain for which the cookie is valid. Defaults to the domain of the current document host. */
+    domain?: Optional<string>;
+    /** @description Whether the cookie is only transmitted over secure (HTTPS) connections. Defaults to true in production. */
+    secure?: Optional<boolean>;
+    /** @description Controls whether the cookie is withheld on cross-site requests, providing some protection against cross-site request forgery attacks. */
+    sameSite?: Optional<'lax' | 'strict' | 'none' | boolean>;
+}
+/**
+ * @description Represents an extended Request object that includes additional properties
+ * required by the Xeno-js framework, such as custom path handling.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface ExtendedRequest extends Request {
+    /**
+     * @description The path of the request, which may be modified by middleware.
+     * Example: '/api/v1/user'
+     */
+    path: string;
+}
+
+/**
+ * @description Agnostic contract used to execute HTTP calls independently from concrete transport libraries (fetch, axios, undici, etc.).
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface IHttpClient {
+    /**
+     * @description Executes an HTTP GET request to the specified URL with optional request options.
+     * @param url The URL to which the GET request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    get<TResponse = unknown>(url: string, options: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP POST request to the specified URL with the provided request body and optional request options.
+     * @param url The URL to which the POST request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param body The request body to be sent with the POST request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    post<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP PUT request to the specified URL with the provided request body and optional request options.
+     * @param url The URL to which the PUT request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param body The request body to be sent with the PUT request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    put<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP PATCH request to the specified URL with the provided request body and optional request options.
+     * @param url The URL to which the PATCH request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param body The request body to be sent with the PATCH request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    patch<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP DELETE request to the specified URL with optional request options.
+     * @param url The URL to which the DELETE request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    delete<TResponse = unknown>(url: string, options: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+}
+
+export type { CookieOptions as C, ExtendedRequest as E, HttpRequest as H, IHttpClient as I, HttpOptions as a, HttpResponse as b, HttpHeaders as c, HttpBaseRequest as d, HttpMethod as e, HttpQueryValue as f, HttpResponseType as g };