@adaas/a-concept 0.2.9 → 0.2.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-concept",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "A-Concept is a framework of the new generation that is tailored to use AI, enabling developers to create AI-powered applications with ease. It provides a structured approach to building, managing, and deploying AI-driven solutions.",
   "license": "Apache-2.0",
   "main": "./dist/node/index.cjs",

package/src/env/env-browser.ts

@@ -2,7 +2,7 @@ import { A_TYPES__ContextEnvironment } from "../global/A-Context/A-Context.types
 import { A_CONCEPT_BASE_ENV } from "./env.base";
 
 
-export class ENV extends A_CONCEPT_BASE_ENV {
+export class A_CONCEPT_ENV extends A_CONCEPT_BASE_ENV {
     static get A_CONCEPT_ENVIRONMENT() {
         return window.__A_CONCEPT_ENVIRONMENT_ENV__?.A_CONCEPT_ENVIRONMENT || super.A_CONCEPT_ENVIRONMENT;
     }
@@ -21,4 +21,13 @@ export class ENV extends A_CONCEPT_BASE_ENV {
     static get A_ERROR_DEFAULT_DESCRIPTION() {
         return window.__A_CONCEPT_ENVIRONMENT_ENV__?.A_ERROR_DEFAULT_DESCRIPTION || super.A_ERROR_DEFAULT_DESCRIPTION;
     }
+    static get(name: string) {
+        return window.__A_CONCEPT_ENVIRONMENT_ENV__?.[name] || (this as typeof A_CONCEPT_ENV)[name as keyof typeof A_CONCEPT_ENV];
+    }
+    static set(name: string, value: string) {
+        if (!window.__A_CONCEPT_ENVIRONMENT_ENV__) {
+            window.__A_CONCEPT_ENVIRONMENT_ENV__ = {};
+        }
+        window.__A_CONCEPT_ENVIRONMENT_ENV__[name] = value;
+    }
 };

package/src/env/env-node.ts

@@ -2,7 +2,7 @@ import { A_CONSTANTS__DEFAULT_ENV_VARIABLES } from "../constants/env.constants";
 import { A_TYPES__ContextEnvironment } from "../global/A-Context/A-Context.types";
 import { A_CONCEPT_BASE_ENV } from "./env.base";
 
-export class ENV extends A_CONCEPT_BASE_ENV {
+export class A_CONCEPT_ENV extends A_CONCEPT_BASE_ENV {
     // ----------------------------------------------------------
     // A-Concept Core Environment Variables
     // ----------------------------------------------------------
@@ -37,8 +37,8 @@ export class ENV extends A_CONCEPT_BASE_ENV {
     /**
      * Runtime environment of the application e.g. browser, node
      */
-    static get A_CONCEPT_RUNTIME_ENVIRONMENT():A_TYPES__ContextEnvironment {
-        return  'server';
+    static get A_CONCEPT_RUNTIME_ENVIRONMENT(): A_TYPES__ContextEnvironment {
+        return 'server';
     }
 
     /**
@@ -46,7 +46,7 @@ export class ENV extends A_CONCEPT_BASE_ENV {
      * [!] Automatically set by A-Concept when the application starts
      */
     static get A_CONCEPT_ROOT_FOLDER() {
-        return process.env[A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_CONCEPT_ROOT_FOLDER] || super.A_CONCEPT_ROOT_FOLDER;
+        return process.env[A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_CONCEPT_ROOT_FOLDER] || process.cwd();
     }
 
     /**
@@ -55,4 +55,12 @@ export class ENV extends A_CONCEPT_BASE_ENV {
     static get A_ERROR_DEFAULT_DESCRIPTION() {
         return process.env[A_CONSTANTS__DEFAULT_ENV_VARIABLES.A_ERROR_DEFAULT_DESCRIPTION] || super.A_ERROR_DEFAULT_DESCRIPTION;
     }
+
+    static get(name: string) {
+        return process.env[name] || (this as A_CONCEPT_ENV)[name as keyof typeof A_CONCEPT_ENV];
+    }
+
+    static set(name: string, value: string): void {
+        process.env[name] = value;
+    }
 } 

package/src/env/env.base.ts

@@ -35,7 +35,7 @@ export class A_CONCEPT_BASE_ENV {
   /**
    * Runtime environment of the application e.g. browser, node
    */
-  static get A_CONCEPT_RUNTIME_ENVIRONMENT():A_TYPES__ContextEnvironment {
+  static get A_CONCEPT_RUNTIME_ENVIRONMENT(): A_TYPES__ContextEnvironment {
     return "unknown";
   }
 
@@ -53,4 +53,24 @@ export class A_CONCEPT_BASE_ENV {
   static get A_ERROR_DEFAULT_DESCRIPTION() {
     return "If you see this error please let us know.";
   }
+
+  /**
+   * Generic getter for environment variables. This allows to access environment variables dynamically by name. It will return undefined if the variable does not exist.
+   * 
+   * @param name 
+   * @returns 
+   */
+  static get(name: string) {
+    return (this as any)[name];
+  }
+  /**
+   * Generic setter for environment variables. This allows to set environment variables dynamically by name.
+   * 
+   * @param name 
+   * @param value 
+   */
+  static set(name: string, value: string) {
+    (this as any)[name] = value;
+  }
+
 } 

package/src/env/global.browser.d.ts

@@ -1,8 +1,15 @@
+import { A_CONSTANTS__DEFAULT_ENV_VARIABLES, A_TYPES__ConceptENVVariables } from "../constants/env.constants";
 import type { RuntimeEnv } from "./env.base";
 
+
+type EnvVariablesType = {
+    [key in keyof typeof A_CONSTANTS__DEFAULT_ENV_VARIABLES]?: string;
+}
+
 declare global {
     interface Window {
-        __A_CONCEPT_ENVIRONMENT_ENV__?: Partial<RuntimeEnv> & {
-        };
+        __A_CONCEPT_ENVIRONMENT_ENV__?: {
+            [key: string]: string
+        } & EnvVariablesType
     }
 }

package/src/env/index.browser.ts

@@ -1 +1 @@
-export { ENV } from "./env-browser";
+export { A_CONCEPT_ENV } from "./env-browser";

package/src/env/index.node.ts

@@ -1 +1 @@
-export { ENV } from "./env-node";
+export { A_CONCEPT_ENV } from "./env-node";

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

@@ -39,7 +39,7 @@ import { A_CommonHelper } from "@adaas/a-concept/helpers/A_Common.helper";
 import { A_TYPES__Fragment_Constructor } from "../A-Fragment/A-Fragment.types";
 import { A_Dependency } from "../A-Dependency/A-Dependency.class";
 import { A_TYPES__Ctor } from "@adaas/a-concept/types/A_Common.types";
-import { ENV } from "@adaas/a-concept/env";
+import { A_CONCEPT_ENV } from "@adaas/a-concept/env";
 
 
 
@@ -53,7 +53,7 @@ export class A_Context {
      * [!] If environment variable is not set, it will default to 'a-concept'
      */
     static get concept() {
-        return ENV.A_CONCEPT_NAME || 'a-concept';
+        return A_CONCEPT_ENV.A_CONCEPT_NAME || 'a-concept';
     }
     /**
      * Root scope of the application from environment variable A_CONCEPT_ROOT_SCOPE
@@ -69,7 +69,7 @@ export class A_Context {
      * [!] Determined by environment variable A_CONCEPT_RUNTIME_ENVIRONMENT that comes from the build tool or is set manually in the environment.
      */
     static get environment(): A_TYPES__ContextEnvironment {
-        return ENV.A_CONCEPT_RUNTIME_ENVIRONMENT
+        return A_CONCEPT_ENV.A_CONCEPT_RUNTIME_ENVIRONMENT
     }
 
     /**
@@ -121,7 +121,7 @@ export class A_Context {
      * [!] This class should not be instantiated directly. Use A_Context.getInstance() instead.
      */
     private constructor() {
-        const name = String(ENV.A_CONCEPT_ROOT_SCOPE) || 'root';
+        const name = String(A_CONCEPT_ENV.A_CONCEPT_ROOT_SCOPE) || 'root';
 
         this._root = new A_Scope({ name });
     }
@@ -1049,7 +1049,7 @@ export class A_Context {
 
         instance._registry = new WeakMap();
 
-        const name = String(ENV.A_CONCEPT_ROOT_SCOPE) || 'root';
+        const name = String(A_CONCEPT_ENV.A_CONCEPT_ROOT_SCOPE) || 'root';
 
         instance._root = new A_Scope({ name });
     }

package/src/global/A-Error/A_Error.class.ts

@@ -10,7 +10,7 @@ import { A_FormatterHelper } from '@adaas/a-concept/helpers/A_Formatter.helper';
 import { A_Context } from '../A-Context/A-Context.class';
 import { A_TypeGuards } from '@adaas/a-concept/helpers/A_TypeGuards.helper';
 import { ASEID } from '../ASEID/ASEID.class';
-import { ENV } from '@adaas/a-concept/env';
+import { A_CONCEPT_ENV } from '@adaas/a-concept/env';
 
 
 export class A_Error<
@@ -286,7 +286,7 @@ export class A_Error<
      * [!] Note: This description is intended to provide more context about the error and can be used for debugging or logging purposes
      */
     get description(): string {
-        return this._description || String(ENV.A_ERROR_DEFAULT_DESCRIPTION) || A_CONSTANTS__ERROR_DESCRIPTION;
+        return this._description || String(A_CONCEPT_ENV.A_ERROR_DEFAULT_DESCRIPTION) || A_CONSTANTS__ERROR_DESCRIPTION;
     }
     /**
      * Returns the original error if any