@adaas/a-utils 0.1.7 → 0.1.9

package/README.md

@@ -2,13 +2,13 @@
 
 # A-Utils SDK 
 
-This package is a set of common utils that can be used across projects related or not related to ADAAS Ecosystem. 
-In this package it is possible to find useful features to work with structures, objects and types.  
+This package is a set of common utilities that can be used across projects related or not related to ADAAS Ecosystem. 
+In this package it is possible to find useful features to work with structures, objects, types, commands, configuration management, logging, scheduling, and more.  
 
 
 | LTS | Latest | npm               |
 |---------------|----------|---------------------------|
-| v1.0.0      |   v1.0.1    |     [@adaas/a-utils](https://npm.com)    |
+| v0.1.7      |   v0.1.7    |     [@adaas/a-utils](https://npm.com)    |
 
 
 <!-- TABLE OF CONTENTS -->
@@ -16,23 +16,409 @@ In this package it is possible to find useful features to work with structures,
 
 - [About the Project](#overview)
 - [Installation](#installation)
-- [ENV Variables](#environment-variables)
+- [Components](#components)
+  - [A-Channel](#a-channel)
+  - [A-Command](#a-command)
+  - [A-Config](#a-config)
+  - [A-Logger](#a-logger)
+  - [A-Manifest](#a-manifest)
+  - [A-Memory](#a-memory)
+  - [A-Polyfill](#a-polyfill)
+  - [A-Schedule](#a-schedule)
+- [Environment Variables](#environment-variables)
 - [Links](#links)
 
 
 ## Installation
 
 ```bash
-
 cd /your/project/location
-adf
 npm i @adaas/a-utils
+```
+
+## Components
+
+### A-Channel
+
+A communication channel component that provides messaging capabilities within the ADAAS ecosystem.
+
+**Basic Usage:**
+```typescript
+import { A_Channel } from '@adaas/a-utils';
+
+const channel = new A_Channel();
+// Channel is ready for use
+```
+
+**Features:**
+- Inter-component communication
+- Message routing and handling
+- Integration with A-Context
+
+---
+
+### A-Command
+
+A powerful command execution system that provides structured command patterns with lifecycle management, status tracking, and serialization capabilities.
 
+**Basic Usage:**
+```typescript
+import { A_Command } from '@adaas/a-utils';
+
+// Create a command
+const command = new A_Command({});
+
+// Execute the command
+await command.execute();
+
+console.log(command.status); // 'COMPLETED'
+console.log(command.duration); // Execution time in ms
+```
+
+**Advanced Usage:**
+```typescript
+// Command with custom logic
+class CustomCommand extends A_Command {
+    async execute() {
+        // Your custom command logic here
+        return await super.execute();
+    }
+}
+
+// Serialization
+const command = new A_Command({});
+await command.execute();
+
+const serialized = command.toJSON();
+const deserializedCommand = new A_Command(serialized);
 ```
 
+**Features:**
+- Command execution with lifecycle management
+- Status tracking (INITIALIZED, PROCESSING, COMPLETED, FAILED)
+- Built-in timing and duration tracking
+- JSON serialization/deserialization
+- Scope integration with dependency injection
+- Memory management integration
+
+**Command Status:**
+- `INITIALIZED` - Command created but not started
+- `PROCESSING` - Command is currently executing
+- `COMPLETED` - Command finished successfully
+- `FAILED` - Command execution failed
+
+---
+
+### A-Config
+
+A flexible configuration management system that supports multiple sources (environment variables, files) with type safety and validation.
+
+**Basic Usage:**
+```typescript
+import { A_Config } from '@adaas/a-utils';
+
+// Simple configuration
+const config = new A_Config({
+    variables: ['API_URL', 'PORT'] as const,
+    defaults: {
+        PORT: '3000'
+    }
+});
+
+console.log(config.get('PORT')); // '3000' or ENV value
+console.log(config.get('API_URL')); // ENV value or undefined
+```
+
+**Advanced Usage with File Loading:**
+```typescript
+import { A_Config, A_ConfigLoader, ENVConfigReader, FileConfigReader } from '@adaas/a-utils';
+
+// Configuration with multiple sources
+const config = new A_Config({
+    variables: ['DATABASE_URL', 'JWT_SECRET', 'LOG_LEVEL'] as const,
+    defaults: {
+        LOG_LEVEL: 'info'
+    }
+});
+
+// Use with config loader for file support
+const configLoader = new A_ConfigLoader();
+// Automatically loads from .env files and environment variables
+```
+
+**Features:**
+- Type-safe configuration management
+- Multiple data sources (ENV, files)
+- Default value support
+- Automatic environment variable loading
+- Integration with ADAAS concept system
+- Validation and error handling
+
+---
+
+### A-Logger
+
+A comprehensive logging system with color support, scope awareness, and configurable output formatting.
+
+**Basic Usage:**
+```typescript
+import { A_Logger } from '@adaas/a-utils';
+import { A_Scope } from '@adaas/a-concept';
+
+const scope = new A_Scope({
+    name: 'MyApp',
+    components: [A_Logger]
+});
+
+const logger = scope.resolve(A_Logger);
+
+logger.log('Hello World');
+logger.error('Something went wrong');
+logger.warning('This is a warning');
+logger.success('Operation completed');
+```
+
+**Features:**
+- Colored console output
+- Scope-aware logging
+- Multiple log levels (log, error, warning, success)
+- Integration with A-Config for configuration
+- Formatted output with timestamps and scope information
+
+---
+
+### A-Manifest
+
+A powerful access control and permission management system that allows fine-grained control over component and method access using regex patterns and rule-based configurations.
+
+**Basic Usage:**
+```typescript
+import { A_Manifest } from '@adaas/a-utils';
+import { A_Component } from '@adaas/a-concept';
+
+class UserController extends A_Component {
+    get() { return 'users'; }
+    post() { return 'create user'; }
+    delete() { return 'delete user'; }
+}
+
+class GuestUser extends A_Component {}
+class AdminUser extends A_Component {}
 
+// Component-level access control
+const manifest = new A_Manifest([
+    {
+        component: UserController,
+        exclude: [GuestUser] // Guests cannot access UserController
+    }
+]);
 
+// Check permissions
+const canAccess = manifest.isAllowed(UserController, 'get').for(GuestUser); // false
+const adminAccess = manifest.isAllowed(UserController, 'get').for(AdminUser); // true
+```
+
+**Method-Level Control:**
+```typescript
+const manifest = new A_Manifest([
+    {
+        component: UserController,
+        methods: [
+            {
+                method: 'delete',
+                apply: [AdminUser] // Only admins can delete
+            },
+            {
+                method: 'post',
+                exclude: [GuestUser] // Guests cannot create
+            }
+        ]
+    }
+]);
+```
+
+**Regex Pattern Support:**
+```typescript
+const manifest = new A_Manifest([
+    {
+        component: UserController,
+        methods: [
+            {
+                method: /^(post|put|delete)$/, // All mutating operations
+                exclude: [GuestUser]
+            }
+        ]
+    }
+]);
+```
+
+**Complex Scenarios:**
+```typescript
+const manifest = new A_Manifest([
+    {
+        component: UserController,
+        exclude: [GuestUser], // Base rule: guests excluded
+        methods: [
+            {
+                method: 'get',
+                apply: [GuestUser, AdminUser] // Override: guests can read
+            }
+        ]
+    }
+]);
+
+// Results:
+// UserController.get for GuestUser -> true (method override)
+// UserController.post for GuestUser -> false (component exclusion)
+```
+
+**Features:**
+- Component-level and method-level access control
+- Regex pattern matching for flexible rules
+- Rule precedence (method-level overrides component-level)
+- Fluent API for permission checking
+- Support for inclusion (`apply`) and exclusion (`exclude`) rules
+- Type-safe configuration with TypeScript
+
+---
+
+### A-Memory
+
+A type-safe memory management system for storing intermediate values and tracking errors during complex operations.
+
+**Basic Usage:**
+```typescript
+import { A_Memory } from '@adaas/a-utils';
+
+// Create memory instance
+const memory = new A_Memory<{
+    userId: string;
+    userData: any;
+    processedData: any;
+}>({
+    userId: '12345'
+});
+
+// Store values
+memory.set('userData', { name: 'John', email: 'john@example.com' });
+memory.set('processedData', processUserData(memory.get('userData')));
+
+// Check prerequisites
+const hasRequired = await memory.verifyPrerequisites(['userId', 'userData']);
+console.log(hasRequired); // true
+
+// Access values
+const userId = memory.get('userId');
+const allData = memory.toJSON();
+```
+
+**Error Tracking:**
+```typescript
+import { A_Error } from '@adaas/a-concept';
+
+const memory = new A_Memory();
+
+// Errors are automatically tracked
+try {
+    // Some operation that might fail
+    throw new A_Error('Something went wrong');
+} catch (error) {
+    memory.addError(error);
+}
+
+// Check for errors
+if (memory.Errors) {
+    console.log('Errors occurred:', memory.Errors);
+}
+```
+
+**Features:**
+- Type-safe value storage
+- Prerequisite verification
+- Error tracking and management
+- JSON serialization
+- Generic type support for custom data structures
+
+---
+
+### A-Polyfill
+
+A polyfill management system that provides consistent API support across different environments.
+
+**Basic Usage:**
+```typescript
+import { A_Polyfill } from '@adaas/a-utils';
+
+const polyfill = new A_Polyfill();
+// Polyfill ensures consistent API availability
+```
+
+**Features:**
+- Cross-environment compatibility
+- Automatic polyfill detection and application
+- Integration with A-Component system
+
+---
+
+### A-Schedule
+
+A comprehensive scheduling and task management system with support for delays, cancellation, and promise-based operations.
+
+**Basic Usage:**
+```typescript
+import { A_Schedule } from '@adaas/a-utils';
+import { A_Scope } from '@adaas/a-concept';
+
+const scope = new A_Scope({
+    components: [A_Schedule]
+});
+
+const schedule = scope.resolve(A_Schedule);
+
+// Schedule a delayed operation
+const scheduler = await schedule.delay(3000, async () => {
+    return 'Task completed after 3 seconds';
+});
+
+const result = await scheduler.promise; // 'Task completed after 3 seconds'
+```
+
+**Cancellation Support:**
+```typescript
+const scheduler = await schedule.delay(5000, async () => {
+    return 'This might be cancelled';
+});
+
+// Cancel the scheduled task
+scheduler.cancel();
+
+try {
+    await scheduler.promise;
+} catch (error) {
+    console.log('Task was cancelled');
+}
+```
+
+**Advanced Scheduling:**
+```typescript
+// Schedule multiple tasks
+const tasks = await Promise.all([
+    schedule.delay(1000, () => 'Task 1'),
+    schedule.delay(2000, () => 'Task 2'),
+    schedule.delay(3000, () => 'Task 3')
+]);
+
+const results = await Promise.all(tasks.map(t => t.promise));
+console.log(results); // ['Task 1', 'Task 2', 'Task 3']
+```
 
+**Features:**
+- Promise-based task scheduling
+- Configurable delays
+- Task cancellation support
+- Multiple concurrent task management
+- Integration with A-Component dependency injection
+- Type-safe task execution
 
 ## Environment Variables
 
@@ -40,6 +426,7 @@ npm i @adaas/a-utils
 |---------------|----------|---------------------------|
 | A_NAMESPACE      |    YES    |      Your desired Namespace for the project     |
 
+Additional environment variables may be required by specific components like A-Config depending on your configuration setup.
 
 ## Links
 

package/dist/index.d.ts

@@ -12,11 +12,16 @@ export { ENVConfigReader } from './src/lib/A-Config/components/ENVConfigReader.c
 export { FileConfigReader } from './src/lib/A-Config/components/FileConfigReader.component';
 export * from './src/lib/A-Config/A-Config.types';
 export * from './src/lib/A-Config/A-Config.constants';
+export { A_Logger } from './src/lib/A-Logger/A-Logger.component';
+export { A_Manifest } from './src/lib/A-Manifest/A-Manifest.context';
+export { A_ManifestError } from './src/lib/A-Manifest/A-Manifest.error';
+export { A_ManifestChecker } from './src/lib/A-Manifest/classes/A-ManifestChecker.class';
+export * from './src/lib/A-Manifest/A-Manifest.types';
 export { A_Memory } from './src/lib/A-Memory/A-Memory.context';
 export { A_Polyfill } from './src/lib/A-Polyfill/A-Polyfill.component';
 export { A_PolyfillClass } from './src/lib/A-Polyfill/A-Polyfills.class';
-export { A_Logger } from './src/lib/A-Logger/A-Logger.component';
+export * from './src/lib/A-Polyfill/A-Polyfill.types';
 export { A_Schedule } from './src/lib/A-Schedule/A-Schedule.component';
-export * from './src/lib/A-Schedule/A-Schedule.types';
 export { A_ScheduleObject } from './src/lib/A-Schedule/A-ScheduleObject.class';
 export { A_Deferred } from './src/lib/A-Schedule/A-Deferred.class';
+export * from './src/lib/A-Schedule/A-Schedule.types';

package/dist/index.js

@@ -14,18 +14,27 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.A_Deferred = exports.A_ScheduleObject = exports.A_Schedule = exports.A_Logger = exports.A_PolyfillClass = exports.A_Polyfill = exports.A_Memory = exports.FileConfigReader = exports.ENVConfigReader = exports.ConfigReader = exports.A_ConfigError = exports.A_Config = exports.A_ConfigLoader = exports.A_CommandError = exports.A_Command = exports.A_ChannelError = exports.A_Channel = void 0;
+exports.A_Deferred = exports.A_ScheduleObject = exports.A_Schedule = exports.A_PolyfillClass = exports.A_Polyfill = exports.A_Memory = exports.A_ManifestChecker = exports.A_ManifestError = exports.A_Manifest = exports.A_Logger = exports.FileConfigReader = exports.ENVConfigReader = exports.ConfigReader = exports.A_ConfigError = exports.A_Config = exports.A_ConfigLoader = exports.A_CommandError = exports.A_Command = exports.A_ChannelError = exports.A_Channel = void 0;
+// ============================================================================
+// A-Channel Components
+// ============================================================================
 var A_Channel_component_1 = require("./src/lib/A-Channel/A-Channel.component");
 Object.defineProperty(exports, "A_Channel", { enumerable: true, get: function () { return A_Channel_component_1.A_Channel; } });
 var A_Channel_error_1 = require("./src/lib/A-Channel/A-Channel.error");
 Object.defineProperty(exports, "A_ChannelError", { enumerable: true, get: function () { return A_Channel_error_1.A_ChannelError; } });
-// export * from './src/lib/A-Channel/A-Channel.types';
+// export * from './src/lib/A-Channel/A-Channel.types'; // Empty file
+// ============================================================================
+// A-Command Components
+// ============================================================================
 var A_Command_entity_1 = require("./src/lib/A-Command/A-Command.entity");
 Object.defineProperty(exports, "A_Command", { enumerable: true, get: function () { return A_Command_entity_1.A_Command; } });
 var A_Command_error_1 = require("./src/lib/A-Command/A-Command.error");
 Object.defineProperty(exports, "A_CommandError", { enumerable: true, get: function () { return A_Command_error_1.A_CommandError; } });
 __exportStar(require("./src/lib/A-Command/A-Command.types"), exports);
 __exportStar(require("./src/lib/A-Command/A-Command.constants"), exports);
+// ============================================================================
+// A-Config Components
+// ============================================================================
 var A_Config_container_1 = require("./src/lib/A-Config/A-Config.container");
 Object.defineProperty(exports, "A_ConfigLoader", { enumerable: true, get: function () { return A_Config_container_1.A_ConfigLoader; } });
 var A_Config_context_1 = require("./src/lib/A-Config/A-Config.context");
@@ -40,21 +49,43 @@ var FileConfigReader_component_1 = require("./src/lib/A-Config/components/FileCo
 Object.defineProperty(exports, "FileConfigReader", { enumerable: true, get: function () { return FileConfigReader_component_1.FileConfigReader; } });
 __exportStar(require("./src/lib/A-Config/A-Config.types"), exports);
 __exportStar(require("./src/lib/A-Config/A-Config.constants"), exports);
+// ============================================================================
+// A-Logger Components
+// ============================================================================
+var A_Logger_component_1 = require("./src/lib/A-Logger/A-Logger.component");
+Object.defineProperty(exports, "A_Logger", { enumerable: true, get: function () { return A_Logger_component_1.A_Logger; } });
+// export * from './src/lib/A-Logger/A-Logger.types'; // Empty file
+// ============================================================================
+// A-Manifest Components
+// ============================================================================
+var A_Manifest_context_1 = require("./src/lib/A-Manifest/A-Manifest.context");
+Object.defineProperty(exports, "A_Manifest", { enumerable: true, get: function () { return A_Manifest_context_1.A_Manifest; } });
+var A_Manifest_error_1 = require("./src/lib/A-Manifest/A-Manifest.error");
+Object.defineProperty(exports, "A_ManifestError", { enumerable: true, get: function () { return A_Manifest_error_1.A_ManifestError; } });
+var A_ManifestChecker_class_1 = require("./src/lib/A-Manifest/classes/A-ManifestChecker.class");
+Object.defineProperty(exports, "A_ManifestChecker", { enumerable: true, get: function () { return A_ManifestChecker_class_1.A_ManifestChecker; } });
+__exportStar(require("./src/lib/A-Manifest/A-Manifest.types"), exports);
+// ============================================================================
+// A-Memory Components
+// ============================================================================
 var A_Memory_context_1 = require("./src/lib/A-Memory/A-Memory.context");
 Object.defineProperty(exports, "A_Memory", { enumerable: true, get: function () { return A_Memory_context_1.A_Memory; } });
+// ============================================================================
+// A-Polyfill Components
+// ============================================================================
 var A_Polyfill_component_1 = require("./src/lib/A-Polyfill/A-Polyfill.component");
 Object.defineProperty(exports, "A_Polyfill", { enumerable: true, get: function () { return A_Polyfill_component_1.A_Polyfill; } });
 var A_Polyfills_class_1 = require("./src/lib/A-Polyfill/A-Polyfills.class");
 Object.defineProperty(exports, "A_PolyfillClass", { enumerable: true, get: function () { return A_Polyfills_class_1.A_PolyfillClass; } });
-// export * from './src/lib/A-Polyfill/A-Polyfill.types';
-var A_Logger_component_1 = require("./src/lib/A-Logger/A-Logger.component");
-Object.defineProperty(exports, "A_Logger", { enumerable: true, get: function () { return A_Logger_component_1.A_Logger; } });
-// export * from './src/lib/A-Logger/A-Logger.types';
+__exportStar(require("./src/lib/A-Polyfill/A-Polyfill.types"), exports);
+// ============================================================================
+// A-Schedule Components
+// ============================================================================
 var A_Schedule_component_1 = require("./src/lib/A-Schedule/A-Schedule.component");
 Object.defineProperty(exports, "A_Schedule", { enumerable: true, get: function () { return A_Schedule_component_1.A_Schedule; } });
-__exportStar(require("./src/lib/A-Schedule/A-Schedule.types"), exports);
 var A_ScheduleObject_class_1 = require("./src/lib/A-Schedule/A-ScheduleObject.class");
 Object.defineProperty(exports, "A_ScheduleObject", { enumerable: true, get: function () { return A_ScheduleObject_class_1.A_ScheduleObject; } });
 var A_Deferred_class_1 = require("./src/lib/A-Schedule/A-Deferred.class");
 Object.defineProperty(exports, "A_Deferred", { enumerable: true, get: function () { return A_Deferred_class_1.A_Deferred; } });
+__exportStar(require("./src/lib/A-Schedule/A-Schedule.types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,+EAAoE;AAA3D,gHAAA,SAAS,OAAA;AAClB,uEAAqE;AAA5D,iHAAA,cAAc,OAAA;AACvB,uDAAuD;AAGvD,yEAAiE;AAAxD,6GAAA,SAAS,OAAA;AAClB,uEAAqE;AAA5D,iHAAA,cAAc,OAAA;AACvB,sEAAoD;AACpD,0EAAwD;AAGxD,4EAAuE;AAA9D,oHAAA,cAAc,OAAA;AACvB,wEAA+D;AAAtD,4GAAA,QAAQ,OAAA;AACjB,oEAAkE;AAAzD,+GAAA,aAAa,OAAA;AACtB,+FAAoF;AAA3E,sHAAA,YAAY,OAAA;AACrB,qGAA0F;AAAjF,4HAAA,eAAe,OAAA;AACxB,uGAA4F;AAAnF,8HAAA,gBAAgB,OAAA;AACzB,oEAAkD;AAClD,wEAAsD;AAGtD,wEAA8D;AAArD,4GAAA,QAAQ,OAAA;AAEjB,kFAAuE;AAA9D,kHAAA,UAAU,OAAA;AACnB,4EAAyE;AAAhE,oHAAA,eAAe,OAAA;AACxB,yDAAyD;AAEzD,4EAAiE;AAAxD,8GAAA,QAAQ,OAAA;AACjB,qDAAqD;AAGrD,kFAAsE;AAA7D,kHAAA,UAAU,OAAA;AACnB,wEAAqD;AACrD,sFAA8E;AAArE,0HAAA,gBAAgB,OAAA;AACzB,0EAAkE;AAAzD,8GAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAC/E,+EAAoE;AAA3D,gHAAA,SAAS,OAAA;AAClB,uEAAqE;AAA5D,iHAAA,cAAc,OAAA;AACvB,qEAAqE;AAGrE,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAC/E,yEAAiE;AAAxD,6GAAA,SAAS,OAAA;AAClB,uEAAqE;AAA5D,iHAAA,cAAc,OAAA;AACvB,sEAAoD;AACpD,0EAAwD;AAGxD,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAC/E,4EAAuE;AAA9D,oHAAA,cAAc,OAAA;AACvB,wEAA+D;AAAtD,4GAAA,QAAQ,OAAA;AACjB,oEAAkE;AAAzD,+GAAA,aAAa,OAAA;AACtB,+FAAoF;AAA3E,sHAAA,YAAY,OAAA;AACrB,qGAA0F;AAAjF,4HAAA,eAAe,OAAA;AACxB,uGAA4F;AAAnF,8HAAA,gBAAgB,OAAA;AACzB,oEAAkD;AAClD,wEAAsD;AAGtD,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAC/E,4EAAiE;AAAxD,8GAAA,QAAQ,OAAA;AACjB,mEAAmE;AAGnE,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAC/E,8EAAqE;AAA5D,gHAAA,UAAU,OAAA;AACnB,0EAAwE;AAA/D,mHAAA,eAAe,OAAA;AACxB,gGAAyF;AAAhF,4HAAA,iBAAiB,OAAA;AAC1B,wEAAsD;AAGtD,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAC/E,wEAA+D;AAAtD,4GAAA,QAAQ,OAAA;AAGjB,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAC/E,kFAAuE;AAA9D,kHAAA,UAAU,OAAA;AACnB,4EAAyE;AAAhE,oHAAA,eAAe,OAAA;AACxB,wEAAsD;AAGtD,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAC/E,kFAAuE;AAA9D,kHAAA,UAAU,OAAA;AACnB,sFAA+E;AAAtE,0HAAA,gBAAgB,OAAA;AACzB,0EAAmE;AAA1D,8GAAA,UAAU,OAAA;AACnB,wEAAsD"}

package/dist/src/lib/A-Channel/A-Channel.component.d.ts

@@ -1,3 +1,22 @@
 import { A_Component } from "@adaas/a-concept";
 export declare class A_Channel extends A_Component {
+    /**
+     * Indicates whether the channel is processing requests
+     */
+    protected _processing: boolean;
+    /**
+     * Indicates whether the channel is connected
+     */
+    protected _initialized?: Promise<void>;
+    /**
+      * Indicates whether the channel is processing requests
+      */
+    get processing(): boolean;
+    /**
+     * Indicates whether the channel is connected
+     */
+    get initialize(): Promise<void>;
+    connect(): Promise<void>;
+    request(params: any): Promise<any>;
+    send(message: any): Promise<void>;
 }

package/dist/src/lib/A-Channel/A-Channel.component.js

@@ -1,8 +1,84 @@
 "use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.A_Channel = void 0;
 const a_concept_1 = require("@adaas/a-concept");
+const A_Channel_error_1 = require("./A-Channel.error");
 class A_Channel extends a_concept_1.A_Component {
+    constructor() {
+        super(...arguments);
+        /**
+         * Indicates whether the channel is processing requests
+         */
+        this._processing = false;
+    }
+    /**
+      * Indicates whether the channel is processing requests
+      */
+    get processing() {
+        return this._processing;
+    }
+    /**
+     * Indicates whether the channel is connected
+     */
+    get initialize() {
+        if (!this._initialized) {
+            this._initialized = this.connect();
+        }
+        return this._initialized;
+    }
+    connect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new A_Channel_error_1.A_ChannelError(A_Channel_error_1.A_ChannelError.MethodNotImplemented, `The connect method is not implemented in ${this.constructor.name} channel. This method is required to initialize the channel before use. So please implement it in the derived class.`);
+        });
+    }
+    request(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new A_Channel_error_1.A_ChannelError(A_Channel_error_1.A_ChannelError.MethodNotImplemented, `The request method is not implemented in ${this.constructor.name} channel.`);
+        });
+    }
+    send(message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new A_Channel_error_1.A_ChannelError(A_Channel_error_1.A_ChannelError.MethodNotImplemented, `The send method is not implemented in ${this.constructor.name} channel.`);
+        });
+    }
 }
 exports.A_Channel = A_Channel;
+__decorate([
+    a_concept_1.A_Feature.Define()
+    /**
+     * Initializes the channel before use
+     */
+], A_Channel.prototype, "connect", null);
+__decorate([
+    a_concept_1.A_Feature.Define()
+    /**
+     * Allows to send a request through the channel
+     *
+     * @param req - The request parameters
+     * @returns The response from the channel
+     */
+], A_Channel.prototype, "request", null);
+__decorate([
+    a_concept_1.A_Feature.Define()
+    /**
+     * Uses for Fire-and-Forget messaging through the channel
+     *
+     * @param message - can be of any type depending on the channel implementation
+     */
+], A_Channel.prototype, "send", null);
 //# sourceMappingURL=A-Channel.component.js.map

package/dist/src/lib/A-Channel/A-Channel.component.js.map

@@ -1 +1 @@
-{"version":3,"file":"A-Channel.component.js","sourceRoot":"","sources":["../../../../src/lib/A-Channel/A-Channel.component.ts"],"names":[],"mappings":";;;AAAA,gDAA0D;AAI1D,MAAa,SAAU,SAAQ,uBAAW;CAGzC;AAHD,8BAGC"}
+{"version":3,"file":"A-Channel.component.js","sourceRoot":"","sources":["../../../../src/lib/A-Channel/A-Channel.component.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,gDAA0D;AAC1D,uDAAmD;AAInD,MAAa,SAAU,SAAQ,uBAAW;IAA1C;;QAEI;;WAEG;QACO,gBAAW,GAAY,KAAK,CAAC;IAgE3C,CAAC;IA1DG;;QAEI;IACJ,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IACD;;OAEG;IACH,IAAI,UAAU;QACV,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAOK,OAAO;;YACT,MAAM,IAAI,gCAAc,CACpB,gCAAc,CAAC,oBAAoB,EACnC,4CAA4C,IAAI,CAAC,WAAW,CAAC,IAAI,sHAAsH,CAC1L,CAAC;QACN,CAAC;KAAA;IAUK,OAAO,CAAC,MAAW;;YACrB,MAAM,IAAI,gCAAc,CACpB,gCAAc,CAAC,oBAAoB,EACnC,4CAA4C,IAAI,CAAC,WAAW,CAAC,IAAI,WAAW,CAC/E,CAAC;QACN,CAAC;KAAA;IAUK,IAAI,CAAC,OAAY;;YACnB,MAAM,IAAI,gCAAc,CACpB,gCAAc,CAAC,oBAAoB,EACnC,yCAAyC,IAAI,CAAC,WAAW,CAAC,IAAI,WAAW,CAC5E,CAAC;QACN,CAAC;KAAA;CAEJ;AArED,8BAqEC;AArCS;IAJL,qBAAS,CAAC,MAAM,EAAE;IACnB;;OAEG;wCAMF;AAUK;IAPL,qBAAS,CAAC,MAAM,EAAE;IACnB;;;;;OAKG;wCAMF;AAUK;IANL,qBAAS,CAAC,MAAM,EAAE;IACnB;;;;OAIG;qCAMF"}

package/dist/src/lib/A-Channel/A-Channel.error.d.ts

@@ -1,3 +1,4 @@
 import { A_Error } from "@adaas/a-concept";
 export declare class A_ChannelError extends A_Error {
+    static readonly MethodNotImplemented = "A-Channel Method Not Implemented";
 }

package/dist/src/lib/A-Channel/A-Channel.error.js

@@ -5,4 +5,5 @@ const a_concept_1 = require("@adaas/a-concept");
 class A_ChannelError extends a_concept_1.A_Error {
 }
 exports.A_ChannelError = A_ChannelError;
+A_ChannelError.MethodNotImplemented = 'A-Channel Method Not Implemented';
 //# sourceMappingURL=A-Channel.error.js.map

package/dist/src/lib/A-Channel/A-Channel.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"A-Channel.error.js","sourceRoot":"","sources":["../../../../src/lib/A-Channel/A-Channel.error.ts"],"names":[],"mappings":";;;AAAA,gDAA2C;AAG3C,MAAa,cAAe,SAAQ,mBAAO;CAE1C;AAFD,wCAEC"}
+{"version":3,"file":"A-Channel.error.js","sourceRoot":"","sources":["../../../../src/lib/A-Channel/A-Channel.error.ts"],"names":[],"mappings":";;;AAAA,gDAA2C;AAG3C,MAAa,cAAe,SAAQ,mBAAO;;AAA3C,wCAIC;AAFmB,mCAAoB,GAAG,kCAAkC,CAAC"}