@adaas/a-concept 0.3.1 → 0.3.3

package/dist/node/index.cjs

@@ -507,7 +507,7 @@ var A_CONCEPT_BASE_ENV = class {
    * Environment of the application e.g. development, production, staging
    */
   static get A_CONCEPT_ENVIRONMENT() {
-    return "production";
+    return "development";
   }
   /**
    * Runtime environment of the application e.g. browser, node
@@ -1258,6 +1258,17 @@ var A_Meta = class _A_Meta {
     this.meta = new Map(meta.meta);
     return this;
   }
+  /**
+   * Allows to create a copy of the meta object with the same values, this is needed to ensure that when we inherit meta from the parent component, we create a copy of it, not a reference to the same object. This allows us to modify the meta of the child component without affecting the meta of the parent component.
+   * 
+   * @returns 
+   */
+  clone() {
+    const ctor = this.constructor;
+    const copy = new ctor();
+    copy.meta = new Map(this.meta);
+    return copy;
+  }
   /**
    * Method to set values in the map
    * 
@@ -1369,9 +1380,20 @@ var A_Meta = class _A_Meta {
   clear() {
     this.meta.clear();
   }
+  /**
+   * Method to convert the meta to an array of key-value pairs
+   * 
+   * @returns 
+   */
   toArray() {
     return Array.from(this.meta.entries());
   }
+  /**
+   * Helper method to recursively convert the meta object to a JSON-compatible format. It handles nested A_Meta instances, Maps, Arrays, and plain objects.
+   * 
+   * @param value 
+   * @returns 
+   */
   recursiveToJSON(value) {
     switch (true) {
       case value instanceof _A_Meta:
@@ -2136,6 +2158,49 @@ function A_Dependency_All() {
   };
 }
 
+// src/lib/A-Dependency/A-Dependency-Query.decorator.ts
+function A_Dependency_Query(query, pagination) {
+  return function(target, methodName, parameterIndex) {
+    const componentName = A_CommonHelper.getComponentName(target);
+    if (!A_TypeGuards.isTargetAvailableForInjection(target)) {
+      throw new A_DependencyError(
+        A_DependencyError.InvalidDependencyTarget,
+        `A-All cannot be used on the target of type ${typeof target} (${componentName})`
+      );
+    }
+    const method = methodName ? String(methodName) : "constructor";
+    let metaKey;
+    switch (true) {
+      case (A_TypeGuards.isComponentConstructor(target) || A_TypeGuards.isComponentInstance(target)):
+        metaKey = "a-component-injections" /* INJECTIONS */;
+        break;
+      case A_TypeGuards.isContainerInstance(target):
+        metaKey = "a-container-injections" /* INJECTIONS */;
+        break;
+      case A_TypeGuards.isEntityInstance(target):
+        metaKey = "a-component-injections" /* INJECTIONS */;
+        break;
+    }
+    const existedMeta = A_Context.meta(target).get(metaKey) || new A_Meta();
+    const paramsArray = existedMeta.get(method) || [];
+    paramsArray[parameterIndex].resolutionStrategy = {
+      query: {
+        ...paramsArray[parameterIndex].resolutionStrategy.query,
+        ...query
+      },
+      pagination: {
+        ...paramsArray[parameterIndex].resolutionStrategy.pagination,
+        ...pagination
+      }
+    };
+    existedMeta.set(method, paramsArray);
+    A_Context.meta(target).set(
+      metaKey,
+      existedMeta
+    );
+  };
+}
+
 // src/lib/A-Dependency/A-Dependency.class.ts
 var A_Dependency = class {
   /**
@@ -2215,6 +2280,15 @@ var A_Dependency = class {
   static get All() {
     return A_Dependency_All;
   }
+  /**
+   * Allows to indicate that the dependency should be resolved by specific query parameters
+   * e.g. by ASEID, name, type, custom properties, etc.
+   * 
+   * @returns
+   */
+  static get Query() {
+    return A_Dependency_Query;
+  }
   get flat() {
     return this._resolutionStrategy.flat;
   }
@@ -4072,6 +4146,21 @@ var A_Scope = class {
     return slice.length === 1 && count !== -1 ? slice[0] : slice.length ? slice : void 0;
   }
   resolveConstructor(name) {
+    switch (true) {
+      case A_TypeGuards.isComponentConstructor(name):
+        return Array.from(this.allowedComponents).find((c) => A_CommonHelper.isInheritedFrom(c, name));
+      case A_TypeGuards.isEntityConstructor(name):
+        return Array.from(this.allowedEntities).find((e) => A_CommonHelper.isInheritedFrom(e, name));
+      case A_TypeGuards.isFragmentConstructor(name):
+        return Array.from(this.allowedFragments).find((f) => A_CommonHelper.isInheritedFrom(f, name));
+      case A_TypeGuards.isErrorConstructor(name):
+        return Array.from(this.allowedErrors).find((e) => A_CommonHelper.isInheritedFrom(e, name));
+    }
+    if (!A_TypeGuards.isString(name))
+      throw new A_ScopeError(
+        A_ScopeError.ResolutionError,
+        `Invalid constructor name provided: ${name}`
+      );
     const component = Array.from(this.allowedComponents).find(
       (c) => c.name === name || c.name === A_FormatterHelper.toPascalCase(name)
     );
@@ -4974,7 +5063,7 @@ var A_Context = class _A_Context {
       }
       if (!inheritedMeta)
         inheritedMeta = new metaType();
-      instance._metaStorage.set(property, new metaType().from(inheritedMeta));
+      instance._metaStorage.set(property, inheritedMeta.clone());
     }
     return instance._metaStorage.get(property);
   }
@@ -5006,13 +5095,6 @@ var A_Context = class _A_Context {
     if (!this.isAllowedForScopeAllocation(param1) && !this.isAllowedToBeRegistered(param1))
       throw new A_ContextError(A_ContextError.InvalidScopeParameterError, `Invalid parameter provided to get scope. Component of type ${name} is not allowed for scope allocation.`);
     switch (true) {
-      case this.isAllowedForScopeAllocation(param1):
-        if (!instance._registry.has(param1))
-          throw new A_ContextError(
-            A_ContextError.ScopeNotFoundError,
-            `Invalid parameter provided to get scope. Component of type ${name} does not have a scope allocated. Make sure to allocate a scope using A_Context.allocate() method before trying to get the scope.`
-          );
-        return instance._registry.get(param1);
       case this.isAllowedToBeRegistered(param1):
         if (!instance._scopeStorage.has(param1))
           throw new A_ContextError(
@@ -5020,6 +5102,13 @@ var A_Context = class _A_Context {
             `Invalid parameter provided to get scope. Component of type ${name} does not have a scope registered. Make sure to register the component using A_Context.register() method before trying to get the scope.`
           );
         return instance._scopeStorage.get(param1);
+      case this.isAllowedForScopeAllocation(param1):
+        if (!instance._registry.has(param1))
+          throw new A_ContextError(
+            A_ContextError.ScopeNotFoundError,
+            `Invalid parameter provided to get scope. Component of type ${name} does not have a scope allocated. Make sure to allocate a scope using A_Context.allocate() method before trying to get the scope.`
+          );
+        return instance._registry.get(param1);
       default:
         throw new A_ContextError(A_ContextError.InvalidScopeParameterError, `Invalid parameter provided to get scope. Component of type ${name} is not allowed to be registered.`);
     }
@@ -5237,7 +5326,7 @@ var A_Context = class _A_Context {
    * @returns 
    */
   static isAllowedForScopeAllocation(param) {
-    return A_TypeGuards.isContainerInstance(param) || A_TypeGuards.isFeatureInstance(param);
+    return A_TypeGuards.isContainerInstance(param) || A_TypeGuards.isFeatureInstance(param) || A_TypeGuards.isEntityInstance(param);
   }
   /**
    * Type guard to check if the param is allowed to be registered in the context.
@@ -5726,6 +5815,7 @@ exports.A_Dependency_Default = A_Dependency_Default;
 exports.A_Dependency_Flat = A_Dependency_Flat;
 exports.A_Dependency_Load = A_Dependency_Load;
 exports.A_Dependency_Parent = A_Dependency_Parent;
+exports.A_Dependency_Query = A_Dependency_Query;
 exports.A_Dependency_Require = A_Dependency_Require;
 exports.A_Entity = A_Entity;
 exports.A_EntityError = A_EntityError;