kimu-core 0.4.1 → 0.5.0

package/src/modules-repository/api-axios/interfaces.ts

@@ -1,71 +1,71 @@
-/**
- * HTTP method types supported by the API service
- */
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-
-/**
- * Configuration options for HTTP requests
- */
-export interface ApiRequestConfig {
-  /** HTTP headers to include in the request */
-  headers?: Record<string, string>;
-  /** Query parameters to append to the URL */
-  params?: Record<string, string | number | boolean>;
-  /** Request timeout in milliseconds */
-  timeout?: number;
-  /** Whether to include credentials (cookies) in the request */
-  withCredentials?: boolean;
-  /** Response type expected from the server */
-  responseType?: 'json' | 'text' | 'blob' | 'arraybuffer';
-  /** Callback for upload progress */
-  onUploadProgress?: (progressEvent: ProgressEvent) => void;
-  /** Callback for download progress */
-  onDownloadProgress?: (progressEvent: ProgressEvent) => void;
-  /** Custom axios config to merge */
-  axiosConfig?: any;
-}
-
-/**
- * Standard API response structure
- */
-export interface ApiResponse<T = any> {
-  /** Response data from the server */
-  data: T;
-  /** HTTP status code */
-  status: number;
-  /** HTTP status text */
-  statusText: string;
-  /** Response headers */
-  headers: Record<string, string>;
-  /** Original request configuration */
-  config: ApiRequestConfig;
-}
-
-/**
- * Error response structure for failed requests
- */
-export interface ApiError {
-  /** Error message */
-  message: string;
-  /** HTTP status code (if available) */
-  status?: number;
-  /** Response data from the server (if available) */
-  data?: any;
-  /** Original error object */
-  originalError?: any;
-}
-
-/**
- * Interceptor function for requests
- */
-export type RequestInterceptor = (config: ApiRequestConfig) => ApiRequestConfig | Promise<ApiRequestConfig>;
-
-/**
- * Interceptor function for responses
- */
-export type ResponseInterceptor = (response: ApiResponse) => ApiResponse | Promise<ApiResponse>;
-
-/**
- * Interceptor function for errors
- */
-export type ErrorInterceptor = (error: ApiError) => any;
+/**
+ * HTTP method types supported by the API service
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+
+/**
+ * Configuration options for HTTP requests
+ */
+export interface ApiRequestConfig {
+  /** HTTP headers to include in the request */
+  headers?: Record<string, string>;
+  /** Query parameters to append to the URL */
+  params?: Record<string, string | number | boolean>;
+  /** Request timeout in milliseconds */
+  timeout?: number;
+  /** Whether to include credentials (cookies) in the request */
+  withCredentials?: boolean;
+  /** Response type expected from the server */
+  responseType?: 'json' | 'text' | 'blob' | 'arraybuffer';
+  /** Callback for upload progress */
+  onUploadProgress?: (progressEvent: ProgressEvent) => void;
+  /** Callback for download progress */
+  onDownloadProgress?: (progressEvent: ProgressEvent) => void;
+  /** Custom axios config to merge */
+  axiosConfig?: any;
+}
+
+/**
+ * Standard API response structure
+ */
+export interface ApiResponse<T = any> {
+  /** Response data from the server */
+  data: T;
+  /** HTTP status code */
+  status: number;
+  /** HTTP status text */
+  statusText: string;
+  /** Response headers */
+  headers: Record<string, string>;
+  /** Original request configuration */
+  config: ApiRequestConfig;
+}
+
+/**
+ * Error response structure for failed requests
+ */
+export interface ApiError {
+  /** Error message */
+  message: string;
+  /** HTTP status code (if available) */
+  status?: number;
+  /** Response data from the server (if available) */
+  data?: any;
+  /** Original error object */
+  originalError?: any;
+}
+
+/**
+ * Interceptor function for requests
+ */
+export type RequestInterceptor = (config: ApiRequestConfig) => ApiRequestConfig | Promise<ApiRequestConfig>;
+
+/**
+ * Interceptor function for responses
+ */
+export type ResponseInterceptor = (response: ApiResponse) => ApiResponse | Promise<ApiResponse>;
+
+/**
+ * Interceptor function for errors
+ */
+export type ErrorInterceptor = (error: ApiError) => any;

package/src/modules-repository/api-axios/module.ts

@@ -1,41 +1,41 @@
-/**
- * API Axios Module
- * 
- * Advanced HTTP client module based on Axios library.
- * Provides enhanced features over the basic api-core module.
- * 
- * @module api-axios
- * @author UnicòVerso
- * @version 1.0.0
- */
-
-import { KimuModule } from '../../core/kimu-module';
-import { apiAxiosService } from './api-axios-service';
-
-/**
- * ApiAxiosModule - Module wrapper for the Axios-based API service
- * 
- * This module provides an advanced HTTP client with features like:
- * - Request/response interceptors
- * - Automatic retry logic
- * - Request cancellation
- * - Progress tracking
- * - Response caching
- */
-export default class ApiAxiosModule extends KimuModule {
-  constructor(name = 'api-axios', version = '1.0.0', options?: any) {
-    super(name, version, options);
-  }
-
-  /**
-   * Returns the singleton instance of the API Axios service
-   */
-  getService() {
-    return apiAxiosService;
-  }
-}
-
-// Re-export for convenience
-export { apiAxiosService } from './api-axios-service';
-export { ApiAxiosService } from './api-axios-service';
-export * from './interfaces';
+/**
+ * API Axios Module
+ * 
+ * Advanced HTTP client module based on Axios library.
+ * Provides enhanced features over the basic api-core module.
+ * 
+ * @module api-axios
+ * @author UnicòVerso
+ * @version 1.0.0
+ */
+
+import { KimuModule } from '../../core/kimu-module';
+import { apiAxiosService } from './api-axios-service';
+
+/**
+ * ApiAxiosModule - Module wrapper for the Axios-based API service
+ * 
+ * This module provides an advanced HTTP client with features like:
+ * - Request/response interceptors
+ * - Automatic retry logic
+ * - Request cancellation
+ * - Progress tracking
+ * - Response caching
+ */
+export default class ApiAxiosModule extends KimuModule {
+  constructor(name = 'api-axios', version = '1.0.0', options?: any) {
+    super(name, version, options);
+  }
+
+  /**
+   * Returns the singleton instance of the API Axios service
+   */
+  getService() {
+    return apiAxiosService;
+  }
+}
+
+// Re-export for convenience
+export { apiAxiosService } from './api-axios-service';
+export { ApiAxiosService } from './api-axios-service';
+export * from './interfaces';

package/src/modules-repository/api-core/CHANGELOG.md

@@ -1,42 +1,42 @@
-# API Core Module - Changelog
-
-## [1.0.0] - 2025-11-01
-
-### Added
-- Initial release of API Core module
-- Basic HTTP client functionality based on native fetch API
-- Support for all HTTP methods (GET, POST, PUT, PATCH, DELETE)
-- Request/Response/Error interceptors
-- Query parameters and headers management
-- Timeout and request cancellation support
-- Multiple response types (JSON, text, blob, arraybuffer)
-- Global configuration with baseURL
-- TypeScript-first with complete type safety
-- Zero external dependencies (~2KB minified)
-- Comprehensive documentation and examples
-
-### Features
-- ✅ Promise-based async/await API
-- ✅ Automatic JSON parsing
-- ✅ Error handling with structured ApiError
-- ✅ Request/Response transformation via interceptors
-- ✅ Configurable timeout
-- ✅ AbortController support for request cancellation
-- ✅ Query parameters serialization
-- ✅ Custom headers support
-- ✅ Credentials and cache mode configuration
-- ✅ Lightweight and performant
-
-### Documentation
-- Complete README with usage examples
-- TypeScript interfaces and type definitions
-- Example file with 17+ practical use cases
-- Integration examples with KIMU components
-
-### Future Roadmap
-- Automatic retry logic
-- Request caching
-- Request deduplication
-- Upload/Download progress tracking
-- Request queue with priority
-- Mock/test utilities
+# API Core Module - Changelog
+
+## [1.0.0] - 2025-11-01
+
+### Added
+- Initial release of API Core module
+- Basic HTTP client functionality based on native fetch API
+- Support for all HTTP methods (GET, POST, PUT, PATCH, DELETE)
+- Request/Response/Error interceptors
+- Query parameters and headers management
+- Timeout and request cancellation support
+- Multiple response types (JSON, text, blob, arraybuffer)
+- Global configuration with baseURL
+- TypeScript-first with complete type safety
+- Zero external dependencies (~2KB minified)
+- Comprehensive documentation and examples
+
+### Features
+- ✅ Promise-based async/await API
+- ✅ Automatic JSON parsing
+- ✅ Error handling with structured ApiError
+- ✅ Request/Response transformation via interceptors
+- ✅ Configurable timeout
+- ✅ AbortController support for request cancellation
+- ✅ Query parameters serialization
+- ✅ Custom headers support
+- ✅ Credentials and cache mode configuration
+- ✅ Lightweight and performant
+
+### Documentation
+- Complete README with usage examples
+- TypeScript interfaces and type definitions
+- Example file with 17+ practical use cases
+- Integration examples with KIMU components
+
+### Future Roadmap
+- Automatic retry logic
+- Request caching
+- Request deduplication
+- Upload/Download progress tracking
+- Request queue with priority
+- Mock/test utilities