kimu-core 0.4.1 → 0.5.0

package/src/extensions/{kimu-home → app-root}/component.ts

@@ -8,11 +8,11 @@ import { KimuComponentElement } from '../../core/kimu-component-element';
 import { KimuGlobalLang, KimuI18nService } from '../../modules/i18n/module';
 
 @KimuComponent({
-    tag: 'kimu-home',
-    path: 'kimu-home',
-    name: 'KIMU Home',
+    tag: 'app-root',
+    path: 'app-root',
+    name: 'Application Root',
     version: '1.0.0',
-    description: 'Main interface container',
+    description: 'Main application root component',
     icon: '🏠',
     author: 'UnicòVerso',
     kimuVersion: '1.0.0',
@@ -24,7 +24,7 @@ import { KimuGlobalLang, KimuI18nService } from '../../modules/i18n/module';
         }
     }
 })
-export class KimuHomeComponent extends KimuComponentElement {
+export class AppRootComponent extends KimuComponentElement {
 
     /** I18n service instance for translations */
     private i18n = new KimuI18nService(

package/src/extensions/extensions-manifest.json

@@ -1,10 +1,10 @@
 [
   {
-    "tag": "kimu-home",
-    "path": "kimu-home",
+    "tag": "app-root",
+    "path": "app-root",
     "internal": true,
-    "name": "KIMU Home",
-    "description": "Main interface container",
+    "name": "Application Root",
+    "description": "Main application root component",
     "version": "1.0.0",
     "author": "UnicòVerso",
     "icon": "🏠",

package/src/main.ts

@@ -41,9 +41,9 @@ async function main() {
 
     // Mount the extensions
     // Load the main component of the Kimu application
-    // The main component is the one that has the tag name 'kimu-home'
-    console.log('[KIMU-MAIN] 🚀 Loading kimu-home extension...');
-    const mainAppExtensions = 'kimu-home';
+    // The main component is the one that has the tag name 'app-root'
+    console.log('[KIMU-MAIN] 🚀 Loading app-root extension...');
+    const mainAppExtensions = 'app-root';
     
     try {
       await kimuExtensionManager.load(mainAppExtensions);

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

@@ -1,48 +1,48 @@
-# Changelog - API Axios Module
-
-All notable changes to the api-axios module will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.0.0] - 2025-11-01
-
-### Added
-- Initial release of api-axios module
-- Full Axios-based HTTP client implementation
-- Request/response interceptors support
-- Automatic retry logic with exponential backoff
-- Request cancellation support via cancel tokens
-- Upload/download progress tracking
-- Response caching with configurable TTL
-- Complete TypeScript type definitions
-- Comprehensive documentation and examples
-- Migration guide from api-core
-- Error transformation and standardized error handling
-- Support for all HTTP methods (GET, POST, PUT, PATCH, DELETE)
-- Query parameters and custom headers support
-- Timeout configuration per request
-- Credentials (cookies) support
-
-### Features Over api-core
-- **Interceptors**: Add custom logic before/after requests
-- **Retry Logic**: Automatic retry with exponential backoff
-- **Cancellation**: Cancel pending requests when needed
-- **Progress**: Track upload/download progress in real-time
-- **Caching**: Cache GET responses to reduce network calls
-- **Better Errors**: Enhanced error handling with original error preservation
-
-### Dependencies
-- axios: ^1.6.0 (external dependency)
-
-## [Unreleased]
-
-### Planned Features
-- Request deduplication (prevent duplicate concurrent requests)
-- Request queue management
-- Offline request queueing
-- Custom retry strategies
-- Response schema validation
-- Mock mode for testing
-- Request/response logging
-- Metrics and performance tracking
+# Changelog - API Axios Module
+
+All notable changes to the api-axios module will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-11-01
+
+### Added
+- Initial release of api-axios module
+- Full Axios-based HTTP client implementation
+- Request/response interceptors support
+- Automatic retry logic with exponential backoff
+- Request cancellation support via cancel tokens
+- Upload/download progress tracking
+- Response caching with configurable TTL
+- Complete TypeScript type definitions
+- Comprehensive documentation and examples
+- Migration guide from api-core
+- Error transformation and standardized error handling
+- Support for all HTTP methods (GET, POST, PUT, PATCH, DELETE)
+- Query parameters and custom headers support
+- Timeout configuration per request
+- Credentials (cookies) support
+
+### Features Over api-core
+- **Interceptors**: Add custom logic before/after requests
+- **Retry Logic**: Automatic retry with exponential backoff
+- **Cancellation**: Cancel pending requests when needed
+- **Progress**: Track upload/download progress in real-time
+- **Caching**: Cache GET responses to reduce network calls
+- **Better Errors**: Enhanced error handling with original error preservation
+
+### Dependencies
+- axios: ^1.6.0 (external dependency)
+
+## [Unreleased]
+
+### Planned Features
+- Request deduplication (prevent duplicate concurrent requests)
+- Request queue management
+- Offline request queueing
+- Custom retry strategies
+- Response schema validation
+- Mock mode for testing
+- Request/response logging
+- Metrics and performance tracking

package/src/modules-repository/api-axios/QUICK-REFERENCE.md

@@ -1,178 +1,178 @@
-# API Axios - Quick Reference
-
-## Import
-
-```typescript
-import { apiAxiosService } from '../../modules/api-axios/api-axios-service';
-```
-
-## Basic Methods
-
-```typescript
-// GET request
-const response = await apiAxiosService.get(url, config);
-
-// POST request
-const response = await apiAxiosService.post(url, data, config);
-
-// PUT request
-const response = await apiAxiosService.put(url, data, config);
-
-// PATCH request
-const response = await apiAxiosService.patch(url, data, config);
-
-// DELETE request
-const response = await apiAxiosService.delete(url, config);
-
-// Generic request with method
-const response = await apiAxiosService.request(method, url, data, config);
-```
-
-## Common Use Cases
-
-### With Query Parameters
-```typescript
-const response = await apiAxiosService.get('https://api.example.com/users', {
-  params: { page: 1, limit: 10 }
-});
-// Calls: https://api.example.com/users?page=1&limit=10
-```
-
-### With Custom Headers
-```typescript
-const response = await apiAxiosService.get('https://api.example.com/data', {
-  headers: {
-    'Authorization': 'Bearer token123',
-    'X-Custom-Header': 'value'
-  }
-});
-```
-
-### With Timeout
-```typescript
-const response = await apiAxiosService.get('https://api.example.com/data', {
-  timeout: 5000 // 5 seconds
-});
-```
-
-### With Retry
-```typescript
-const response = await apiAxiosService.request('GET', 'https://api.example.com/data', null, {
-  retries: 3,
-  retryDelay: 1000
-});
-```
-
-### With Cache
-```typescript
-const response = await apiAxiosService.get('https://api.example.com/data', {
-  useCache: true
-});
-
-// Configure cache TTL
-apiAxiosService.setCacheTTL(10 * 60 * 1000); // 10 minutes
-
-// Clear cache
-apiAxiosService.clearCache();
-```
-
-### With Progress Tracking
-```typescript
-const response = await apiAxiosService.post('https://api.example.com/upload', formData, {
-  onUploadProgress: (event) => {
-    const percent = Math.round((event.loaded * 100) / event.total);
-    console.log(`Upload: ${percent}%`);
-  }
-});
-```
-
-### With Cancellation
-```typescript
-const cancelToken = apiAxiosService.createCancelToken();
-
-const promise = apiAxiosService.get('https://api.example.com/data', {
-  axiosConfig: { cancelToken: cancelToken.token }
-});
-
-// Cancel if needed
-cancelToken.cancel('User cancelled');
-```
-
-## Interceptors
-
-### Request Interceptor
-```typescript
-apiAxiosService.addRequestInterceptor(async (config) => {
-  config.headers = config.headers || {};
-  config.headers['Authorization'] = 'Bearer token';
-  return config;
-});
-```
-
-### Response Interceptor
-```typescript
-apiAxiosService.addResponseInterceptor(async (response) => {
-  console.log('Response:', response.status);
-  return response;
-});
-```
-
-### Error Interceptor
-```typescript
-apiAxiosService.addErrorInterceptor(async (error) => {
-  if (error.status === 401) {
-    // Handle unauthorized
-  }
-});
-```
-
-## TypeScript Types
-
-```typescript
-import type { ApiResponse, ApiError, ApiRequestConfig } from '../../modules/api-axios';
-
-interface User {
-  id: number;
-  name: string;
-}
-
-const response = await apiAxiosService.get<User>('https://api.example.com/user/1');
-// response.data is typed as User
-```
-
-## Error Handling
-
-```typescript
-try {
-  const response = await apiAxiosService.get('https://api.example.com/data');
-  console.log(response.data);
-} catch (error: any) {
-  console.error('Status:', error.status);
-  console.error('Message:', error.message);
-  console.error('Data:', error.data);
-}
-```
-
-## Response Format
-
-```typescript
-{
-  data: any,           // Response data
-  status: number,      // HTTP status code
-  statusText: string,  // HTTP status text
-  headers: {},         // Response headers
-  config: {}           // Original request config
-}
-```
-
-## Migration from api-core
-
-```typescript
-// Simply replace the import
-// From:
-import { apiCoreService } from '../../modules/api-core/api-core-service';
-// To:
-import { apiAxiosService } from '../../modules/api-axios/api-axios-service';
-
-// All basic methods work the same!
-```
+# API Axios - Quick Reference
+
+## Import
+
+```typescript
+import { apiAxiosService } from '../../modules/api-axios/api-axios-service';
+```
+
+## Basic Methods
+
+```typescript
+// GET request
+const response = await apiAxiosService.get(url, config);
+
+// POST request
+const response = await apiAxiosService.post(url, data, config);
+
+// PUT request
+const response = await apiAxiosService.put(url, data, config);
+
+// PATCH request
+const response = await apiAxiosService.patch(url, data, config);
+
+// DELETE request
+const response = await apiAxiosService.delete(url, config);
+
+// Generic request with method
+const response = await apiAxiosService.request(method, url, data, config);
+```
+
+## Common Use Cases
+
+### With Query Parameters
+```typescript
+const response = await apiAxiosService.get('https://api.example.com/users', {
+  params: { page: 1, limit: 10 }
+});
+// Calls: https://api.example.com/users?page=1&limit=10
+```
+
+### With Custom Headers
+```typescript
+const response = await apiAxiosService.get('https://api.example.com/data', {
+  headers: {
+    'Authorization': 'Bearer token123',
+    'X-Custom-Header': 'value'
+  }
+});
+```
+
+### With Timeout
+```typescript
+const response = await apiAxiosService.get('https://api.example.com/data', {
+  timeout: 5000 // 5 seconds
+});
+```
+
+### With Retry
+```typescript
+const response = await apiAxiosService.request('GET', 'https://api.example.com/data', null, {
+  retries: 3,
+  retryDelay: 1000
+});
+```
+
+### With Cache
+```typescript
+const response = await apiAxiosService.get('https://api.example.com/data', {
+  useCache: true
+});
+
+// Configure cache TTL
+apiAxiosService.setCacheTTL(10 * 60 * 1000); // 10 minutes
+
+// Clear cache
+apiAxiosService.clearCache();
+```
+
+### With Progress Tracking
+```typescript
+const response = await apiAxiosService.post('https://api.example.com/upload', formData, {
+  onUploadProgress: (event) => {
+    const percent = Math.round((event.loaded * 100) / event.total);
+    console.log(`Upload: ${percent}%`);
+  }
+});
+```
+
+### With Cancellation
+```typescript
+const cancelToken = apiAxiosService.createCancelToken();
+
+const promise = apiAxiosService.get('https://api.example.com/data', {
+  axiosConfig: { cancelToken: cancelToken.token }
+});
+
+// Cancel if needed
+cancelToken.cancel('User cancelled');
+```
+
+## Interceptors
+
+### Request Interceptor
+```typescript
+apiAxiosService.addRequestInterceptor(async (config) => {
+  config.headers = config.headers || {};
+  config.headers['Authorization'] = 'Bearer token';
+  return config;
+});
+```
+
+### Response Interceptor
+```typescript
+apiAxiosService.addResponseInterceptor(async (response) => {
+  console.log('Response:', response.status);
+  return response;
+});
+```
+
+### Error Interceptor
+```typescript
+apiAxiosService.addErrorInterceptor(async (error) => {
+  if (error.status === 401) {
+    // Handle unauthorized
+  }
+});
+```
+
+## TypeScript Types
+
+```typescript
+import type { ApiResponse, ApiError, ApiRequestConfig } from '../../modules/api-axios';
+
+interface User {
+  id: number;
+  name: string;
+}
+
+const response = await apiAxiosService.get<User>('https://api.example.com/user/1');
+// response.data is typed as User
+```
+
+## Error Handling
+
+```typescript
+try {
+  const response = await apiAxiosService.get('https://api.example.com/data');
+  console.log(response.data);
+} catch (error: any) {
+  console.error('Status:', error.status);
+  console.error('Message:', error.message);
+  console.error('Data:', error.data);
+}
+```
+
+## Response Format
+
+```typescript
+{
+  data: any,           // Response data
+  status: number,      // HTTP status code
+  statusText: string,  // HTTP status text
+  headers: {},         // Response headers
+  config: {}           // Original request config
+}
+```
+
+## Migration from api-core
+
+```typescript
+// Simply replace the import
+// From:
+import { apiCoreService } from '../../modules/api-core/api-core-service';
+// To:
+import { apiAxiosService } from '../../modules/api-axios/api-axios-service';
+
+// All basic methods work the same!
+```