@adaas/a-concept 0.0.64 → 0.1.2

package/src/global/A-Context/A-Context.error.ts

@@ -0,0 +1,44 @@
+import { A_Error } from "../A-Error/A_Error.class";
+
+
+
+export class A_ContextError extends A_Error {
+
+
+    static NotAllowedForScopeAllocationError = 'Component is not allowed for scope allocation';
+
+    static ComponentAlreadyHasScopeAllocatedError = 'Component already has scope allocated';
+
+    static InvalidMetaParameterError = 'Invalid parameter provided to get meta';
+
+    static InvalidScopeParameterError = 'Invalid parameter provided to get scope';
+
+    static ScopeNotFoundError = 'Scope not found';
+
+    static InvalidFeatureParameterError = 'Invalid parameter provided to get feature';
+
+    static InvalidFeatureDefinitionParameterError = 'Invalid parameter provided to define feature';
+
+    static InvalidFeatureTemplateParameterError = 'Invalid parameter provided to get feature template';
+
+    static InvalidFeatureExtensionParameterError = 'Invalid parameter provided to extend feature';
+
+
+    static InvalidAbstractionParameterError = 'Invalid parameter provided to get abstraction';
+
+    static InvalidAbstractionDefinitionParameterError = 'Invalid parameter provided to define abstraction';
+
+    static InvalidAbstractionTemplateParameterError = 'Invalid parameter provided to get abstraction template';
+
+    static InvalidAbstractionExtensionParameterError = 'Invalid parameter provided to extend abstraction';
+
+    static InvalidInjectionParameterError = 'Invalid parameter provided to get injections';
+
+    static InvalidExtensionParameterError = 'Invalid parameter provided to get extensions';
+
+
+    static InvalidRegisterParameterError = 'Invalid parameter provided to register component';
+
+
+    static InvalidComponentParameterError = 'Invalid component provided';
+}

package/src/global/A-Context/A-Context.types.ts

@@ -0,0 +1,14 @@
+import { A_ComponentMeta } from "../A-Component/A-Component.meta";
+import { A_ContainerMeta } from "../A-Container/A-Container.meta";
+import { A_EntityMeta } from "../A-Entity/A-Entity.meta";
+
+
+
+export type A_TYPES__ContextEnvironment = 'server' | 'browser' | 'mobile' | 'desktop' | 'embedded' | 'unknown';
+
+
+
+
+export type A_TYPES__FeatureExtendableMeta = A_ContainerMeta
+    | A_ComponentMeta
+    | A_EntityMeta

package/src/global/A-Entity/A-Entity.class.ts

@@ -1,18 +1,15 @@
 import {
-    A_CommonHelper,
-    A_Error,
-    ASEID,
-    A_IdentityHelper
-} from "@adaas/a-utils";
-import {
-    A_TYPES__Entity_JSON,
-    A_TYPES__IEntity
+    A_TYPES__Entity_Serialized,
+    A_TYPES__Entity_Init,
+    A_TYPES__IEntity,
 } from "./A-Entity.types";
-import { A_CONSTANTS__DEFAULT_ERRORS } from "@adaas/a-utils/dist/src/constants/errors.constants";
 import { A_Context } from "../A-Context/A-Context.class";
 import { A_Scope } from "../A-Scope/A-Scope.class";
-import { A_CONSTANTS__DEFAULT_ENV_VARIABLES } from "@adaas/a-concept/constants/env.constants";
-
+import { A_FormatterHelper } from "@adaas/a-concept/helpers/A_Formatter.helper";
+import { ASEID } from "../ASEID/ASEID.class";
+import { A_IdentityHelper } from "@adaas/a-concept/helpers/A_Identity.helper";
+import { A_Entity_Error } from "./A-Entity.error";
+import { A_Feature } from "../A-Feature/A-Feature.class";
 
 
 /**
@@ -23,31 +20,27 @@ import { A_CONSTANTS__DEFAULT_ENV_VARIABLES } from "@adaas/a-concept/constants/e
  * Each entity should be connected to the ContextFragment (Scope) and should be able to communicate with other entities.
  */
 export class A_Entity<
-    _ConstructorType = any,
-    _SerializedType extends A_TYPES__Entity_JSON = A_TYPES__Entity_JSON
+    _ConstructorType extends A_TYPES__Entity_Init = A_TYPES__Entity_Init,
+    _SerializedType extends A_TYPES__Entity_Serialized = A_TYPES__Entity_Serialized
 >
     implements A_TYPES__IEntity {
 
-
     // ====================================================================
     // ================== Static A-Entity Information ============================
     // ====================================================================
-
     /**
      * Entity Identifier that corresponds to the class name
      */
     static get entity(): string {
-        return A_CommonHelper.toKebabCase(this.name);
+        return A_FormatterHelper.toKebabCase(this.name);
     }
-
     /**
-     * DEFAULT Namespace of the entity from environment variable A_CONCEPT_NAMESPACE
+     * DEFAULT Concept Name (Application Name) of the entity from environment variable A_CONCEPT_NAME
      * [!] If environment variable is not set, it will default to 'a-concept'
      */
-    static get namespace(): string {
-        return A_Context.root.name;
+    static get concept(): string {
+        return A_Context.concept;
     }
-
     /**
      * DEFAULT Scope of the entity from environment variable A_CONCEPT_DEFAULT_SCOPE
      * [!] If environment variable is not set, it will default to 'core'
@@ -55,9 +48,11 @@ export class A_Entity<
      * [!] e.g. 'default', 'core', 'public', 'internal', etc
      */
     static get scope(): string {
-        return process && process.env ? process.env[A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_CONCEPT_DEFAULT_SCOPE] || 'core' : 'core';
+        return A_Context.root.name;
     }
 
+
+
     // ====================================================================
     // ================== Instance A-Entity Information ====================
     // ====================================================================
@@ -72,9 +67,9 @@ export class A_Entity<
      * [!] ASEID is immutable and should not be changed after the entity is created
      * 
      * [!] ASEID is composed of the following parts:
-     * - namespace: an application specific identifier from where the entity is coming from
-     * - scope: the scope of the entity from Application Namespace
-     * - entity: the name of the entity from Application Namespace
+     * - concept: an application specific identifier from where the entity is coming from
+     * - scope: the scope of the entity from concept
+     * - entity: the name of the entity from concept
      * - id: the unique identifier of the entity
      *
      * [!] For more information about ASEID, please refer to the ASEID class documentation]
@@ -97,7 +92,7 @@ export class A_Entity<
     )
     /**
      * Create a new A_entity instance from Aseid instance
-     * e.g. new ASEID({namespace: 'project', scope: 'default', entity: 'entity', id: '0000000001'})
+     * e.g. new ASEID({concept: 'project', scope: 'default', entity: 'entity', id: '0000000001'})
      * 
      * @param aseid 
      */
@@ -148,48 +143,6 @@ export class A_Entity<
         return this.aseid.id;
     }
 
-    /**
-     * Extracts the namespace from the ASEID
-     * namespace is an application specific identifier from where the entity is coming from
-     */
-    get namespace(): string {
-        return this.aseid.namespace
-    }
-
-    /**
-     * Extracts the scope from the ASEID
-     * scope is the scope of the entity from Application Namespace
-     */
-    get scope(): string {
-        return this.aseid.scope;
-    }
-
-    /**
-     * Extracts the entity from the ASEID
-     * entity is the name of the entity from Application Namespace
-     * 
-     */
-    get entity(): string {
-        return this.aseid.entity;
-    }
-
-    /**
-     * Extracts the version from the ASEID
-     * version is the version of the entity
-     */
-
-    get version(): string | undefined {
-        return this.aseid.version;
-    }
-
-    /**
-     * Extracts the shard from the ASEID
-     * shard is the shard of the entity
-     */
-    get shard(): string | undefined {
-        return this.aseid.shard;
-    }
-
     // ====================================================================
     // ================== Constructor Helpers =============================
     // ====================================================================
@@ -283,7 +236,7 @@ export class A_Entity<
         }
 
         // none of the above -> throw consistent error
-        throw new A_Error(A_CONSTANTS__DEFAULT_ERRORS.INCORRECT_A_ENTITY_CONSTRUCTOR);
+        throw new A_Entity_Error(A_Entity_Error.ValidationError, 'Unable to determine A-Entity constructor initialization method. Please check the provided parameters.');
     }
 
 
@@ -297,19 +250,14 @@ export class A_Entity<
      */
     async call(
         feature: string,
-        scope: A_Scope = A_Context.scope(this)
+        scope?: A_Scope
     ) {
-        //  scope can be completely custom without relation to the entity scope
-        //  or it can be inherited from the entity scope
-        // [!Not Now!] however, each feature should create own scope regardless of the passed scope
-        //  to avoid any possible side effects
-        if (scope && !scope.isInheritedFrom(A_Context.scope(this))) {
-            scope = scope.inherit(A_Context.scope(this));
-        }
-
-        const newFeature = A_Context.feature(this, feature, scope);
+        const newFeature = new A_Feature({
+            name: feature,
+            component: this
+        });
 
-        return await newFeature.process();
+        return await newFeature.process(scope);
     }
 
 
@@ -354,13 +302,10 @@ export class A_Entity<
      * @param aseid 
      */
     fromASEID(aseid: string | ASEID): void {
-        if (typeof aseid === 'string' && ASEID.isASEID(aseid)) {
-            this.aseid = new ASEID(aseid);
-        } else if (aseid instanceof ASEID) {
+        if (aseid instanceof ASEID)
             this.aseid = aseid;
-        } else {
-            throw new A_Error(A_CONSTANTS__DEFAULT_ERRORS.INCORRECT_A_ENTITY_CONSTRUCTOR);
-        }
+        else
+            this.aseid = new ASEID(aseid);
     }
 
     /**
@@ -373,7 +318,7 @@ export class A_Entity<
      */
     fromUndefined(): void {
         this.aseid = new ASEID({
-            namespace: (this.constructor as typeof A_Entity).namespace,
+            concept: (this.constructor as typeof A_Entity).concept,
             scope: (this.constructor as typeof A_Entity).scope,
             entity: (this.constructor as typeof A_Entity).entity,
             id: A_IdentityHelper.generateTimeId()
@@ -391,7 +336,7 @@ export class A_Entity<
      */
     fromNew(newEntity: _ConstructorType): void {
         this.aseid = new ASEID({
-            namespace: (this.constructor as typeof A_Entity).namespace,
+            concept: (this.constructor as typeof A_Entity).concept,
             scope: (this.constructor as typeof A_Entity).scope,
             entity: (this.constructor as typeof A_Entity).entity,
             id: A_IdentityHelper.generateTimeId()

package/src/global/A-Entity/A-Entity.constants.ts

@@ -0,0 +1,12 @@
+export enum A_TYPES__EntityMetaKey {
+    EXTENSIONS = 'a-component-extensions',
+    FEATURES = 'a-component-features',
+    ABSTRACTIONS = 'a-component-abstractions',
+    INJECTIONS = 'a-component-injections',
+}
+
+export enum A_TYPES__EntityFeatures {
+    SAVE = 'save',
+    DESTROY = 'destroy',
+    LOAD = 'load'
+}

package/src/global/A-Entity/A-Entity.error.ts

@@ -0,0 +1,12 @@
+import { A_Error } from "../A-Error/A_Error.class";
+
+
+
+export class A_Entity_Error extends A_Error {
+
+    /**
+     * Error code for validation errors.
+     */
+    static readonly ValidationError = 'A-Entity Validation Error';
+
+}

package/src/global/A-Entity/A-Entity.meta.ts

@@ -1,7 +1,7 @@
-import { A_TYPES__A_InjectDecorator_Meta } from "@adaas/a-concept/decorators/A-Inject/A-Inject.decorator.types";
 import { A_Meta } from "../A-Meta/A-Meta.class";
-import { A_TYPES__EntityMeta, A_TYPES__EntityMetaKey } from "./A-Entity.types";
-import { A_TYPES__A_DefineDecorator_Meta } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types";
+import { A_TYPES__EntityMeta } from "./A-Entity.types";
+import { A_TYPES__EntityMetaKey } from "./A-Entity.constants";
+import { A_TYPES__FeatureDefineDecoratorMeta } from "../A-Feature/A-Feature.types";
 
 
 export class A_EntityMeta extends A_Meta<A_TYPES__EntityMeta> {
@@ -11,7 +11,7 @@ export class A_EntityMeta extends A_Meta<A_TYPES__EntityMeta> {
      * 
      * @returns 
      */
-    features(): Array<A_TYPES__A_DefineDecorator_Meta> {
+    features(): Array<A_TYPES__FeatureDefineDecoratorMeta> {
 
         const features = this.get(A_TYPES__EntityMetaKey.FEATURES);
 

package/src/global/A-Entity/A-Entity.types.ts

@@ -1,31 +1,13 @@
-import { ASEID } from "@adaas/a-utils";
 import { A_Meta } from "../A-Meta/A-Meta.class";
-import { A_Fragment } from "../A-Fragment/A-Fragment.class";
-import { A_TYPES__A_DefineDecorator_Meta, A_TYPES__A_ExtendDecorator_Meta } from "@adaas/a-concept/decorators/A-Feature/A-Feature.decorator.types";
 import { A_Entity } from "./A-Entity.class";
-import { A_TYPES__ContainerMeta_FeatureItem } from "../A-Container/A-Container.types";
+import { ASEID } from "../ASEID/ASEID.class";
+import { A_TYPES__EntityMetaKey } from "./A-Entity.constants";
+import { A_TYPES__FeatureDefineDecoratorMeta, A_TYPES__FeatureExtendDecoratorMeta } from "../A-Feature/A-Feature.types";
 
 
-export type A_TYPES__EntityCallParams<T extends string> = {
-    name: T,
-    fragments: Array<A_Fragment>,
-    entities: Array<A_Entity<any, any>>,
-    components: Array<{ new(...args: any[]): any }>
-}
-
-
-export type A_TYPES__EntityBaseMethods = [
-    A_TYPES__EntityBaseMethod.SAVE,
-    A_TYPES__EntityBaseMethod.DESTROY,
-    A_TYPES__EntityBaseMethod.LOAD
-]
-
-export enum A_TYPES__EntityBaseMethod {
-    SAVE = 'save',
-    DESTROY = 'destroy',
-    LOAD = 'load'
-}
-
+/**
+ * Entity interface
+ */
 export interface A_TYPES__IEntity {
     /**
      * The ASEID of the entity
@@ -33,8 +15,22 @@ export interface A_TYPES__IEntity {
     aseid: ASEID
 };
 
-
-export type A_TYPES__Entity_JSON = {
+// ============================================================================
+// --------------------------- Primary Types ----------------------------------
+// ============================================================================
+/**
+ * Entity constructor type
+ * Uses the generic type T to specify the type of the entity
+ */
+export type A_TYPES__Entity_Constructor<T = A_Entity> = new (...args: any[]) => T;
+/**
+ * Entity initialization type
+ */
+export type A_TYPES__Entity_Init = any;
+/**
+ * Entity serialized type
+ */
+export type A_TYPES__Entity_Serialized = {
     /**
      * The ASEID of the entity
      */
@@ -43,11 +39,14 @@ export type A_TYPES__Entity_JSON = {
 
 
 
-
-
+// ============================================================================
+// --------------------------- Meta Types -------------------------------------
+// ============================================================================
+/**
+ * Entity meta type
+ */
 export type A_TYPES__EntityMeta = {
     [A_TYPES__EntityMetaKey.EXTENSIONS]: A_Meta<{
-
         /**
          * Where Key the regexp for what to apply the extension
          * A set of container names or a wildcard, or a regexp
@@ -55,7 +54,7 @@ export type A_TYPES__EntityMeta = {
          *
          * Where value is the extension instructions
          */
-        [Key: string]: A_TYPES__A_ExtendDecorator_Meta[]
+        [Key: string]: A_TYPES__FeatureExtendDecoratorMeta[]
 
     }>, case
 
@@ -66,15 +65,11 @@ export type A_TYPES__EntityMeta = {
          * 
          * Where value is the list of features
          */
-        [Key: string]: A_TYPES__A_DefineDecorator_Meta
+        [Key: string]: A_TYPES__FeatureDefineDecoratorMeta
     }>
 }
 
-export enum A_TYPES__EntityMetaKey {
-    EXTENSIONS = 'a-component-extensions',
-    FEATURES = 'a-component-features',
-    ABSTRACTIONS = 'a-component-abstractions',
-}
+