@adatechnology/http-client 0.0.1

package/dist/types/http.interface.d.ts

@@ -0,0 +1,175 @@
+import { Observable } from "rxjs";
+/**
+ * HTTP methods supported
+ */
+export declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH",
+    DELETE = "DELETE",
+    HEAD = "HEAD",
+    OPTIONS = "OPTIONS"
+}
+/**
+ * Content types for HTTP requests
+ */
+export declare enum ContentType {
+    JSON = "application/json",
+    FORM_URLENCODED = "application/x-www-form-urlencoded",
+    FORM_DATA = "multipart/form-data",
+    TEXT = "text/plain",
+    XML = "application/xml"
+}
+/**
+ * HTTP request configuration
+ */
+export interface HttpRequestConfig {
+    url: string;
+    method?: HttpMethod;
+    headers?: Record<string, string>;
+    params?: Record<string, any>;
+    data?: any;
+    timeout?: number;
+    contentType?: ContentType;
+    responseType?: "json" | "text" | "blob" | "arraybuffer";
+    withCredentials?: boolean;
+    retryAttempts?: number;
+    retryDelay?: number;
+    cache?: boolean;
+    cacheTtl?: number;
+}
+/**
+ * HTTP response structure
+ */
+export interface HttpResponse<T = any> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    config: HttpRequestConfig;
+    request?: any;
+}
+/**
+ * HTTP error structure
+ */
+export interface HttpError extends Error {
+    config: HttpRequestConfig;
+    response?: HttpResponse;
+    status?: number;
+    statusText?: string;
+    isNetworkError?: boolean;
+    isTimeout?: boolean;
+}
+/**
+ * Error interceptor function
+ */
+export type ErrorInterceptor = (error: any) => any;
+/**
+ * HTTP provider interface
+ */
+export interface HttpProviderInterface {
+    /**
+     * Make a GET request
+     */
+    get<T = any>(url: string, config?: Omit<HttpRequestConfig, "url" | "method">): Promise<HttpResponse<T>>;
+    /**
+     * Make a POST request
+     */
+    post<T = any>(url: string, data?: any, config?: Omit<HttpRequestConfig, "url" | "method" | "data">): Promise<HttpResponse<T>>;
+    /**
+     * Make a PUT request
+     */
+    put<T = any>(url: string, data?: any, config?: Omit<HttpRequestConfig, "url" | "method" | "data">): Promise<HttpResponse<T>>;
+    /**
+     * Make a PATCH request
+     */
+    patch<T = any>(url: string, data?: any, config?: Omit<HttpRequestConfig, "url" | "method" | "data">): Promise<HttpResponse<T>>;
+    /**
+     * Make a DELETE request
+     */
+    delete<T = any>(url: string, config?: Omit<HttpRequestConfig, "url" | "method">): Promise<HttpResponse<T>>;
+    /**
+     * Make a HEAD request
+     */
+    head<T = any>(url: string, config?: Omit<HttpRequestConfig, "url" | "method">): Promise<HttpResponse<T>>;
+    /**
+     * Make an OPTIONS request
+     */
+    options<T = any>(url: string, config?: Omit<HttpRequestConfig, "url" | "method">): Promise<HttpResponse<T>>;
+    /**
+     * Make a generic HTTP request
+     */
+    request<T = any>(config: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Set global headers
+     */
+    setGlobalHeader(key: string, value: string): void;
+    /**
+     * Remove global header
+     */
+    removeGlobalHeader(key: string): void;
+    /**
+     * Get global headers
+     */
+    getGlobalHeaders(): Record<string, string>;
+    /**
+     * Set base URL for all requests
+     */
+    setBaseUrl(baseUrl: string): void;
+    /**
+     * Get current base URL
+     */
+    getBaseUrl(): string;
+    /**
+     * Set default timeout
+     */
+    setDefaultTimeout(timeout: number): void;
+    /**
+     * Add error interceptor
+     */
+    addErrorInterceptor(interceptor: ErrorInterceptor): number;
+    /**
+     * Remove error interceptor
+     */
+    removeErrorInterceptor(id: number): void;
+    /**
+     * Clear cache for a specific key or all cache
+     */
+    clearCache(key?: string): void;
+    /**
+     * Set authorization token
+     */
+    setAuthToken(token: string, type?: string): void;
+    /**
+     * Clear authorization token
+     */
+    clearAuthToken(): void;
+    /**
+     * Add request interceptor
+     */
+    addRequestInterceptor(onFulfilled: (config: any) => any, onRejected?: (error: any) => any): number;
+    /**
+     * Remove request interceptor by id
+     */
+    removeRequestInterceptor(id: number): void;
+    /**
+     * Add response interceptor
+     */
+    addResponseInterceptor(onFulfilled: (response: any) => any, onRejected?: (error: any) => any): number;
+    /**
+     * Remove response interceptor by id
+     */
+    removeResponseInterceptor(id: number): void;
+    /**
+     * Observable version for reactive programming
+     */
+    get$<T = any>(url: string, config?: Omit<HttpRequestConfig, "url" | "method">): Observable<HttpResponse<T>>;
+    post$<T = any>(url: string, data?: any, config?: Omit<HttpRequestConfig, "url" | "method" | "data">): Observable<HttpResponse<T>>;
+    put$<T = any>(url: string, data?: any, config?: Omit<HttpRequestConfig, "url" | "method" | "data">): Observable<HttpResponse<T>>;
+    patch$<T = any>(url: string, data?: any, config?: Omit<HttpRequestConfig, "url" | "method" | "data">): Observable<HttpResponse<T>>;
+    delete$<T = any>(url: string, config?: Omit<HttpRequestConfig, "url" | "method">): Observable<HttpResponse<T>>;
+    head$<T = any>(url: string, config?: Omit<HttpRequestConfig, "url" | "method">): Observable<HttpResponse<T>>;
+    options$<T = any>(url: string, config?: Omit<HttpRequestConfig, "url" | "method">): Observable<HttpResponse<T>>;
+    request$<T = any>(config: HttpRequestConfig): Observable<HttpResponse<T>>;
+}

package/dist/types/http.module.d.ts

@@ -0,0 +1,9 @@
+import { DynamicModule } from "@nestjs/common";
+import { AxiosInstance, AxiosRequestConfig } from "axios";
+export declare class HttpModule {
+    /**
+     * Configure HttpModule with an Axios instance or AxiosRequestConfig.
+     * This will import the implementation-specific module (currently Axios).
+     */
+    static forRoot(config?: AxiosRequestConfig | AxiosInstance): DynamicModule;
+}

package/dist/types/http.provider.d.ts

@@ -0,0 +1,43 @@
+import { Observable } from "rxjs";
+import { ErrorInterceptor, HttpProviderInterface, HttpRequestConfig, HttpResponse } from "./http.interface";
+import type { AxiosHttpProviderInterface } from "./implementations/axios/axios.http.provider";
+export declare class HttpProvider implements HttpProviderInterface {
+    private readonly axiosHttpProvider;
+    constructor(axiosHttpProvider: AxiosHttpProviderInterface);
+    /**
+     * Expose underlying axios instance when available from the axios provider implementation.
+     * This is intentionally typed as unknown/any to avoid leaking implementation details.
+     */
+    getAxiosInstance(): any | undefined;
+    get<T>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    get$<T>(url: string, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    post<T>(url: string, data?: any, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    post$<T>(url: string, data?: any, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    put<T>(url: string, data?: any, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    put$<T>(url: string, data?: any, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    patch<T>(url: string, data?: any, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    patch$<T>(url: string, data?: any, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    delete<T>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    delete$<T>(url: string, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    head<T>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    head$<T>(url: string, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    options<T>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    options$<T>(url: string, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    request<T>(config: HttpRequestConfig): Promise<HttpResponse<T>>;
+    request$<T>(config: HttpRequestConfig): Observable<HttpResponse<T>>;
+    setGlobalHeader(key: string, value: string): void;
+    removeGlobalHeader(key: string): void;
+    getGlobalHeaders(): Record<string, string>;
+    setBaseUrl(baseUrl: string): void;
+    getBaseUrl(): string;
+    setDefaultTimeout(timeout: number): void;
+    addErrorInterceptor(interceptor: ErrorInterceptor): number;
+    removeErrorInterceptor(id: number): void;
+    clearCache(key?: string): void;
+    setAuthToken(token: string, type?: string): void;
+    clearAuthToken(): void;
+    addRequestInterceptor(onFulfilled: (config: any) => any, onRejected?: (error: any) => any): number;
+    removeRequestInterceptor(id: number): void;
+    addResponseInterceptor(onFulfilled: (response: any) => any, onRejected?: (error: any) => any): number;
+    removeResponseInterceptor(id: number): void;
+}

package/dist/types/http.token.d.ts

@@ -0,0 +1,3 @@
+export declare const HTTP_AXIOS_CONNECTION = "HTTP_AXIOS_CONNECTION";
+export declare const HTTP_AXIOS_PROVIDER = "HTTP_AXIOS_PROVIDER";
+export declare const HTTP_PROVIDER = "HTTP_PROVIDER";

package/dist/types/implementations/axios/axios.http.module.d.ts

@@ -0,0 +1,5 @@
+import { DynamicModule } from "@nestjs/common";
+import { AxiosInstance, AxiosRequestConfig } from "axios";
+export declare class HttpImplementationAxiosModule {
+    static forRoot(config?: AxiosRequestConfig | AxiosInstance): DynamicModule;
+}

package/dist/types/implementations/axios/axios.http.provider.d.ts

@@ -0,0 +1,226 @@
+import { AxiosInstance } from "axios";
+import { Observable } from "rxjs";
+import { ErrorInterceptor, HttpProviderInterface, HttpRequestConfig, HttpResponse } from "../../http.interface";
+/**
+ * Interface for Axios HTTP Provider
+ */
+export interface AxiosHttpProviderInterface extends HttpProviderInterface {
+}
+/**
+ * Axios-based implementation of the HTTP provider interface.
+ * Provides HTTP client functionality with both Promise and Observable APIs,
+ * plus basic caching capabilities.
+ */
+export declare class AxiosHttpProvider implements AxiosHttpProviderInterface {
+    private axiosInstance;
+    private errorInterceptors;
+    private nextErrorInterceptorId;
+    private requestInterceptorIds;
+    private responseInterceptorIds;
+    private cache;
+    private cacheCleanupInterval?;
+    constructor(axiosInstance?: AxiosInstance);
+    /**
+     * Starts automatic cache cleanup
+     */
+    private startCacheCleanup;
+    /**
+     * Stops automatic cache cleanup
+     */
+    private stopCacheCleanup;
+    /**
+     * Cleans up expired cache entries
+     */
+    private cleanupExpiredCache;
+    /**
+     * Generates a cache key from URL and config
+     */
+    private generateCacheKey;
+    /**
+     * Gets cached data if valid
+     */
+    private getCached;
+    /**
+     * Sets data in cache
+     */
+    private setCache;
+    /**
+     * Clears cache for a specific key or all cache
+     */
+    clearCache(key?: string): void;
+    /**
+     * Gets cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Sets a global header that will be included in all requests.
+     */
+    setGlobalHeader(key: string, value: string): void;
+    /**
+     * Removes a global header.
+     */
+    removeGlobalHeader(key: string): void;
+    /**
+     * Gets all global headers currently set.
+     */
+    getGlobalHeaders(): Record<string, string>;
+    /**
+     * Sets the base URL for all requests.
+     */
+    setBaseUrl(baseUrl: string): void;
+    /**
+     * Gets the current base URL.
+     */
+    getBaseUrl(): string;
+    /**
+     * Sets the default timeout for all requests.
+     */
+    setDefaultTimeout(timeout: number): void;
+    /**
+     * Adds an error interceptor for handling errors globally.
+     */
+    addErrorInterceptor(interceptor: ErrorInterceptor): number;
+    /**
+     * Adds a request interceptor to the underlying Axios instance.
+     */
+    addRequestInterceptor(onFulfilled: (config: any) => any, onRejected?: (error: any) => any): number;
+    /**
+     * Removes a request interceptor by id.
+     */
+    removeRequestInterceptor(id: number): void;
+    /**
+     * Adds a response interceptor to the underlying Axios instance.
+     */
+    addResponseInterceptor(onFulfilled: (res: any) => any, onRejected?: (error: any) => any): number;
+    /**
+     * Removes a response interceptor by id.
+     */
+    removeResponseInterceptor(id: number): void;
+    /**
+     * Removes an error interceptor by its ID.
+     */
+    removeErrorInterceptor(id: number): void;
+    /**
+     * Performs a GET request to the specified URL.
+     */
+    get<T>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Internal method to perform the actual GET request.
+     */
+    private performGet;
+    /**
+     * Performs a GET request and returns an Observable.
+     */
+    get$<T>(url: string, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    /**
+     * Performs a POST request.
+     */
+    post<T>(url: string, data?: unknown, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Internal method to perform the actual POST request.
+     */
+    private performPost;
+    /**
+     * Performs a POST request and returns an Observable.
+     */
+    post$<T>(url: string, data?: unknown, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    /**
+     * Performs a PUT request.
+     */
+    put<T>(url: string, data?: unknown, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Internal method to perform the actual PUT request.
+     */
+    private performPut;
+    /**
+     * Performs a PUT request and returns an Observable.
+     */
+    put$<T>(url: string, data?: unknown, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    /**
+     * Performs a PATCH request.
+     */
+    patch<T>(url: string, data?: unknown, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Internal method to perform the actual PATCH request.
+     */
+    private performPatch;
+    /**
+     * Performs a PATCH request and returns an Observable.
+     */
+    patch$<T>(url: string, data?: unknown, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    /**
+     * Performs a DELETE request.
+     */
+    delete<T>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Internal method to perform the actual DELETE request.
+     */
+    private performDelete;
+    /**
+     * Performs a DELETE request and returns an Observable.
+     */
+    delete$<T>(url: string, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    /**
+     * Performs a HEAD request.
+     */
+    head<T>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Internal method to perform the actual HEAD request.
+     */
+    private performHead;
+    /**
+     * Performs a HEAD request and returns an Observable.
+     */
+    head$<T>(url: string, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    /**
+     * Performs an OPTIONS request.
+     */
+    options<T>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Internal method to perform the actual OPTIONS request.
+     */
+    private performOptions;
+    /**
+     * Performs an OPTIONS request and returns an Observable.
+     */
+    options$<T>(url: string, config?: HttpRequestConfig): Observable<HttpResponse<T>>;
+    /**
+     * Performs a custom HTTP request.
+     */
+    request<T>(config: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Internal method to perform the actual custom request.
+     */
+    private performRequest;
+    /**
+     * Performs a custom HTTP request and returns an Observable.
+     */
+    request$<T>(config: HttpRequestConfig): Observable<HttpResponse<T>>;
+    /**
+     * Sets the authorization token for requests.
+     */
+    setAuthToken(token: string, type?: string): void;
+    /**
+     * Clears the authorization token.
+     */
+    clearAuthToken(): void;
+    /**
+     * Processes an error through all registered error interceptors.
+     */
+    private processErrorInterceptors;
+    /**
+     * Returns a masked version of the token showing only the initial characters.
+     */
+    private static maskToken;
+    /**
+     * Wraps a promise-returning HTTP method with error interceptor processing.
+     */
+    private wrapWithErrorInterceptors;
+    /**
+     * Transforms an Axios response to the standardized HTTP response format.
+     */
+    private transformResponse;
+}

package/dist/types/implementations/axios/axios.http.token.d.ts

@@ -0,0 +1 @@
+export declare const AXIOS_HTTP_PROVIDER = "AXIOS_HTTP_PROVIDER";

package/dist/types/implementations/http.implementation.module.d.ts

@@ -0,0 +1,2 @@
+export declare class HttpImplementationModule {
+}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export { HttpModule } from "./http.module";
+export { HttpImplementationAxiosModule } from "./implementations/axios/axios.http.module";
+export { HTTP_PROVIDER, HTTP_AXIOS_PROVIDER, HTTP_AXIOS_CONNECTION, } from "./http.token";
+export type { HttpProviderInterface } from "./http.interface";

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@adatechnology/http-client",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "peerDependencies": {
+    "@nestjs/common": "^11",
+    "@nestjs/core": "^11"
+  },
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}