@adaas/a-concept 0.0.64 → 0.1.1

package/dist/src/helpers/A_TypeGuards.helper.js

@@ -0,0 +1,288 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_TypeGuards = void 0;
+const A_Component_class_1 = require("../global/A-Component/A-Component.class");
+const A_Component_meta_1 = require("../global/A-Component/A-Component.meta");
+const A_Container_class_1 = require("../global/A-Container/A-Container.class");
+const A_Container_meta_1 = require("../global/A-Container/A-Container.meta");
+const A_Entity_class_1 = require("../global/A-Entity/A-Entity.class");
+const A_Entity_meta_1 = require("../global/A-Entity/A-Entity.meta");
+const A_Feature_class_1 = require("../global/A-Feature/A-Feature.class");
+const A_Fragment_class_1 = require("../global/A-Fragment/A-Fragment.class");
+const A_Scope_class_1 = require("../global/A-Scope/A-Scope.class");
+const A_Caller_class_1 = require("../global/A-Caller/A_Caller.class");
+const A_Error_class_1 = require("../global/A-Error/A_Error.class");
+const A_Common_helper_1 = require("./A_Common.helper");
+class A_TypeGuards {
+    // ===========================================================================
+    // ============================= BASE Type Guards ============================
+    // ===========================================================================
+    /**
+     * Check if value is a string
+     *
+     * @param value
+     * @returns
+     */
+    static isString(value) {
+        return typeof value === 'string' || value instanceof String;
+    }
+    /**
+     * Check if value is a number
+     *
+     * @param value
+     * @returns
+     */
+    static isNumber(value) {
+        return typeof value === 'number' && isFinite(value);
+    }
+    /**
+     * Check if value is a boolean
+     *
+     * @param value
+     * @returns
+     */
+    static isBoolean(value) {
+        return typeof value === 'boolean';
+    }
+    /**
+     * Check if value is an array
+     *
+     * @param value
+     * @returns
+     */
+    static isArray(value) {
+        return Array.isArray(value);
+    }
+    /**
+     * Check if value is an object
+     *
+     * @param value
+     * @returns
+     */
+    static isObject(value) {
+        return value && typeof value === 'object' && !Array.isArray(value);
+    }
+    /**
+     * Check if value is a function
+     *
+     * @param value
+     * @returns
+     */
+    static isFunction(value) {
+        return typeof value === 'function';
+    }
+    static isUndefined(value) {
+        return typeof value === 'undefined';
+    }
+    static isRegExp(value) {
+        return value instanceof RegExp;
+    }
+    // ===========================================================================
+    // ==========================A-Concept Type Guards ===========================
+    // ===========================================================================
+    /**
+     * Type guard to check if the constructor is of type A_Container
+     *
+     * @param ctor
+     * @returns
+     */
+    static isContainerConstructor(ctor) {
+        return typeof ctor === 'function' && A_Common_helper_1.A_CommonHelper.isInheritedFrom(ctor, A_Container_class_1.A_Container);
+    }
+    /**
+     * Type guard to check if the constructor is of type A_Component
+     *
+     * @param ctor
+     * @returns
+     */
+    static isComponentConstructor(ctor) {
+        return typeof ctor === 'function' && A_Common_helper_1.A_CommonHelper.isInheritedFrom(ctor, A_Component_class_1.A_Component);
+    }
+    /**
+     * Type guard to check if the constructor is of type A_Fragment
+     *
+     * @param ctor
+     * @returns
+     */
+    static isFragmentConstructor(ctor) {
+        return typeof ctor === 'function' && A_Common_helper_1.A_CommonHelper.isInheritedFrom(ctor, A_Fragment_class_1.A_Fragment);
+    }
+    /**
+     * Type guard to check if the constructor is of type A_Entity
+     *
+     * @param ctor
+     * @returns
+     */
+    static isEntityConstructor(ctor) {
+        return typeof ctor === 'function' && A_Common_helper_1.A_CommonHelper.isInheritedFrom(ctor, A_Entity_class_1.A_Entity);
+    }
+    /**
+     * Type guard to check if the constructor is of type A_Scope
+     *
+     * @param ctor
+     * @returns
+     */
+    static isScopeConstructor(ctor) {
+        return typeof ctor === 'function' && A_Common_helper_1.A_CommonHelper.isInheritedFrom(ctor, A_Scope_class_1.A_Scope);
+    }
+    /**
+     * Type guard to check if the constructor is of type A_Scope
+     *
+     * @param ctor
+     * @returns
+     */
+    static isErrorConstructor(ctor) {
+        return typeof ctor === 'function' && A_Common_helper_1.A_CommonHelper.isInheritedFrom(ctor, A_Error_class_1.A_Error);
+    }
+    /**
+     * Type guard to check if the constructor is of type A_Feature
+     *
+     * @param ctor
+     * @returns
+     */
+    static isFeatureConstructor(ctor) {
+        return typeof ctor === 'function' && A_Common_helper_1.A_CommonHelper.isInheritedFrom(ctor, A_Feature_class_1.A_Feature);
+    }
+    /**
+     * Type guard to check if the constructor is of type A_Caller
+     *
+     * @param ctor
+     * @returns
+     */
+    static isCallerConstructor(ctor) {
+        return typeof ctor === 'function' && A_Common_helper_1.A_CommonHelper.isInheritedFrom(ctor, A_Caller_class_1.A_Caller);
+    }
+    // ----------------------------------------------------------------------------
+    // Instance type guards
+    // ----------------------------------------------------------------------------
+    /**
+     * Type guard to check if the instance is of type A_Container
+     *
+     * @param instance
+     * @returns
+     */
+    static isContainerInstance(instance) {
+        return instance instanceof A_Container_class_1.A_Container;
+    }
+    /**
+     * Type guard to check if the instance is of type A_Component
+     *
+     * @param instance
+     * @returns
+     */
+    static isComponentInstance(instance) {
+        return instance instanceof A_Component_class_1.A_Component;
+    }
+    /**
+     * Type guard to check if the instance is of type A_Feature
+     *
+     * @param instance
+     * @returns
+     */
+    static isFeatureInstance(instance) {
+        return instance instanceof A_Feature_class_1.A_Feature;
+    }
+    /**
+     * Type guard to check if the instance is of type A_Fragment
+     *
+     * @param instance
+     * @returns
+     */
+    static isFragmentInstance(instance) {
+        return instance instanceof A_Fragment_class_1.A_Fragment;
+    }
+    /**
+     * Type guard to check if the instance is of type A_Entity
+     *
+     * @param instance
+     * @returns
+     */
+    static isEntityInstance(instance) {
+        return instance instanceof A_Entity_class_1.A_Entity;
+    }
+    /**
+     * Type guard to check if the instance is of type A_Scope
+     *
+     * @param instance
+     * @returns
+     */
+    static isScopeInstance(instance) {
+        return instance instanceof A_Scope_class_1.A_Scope;
+    }
+    /**
+     * Type guard to check if the instance is of type A_Error
+     *
+     * @param instance
+     * @returns
+     */
+    static isErrorInstance(instance) {
+        return instance instanceof A_Error_class_1.A_Error;
+    }
+    /**
+     * Type guard to check if the instance is of type A_ComponentMeta
+     *
+     * @param instance
+     * @returns
+     */
+    static isComponentMetaInstance(instance) {
+        return instance instanceof A_Component_meta_1.A_ComponentMeta;
+    }
+    /**
+     * Type guard to check if the instance is of type A_ContainerMeta
+     *
+     * @param instance
+     * @returns
+     */
+    static isContainerMetaInstance(instance) {
+        return instance instanceof A_Container_meta_1.A_ContainerMeta;
+    }
+    /**
+     * Type guard to check if the instance is of type A_EntityMeta
+     *
+     * @param instance
+     * @returns
+     */
+    static isEntityMetaInstance(instance) {
+        return instance instanceof A_Entity_meta_1.A_EntityMeta;
+    }
+    // ==========================================================================
+    // ========================= SPECIAL Type Guards =============================
+    // ===========================================================================
+    static isConstructorAvailableForAbstraction(target) {
+        return A_TypeGuards.isContainerConstructor(target)
+            || A_TypeGuards.isComponentConstructor(target);
+    }
+    static isTargetAvailableForInjection(target) {
+        return A_TypeGuards.isComponentConstructor(target)
+            || A_TypeGuards.isComponentInstance(target)
+            || A_TypeGuards.isContainerInstance(target);
+    }
+    static isAllowedForFeatureCall(param) {
+        return A_TypeGuards.isContainerInstance(param)
+            || A_TypeGuards.isComponentInstance(param)
+            || A_TypeGuards.isEntityInstance(param);
+    }
+    static isAllowedForFeatureDefinition(param) {
+        return A_TypeGuards.isContainerInstance(param)
+            || A_TypeGuards.isComponentInstance(param)
+            || A_TypeGuards.isEntityInstance(param);
+    }
+    static isAllowedForFeatureExtension(param) {
+        return A_TypeGuards.isComponentInstance(param);
+    }
+    static isAllowedForAbstractionDefinition(param) {
+        return A_TypeGuards.isContainerInstance(param)
+            || A_TypeGuards.isComponentInstance(param);
+    }
+    /**
+     * Allows to check if the provided param is of constructor type.
+     *
+     * @param param
+     * @returns
+     */
+    static isConstructorType(param) {
+        return !!param && A_TypeGuards.isObject(param) && !(param instanceof Error) && "message" in param;
+    }
+}
+exports.A_TypeGuards = A_TypeGuards;
+//# sourceMappingURL=A_TypeGuards.helper.js.map

package/dist/src/helpers/A_TypeGuards.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A_TypeGuards.helper.js","sourceRoot":"","sources":["../../../src/helpers/A_TypeGuards.helper.ts"],"names":[],"mappings":"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"}

package/dist/src/types/A_Common.types.d.ts

@@ -0,0 +1,36 @@
+type Decrement = [never, 0, 1, 2, 3, 4, 5];
+export type A_TYPES__DeepPartial<T, D extends number = 5> = {
+    [P in keyof Required<T>]?: [
+        D
+    ] extends [never] ? any : Required<T>[P] extends Array<infer U> ? Array<A_TYPES__DeepPartial<U, Decrement[D]>> : Required<T>[P] extends Function ? Required<T>[P] : Required<T>[P] extends object ? A_TYPES__DeepPartial<T[P], Decrement[D]> : T[P];
+};
+export type A_TYPES__ObjectKeyEnum<T, E> = {
+    [P in keyof Required<T>]?: T[P] extends object ? A_TYPES__ObjectKeyEnum<T[P], E> : E;
+};
+export type A_TYPES__Dictionary<T> = {
+    [Key: string]: T;
+};
+export type A_TYPES__NonObjectPaths<T> = T extends object ? {
+    [K in keyof T]: `${Exclude<K, symbol>}${""}`;
+}[keyof T] : never;
+export type A_TYPES__Paths<T, D extends number = 5> = [D] extends [never] ? never : (T extends object ? {
+    [K in keyof T]: `${Exclude<K, symbol>}${"" | `.${A_TYPES__Paths<T[K], Decrement[D]>}`}`;
+}[keyof T] : never);
+export type A_TYPES__UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+export type A_TYPES__PathsToObject<_Obj, T extends readonly string[]> = A_TYPES__UnionToIntersection<{
+    [K in keyof T]: T[K] extends `${infer Key}.${infer Rest}` ? {
+        [P in Key]: P extends keyof _Obj ? A_TYPES__PathsToObject<Required<_Obj>[P], [Rest]> : any;
+    } : {
+        [P in T[K]]: `${T[K]}` extends keyof Required<_Obj> ? Required<_Obj>[`${T[K]}`] : never;
+    };
+}[number]>;
+export type A_TYPES__Required<T, arr extends (A_TYPES__Paths<T>)[] = (A_TYPES__Paths<T>)[]> = A_TYPES__PathsToObject<T, arr> & T;
+export type A_TYPES__ExtractNested<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? {
+    [Key in K]: A_TYPES__ExtractNested<T[K], Rest>;
+} : never : P extends keyof T ? {
+    [Key in P]: T[P];
+} : never;
+export type A_TYPES__ExtractProperties<T, P extends A_TYPES__Paths<T>[]> = A_TYPES__UnionToIntersection<{
+    [K in keyof P]: P[K] extends string ? A_TYPES__ExtractNested<T, P[K]> : never;
+}[number]>;
+export {};

package/dist/src/types/A_Common.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=A_Common.types.js.map

package/dist/src/types/A_Common.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A_Common.types.js","sourceRoot":"","sources":["../../../src/types/A_Common.types.ts"],"names":[],"mappings":""}

package/index.ts

@@ -5,14 +5,11 @@ export * from './src/constants/env.constants';
 
 // ---------------------- Major Components ----------------------
 export { A_Context } from './src/global/A-Context/A-Context.class';
-// export * from './src/global/A-Context/A-Context.types';
+export * from './src/global/A-Context/A-Context.types';
 
-export { A_Abstraction } from './src/global/A-Abstraction/A-Abstraction.class';
-export * from './src/global/A-Abstraction/A-Abstraction.types';
-
-export { A_Concept } from './src/global/A-Concept/A_Concept.class';
-export { A_ConceptMeta } from './src/global/A-Concept/A_Concept.meta';
-export * from './src/global/A-Concept/A_Concept.types';
+export { A_Concept } from './src/global/A-Concept/A-Concept.class';
+export { A_ConceptMeta } from './src/global/A-Concept/A-Concept.meta';
+export * from './src/global/A-Concept/A-Concept.types';
 
 export { A_Container } from './src/global/A-Container/A-Container.class';
 export { A_ContainerMeta } from './src/global/A-Container/A-Container.meta';
@@ -27,21 +24,35 @@ export * from './src/global/A-Entity/A-Entity.types';
 
 
 // ---------------------- Common Components ----------------------
-export { A_Channel } from './src/global/A-Channel/A-Channel.class';
-export * from './src/global/A-Channel/A-Channel.types';
+export { A_Abstraction } from './src/global/A-Abstraction/A-Abstraction.class';
+export { A_AbstractionError } from './src/global/A-Abstraction/A-Abstraction.error';
+export * from './src/global/A-Abstraction/A-Abstraction.types';
+
+export { A_Caller } from './src/global/A-Caller/A_Caller.class';
+export { A_CallerError } from './src/global/A-Caller/A_Caller.error';
+export * from './src/global/A-Caller/A_Caller.types';
+
+export { A_Error } from './src/global/A-Error/A_Error.class';
+export * from './src/global/A-Error/A_Error.types';
+
+export { ASEID } from './src/global/ASEID/ASEID.class';
+export { ASEID_Error } from './src/global/ASEID/ASEID.error';
+export * from './src/global/ASEID/ASEID.types';
 
 export { A_Feature } from './src/global/A-Feature/A-Feature.class';
-export { A_FeatureCaller } from './src/global/A-Feature/A-FeatureCaller.class';
+export { A_FeatureError } from './src/global/A-Feature/A-Feature.error';
 export * from './src/global/A-Feature/A-Feature.types';
 
 export { A_Stage } from './src/global/A-Stage/A-Stage.class';
+export { A_StageError } from './src/global/A-Stage/A-Stage.error';
 export * from './src/global/A-Stage/A-Stage.types';
 
 export { A_Scope } from './src/global/A-Scope/A-Scope.class';
+export { A_ScopeError } from './src/global/A-Scope/A-Scope.error';
 export * from './src/global/A-Scope/A-Scope.types';
 
 export { A_Meta } from './src/global/A-Meta/A-Meta.class';
-// export * from './src/global/A-Meta/A-Meta.types';
+export * from './src/global/A-Meta/A-Meta.types';
 
 export { A_Fragment } from './src/global/A-Fragment/A-Fragment.class';
 export * from './src/global/A-Fragment/A-Fragment.types';
@@ -50,43 +61,8 @@ export * from './src/global/A-Fragment/A-Fragment.types';
 // =================================================================================================
 // =============================== Export Decorators ============================================
 // =================================================================================================
-
-export { A_Inject } from './src/decorators/A-Inject/A-Inject.decorator';
-export * from './src/decorators/A-Inject/A-Inject.decorator.types';
-
-export { A_Feature_Define } from './src/decorators/A-Feature/A-Feature-Define.decorator';
-export { A_Feature_Extend } from './src/decorators/A-Feature/A-Feature-Extend.decorator';
-export * from './src/decorators/A-Feature/A-Feature.decorator.types';
-
-export { A_Abstraction_Extend } from './src/decorators/A-Abstraction/A-Abstraction-Extend.decorator';
-export * from './src/decorators/A-Abstraction/A-Abstraction.decorator.types';
-
-export { A_Connect } from './src/decorators/A-Connect/A-Connect.decorator';
-export * from './src/decorators/A-Connect/A-Connect.decorator.types';
-
-
-// =================================================================================================
-// =============================== Export Base Entities ============================================
-// =================================================================================================
-export { A_ConfigLoader } from './src/base/A-Config/A-Config.container';
-export { A_Config } from './src/base/A-Config/A-Config.context';
-export * from './src/base/A-Config/A-Config.types';
-export { ConfigReader } from './src/base/A-Config/components/ConfigReader.component';
-export { ENVConfigReader } from './src/base/A-Config/components/ENVConfigReader.component';
-export { FileConfigReader } from './src/base/A-Config/components/FileConfigReader.component';
-export * from './src/base/A-Config/A-Config.types';
-
-export * from './src/base/A-Logger/A-Logger.component';
-// export * from './src/base/A-Logger/A-Logger.types';
-
-
-
-export { A_Command } from './src/global/A-Command/A-Command.class';
-export * from './src/global/A-Command/A-Command.types';
-export * from './src/global/A-Command/A-Command.constants';
-export { A_CommandContext } from './src/global/A-Command/context/A_Command.context';
-
-
-export { A_ErrorsManager } from './src/base/A-Errors/A-Errors.component';
-export { A_Errors } from './src/base/A-Errors/A-Errors.context';
-export * from './src/base/A-Errors/A-Errors.types';
+export { A_Inject } from './src/global/A-Inject/A-Inject.decorator';
+export * from './src/global/A-Inject/A-Inject.types';
+export { A_Feature_Define } from './src/global/A-Feature/A-Feature-Define.decorator';
+export { A_Feature_Extend } from './src/global/A-Feature/A-Feature-Extend.decorator';
+export { A_Abstraction_Extend } from './src/global/A-Abstraction/A-Abstraction-Extend.decorator';

package/jest.config.ts

@@ -14,6 +14,7 @@ const config: Config.InitialOptions = {
         "@adaas/a-concept/helpers/(.*)": ["<rootDir>/src/helpers/$1"],
         "@adaas/a-concept/decorators/(.*)": ["<rootDir>/src/decorators/$1"],
         "@adaas/a-concept/base/(.*)": ["<rootDir>/src/base/$1"],
+        "@adaas/a-concept/utils/(.*)": ["<rootDir>/src/utils/$1"]
     }
 
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-concept",
-  "version": "0.0.64",
+  "version": "0.1.1",
   "description": "A-Concept is a framework to build new Applications within or outside the ADAAS ecosystem. This framework is designed to be modular structure regardless environment and program goal.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -51,7 +51,6 @@
   },
   "homepage": "https://github.com/ADAAS-org/adaas-adf-auth#readme",
   "dependencies": {
-    "@adaas/a-utils": "^0.0.9",
     "@types/node": "^20.10.0"
   },
   "devDependencies": {

package/src/constants/env.constants.ts

@@ -5,15 +5,21 @@ export const A_CONSTANTS__DEFAULT_ENV_VARIABLES = {
     // These environment variables are used by A-Concept core to configure the application
     // ----------------------------------------------------------
     /**
-     * Namespace of the application
+     * Name of the application
+     * 
+     * DEFAULT value is 'a-concept'
+     * 
      * [!] Provided name will be used for all aseids in the application by default
      */
-    A_CONCEPT_NAMESPACE: 'A_CONCEPT_NAMESPACE',
+    A_CONCEPT_NAME: 'A_CONCEPT_NAME',
     /**
-     * Default scope of the application
+     * Root scope of the application
+     * 
+     * DEFAULT value is 'root'
+     * 
      * [!] Provided name will be used for all aseids in the application by default
      */
-    A_CONCEPT_DEFAULT_SCOPE: 'A_CONCEPT_DEFAULT_SCOPE',
+    A_CONCEPT_ROOT_SCOPE: 'A_CONCEPT_ROOT_SCOPE',
     /**
      * Environment of the application e.g. development, production, staging
      */
@@ -23,10 +29,10 @@ export const A_CONSTANTS__DEFAULT_ENV_VARIABLES = {
      * [!] Automatically set by A-Concept when the application starts
      */
     A_CONCEPT_ROOT_FOLDER: 'A_CONCEPT_ROOT_FOLDER',
-
-    CONFIG_SDK_VALIDATION: 'CONFIG_SDK_VALIDATION',
-    CONFIG_VERBOSE: 'CONFIG_VERBOSE',
-    CONFIG_IGNORE_ERRORS: 'CONFIG_IGNORE_ERRORS',
+    /**
+     * Allows to define a default error description for errors thrown without a description
+     */
+    A_ERROR_DEFAULT_DESCRIPTION: 'A_ERROR_DEFAULT_DESCRIPTION',
 } as const
 
 
@@ -35,10 +41,11 @@ export type A_TYPES__ConceptENVVariables = (typeof A_CONSTANTS__DEFAULT_ENV_VARI
 
 
 export const A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY = [
-    A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_CONCEPT_NAMESPACE,
+    A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_CONCEPT_NAME,
+    A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_CONCEPT_ROOT_SCOPE,
     A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_CONCEPT_ENVIRONMENT,
     A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_CONCEPT_ROOT_FOLDER,
-    A_CONSTANTS__DEFAULT_ENV_VARIABLES.CONFIG_VERBOSE,
-    A_CONSTANTS__DEFAULT_ENV_VARIABLES.CONFIG_IGNORE_ERRORS,
+
+    A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_ERROR_DEFAULT_DESCRIPTION,
 ] as const;
 

package/src/global/A-Abstraction/A-Abstraction-Extend.decorator.ts

@@ -0,0 +1,103 @@
+import {
+    A_TYPES__AbstractionDecoratorConfig,
+    A_TYPES__AbstractionDecoratorDescriptor
+} from "./A-Abstraction.types";
+import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
+import { A_Context } from "@adaas/a-concept/global/A-Context/A-Context.class";
+import { A_Container } from "@adaas/a-concept/global/A-Container/A-Container.class";
+import { A_ContainerMeta } from "@adaas/a-concept/global/A-Container/A-Container.meta";
+import { A_ComponentMeta } from "@adaas/a-concept/global/A-Component/A-Component.meta";
+import { A_Meta } from "@adaas/a-concept/global/A-Meta/A-Meta.class";
+import { A_TYPES__ConceptAbstractions } from "@adaas/a-concept/global/A-Concept/A-Concept.constants";
+import { A_TYPES__ContainerMetaKey } from "@adaas/a-concept/global/A-Container/A-Container.constants";
+import { A_TYPES__ComponentMetaKey } from "@adaas/a-concept/global/A-Component/A-Component.constants";
+import { A_TYPES__ConceptAbstraction } from "@adaas/a-concept/global/A-Concept/A-Concept.types";
+import { A_AbstractionError } from "./A-Abstraction.error";
+import { A_TypeGuards } from "@adaas/a-concept/helpers/A_TypeGuards.helper";
+
+
+/**
+ * A-Abstraction Extend decorator allows to extends behavior of each concept abstraction execution. 
+ * In case some components or containers requires to extend the behavior of the abstraction like 'start', 'build' or 'deploy'
+ * for example, this decorator allows to do so.    
+ * 
+ * @param name - abstraction name 
+ * @param config - configuration of the abstraction extension
+ * @returns 
+ */
+export function A_Abstraction_Extend(
+    /**
+     * Name of the Concept Abstraction to extend
+     */
+    name: A_TYPES__ConceptAbstractions,
+    /**
+     * Configuration of the Abstraction Extension
+     * 
+     */
+    config: Partial<A_TYPES__AbstractionDecoratorConfig> = {}
+) {
+    return function (
+        target: A_Container | A_Component,
+        propertyKey: string,
+        descriptor: A_TYPES__AbstractionDecoratorDescriptor
+    ) {
+        // for error messages
+        const componentName = (target as any)?.constructor?.name || String(target) || 'UnknownComponent';
+
+        if (!name)
+            throw new A_AbstractionError(
+                A_AbstractionError.AbstractionExtensionError,
+                `Abstraction name must be provided to extend abstraction for '${componentName}'.`,
+            );
+
+        //  Only Containers and Components can extend Concept Abstractions
+        if (!A_TypeGuards.isConstructorAvailableForAbstraction(target)) {
+            throw new A_AbstractionError(
+                A_AbstractionError.AbstractionExtensionError,
+                `Unable to extend Abstraction '${name}' for '${componentName}'. Only A-Containers and A-Components can extend Abstractions.`,
+            );
+        }
+
+        let metaKey;
+        const meta: A_ContainerMeta | A_ComponentMeta = A_Context.meta(target);
+
+        switch (true) {
+            case A_TypeGuards.isContainerConstructor(target):
+                metaKey = A_TYPES__ContainerMetaKey.ABSTRACTIONS
+                break;
+            case A_TypeGuards.isComponentConstructor(target):
+                metaKey = A_TYPES__ComponentMetaKey.ABSTRACTIONS
+                break;
+        }
+
+        // Get the existed metadata or create a new one
+        const existedMeta: A_Meta<{
+            [Key: string]: A_TYPES__ConceptAbstraction[];
+        }> = meta.get(metaKey) || new A_Meta();
+
+        // Set the metadata of the method to define a custom Stage with name
+        const existedMetaValue = existedMeta.get(name) || [];
+
+
+        // Add the new method to the metadata
+        existedMetaValue.push({
+            name,
+            handler: propertyKey,
+            before: config.before || [],
+            after: config.after || [],
+            behavior: config.behavior || 'sync'
+        });
+
+        // Set the metadata of the method to define a custom Feature with name
+        existedMeta.set(name, existedMetaValue);
+
+
+        //  Update the metadata of the container with the new Stage definition
+        A_Context
+            .meta(target)
+            .set(
+                metaKey,
+                existedMeta
+            );
+    };
+}