@tapsilat/tapsilat-js 1.0.2

package/dist/http/HttpClient.d.ts

@@ -0,0 +1,149 @@
+import { TapsilatConfig, APIResponse } from "../types";
+import { InterceptorManager } from "./interceptors";
+/**
+ * Configuration options for individual HTTP requests
+ */
+export interface RequestConfig extends Omit<RequestInit, "method" | "body"> {
+    timeout?: number;
+    retries?: number;
+    baseURL?: string;
+    maxRetries?: number;
+    params?: Record<string, any>;
+}
+/**
+ * HTTP methods supported by the client
+ */
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+/**
+ * Generic constraint for request body types
+ */
+export type RequestBody = Record<string, unknown> | Record<string, any> | object | unknown[] | string | FormData;
+/**
+ * HTTP Client for making API requests with comprehensive error handling,
+ * retry logic, and request/response interceptors
+ *
+ * @example
+ * ```typescript
+ * const client = new HttpClient({
+ *   apiKey: 'your-api-key',
+ *   baseURL: 'https://api.example.com/v1'
+ * });
+ *
+ * const data = await client.get<UserResponse>('/users/123');
+ * ```
+ */
+export declare class HttpClient {
+    private readonly config;
+    private readonly interceptors;
+    constructor(config: TapsilatConfig);
+    /**
+     * GET request method overloads
+     */
+    get<T = unknown>(url: string): Promise<APIResponse<T>>;
+    get<T = unknown>(url: string, config: RequestConfig): Promise<APIResponse<T>>;
+    /**
+     * POST request method overloads
+     */
+    post<T = unknown>(url: string): Promise<APIResponse<T>>;
+    post<T = unknown>(url: string, body: RequestBody): Promise<APIResponse<T>>;
+    post<T = unknown>(url: string, body: RequestBody, config: RequestConfig): Promise<APIResponse<T>>;
+    /**
+     * PUT request method overloads
+     */
+    put<T = unknown>(url: string): Promise<APIResponse<T>>;
+    put<T = unknown>(url: string, body: RequestBody): Promise<APIResponse<T>>;
+    put<T = unknown>(url: string, body: RequestBody, config: RequestConfig): Promise<APIResponse<T>>;
+    /**
+     * PATCH request method overloads
+     */
+    patch<T = unknown>(url: string): Promise<APIResponse<T>>;
+    patch<T = unknown>(url: string, body: RequestBody): Promise<APIResponse<T>>;
+    patch<T = unknown>(url: string, body: RequestBody, config: RequestConfig): Promise<APIResponse<T>>;
+    /**
+     * DELETE request method overloads
+     */
+    delete<T = unknown>(url: string): Promise<APIResponse<T>>;
+    delete<T = unknown>(url: string, config: RequestConfig): Promise<APIResponse<T>>;
+    /**
+     * Core request method with comprehensive error handling and retry logic
+     *
+     * @param method - HTTP method to use
+     * @param url - Request URL (relative to baseURL)
+     * @param body - Request body data
+     * @param config - Additional request configuration
+     * @returns Promise resolving to API response
+     */
+    private request;
+    /**
+     * Makes the actual HTTP request with timeout handling
+     */
+    private makeRequest;
+    /**
+     * Processes the fetch response and converts to APIResponse format
+     */
+    private processResponse;
+    /**
+     * Creates appropriate error based on response status and data
+     */
+    private createErrorFromResponse;
+    /**
+     * Extracts error message from response data
+     */
+    private extractErrorMessage;
+    /**
+     * Extracts validation details from error response
+     */
+    private extractValidationDetails;
+    /**
+     * Extracts rate limit information from response headers
+     */
+    private extractRateLimitInfo;
+    /**
+     * Builds the complete URL for the request
+     */
+    private buildUrl;
+    /**
+     * Builds RequestInit options for the fetch request
+     */
+    private buildRequestOptions;
+    /**
+     * Determines if an error should prevent retrying
+     */
+    private shouldNotRetry;
+    /**
+     * Calculates retry delay with exponential backoff
+     */
+    private calculateRetryDelay;
+    /**
+     * Utility method to create delay
+     */
+    private delay;
+    /**
+     * Gets the interceptor manager for advanced request/response handling
+     *
+     * @returns InterceptorManager instance
+     */
+    getInterceptors(): InterceptorManager;
+    /**
+     * Adds a request interceptor
+     *
+     * @param interceptor - Request interceptor function
+     * @returns Interceptor ID for removal
+     */
+    addRequestInterceptor(interceptor: Parameters<InterceptorManager["addRequestInterceptor"]>[0]): number;
+    /**
+     * Adds a response interceptor
+     *
+     * @param interceptor - Response interceptor function
+     * @returns Interceptor ID for removal
+     */
+    addResponseInterceptor(interceptor: Parameters<InterceptorManager["addResponseInterceptor"]>[0]): number;
+    /**
+     * Adds an error interceptor
+     *
+     * @param interceptor - Error interceptor function
+     * @returns Interceptor ID for removal
+     */
+    addErrorInterceptor(interceptor: Parameters<InterceptorManager["addErrorInterceptor"]>[0]): number;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/http/HttpClient.d.ts.map

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

package/dist/http/interceptors.d.ts

@@ -0,0 +1,50 @@
+import { APIResponse } from "../types";
+export type RequestInterceptor = (url: string, options: RequestInit) => Promise<{
+    url: string;
+    options: RequestInit;
+}> | {
+    url: string;
+    options: RequestInit;
+};
+export type ResponseInterceptor = (response: APIResponse<any>, request: {
+    url: string;
+    options: RequestInit;
+}) => Promise<APIResponse<any>> | APIResponse<any>;
+export type ErrorInterceptor = (error: Error, request: {
+    url: string;
+    options: RequestInit;
+}) => Promise<never | APIResponse<any>> | never | APIResponse<any>;
+export declare class InterceptorManager {
+    private requestInterceptors;
+    private responseInterceptors;
+    private errorInterceptors;
+    addRequestInterceptor(interceptor: RequestInterceptor): number;
+    removeRequestInterceptor(id: number): void;
+    executeRequestInterceptors(url: string, options: RequestInit): Promise<{
+        url: string;
+        options: RequestInit;
+    }>;
+    addResponseInterceptor(interceptor: ResponseInterceptor): number;
+    removeResponseInterceptor(id: number): void;
+    executeResponseInterceptors<T>(response: APIResponse<T>, request: {
+        url: string;
+        options: RequestInit;
+    }): Promise<APIResponse<T>>;
+    addErrorInterceptor(interceptor: ErrorInterceptor): number;
+    removeErrorInterceptor(id: number): void;
+    executeErrorInterceptors(error: Error, request: {
+        url: string;
+        options: RequestInit;
+    }): Promise<never | APIResponse<any>>;
+    clear(): void;
+}
+export declare const createLoggingInterceptor: (debug?: boolean) => {
+    request: RequestInterceptor;
+    response: ResponseInterceptor;
+    error: ErrorInterceptor;
+};
+export declare const createTimingInterceptor: () => {
+    request: RequestInterceptor;
+    response: ResponseInterceptor;
+};
+//# sourceMappingURL=interceptors.d.ts.map

package/dist/http/interceptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../../src/http/interceptors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,KAElB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,GAC9C;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,EAC1B,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,KAC3C,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AAElD,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,KAC3C,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AAElE,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,iBAAiB,CAA0B;IAGnD,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM;IAK9D,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMpC,0BAA0B,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;IAgBjD,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,GAAG,MAAM;IAKhE,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMrC,2BAA2B,CAAC,CAAC,EACjC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EACxB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,GAC7C,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAa1B,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,GAAG,MAAM;IAK1D,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMlC,wBAAwB,CAC5B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,GAC7C,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAiBpC,KAAK,IAAI,IAAI;CAKd;AAGD,eAAO,MAAM,wBAAwB,GACnC,QAAO,OAAe,KACrB;IACD,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,KAAK,EAAE,gBAAgB,CAAC;CA+BxB,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAAO;IACzC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,mBAAmB,CAAC;CAkC/B,CAAC"}