api-core-lib 11.7.6 → 11.8.7

package/dist/index.d.mts

@@ -1,5 +1,12 @@
 import { InternalAxiosRequestConfig, AxiosResponse, AxiosRequestConfig, AxiosProgressEvent, AxiosInstance, Method } from 'axios';
 
+interface Logger {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+}
+
 /**
  * @file src/types.ts
  * @description This file serves as the central source for all data types and interfaces
@@ -192,25 +199,11 @@ interface RefreshTokenConfig {
  * 'error': Logs only critical errors.
  * 'silent': Disables all logging.
  */
-type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent' | "log";
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
 /**
  * An interface for a custom logger, compatible with the standard `console` object.
  * It now includes a `debug` method for more granular logging.
  */
-interface Logger {
-    /** Logs a standard message. In our wrapper, this is often an alias for `info` or `debug`. */
-    log(message?: any, ...optionalParams: any[]): void;
-    /** Logs an informational message. */
-    info(message?: any, ...optionalParams: any[]): void;
-    /** Logs a warning message. */
-    warn(message?: any, ...optionalParams: any[]): void;
-    /** Logs an error message. */
-    error(message?: any, ...optionalParams: any[]): void;
-    /**
-     * Logs a debug message, typically for verbose, development-only output.
-     */
-    debug(message?: any, ...optionalParams: any[]): void;
-}
 /**
  * The main configuration object for the `createApiClient` factory function.
  */
@@ -248,17 +241,6 @@ interface ApiClientConfig {
     maxQueueSize?: number;
 }
 
-/**
- * @file src/core/client.ts
- * @description This is the heart of the API client library.
- * The `createApiClient` function constructs and configures a sophisticated Axios instance.
- * It features intelligent, security-first token management, a flexible middleware system,
- * and customizable logging, all designed to work seamlessly in modern web frameworks like Next.js.
- */
-
-/**
- * Creates and configures a new Axios instance with advanced features.
- */
 declare function createApiClient(config: ApiClientConfig): AxiosInstance;
 
 /**
@@ -472,11 +454,6 @@ type ModuleActions<TModule extends ApiModuleConfig> = {
     [K in keyof TModule['actions']]: TModule['actions'][K] extends ActionConfig<infer TInput, infer TOutput> ? ExecutableAction<TInput, TOutput> : never;
 };
 
-/**
- * A factory function to create a reusable set of API services for a specific endpoint.
- * It provides full CRUD operations plus advanced features like bulk deletion and file uploads,
- * with intelligent, dynamic URL building.
- */
 declare function createApiServices<T>(axiosInstance: AxiosInstance, baseEndpoint: string): {
     get: (id?: string | number, config?: ActionOptions) => Promise<StandardResponse<T>>;
     getWithQuery: (query: string, config?: RequestConfig) => Promise<StandardResponse<T>>;
@@ -563,15 +540,6 @@ declare class CacheManager {
 }
 declare const cacheManager: CacheManager;
 
-/**
- * A smart response processor that normalizes API responses.
- * It intelligently unwraps nested data from standard API envelopes
- * (like { success: true, data: {...} }) and provides direct access
- * to the core data, while still handling errors consistently.
- *
- * @param responseOrError The raw Axios response or a pre-processed ApiError.
- * @returns A standardized `StandardResponse` object with direct access to `.data`.
- */
 declare const processResponse: <T>(responseOrError: AxiosResponse<any> | ApiError) => StandardResponse<T>;
 
 declare function useApi<T>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): UseApiReturn<T>;
@@ -629,4 +597,4 @@ interface UseApiResourceReturn<T, TCreate, TUpdate, TPathParams> {
     setQuery: React.Dispatch<React.SetStateAction<QueryOptions>>;
 }
 
-export { type ActionConfig, type ActionOptions, type ActionState, type ApiClientConfig, type ApiError, type ApiModuleConfig, type ApiResourceStatus, type ApiResponse, type ExecutableAction, type LogLevel, type Logger, type Middleware, type MiddlewareContext, type ModuleActions, type PaginationMeta, type QueryOptions, type RefreshTokenConfig, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiActions, type UseApiConfig, type UseApiModuleOptions, type UseApiModuleReturn, type UseApiQuery, type UseApiResourceActions, type UseApiResourceConfig, type UseApiResourceReturn, type UseApiResourceState, type UseApiReturn, type UseApiState, type ValidationError, buildPaginateQuery, cacheManager, createApiActions, createApiClient, createApiServices, processResponse, useApi, useApiModule };
+export { type ActionConfig, type ActionOptions, type ActionState, type ApiClientConfig, type ApiError, type ApiModuleConfig, type ApiResourceStatus, type ApiResponse, type ExecutableAction, type LogLevel, type Middleware, type MiddlewareContext, type ModuleActions, type PaginationMeta, type QueryOptions, type RefreshTokenConfig, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiActions, type UseApiConfig, type UseApiModuleOptions, type UseApiModuleReturn, type UseApiQuery, type UseApiResourceActions, type UseApiResourceConfig, type UseApiResourceReturn, type UseApiResourceState, type UseApiReturn, type UseApiState, type ValidationError, buildPaginateQuery, cacheManager, createApiActions, createApiClient, createApiServices, processResponse, useApi, useApiModule };

package/dist/index.d.ts

@@ -1,5 +1,12 @@
 import { InternalAxiosRequestConfig, AxiosResponse, AxiosRequestConfig, AxiosProgressEvent, AxiosInstance, Method } from 'axios';
 
+interface Logger {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+}
+
 /**
  * @file src/types.ts
  * @description This file serves as the central source for all data types and interfaces
@@ -192,25 +199,11 @@ interface RefreshTokenConfig {
  * 'error': Logs only critical errors.
  * 'silent': Disables all logging.
  */
-type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent' | "log";
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
 /**
  * An interface for a custom logger, compatible with the standard `console` object.
  * It now includes a `debug` method for more granular logging.
  */
-interface Logger {
-    /** Logs a standard message. In our wrapper, this is often an alias for `info` or `debug`. */
-    log(message?: any, ...optionalParams: any[]): void;
-    /** Logs an informational message. */
-    info(message?: any, ...optionalParams: any[]): void;
-    /** Logs a warning message. */
-    warn(message?: any, ...optionalParams: any[]): void;
-    /** Logs an error message. */
-    error(message?: any, ...optionalParams: any[]): void;
-    /**
-     * Logs a debug message, typically for verbose, development-only output.
-     */
-    debug(message?: any, ...optionalParams: any[]): void;
-}
 /**
  * The main configuration object for the `createApiClient` factory function.
  */
@@ -248,17 +241,6 @@ interface ApiClientConfig {
     maxQueueSize?: number;
 }
 
-/**
- * @file src/core/client.ts
- * @description This is the heart of the API client library.
- * The `createApiClient` function constructs and configures a sophisticated Axios instance.
- * It features intelligent, security-first token management, a flexible middleware system,
- * and customizable logging, all designed to work seamlessly in modern web frameworks like Next.js.
- */
-
-/**
- * Creates and configures a new Axios instance with advanced features.
- */
 declare function createApiClient(config: ApiClientConfig): AxiosInstance;
 
 /**
@@ -472,11 +454,6 @@ type ModuleActions<TModule extends ApiModuleConfig> = {
     [K in keyof TModule['actions']]: TModule['actions'][K] extends ActionConfig<infer TInput, infer TOutput> ? ExecutableAction<TInput, TOutput> : never;
 };
 
-/**
- * A factory function to create a reusable set of API services for a specific endpoint.
- * It provides full CRUD operations plus advanced features like bulk deletion and file uploads,
- * with intelligent, dynamic URL building.
- */
 declare function createApiServices<T>(axiosInstance: AxiosInstance, baseEndpoint: string): {
     get: (id?: string | number, config?: ActionOptions) => Promise<StandardResponse<T>>;
     getWithQuery: (query: string, config?: RequestConfig) => Promise<StandardResponse<T>>;
@@ -563,15 +540,6 @@ declare class CacheManager {
 }
 declare const cacheManager: CacheManager;
 
-/**
- * A smart response processor that normalizes API responses.
- * It intelligently unwraps nested data from standard API envelopes
- * (like { success: true, data: {...} }) and provides direct access
- * to the core data, while still handling errors consistently.
- *
- * @param responseOrError The raw Axios response or a pre-processed ApiError.
- * @returns A standardized `StandardResponse` object with direct access to `.data`.
- */
 declare const processResponse: <T>(responseOrError: AxiosResponse<any> | ApiError) => StandardResponse<T>;
 
 declare function useApi<T>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): UseApiReturn<T>;
@@ -629,4 +597,4 @@ interface UseApiResourceReturn<T, TCreate, TUpdate, TPathParams> {
     setQuery: React.Dispatch<React.SetStateAction<QueryOptions>>;
 }
 
-export { type ActionConfig, type ActionOptions, type ActionState, type ApiClientConfig, type ApiError, type ApiModuleConfig, type ApiResourceStatus, type ApiResponse, type ExecutableAction, type LogLevel, type Logger, type Middleware, type MiddlewareContext, type ModuleActions, type PaginationMeta, type QueryOptions, type RefreshTokenConfig, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiActions, type UseApiConfig, type UseApiModuleOptions, type UseApiModuleReturn, type UseApiQuery, type UseApiResourceActions, type UseApiResourceConfig, type UseApiResourceReturn, type UseApiResourceState, type UseApiReturn, type UseApiState, type ValidationError, buildPaginateQuery, cacheManager, createApiActions, createApiClient, createApiServices, processResponse, useApi, useApiModule };
+export { type ActionConfig, type ActionOptions, type ActionState, type ApiClientConfig, type ApiError, type ApiModuleConfig, type ApiResourceStatus, type ApiResponse, type ExecutableAction, type LogLevel, type Middleware, type MiddlewareContext, type ModuleActions, type PaginationMeta, type QueryOptions, type RefreshTokenConfig, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiActions, type UseApiConfig, type UseApiModuleOptions, type UseApiModuleReturn, type UseApiQuery, type UseApiResourceActions, type UseApiResourceConfig, type UseApiResourceReturn, type UseApiResourceState, type UseApiReturn, type UseApiState, type ValidationError, buildPaginateQuery, cacheManager, createApiActions, createApiClient, createApiServices, processResponse, useApi, useApiModule };