@adaas/a-utils 0.1.14 → 0.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-utils",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "A-Utils is a set of utilities that are used across the ADAAS ecosystem. This package is designed to be a collection of utilities that are used across the ADAAS ecosystem.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -27,7 +27,8 @@
     "test": "jest ",
     "start": "nodemon ./tests/log.ts",
     "examples:config": "nodemon ./examples/config.ts",
-    "publish": "npm run test && npm run build && git add . && git commit -m \"new version created :: $(cat package.json | grep version | head -1  | awk -F: '{ print $2 }'  | sed 's/[\",]//g')\" && npm version patch && npm publish --access public",
+    "examples:logger": "nodemon ./examples/A-Logger-examples.ts",
+    "release": "npm run test && npm run build && git add . && git commit -m \"new version created :: $(cat package.json | grep version | head -1  | awk -F: '{ print $2 }'  | sed 's/[\",]//g')\" && npm version patch && npm publish --access public",
     "preversion": "echo test",
     "version": "echo git add .",
     "postversion": "git push --no-verify && git push --tags --no-verify && echo \"\n======Version Pushed Successfully=====\n\" ",
@@ -36,21 +37,39 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ADAAS-org/adaas-adf-auth.git"
+    "url": "git+https://github.com/ADAAS-org/adaas-a-utils.git"
   },
   "keywords": [
     "sdk",
+    "utilities",
+    "typescript",
+    "nodejs",
+    "command-pattern",
+    "channel",
+    "configuration",
+    "logging",
+    "scheduling",
+    "memory-management",
+    "dependency-injection",
+    "component-architecture",
+    "adaas",
+    "ecosystem",
     "ai",
-    "rag"
+    "rag",
+    "manifest",
+    "polyfill",
+    "async",
+    "lifecycle",
+    "error-handling"
   ],
   "author": "adaas.org",
   "license": "ISC",
   "bugs": {
-    "url": "https://github.com/ADAAS-org/adaas-adf-auth/issues"
+    "url": "https://github.com/ADAAS-org/adaas-a-utils/issues"
   },
-  "homepage": "https://github.com/ADAAS-org/adaas-adf-auth#readme",
+  "homepage": "https://github.com/ADAAS-org/adaas-a-utils#readme",
   "dependencies": {
-    "@adaas/a-concept": "^0.1.24"
+    "@adaas/a-concept": "^0.1.28"
   },
   "devDependencies": {
     "@types/chai": "^4.3.14",

package/src/index.ts

@@ -3,8 +3,10 @@
 // A-Channel Components
 // ============================================================================
 export { A_Channel } from './lib/A-Channel/A-Channel.component';
+export { A_ChannelRequest } from './lib/A-Channel/A-ChannelRequest.context';
 export { A_ChannelError } from './lib/A-Channel/A-Channel.error';
-// export * from './src/lib/A-Channel/A-Channel.types'; // Empty file
+export * from './lib/A-Channel/A-Channel.types';
+export * from './lib/A-Channel/A-Channel.constants';
 
 
 // ============================================================================

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

@@ -1,7 +1,9 @@
 import { A_Component, A_Context, A_Error, A_Feature, A_IdentityHelper, A_Inject, A_Scope, A_TYPES__InjectableConstructors, A_TYPES__InjectableTargets } from "@adaas/a-concept";
 import { A_ChannelError } from "./A-Channel.error";
 import { A_ChannelFeatures } from "./A-Channel.constants";
-import { A_ChannelRequestContext } from "./A-ChannelRequest.context";
+import { A_ChannelRequest } from "./A-ChannelRequest.context";
+import { A_Logger } from "../A-Logger/A-Logger.component";
+import { A_Config } from "../A-Config/A-Config.context";
 
 /**
  * A-Channel - A powerful, extensible communication channel component
@@ -37,7 +39,7 @@ import { A_ChannelRequestContext } from "./A-ChannelRequest.context";
  * class HttpProcessor extends A_Component {
  *     @A_Feature.Extend({ scope: [HttpChannel] })
  *     async [A_ChannelFeatures.onRequest](
- *         @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+ *         @A_Inject(A_ChannelRequest) context: A_ChannelRequest
  *     ) {
  *         const response = await fetch(context.params.url);
  *         (context as any)._result = await response.json();
@@ -186,7 +188,7 @@ export class A_Channel extends A_Component {
      * ```typescript
      * @A_Feature.Extend({ scope: [HttpChannel] })
      * async [A_ChannelFeatures.onBeforeRequest](
-     *     @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+     *     @A_Inject(A_ChannelRequest) context: A_ChannelRequest
      * ) {
      *     // Validate required parameters
      *     if (!context.params.url) {
@@ -218,7 +220,7 @@ export class A_Channel extends A_Component {
      * ```typescript
      * @A_Feature.Extend({ scope: [HttpChannel] })
      * async [A_ChannelFeatures.onRequest](
-     *     @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+     *     @A_Inject(A_ChannelRequest) context: A_ChannelRequest
      * ) {
      *     const response = await fetch(context.params.url);
      *     (context as any)._result = await response.json();
@@ -247,7 +249,7 @@ export class A_Channel extends A_Component {
      * ```typescript
      * @A_Feature.Extend({ scope: [HttpChannel] })
      * async [A_ChannelFeatures.onAfterRequest](
-     *     @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+     *     @A_Inject(A_ChannelRequest) context: A_ChannelRequest
      * ) {
      *     console.log(`Request completed in ${Date.now() - context.startTime}ms`);
      *     await this.cacheResponse(context.params, context.data);
@@ -276,7 +278,7 @@ export class A_Channel extends A_Component {
      * ```typescript
      * @A_Feature.Extend({ scope: [HttpChannel] })
      * async [A_ChannelFeatures.onError](
-     *     @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+     *     @A_Inject(A_ChannelRequest) context: A_ChannelRequest
      * ) {
      *     console.error('Request failed:', context.params, context.failed);
      *     await this.logError(context);
@@ -305,7 +307,7 @@ export class A_Channel extends A_Component {
      * ```typescript
      * @A_Feature.Extend({ scope: [EventChannel] })
      * async [A_ChannelFeatures.onSend](
-     *     @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+     *     @A_Inject(A_ChannelRequest) context: A_ChannelRequest
      * ) {
      *     const { eventType, payload } = context.params;
      *     await this.publishEvent(eventType, payload);
@@ -364,7 +366,7 @@ export class A_Channel extends A_Component {
      * @template _ParamsType The type of request parameters
      * @template _ResultType The type of response data
      * @param params The request parameters
-     * @returns {Promise<A_ChannelRequestContext<_ParamsType, _ResultType>>} Request context with response
+     * @returns {Promise<A_ChannelRequest<_ParamsType, _ResultType>>} Request context with response
      * 
      * @example
      * ```typescript
@@ -387,7 +389,7 @@ export class A_Channel extends A_Component {
     async request<
         _ParamsType extends Record<string, any> = Record<string, any>,
         _ResultType extends Record<string, any> = Record<string, any>,
-    >(params: _ParamsType): Promise<A_ChannelRequestContext<_ParamsType, _ResultType>> {
+    >(params: _ParamsType): Promise<A_ChannelRequest<_ParamsType, _ResultType>> {
         // Ensure channel is initialized before processing
         await this.initialize;
 
@@ -395,12 +397,12 @@ export class A_Channel extends A_Component {
         this._processing = true;
 
         // Create isolated scope for this request
-        const requestScope = new A_Scope({ 
-            name: `a-channel@scope:request:${A_IdentityHelper.generateTimeId()}` 
+        const requestScope = new A_Scope({
+            name: `a-channel@scope:request:${A_IdentityHelper.generateTimeId()}`
         });
 
         // Create request context
-        const context = new A_ChannelRequestContext<_ParamsType, _ResultType>(params);
+        const context = new A_ChannelRequest<_ParamsType, _ResultType>(params);
 
         try {
             // Set up dependency injection scope
@@ -481,12 +483,12 @@ export class A_Channel extends A_Component {
         this._processing = true;
 
         // Create isolated scope for this send operation
-        const requestScope = new A_Scope({ 
-            name: `a-channel@scope:send:${A_IdentityHelper.generateTimeId()}` 
+        const requestScope = new A_Scope({
+            name: `a-channel@scope:send:${A_IdentityHelper.generateTimeId()}`
         });
 
         // Create request context for the message
-        const context = new A_ChannelRequestContext<_ParamsType>(message);
+        const context = new A_ChannelRequest<_ParamsType>(message);
 
         try {
             // Set up dependency injection scope
@@ -521,14 +523,14 @@ export class A_Channel extends A_Component {
      * For fire-and-forget pattern: Use send()
      * For consumer patterns: Implement custom consumer logic using request() in a loop
      */
-    async consume<T extends Record<string, any> = Record<string, any>>(): Promise<A_ChannelRequestContext<any, T>> {
+    async consume<T extends Record<string, any> = Record<string, any>>(): Promise<A_ChannelRequest<any, T>> {
         await this.initialize;
 
         this._processing = true;
 
         const requestScope = new A_Scope({ name: `a-channel@scope:consume:${A_IdentityHelper.generateTimeId()}` });
 
-        const context = new A_ChannelRequestContext<any, T>();
+        const context = new A_ChannelRequest<any, T>();
 
         try {
             requestScope.inherit(A_Context.scope(this));
@@ -555,4 +557,69 @@ export class A_Channel extends A_Component {
         }
     }
 
+}
+
+
+
+
+class HttpChannel extends A_Channel {
+
+    protected baseUrl!: string
+}
+
+
+class SSOChannel extends HttpChannel {
+    constructor() {
+        super();
+
+        this.baseUrl = 'https://sso.example.com';
+    }
+}
+
+
+class PrstChannel extends HttpChannel {
+
+    constructor() {
+        super();
+
+        this.baseUrl = 'https://prst.example.com';
+    }
+}
+
+
+class PollyspotChannel extends HttpChannel {
+
+    constructor() {
+        super();
+
+        this.baseUrl = 'https://pollyspot.example.com';
+    }
+}
+
+
+class GlobalErrorhandler extends A_Component {
+
+    @A_Feature.Extend({
+        name: A_ChannelFeatures.onError,
+        scope: [PollyspotChannel]
+    })
+    async handleError(
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest<any, any>,
+        @A_Inject(A_Logger) logger: A_Logger,
+        @A_Inject(A_Config) config: A_Config
+    ) {
+        // Handle the error
+    }
+
+    @A_Feature.Extend({
+        name: A_ChannelFeatures.onError,
+    })
+    async anotherError(
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest<any, any>,
+        @A_Inject(A_Logger) logger: A_Logger,
+        @A_Inject(A_Config) config: A_Config
+    ) {
+        // Handle the error
+
+    }
 }

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

@@ -1,5 +1,5 @@
 import { A_Error, A_TypeGuards } from "@adaas/a-concept";
-import { A_ChannelRequestContext } from "./A-ChannelRequest.context";
+import { A_ChannelRequest } from "./A-ChannelRequest.context";
 
 
 export class A_ChannelError extends A_Error {
@@ -15,7 +15,7 @@ export class A_ChannelError extends A_Error {
     // ==================== Properties ==========================
     // ==========================================================
 
-    protected _context?: A_ChannelRequestContext
+    protected _context?: A_ChannelRequest
 
 
     /**
@@ -27,21 +27,21 @@ export class A_ChannelError extends A_Error {
      */
     constructor(
         originalError: string | A_Error | Error | any,
-        context?: A_ChannelRequestContext | string
+        context?: A_ChannelRequest | string
     ) {
         if (A_TypeGuards.isString(context))
             super(originalError, context);
         else
             super(originalError);
 
-        if (context instanceof A_ChannelRequestContext)
+        if (context instanceof A_ChannelRequest)
             this._context = context
     }
 
     /***
      * Returns Context of the error
      */
-    get context(): A_ChannelRequestContext | undefined {
+    get context(): A_ChannelRequest | undefined {
         return this._context
     }
 

package/src/lib/A-Channel/A-ChannelRequest.context.ts

@@ -3,7 +3,7 @@ import { A_ChannelRequestStatuses } from "./A-Channel.constants";
 import { A_ChannelRequestContext_Serialized } from "./A-Channel.types";
 
 
-export class A_ChannelRequestContext<
+export class A_ChannelRequest<
     _ParamsType extends Record<string, any> = Record<string, any>,
     _ResultType extends Record<string, any> = Record<string, any>,
 > extends A_Fragment {

package/src/lib/A-Channel/README.md

@@ -91,7 +91,7 @@ console.log('Message sent successfully');
 ```typescript
 import { A_Component, A_Feature, A_Inject } from '@adaas/a-concept';
 import { A_ChannelFeatures } from '@adaas/a-utils/lib/A-Channel/A-Channel.constants';
-import { A_ChannelRequestContext } from '@adaas/a-utils/lib/A-Channel/A-ChannelRequest.context';
+import { A_ChannelRequest } from '@adaas/a-utils/lib/A-Channel/A-ChannelRequest.context';
 
 // Define typed interfaces
 interface UserRequest {
@@ -121,7 +121,7 @@ class UserProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [UserManagementChannel] })
     async [A_ChannelFeatures.onBeforeRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext<UserRequest>
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest<UserRequest>
     ) {
         // Validate request
         const { action, userId } = context.params;
@@ -133,7 +133,7 @@ class UserProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [UserManagementChannel] })
     async [A_ChannelFeatures.onRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext<UserRequest, UserResponse>
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest<UserRequest, UserResponse>
     ) {
         const { action, userId, userData } = context.params;
         
@@ -162,7 +162,7 @@ class UserProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [UserManagementChannel] })
     async [A_ChannelFeatures.onAfterRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext<UserRequest, UserResponse>
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest<UserRequest, UserResponse>
     ) {
         // Log successful completion
         console.log(`Request completed: ${context.data?.message}`);
@@ -170,7 +170,7 @@ class UserProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [UserManagementChannel] })
     async [A_ChannelFeatures.onError](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext<UserRequest>
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest<UserRequest>
     ) {
         console.error(`Request failed for action: ${context.params.action}`);
         // Log error, send alerts, etc.
@@ -238,7 +238,7 @@ class RequestLifecycleProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [LifecycleChannel] })
     async [A_ChannelFeatures.onBeforeRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         console.log('2. Pre-processing request...');
         // Validate input, authenticate, rate limiting
@@ -246,7 +246,7 @@ class RequestLifecycleProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [LifecycleChannel] })
     async [A_ChannelFeatures.onRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         console.log('3. Processing request...');
         // Main business logic
@@ -254,7 +254,7 @@ class RequestLifecycleProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [LifecycleChannel] })
     async [A_ChannelFeatures.onAfterRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         console.log('4. Post-processing request...');
         // Logging, analytics, cleanup
@@ -262,7 +262,7 @@ class RequestLifecycleProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [LifecycleChannel] })
     async [A_ChannelFeatures.onError](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         console.log('5. Handling error...');
         // Error logging, alerts, recovery
@@ -281,7 +281,7 @@ class APIProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [APIChannel] })
     async [A_ChannelFeatures.onRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         const { endpoint, method, body } = context.params;
         
@@ -341,7 +341,7 @@ class EventBroadcaster extends A_Component {
     
     @A_Feature.Extend({ scope: [EventChannel] })
     async [A_ChannelFeatures.onSend](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         const { eventType, payload, recipients } = context.params;
         
@@ -378,7 +378,7 @@ class MessageQueue extends A_Component {
     
     @A_Feature.Extend({ scope: [QueueChannel] })
     async [A_ChannelFeatures.onSend](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         const message = {
             id: Date.now(),
@@ -436,7 +436,7 @@ class ErrorHandler extends A_Component {
     
     @A_Feature.Extend({ scope: [RobustChannel] })
     async [A_ChannelFeatures.onRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         const { operation } = context.params;
         
@@ -457,7 +457,7 @@ class ErrorHandler extends A_Component {
     
     @A_Feature.Extend({ scope: [RobustChannel] })
     async [A_ChannelFeatures.onError](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         console.log('Error details:', {
             operation: context.params.operation,
@@ -517,7 +517,7 @@ class DatabaseProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [DatabaseChannel] })
     async [A_ChannelFeatures.onRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext<DatabaseQuery, DatabaseResult>
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest<DatabaseQuery, DatabaseResult>
     ) {
         const { table, operation, where, data } = context.params;
         
@@ -602,14 +602,14 @@ class MetricsCollector extends A_Component {
     
     @A_Feature.Extend({ scope: [AdvancedChannel] })
     async [A_ChannelFeatures.onBeforeRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         (context as any)._startTime = Date.now();
     }
     
     @A_Feature.Extend({ scope: [AdvancedChannel] })
     async [A_ChannelFeatures.onAfterRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         const channel = A_Context.scope(this).resolve(AdvancedChannel);
         const duration = Date.now() - (context as any)._startTime;
@@ -620,7 +620,7 @@ class MetricsCollector extends A_Component {
     
     @A_Feature.Extend({ scope: [AdvancedChannel] })
     async [A_ChannelFeatures.onError](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         const channel = A_Context.scope(this).resolve(AdvancedChannel);
         channel['metrics'].errors++;
@@ -632,7 +632,7 @@ class CacheLayer extends A_Component {
     
     @A_Feature.Extend({ scope: [AdvancedChannel] })
     async [A_ChannelFeatures.onBeforeRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         const cacheKey = JSON.stringify(context.params);
         
@@ -645,7 +645,7 @@ class CacheLayer extends A_Component {
     
     @A_Feature.Extend({ scope: [AdvancedChannel] })
     async [A_ChannelFeatures.onAfterRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         if (!(context as any)._cached && context.data) {
             const cacheKey = JSON.stringify(context.params);
@@ -685,7 +685,7 @@ console.log('Metrics:', advancedChannel.getMetrics());
 - `async disconnect(): Promise<void>` - Cleanup and disconnect the channel
 
 ##### Communication
-- `async request<T, R>(params: T): Promise<A_ChannelRequestContext<T, R>>` - Send request and wait for response
+- `async request<T, R>(params: T): Promise<A_ChannelRequest<T, R>>` - Send request and wait for response
 - `async send<T>(message: T): Promise<void>` - Send fire-and-forget message
 
 #### Lifecycle Hooks (Extensible via A_Feature)
@@ -697,7 +697,7 @@ console.log('Metrics:', advancedChannel.getMetrics());
 - `onSend` - Called to process send operation
 - `onError` - Called when any operation fails
 
-### A_ChannelRequestContext Class
+### A_ChannelRequest Class
 
 #### Properties
 - `params: T` - Request parameters
@@ -750,7 +750,7 @@ class HttpChannel extends A_Channel {
 class HttpProcessor extends A_Component {
     @A_Feature.Extend({ scope: [HttpChannel] })
     async [A_ChannelFeatures.onRequest](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         const { method, url, body, headers } = context.params;
         
@@ -818,7 +818,7 @@ class WebSocketProcessor extends A_Component {
     
     @A_Feature.Extend({ scope: [WebSocketChannel] })
     async [A_ChannelFeatures.onSend](
-        @A_Inject(A_ChannelRequestContext) context: A_ChannelRequestContext
+        @A_Inject(A_ChannelRequest) context: A_ChannelRequest
     ) {
         const channel = A_Context.scope(this).resolve(WebSocketChannel);
         const message = JSON.stringify(context.params);

package/src/lib/A-Command/A-Command.constants.ts

@@ -1,35 +1,71 @@
-export enum A_TYPES__CommandMetaKey {
-    EXTENSIONS = 'a-command-extensions',
-    FEATURES = 'a-command-features',
-    ABSTRACTIONS = 'a-command-abstractions',
-}
-
+/**
+ * A-Command Statuses
+ */
 export enum A_CONSTANTS__A_Command_Status {
+    /**
+     * Command has been created but not yet initialized
+     */
     CREATED = 'CREATED',
+    /** 
+     * Command is initializing
+     */
     INITIALIZATION = 'INITIALIZATION',
+    /**
+     * Command has been initialized
+     */
     INITIALIZED = 'INITIALIZED',
+    /**
+     * Command is compiling
+     */
     COMPILATION = 'COMPILATION',
+    /**
+     * Command is compiled
+     */
     COMPILED = 'COMPILED',
+    /**
+     * Command is executing
+     */
     IN_PROGRESS = 'IN_PROGRESS',
+    /**
+     * Command has completed successfully
+     */
     COMPLETED = 'COMPLETED',
+    /**
+     * Command has failed
+     */
     FAILED = 'FAILED',
 }
 
 /**
  * A-Command Lifecycle Features
  */
-export enum A_CONSTANTS_A_Command_Features {
-    INIT = 'init',
-    COMPLIED = 'complied',
-    EXECUTE = 'execute',
-    COMPLETE = 'complete',
-    FAIL = 'fail',
+export enum A_CommandFeatures {
+    /**
+     * Allows to extend initialization logic and behavior
+     */
+    onInit = 'onInit',
+    /**
+     * Allows to extend compilation logic and behavior
+     */
+    onCompile = 'onCompile',
+    /**
+     * Allows to extend execution logic and behavior
+     */
+    onExecute = 'onExecute',
+    /**
+     * Allows to extend completion logic and behavior
+     */
+    onComplete = 'onComplete',
+    /**
+     * 
+     */
+    onFail = 'onFail',
 }
 
 
 
 
-export type A_CONSTANTS__A_Command_Event = 'init' | 'compile' | 'execute' | 'complete' | 'fail';
+export type A_CONSTANTS__A_Command_Event = keyof typeof A_CommandFeatures;