@adaas/a-concept 0.0.64 → 0.1.1

package/dist/src/{decorators → global}/A-Feature/A-Feature-Define.decorator.js

@@ -1,16 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.A_Feature_Define = A_Feature_Define;
-const A_Entity_class_1 = require("../../global/A-Entity/A-Entity.class");
-const A_Context_class_1 = require("../../global/A-Context/A-Context.class");
-const A_Component_class_1 = require("../../global/A-Component/A-Component.class");
-const A_Container_class_1 = require("../../global/A-Container/A-Container.class");
-const A_Container_types_1 = require("../../global/A-Container/A-Container.types");
-const A_Entity_types_1 = require("../../global/A-Entity/A-Entity.types");
-const A_Component_types_1 = require("../../global/A-Component/A-Component.types");
-const A_Meta_class_1 = require("../../global/A-Meta/A-Meta.class");
-const A_Command_class_1 = require("../../global/A-Command/A-Command.class");
-const A_Command_types_1 = require("../../global/A-Command/A-Command.types");
+const A_Context_class_1 = require("../A-Context/A-Context.class");
+const A_Meta_class_1 = require("../A-Meta/A-Meta.class");
+const A_Entity_constants_1 = require("../A-Entity/A-Entity.constants");
+const A_Container_constants_1 = require("../A-Container/A-Container.constants");
+const A_Component_constants_1 = require("../A-Component/A-Component.constants");
+const A_TypeGuards_helper_1 = require("../../helpers/A_TypeGuards.helper");
+const A_Feature_error_1 = require("./A-Feature.error");
 /**
  * A-Feature decorator
  *
@@ -26,38 +23,35 @@ const A_Command_types_1 = require("../../global/A-Command/A-Command.types");
  */
 function A_Feature_Define(config = {}) {
     return function (target, propertyKey, descriptor) {
+        var _a;
+        // for error messages
+        const componentName = ((_a = target === null || target === void 0 ? void 0 : target.constructor) === null || _a === void 0 ? void 0 : _a.name) || String(target) || 'Unknown';
+        if (!A_TypeGuards_helper_1.A_TypeGuards.isAllowedForFeatureDefinition(target))
+            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureDefinitionError, `A-Feature cannot be defined on the ${componentName} level`);
         const meta = A_Context_class_1.A_Context.meta(target.constructor);
         let metaKey;
         switch (true) {
-            case target instanceof A_Entity_class_1.A_Entity:
-                metaKey = A_Entity_types_1.A_TYPES__EntityMetaKey.FEATURES;
+            case A_TypeGuards_helper_1.A_TypeGuards.isEntityInstance(target):
+                metaKey = A_Entity_constants_1.A_TYPES__EntityMetaKey.FEATURES;
                 break;
-            case target instanceof A_Container_class_1.A_Container:
-                metaKey = A_Container_types_1.A_TYPES__ContainerMetaKey.FEATURES;
+            case A_TypeGuards_helper_1.A_TypeGuards.isContainerInstance(target):
+                metaKey = A_Container_constants_1.A_TYPES__ContainerMetaKey.FEATURES;
                 break;
-            case target instanceof A_Component_class_1.A_Component:
-                metaKey = A_Component_types_1.A_TYPES__ComponentMetaKey.FEATURES;
+            case A_TypeGuards_helper_1.A_TypeGuards.isComponentInstance(target):
+                metaKey = A_Component_constants_1.A_TYPES__ComponentMetaKey.FEATURES;
                 break;
-            case target instanceof A_Command_class_1.A_Command:
-                metaKey = A_Command_types_1.A_TYPES__CommandMetaKey.FEATURES;
-                break;
-            default: {
-                console.log(target);
-                throw new Error(`A-Feature cannot be defined on the ${target.constructor.name} level`);
-            }
         }
         // Get the existed metadata or create a new one
         const existedMeta = meta.get(metaKey) || new A_Meta_class_1.A_Meta();
-        const handlerName = config.name || propertyKey;
+        const name = config.name || propertyKey;
         //  default to false
         const invoke = config.invoke || false;
         // Set the metadata of the method to define a custom Feature with name 
         existedMeta.set(propertyKey, {
-            name: `${target.constructor.name}.${handlerName}`,
+            name: `${target.constructor.name}.${name}`,
             handler: propertyKey,
             invoke: invoke,
             template: config.template && config.template.length ? config.template.map(item => (Object.assign(Object.assign({}, item), { before: item.before || [], after: item.after || [], behavior: item.behavior || 'sync' }))) : [],
-            channel: config.channel || []
         });
         //  Update the metadata of the container with the new Feature definition
         A_Context_class_1.A_Context
@@ -74,7 +68,7 @@ function A_Feature_Define(config = {}) {
                 originalMethod.apply(this, args);
             // Call your `call` with the function name
             if (typeof this.call === "function" && invoke)
-                return this.call(handlerName);
+                return this.call(name);
         };
         return descriptor;
     };

package/dist/src/global/A-Feature/A-Feature-Define.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A-Feature-Define.decorator.js","sourceRoot":"","sources":["../../../../src/global/A-Feature/A-Feature-Define.decorator.ts"],"names":[],"mappings":"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"}

package/dist/src/{decorators → global}/A-Feature/A-Feature-Extend.decorator.d.ts

@@ -1,4 +1,4 @@
-import { A_TYPES__A_ExtendDecoratorConfig } from "./A-Feature.decorator.types";
+import { A_TYPES__FeatureExtendDecoratorConfig } from "./A-Feature.types";
 /**
  * A-Extend decorator
  *
@@ -17,17 +17,40 @@ import { A_TYPES__A_ExtendDecoratorConfig } from "./A-Feature.decorator.types";
  *
  * @param regexp
  */
-export declare function A_Feature_Extend(regexp: RegExp): any;
+export declare function A_Feature_Extend(
+/**
+ * The regular expression to match the name of the Feature method to be extended
+ *
+ * Example:
+ *
+ * ```ts
+ *  @A_Feature.Extend(/.*\.load/)
+ * ```
+ */
+regexp: RegExp): any;
 /**
  * In this case the name configurations will be used as an input to get scope and name of target function
  * [!] Not that for all SCOPE will be used OR operator
  *
  * @param config
  */
-export declare function A_Feature_Extend(config: Partial<A_TYPES__A_ExtendDecoratorConfig>): any;
+export declare function A_Feature_Extend(
+/**
+ * Configuration for the A-Feature-Extend decorator
+ */
+config: Partial<A_TYPES__FeatureExtendDecoratorConfig>): any;
 /**
  * In this case the name of function will be used as a name of the Feature.
  * [!] AND it will be applicable for ANY element where the name is the same as the name of the function
  */
 export declare function A_Feature_Extend(): any;
+/**
+ * Builds a target regular expression based on the provided parameters.
+ *
+ * @param param1 - The first parameter, which can be a string or an object.
+ * @param include - An array of items to include in the regular expression.
+ * @param exclude - An array of items to exclude from the regular expression.
+ * @param propertyKey - The property key to use in the regular expression.
+ * @returns A regular expression object.
+ */
 export declare function buildTargetRegexp(param1: any, include: any[], exclude: any[], propertyKey: string): RegExp;

package/dist/src/global/A-Feature/A-Feature-Extend.decorator.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_Feature_Extend = A_Feature_Extend;
+exports.buildTargetRegexp = buildTargetRegexp;
+const A_Context_class_1 = require("../A-Context/A-Context.class");
+const A_Meta_class_1 = require("../A-Meta/A-Meta.class");
+const A_TypeGuards_helper_1 = require("../../helpers/A_TypeGuards.helper");
+const A_Component_constants_1 = require("../A-Component/A-Component.constants");
+const A_Feature_error_1 = require("./A-Feature.error");
+function A_Feature_Extend(param1) {
+    return function (target, propertyKey, descriptor) {
+        var _a;
+        // for error messages
+        const componentName = ((_a = target === null || target === void 0 ? void 0 : target.constructor) === null || _a === void 0 ? void 0 : _a.name) || String(target) || 'Unknown';
+        if (!A_TypeGuards_helper_1.A_TypeGuards.isAllowedForFeatureExtension(target))
+            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureExtensionError, `A-Feature-Extend cannot be applied on the ${componentName} level`);
+        let targetRegexp;
+        let behavior = 'sync';
+        let before = [];
+        let after = [];
+        let include = [];
+        let exclude = [];
+        switch (true) {
+            case A_TypeGuards_helper_1.A_TypeGuards.isRegExp(param1):
+                targetRegexp = param1;
+                break;
+            case !!param1 && typeof param1 === 'object':
+                if (Array.isArray(param1.scope))
+                    include = param1.scope;
+                else if (!!param1.scope && typeof param1.scope === 'object') {
+                    if (Array.isArray(param1.scope.include))
+                        include = param1.scope.include;
+                    if (Array.isArray(param1.scope.exclude))
+                        exclude = param1.scope.exclude;
+                }
+                targetRegexp = buildTargetRegexp(param1, include, exclude, propertyKey);
+                behavior = param1.behavior || behavior;
+                before = param1.before || before;
+                after = param1.after || after;
+                break;
+            default:
+                targetRegexp = new RegExp(`^.*\\.${propertyKey}$`);
+                break;
+        }
+        const existedDefinitions = A_Context_class_1.A_Context
+            .meta(target)
+            .get(A_Component_constants_1.A_TYPES__ComponentMetaKey.FEATURES);
+        // Get the existed metadata or create a new one
+        const existedMeta = A_Context_class_1.A_Context
+            .meta(target)
+            .get(A_Component_constants_1.A_TYPES__ComponentMetaKey.EXTENSIONS)
+            || new A_Meta_class_1.A_Meta();
+        if (existedDefinitions
+            && existedDefinitions.size()
+            && existedDefinitions.has(propertyKey)
+            && existedDefinitions.get(propertyKey).invoke) {
+            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureExtensionError, `A-Feature-Extend cannot be used on the method "${propertyKey}" because it is already defined as a Feature with "invoke" set to true. Please remove the A-Feature-Extend decorator or set "invoke" to false in the A-Feature decorator.`);
+        }
+        const existedMetaValue = existedMeta.get(targetRegexp.source) || [];
+        // Add the new method to the metadata
+        existedMetaValue.push({
+            name: targetRegexp.source,
+            handler: propertyKey,
+            behavior,
+            before,
+            after
+        });
+        // Set the metadata of the method to define a custom Feature with name
+        existedMeta.set(targetRegexp.source, existedMetaValue);
+        //  Update the metadata of the container with the new Feature definition
+        A_Context_class_1.A_Context
+            .meta(target)
+            .set(A_Component_constants_1.A_TYPES__ComponentMetaKey.EXTENSIONS, existedMeta);
+    };
+}
+/**
+ * Builds a target regular expression based on the provided parameters.
+ *
+ * @param param1 - The first parameter, which can be a string or an object.
+ * @param include - An array of items to include in the regular expression.
+ * @param exclude - An array of items to exclude from the regular expression.
+ * @param propertyKey - The property key to use in the regular expression.
+ * @returns A regular expression object.
+ */
+function buildTargetRegexp(param1, include, exclude, propertyKey) {
+    const includePart = include.length
+        ? `(${include.map(el => el.name).join('|')})`
+        : `.*`;
+    const excludePart = exclude.length
+        ? `(?!${exclude.map(el => el.name).join('|')})`
+        : ``;
+    const pattern = param1.scope
+        ? `^${excludePart}${includePart}\\.${param1.name || propertyKey}$`
+        : `.*\\.${param1.name || propertyKey}$`;
+    return new RegExp(pattern);
+}
+//# sourceMappingURL=A-Feature-Extend.decorator.js.map

package/dist/src/global/A-Feature/A-Feature-Extend.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A-Feature-Extend.decorator.js","sourceRoot":"","sources":["../../../../src/global/A-Feature/A-Feature-Extend.decorator.ts"],"names":[],"mappings":"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"}

package/dist/src/global/A-Feature/A-Feature.class.d.ts

@@ -1,11 +1,12 @@
-import { A_Feature_Define } from "../../decorators/A-Feature/A-Feature-Define.decorator";
-import { A_TYPES__FeatureConstructor, A_TYPES__FeatureState } from "./A-Feature.types";
-import { A_Error } from "@adaas/a-utils";
-import { A_TYPES__A_Feature_Extend } from "../../decorators/A-Feature/A-Feature.decorator.types";
+import { A_TYPES__Feature_Init, A_TYPES__Feature_InitWithComponent, A_TYPES__Feature_InitWithTemplate, A_TYPES__FeatureAvailableComponents, A_TYPES__FeatureState } from "./A-Feature.types";
+import { A_Feature_Define } from "./A-Feature-Define.decorator";
+import { A_Feature_Extend } from "./A-Feature-Extend.decorator";
 import { A_Stage } from "../A-Stage/A-Stage.class";
-import { StepsManager } from "../../helpers/StepsManager.class";
+import { A_StepsManager } from "../../helpers/A_StepsManager.class";
+import { A_StageError } from "../A-Stage/A-Stage.error";
+import { A_FeatureError } from "./A-Feature.error";
+import { A_Caller } from "../A-Caller/A_Caller.class";
 import { A_Scope } from "../A-Scope/A-Scope.class";
-import { A_FeatureCaller } from "./A-FeatureCaller.class";
 /**
  * A_Feature is representing a feature that can be executed across multiple components
  * This class stores the steps of the feature and executes them in order of appearance
@@ -14,7 +15,7 @@ import { A_FeatureCaller } from "./A-FeatureCaller.class";
  * across the different, distributed components
  *
  */
-export declare class A_Feature {
+export declare class A_Feature<T extends A_TYPES__FeatureAvailableComponents = A_TYPES__FeatureAvailableComponents> {
     /**
      * Define a new A-Feature
      */
@@ -22,36 +23,129 @@ export declare class A_Feature {
     /**
      * Extend an existing A-Feature
      */
-    static get Extend(): A_TYPES__A_Feature_Extend;
-    protected stages: Array<A_Stage>;
+    static get Extend(): typeof A_Feature_Extend;
+    /**
+     * The name of the Feature
+     */
+    protected _name: string;
+    /**
+     * List of stages that are part of this Feature
+     */
+    protected _stages: Array<A_Stage>;
+    /**
+     * The Stage currently being processed
+     */
     protected _current?: A_Stage;
-    protected _caller: A_FeatureCaller;
+    /**
+     * Actual Index of the current Stage being processed
+     */
     protected _index: number;
-    protected SM: StepsManager;
-    state: A_TYPES__FeatureState;
-    result?: any;
-    error?: A_Error;
-    readonly name: string;
-    readonly Scope: A_Scope;
-    constructor(params: A_TYPES__FeatureConstructor);
     /**
-     * Returns the current A-Feature Stage
+     * Steps Manager to organize the steps into stages
+     */
+    protected _SM: A_StepsManager;
+    /**
+     * The Caller that initiated the Feature call
+     */
+    protected _caller: A_Caller<T>;
+    /**
+     * The current state of the Feature
+     */
+    protected _state: A_TYPES__FeatureState;
+    /**
+     * The error that caused the Feature to be interrupted
+     */
+    protected _error?: A_FeatureError;
+    /**
+     * A-Feature is a pipeline distributed by multiple components that can be easily attached or detached from the scope.
+     * Feature itself does not have scope, but attached to the caller who dictates how feature should be processed.
+     *
+     * Comparing to A-Command Feature does not store any state except statuses for better analysis.
+     *
+     * [!] Note: If A-Feature should have result use A-Fragment
      *
+     * @param params
+     */
+    constructor(
+    /**
+     * Feature Initialization parameters
+     */
+    params: A_TYPES__Feature_Init<T>);
+    /**
+     * The name of the Feature
+     */
+    get name(): string;
+    /**
+     * The error that caused the Feature to be interrupted
+     */
+    get error(): A_FeatureError | undefined;
+    /**
+     * The current state of the Feature
+     */
+    get state(): A_TYPES__FeatureState;
+    /**
+     * Sets the current state of the Feature
+     */
+    get index(): number;
+    /**
+     * Returns the current A-Feature Stage
      */
     get stage(): A_Stage | undefined;
-    get Caller(): A_FeatureCaller;
     /**
-     * Custom iterator to iterate over the steps of the feature
+     * The Caller that initiated the Feature call
+     */
+    get caller(): A_Caller<T>;
+    /**
+     * The Scope allocated for the Feature Execution
+     */
+    get scope(): A_Scope;
+    /**
+     * This method checks if the A-Feature is done
+     *
+     * @returns
+     */
+    get isDone(): boolean;
+    /**
+     * Iterator to iterate over the steps of the feature
      *
      * @returns
      */
     [Symbol.iterator](): Iterator<A_Stage, any>;
     /**
-     * This method checks if the A-Feature is done
+     * Validates the provided parameters for A-Feature initialization
+     *
+     * @param params
+     */
+    protected validateParams(params: A_TYPES__Feature_Init<T>): void;
+    /**
+     * Returns the appropriate initializer method based on the provided parameters
      *
+     * @param params
      * @returns
      */
-    isDone(): boolean;
+    protected getInitializer(params: A_TYPES__Feature_Init<T>): (param1: any) => void | (() => void);
+    /**
+     * Initializes the A-Feature from the provided template
+     *
+     * @param params
+     */
+    protected fromTemplate(params: A_TYPES__Feature_InitWithTemplate): void;
+    /**
+     * Initializes the A-Feature from the provided component
+     *
+     * @param params
+     */
+    protected fromComponent(params: A_TYPES__Feature_InitWithComponent<T>): void;
+    /**
+     * This method processes the feature by executing all the stages
+     *
+     */
+    process(
+    /**
+     * Optional scope to be used to resolve the steps dependencies
+     * If not provided, the scope of the caller component will be used
+     */
+    scope?: A_Scope): Promise<void>;
     /**
      * This method moves the feature to the next stage
      *
@@ -62,23 +156,19 @@ export declare class A_Feature {
      * This method marks the feature as completed and returns the result
      * Uses to interrupt or end the feature processing
      *
-     * The result of the feature is a Scope Fragments
-     *
      * @param result
      * @returns
      */
-    completed<T extends any>(): Promise<T>;
+    completed(): Promise<void>;
     /**
      * This method marks the feature as failed and throws an error
      * Uses to interrupt or end the feature processing
      *
      * @param error
      */
-    failed(error: Error | A_Error | unknown): Promise<void>;
+    interrupt(
     /**
-     * This method processes the feature by executing all the stages
-     *
+     * The reason of feature interruption
      */
-    process(scope?: A_Scope): Promise<any>;
-    protected errorHandler(error: Error | A_Error | unknown): Promise<void>;
+    reason?: string | A_StageError | Error): Promise<void>;
 }