@adaas/a-concept 0.1.45 → 0.1.47

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-concept",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "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.",
   "license": "Apache-2.0",
   "main": "./dist/index.cjs",

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

@@ -8,7 +8,7 @@ import { A_Scope } from "../A-Scope/A-Scope.class";
 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_EntityError } from "./A-Entity.error";
 import { A_Feature } from "../A-Feature/A-Feature.class";
 
 
@@ -236,7 +236,7 @@ export class A_Entity<
         }
 
         // none of the above -> throw consistent error
-        throw new A_Entity_Error(A_Entity_Error.ValidationError, 'Unable to determine A-Entity constructor initialization method. Please check the provided parameters.');
+        throw new A_EntityError(A_EntityError.ValidationError, 'Unable to determine A-Entity constructor initialization method. Please check the provided parameters.');
     }
 
 

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

@@ -2,7 +2,7 @@ import { A_Error } from "../A-Error/A_Error.class";
 
 
 
-export class A_Entity_Error extends A_Error {
+export class A_EntityError extends A_Error {
 
     /**
      * Error code for validation errors.

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

@@ -184,14 +184,14 @@ export class A_Scope<
         /**
          * A set of constructors that are allowed in the scope
          */
-        params: Partial<A_TYPES__Scope_Init<_ComponentType, _ErrorType, _EntityType, _FragmentType>>,
+        params: Partial<A_TYPES__Scope_Init<_MetaItems, _ComponentType, _ErrorType, _EntityType, _FragmentType>>,
         /**
          * Configuration options for the scope
          */
         config?: Partial<A_TYPES__ScopeConfig>
     )
     constructor(
-        param1?: Partial<A_TYPES__Scope_Init<_ComponentType, _ErrorType, _EntityType, _FragmentType>>,
+        param1?: Partial<A_TYPES__Scope_Init<_MetaItems, _ComponentType, _ErrorType, _EntityType, _FragmentType>>,
         param2?: Partial<A_TYPES__ScopeConfig>
     ) {
         const initializer = this.getInitializer(param1);
@@ -209,7 +209,7 @@ export class A_Scope<
      * @returns
      */
     protected getInitializer(
-        param1?: Partial<A_TYPES__Scope_Init<_ComponentType, _ErrorType, _EntityType, _FragmentType>>,
+        param1?: Partial<A_TYPES__Scope_Init<_MetaItems, _ComponentType, _ErrorType, _EntityType, _FragmentType>>,
         param2?: Partial<A_TYPES__ScopeConfig>
     ): (param1: any, param2: any) => void | (() => void) {
         switch (true) {
@@ -226,7 +226,7 @@ export class A_Scope<
 
 
     protected defaultInitialized(
-        params: Partial<A_TYPES__Scope_Init<_ComponentType, _ErrorType, _EntityType, _FragmentType>> = {},
+        params: Partial<A_TYPES__Scope_Init<_MetaItems, _ComponentType, _ErrorType, _EntityType, _FragmentType>> = {},
         config: Partial<A_TYPES__ScopeConfig> = {}
     ) {
         this._name = params.name || this.constructor.name
@@ -235,6 +235,7 @@ export class A_Scope<
         this.initErrors(params.errors);
         this.initFragments(params.fragments);
         this.initEntities(params.entities);
+        this.initMeta(params.meta);
 
         if (config.parent) {
             this._parent = config.parent;
@@ -282,6 +283,20 @@ export class A_Scope<
      * @param _fragments 
      */
     protected initFragments(_fragments?: _FragmentType) { _fragments?.forEach(this.register.bind(this)); }
+    /**
+     * This method is used to initialize the meta in the scope
+     * 
+     * This method only sets the meta values in the scope in case they are not set yet
+     * 
+     * @param _meta 
+     */
+    protected initMeta(_meta?: Partial<_MetaItems>) {
+        if (_meta) {
+            Object.entries(_meta).forEach(([key, value]) => {
+                this._meta.set(key as keyof _MetaItems, value as _MetaItems[keyof _MetaItems]);
+            });
+        }
+    }
 
 
     // ==========================================================================
@@ -324,7 +339,7 @@ export class A_Scope<
      * }
      * ```
      */
-    get(param: keyof _MetaItems): _MetaItems[typeof param] | undefined {
+    get<K extends keyof _MetaItems>(param: K): _MetaItems[K] | undefined {
         return this._meta.get(param);
     }
 
@@ -340,7 +355,7 @@ export class A_Scope<
      * scope.set('role', 'admin');
      * ```
      */
-    set(param: keyof _MetaItems, value: _MetaItems[typeof param]): void {
+    set<K extends keyof _MetaItems>(param: K, value: _MetaItems[K]): void {
         this._meta.set(param, value);
     }
 
@@ -1537,5 +1552,4 @@ export class A_Scope<
 
         console.log(chain.join(' -> '));
     }
-}
-
+}

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

@@ -25,6 +25,7 @@ export type A_TYPES__Scope_Constructor<T = A_Scope> = new (...args: any[]) => T;
  * Scope initialization type
  */
 export type A_TYPES__Scope_Init<
+    _MetaItems extends Record<string, any> = any,
     _ComponentType extends A_TYPES__Component_Constructor[] = A_TYPES__Component_Constructor[],
     _ErrorType extends A_TYPES__Error_Constructor[] = A_TYPES__Error_Constructor[],
     _EntityType extends A_TYPES__Entity_Constructor[] = A_TYPES__Entity_Constructor[],
@@ -54,6 +55,8 @@ export type A_TYPES__Scope_Init<
         ..._EntityType,
         ...InstanceType<_EntityType[number]>[]
     ];
+
+    meta: Partial<_MetaItems>;
 };
 /**
  * Scope configuration type

package/src/index.ts

@@ -6,27 +6,35 @@ export * from './types/A_Common.types';
 
 // ---------------------- Major Components ----------------------
 export { A_Context } from './global/A-Context/A-Context.class';
+export { A_ContextError } from './global/A-Context/A-Context.error';
 export * from './global/A-Context/A-Context.types';
 
 export { A_Concept } from './global/A-Concept/A-Concept.class';
 export { A_ConceptMeta } from './global/A-Concept/A-Concept.meta';
 export * from './global/A-Concept/A-Concept.types';
+export * from './global/A-Concept/A-Concept.constants';
 
 export { A_Container } from './global/A-Container/A-Container.class';
 export { A_ContainerMeta } from './global/A-Container/A-Container.meta';
 export * from './global/A-Container/A-Container.types';
+export * from './global/A-Container/A-Container.constants';
 
 export { A_Component } from './global/A-Component/A-Component.class';
 export { A_ComponentMeta } from './global/A-Component/A-Component.meta';
 export * from './global/A-Component/A-Component.types';
+export * from './global/A-Component/A-Component.constants';
 
 export { A_Entity } from './global/A-Entity/A-Entity.class';
+export { A_EntityError } from './global/A-Entity/A-Entity.error';
+export { A_EntityMeta } from './global/A-Entity/A-Entity.meta';
 export * from './global/A-Entity/A-Entity.types';
+export * from './global/A-Entity/A-Entity.constants';
 
 
 // ---------------------- Common Components ----------------------
 export { A_Abstraction } from './global/A-Abstraction/A-Abstraction.class';
 export { A_AbstractionError } from './global/A-Abstraction/A-Abstraction.error';
+export { A_Abstraction_Extend } from './global/A-Abstraction/A-Abstraction-Extend.decorator';
 export * from './global/A-Abstraction/A-Abstraction.types';
 
 export { A_Caller } from './global/A-Caller/A_Caller.class';
@@ -35,13 +43,17 @@ export * from './global/A-Caller/A_Caller.types';
 
 export { A_Error } from './global/A-Error/A_Error.class';
 export * from './global/A-Error/A_Error.types';
+export * from './global/A-Error/A_Error.constants';
 
 export { ASEID } from './global/ASEID/ASEID.class';
 export { ASEID_Error } from './global/ASEID/ASEID.error';
 export * from './global/ASEID/ASEID.types';
+// export * from './global/ASEID/ASEID.constants';
 
 export { A_Feature } from './global/A-Feature/A-Feature.class';
 export { A_FeatureError } from './global/A-Feature/A-Feature.error';
+export { A_Feature_Define } from './global/A-Feature/A-Feature-Define.decorator';
+export { A_Feature_Extend } from './global/A-Feature/A-Feature-Extend.decorator';
 export * from './global/A-Feature/A-Feature.types';
 
 export { A_Stage } from './global/A-Stage/A-Stage.class';
@@ -60,20 +72,14 @@ export * from './global/A-Fragment/A-Fragment.types';
 
 export { A_Dependency } from './global/A-Dependency/A-Dependency.class';
 export { A_DependencyError } from './global/A-Dependency/A-Dependency.error';
+export { A_Dependency_Require } from './global/A-Dependency/A-Dependency-Require.decorator';
+export { A_Dependency_Load } from './global/A-Dependency/A-Dependency-Load.decorator';
+export { A_Dependency_Default } from './global/A-Dependency/A-Dependency-Default.decorator';
 export * from './global/A-Dependency/A-Dependency.types';
 
-
-// =================================================================================================
-// =============================== Export Decorators ===============================================
-// =================================================================================================
+export { A_InjectError } from './global/A-Inject/A-Inject.error';
 export { A_Inject } from './global/A-Inject/A-Inject.decorator';
 export * from './global/A-Inject/A-Inject.types';
-export { A_Feature_Define } from './global/A-Feature/A-Feature-Define.decorator';
-export { A_Feature_Extend } from './global/A-Feature/A-Feature-Extend.decorator';
-export { A_Abstraction_Extend } from './global/A-Abstraction/A-Abstraction-Extend.decorator';
-export { A_Dependency_Require } from './global/A-Dependency/A-Dependency-Require.decorator';
-export { A_Dependency_Load } from './global/A-Dependency/A-Dependency-Load.decorator';
-export { A_Dependency_Default } from './global/A-Dependency/A-Dependency-Default.decorator';
 
 
 // =================================================================================================

package/tests/A-Scope.test.ts

@@ -47,6 +47,33 @@ describe('A-Scope tests', () => {
         expect(userId).toBe('12345');
         expect(role).toBe('admin');
     });
+    it('Should be possible to set meta via constructor', async () => {
+        const scope = new A_Scope<{ userId: string, role: string }>({
+            name: 'TestScope',
+            meta: {
+                userId: '12345',
+                role: 'admin'
+            }
+        });
+
+        const userId = scope.get('userId');
+        const role = scope.get('role');
+
+        expect(userId).toBe('12345');
+        expect(role).toBe('admin');
+    });
+    it('Should properly use types and generics', async () => {
+        const scope = new A_Scope<{ userId: string, role: { name: string } }>({ name: 'TestScope' });
+
+        scope.set('userId', '12345');
+        scope.set('role', { name: 'admin' });
+
+        const userId = scope.get('userId');
+        const role = scope.get('role');
+
+        expect(userId).toBe('12345');
+        expect(role).toEqual({ name: 'admin' });
+    });
     it('Should allow to register and resolve a component with dependencies', async () => {
         class DependentComponent extends A_Component {
             constructor(