@adaas/a-utils 0.2.7 → 0.2.9

package/dist/node/lib/A-Memory/A-Memory.component.mjs

@@ -0,0 +1,325 @@
+import { __decorateClass, __decorateParam } from '../../chunk-EQQGB2QZ.mjs';
+import { A_Component, A_Context, A_Scope, A_Feature, A_Inject, A_Dependency } from '@adaas/a-concept';
+import { A_MemoryFeatures } from './A-Memory.constants';
+import { A_MemoryContext } from './A-Memory.context';
+import { A_MemoryError } from './A-Memory.error';
+import { A_OperationContext } from '@adaas/a-utils/a-operation';
+import { A_Frame } from '@adaas/a-frame';
+
+var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+let A_Memory = class extends A_Component {
+  get ready() {
+    if (!this._ready) {
+      this._ready = this.init();
+    }
+    return this._ready;
+  }
+  /**
+   * Handles errors during memory operations
+   */
+  async [_i = A_MemoryFeatures.onError](...args) {
+  }
+  /**
+   * Handles memory expiration
+   */
+  async [_h = A_MemoryFeatures.onExpire](...args) {
+  }
+  /**
+   * Initializes the memory context
+   */
+  async [_g = A_MemoryFeatures.onInit](context, ...args) {
+    if (!context) {
+      context = new A_MemoryContext();
+      A_Context.scope(this).register(context);
+    }
+  }
+  async [_f = A_MemoryFeatures.onDestroy](context, ...args) {
+    context.clear();
+  }
+  async [_e = A_MemoryFeatures.onGet](operation, context, ...args) {
+    operation.succeed(context.get(operation.params.key));
+  }
+  /**
+   * Handles the 'has' operation for checking existence of a key in memory
+   */
+  async [_d = A_MemoryFeatures.onHas](operation, context, ...args) {
+    operation.succeed(context.has(operation.params.key));
+  }
+  /**
+   * Handles the 'set' operation for saving a value in memory
+   */
+  async [_c = A_MemoryFeatures.onSet](operation, context, scope, ...args) {
+    context.set(operation.params.key, operation.params.value);
+  }
+  /**
+   * Handles the 'drop' operation for removing a value from memory
+   */
+  async [_b = A_MemoryFeatures.onDrop](operation, context, ...args) {
+    context.delete(operation.params.key);
+  }
+  /**
+   * Handles the 'clear' operation for clearing all values from memory
+   */
+  async [_a = A_MemoryFeatures.onClear](operation, context, ...args) {
+    context.clear();
+  }
+  // ======================================================================
+  // =========================A-Memory Methods=============================
+  // ======================================================================
+  /**
+   * Initializes the memory context
+   */
+  async init() {
+    if (this._ready)
+      return this._ready;
+    const scope = new A_Scope({ name: "A-Memory-Init-Scope" }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_MemoryFeatures.onInit, scope);
+    } catch (error) {
+      const initError = new A_MemoryError({
+        title: A_MemoryError.MemoryInitializationError,
+        description: "An error occurred during memory initialization",
+        originalError: error
+      });
+      scope.register(initError);
+      await this.call(A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw initError;
+    }
+  }
+  /**
+   * Destroys the memory context
+   *
+   * This method is responsible for cleaning up any resources
+   * used by the memory context and resetting its state.
+   */
+  async destroy() {
+    const scope = new A_Scope({ name: "A-Memory-Destroy-Scope" }).inherit(A_Context.scope(this));
+    try {
+      this._ready = void 0;
+      await this.call(A_MemoryFeatures.onDestroy, scope);
+    } catch (error) {
+      const destroyError = new A_MemoryError({
+        title: A_MemoryError.MemoryDestructionError,
+        description: "An error occurred during memory destruction",
+        originalError: error
+      });
+      scope.register(destroyError);
+      await this.call(A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw destroyError;
+    }
+  }
+  /**
+    * Retrieves a value from the context memory
+    * 
+    * @param key - memory key to retrieve
+    * @returns - value associated with the key or undefined if not found
+    */
+  async get(key) {
+    const operation = new A_OperationContext("get", { key });
+    const scope = new A_Scope({
+      name: "A-Memory-Get-Operation-Scope",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_MemoryFeatures.onGet, scope);
+      scope.destroy();
+      return operation.result;
+    } catch (error) {
+      const getError = new A_MemoryError({
+        title: A_MemoryError.MemoryGetError,
+        description: `An error occurred while getting the value for key "${String(key)}"`,
+        originalError: error
+      });
+      scope.register(getError);
+      await this.call(A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw getError;
+    }
+  }
+  /**
+   * Checks if a value exists in the context memory
+   * 
+   * @param key - memory key to check
+   * @returns - true if key exists, false otherwise
+   */
+  async has(key) {
+    const operation = new A_OperationContext("has", { key });
+    const scope = new A_Scope({
+      name: "A-Memory-Has-Operation-Scope",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_MemoryFeatures.onHas, scope);
+      scope.destroy();
+      return operation.result;
+    } catch (error) {
+      const getError = new A_MemoryError({
+        title: A_MemoryError.MemoryHasError,
+        description: `An error occurred while checking existence for key "${String(key)}"`,
+        originalError: error
+      });
+      scope.register(getError);
+      await this.call(A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw getError;
+    }
+  }
+  /**
+   * Saves a value in the context memory
+   * 
+   * @param key 
+   * @param value 
+   */
+  async set(key, value) {
+    const operation = new A_OperationContext("set", { key, value });
+    const scope = new A_Scope({
+      name: "A-Memory-Set-Operation-Scope",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_MemoryFeatures.onSet, scope);
+    } catch (error) {
+      const setError = new A_MemoryError({
+        title: A_MemoryError.MemorySetError,
+        description: `An error occurred while setting the value for key "${String(key)}"`,
+        originalError: error
+      });
+      scope.register(setError);
+      await this.call(A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw setError;
+    }
+  }
+  /**
+   * Removes a value from the context memory by key
+   * 
+   * @param key 
+   */
+  async drop(key) {
+    const operation = new A_OperationContext("drop", { key });
+    const scope = new A_Scope({
+      name: "A-Memory-Drop-Operation-Scope",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_MemoryFeatures.onDrop, scope);
+    } catch (error) {
+      const dropError = new A_MemoryError({
+        title: A_MemoryError.MemoryDropError,
+        description: `An error occurred while dropping the value for key "${String(key)}"`,
+        originalError: error
+      });
+      scope.register(dropError);
+      await this.call(A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw dropError;
+    }
+  }
+  /**
+   * Clears all stored values in the context memory
+   */
+  async clear() {
+    const operation = new A_OperationContext("clear");
+    const scope = new A_Scope({
+      name: "A-Memory-Clear-Operation-Scope",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_MemoryFeatures.onClear, scope);
+    } catch (error) {
+      const clearError = new A_MemoryError({
+        title: A_MemoryError.MemoryClearError,
+        description: `An error occurred while clearing the memory`,
+        originalError: error
+      });
+      scope.register(clearError);
+      await this.call(A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw clearError;
+    }
+  }
+  /**
+   * Serializes the memory context to a JSON object
+   *  
+   * @returns - serialized memory object 
+   */
+  async toJSON() {
+    const operation = new A_OperationContext("serialize");
+    const scope = new A_Scope({
+      name: "A-Memory-Serialize-Operation-Scope",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_MemoryFeatures.onSerialize, scope);
+      return operation.result;
+    } catch (error) {
+      const serializeError = new A_MemoryError({
+        title: A_MemoryError.MemorySerializeError,
+        description: `An error occurred while serializing the memory`,
+        originalError: error
+      });
+      scope.register(serializeError);
+      await this.call(A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw serializeError;
+    }
+  }
+};
+__decorateClass([
+  A_Feature.Extend()
+], A_Memory.prototype, _i, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Memory.prototype, _h, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_MemoryContext))
+], A_Memory.prototype, _g, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_MemoryContext))
+], A_Memory.prototype, _f, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Dependency.Required()),
+  __decorateParam(0, A_Inject(A_OperationContext)),
+  __decorateParam(1, A_Inject(A_MemoryContext))
+], A_Memory.prototype, _e, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Dependency.Required()),
+  __decorateParam(0, A_Inject(A_OperationContext)),
+  __decorateParam(1, A_Inject(A_MemoryContext))
+], A_Memory.prototype, _d, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Dependency.Required()),
+  __decorateParam(0, A_Inject(A_OperationContext)),
+  __decorateParam(1, A_Inject(A_MemoryContext)),
+  __decorateParam(2, A_Inject(A_Scope))
+], A_Memory.prototype, _c, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Dependency.Required()),
+  __decorateParam(0, A_Inject(A_OperationContext)),
+  __decorateParam(1, A_Inject(A_MemoryContext))
+], A_Memory.prototype, _b, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Dependency.Required()),
+  __decorateParam(0, A_Inject(A_OperationContext)),
+  __decorateParam(1, A_Inject(A_MemoryContext))
+], A_Memory.prototype, _a, 1);
+A_Memory = __decorateClass([
+  A_Frame.Component({
+    namespace: "A-Utils",
+    name: "A-Memory",
+    description: "In-memory data storage component that provides a simple key-value store with asynchronous operations. It supports basic memory operations such as get, set, has, drop, and clear, along with lifecycle management and error handling features. This components features can be extended with other components to provide ability store data across multiple storage, or extract data from multiple external sources. Good example is to store some runtime data that needs to be shared across multiple containers or concepts."
+  })
+], A_Memory);
+
+export { A_Memory };
+//# sourceMappingURL=A-Memory.component.mjs.map
+//# sourceMappingURL=A-Memory.component.mjs.map

package/dist/node/lib/A-Memory/A-Memory.component.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Memory/A-Memory.component.ts"],"names":[],"mappings":"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","file":"A-Memory.component.mjs","sourcesContent":["import { A_Component, A_Inject, A_Scope, A_Feature, A_Dependency, A_Context } from \"@adaas/a-concept\";\nimport { A_MemoryFeatures } from \"./A-Memory.constants\";\nimport { A_MemoryContext } from \"./A-Memory.context\";\nimport { A_MemoryError } from \"./A-Memory.error\";\nimport { A_OperationContext } from \"@adaas/a-utils/a-operation\";\nimport { A_MemoryOperationContext } from \"./A-Memory.types\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n\n\n@A_Frame.Component({\n    namespace: 'A-Utils',\n    name: 'A-Memory',\n    description: 'In-memory data storage component that provides a simple key-value store with asynchronous operations. It supports basic memory operations such as get, set, has, drop, and clear, along with lifecycle management and error handling features. This components features can be extended with other components to provide ability store data across multiple storage, or extract data from multiple external sources. Good example is to store some runtime data that needs to be shared across multiple containers or concepts.'\n})\nexport class A_Memory<\n    _StorageType extends Record<string, any> = Record<string, any>,\n    _SerializedType extends Record<string, any> = Record<string, any>\n> extends A_Component {\n\n    protected _ready?: Promise<void>\n\n\n    get ready(): Promise<void> {\n        if (!this._ready) {\n            this._ready = this.init();\n        }\n        return this._ready;\n    }\n\n    // ======================================================================\n    // ======================A-Memory Lifecycle Hooks========================\n    // ======================================================================\n\n    @A_Feature.Extend()\n    /**\n     * Handles errors during memory operations\n     */\n    async [A_MemoryFeatures.onError](...args: any[]): Promise<void> {\n        // Handle error\n    }\n\n    @A_Feature.Extend()\n    /**\n     * Handles memory expiration\n     */\n    async [A_MemoryFeatures.onExpire](...args: any[]): Promise<void> {\n        // Clear memory on expire\n    }\n\n    @A_Feature.Extend()\n    /**\n     * Initializes the memory context\n     */\n    async [A_MemoryFeatures.onInit](\n        @A_Inject(A_MemoryContext) context: A_MemoryContext<_StorageType>,\n        ...args: any[]\n    ): Promise<void> {\n        // Initialize memory\n        if (!context) {\n            context = new A_MemoryContext<_StorageType>();\n            A_Context.scope(this).register(context);\n        }\n    }\n\n    @A_Feature.Extend()\n    async [A_MemoryFeatures.onDestroy](\n        @A_Inject(A_MemoryContext) context: A_MemoryContext<_StorageType>,\n        ...args: any[]): Promise<void> {\n        // Cleanup memory\n        context.clear();\n    }\n\n    /**\n     * Handles the 'get' operation for retrieving a value from memory\n     */\n    @A_Feature.Extend()\n    async [A_MemoryFeatures.onGet](\n        @A_Dependency.Required()\n        @A_Inject(A_OperationContext) operation: A_MemoryOperationContext,\n        @A_Inject(A_MemoryContext) context: A_MemoryContext<_StorageType>,\n        ...args: any[]\n    ): Promise<void> {\n        // Handle get operation\n        operation.succeed(context.get(operation.params.key));\n    }\n\n    @A_Feature.Extend()\n    /**\n     * Handles the 'has' operation for checking existence of a key in memory\n     */\n    async [A_MemoryFeatures.onHas](\n        @A_Dependency.Required()\n        @A_Inject(A_OperationContext) operation: A_MemoryOperationContext<boolean>,\n        @A_Inject(A_MemoryContext) context: A_MemoryContext<_StorageType>,\n        ...args: any[]\n    ): Promise<void> {\n        // Handle has operation\n        operation.succeed(context.has(operation.params.key));\n    }\n\n    @A_Feature.Extend()\n    /**\n     * Handles the 'set' operation for saving a value in memory\n     */\n    async [A_MemoryFeatures.onSet](\n        @A_Dependency.Required()\n        @A_Inject(A_OperationContext) operation: A_MemoryOperationContext,\n        @A_Inject(A_MemoryContext) context: A_MemoryContext<_StorageType>,\n        @A_Inject(A_Scope) scope: A_Scope,\n        ...args: any[]\n    ): Promise<void> {\n        // Handle set operation\n        context.set(operation.params.key, operation.params.value);\n    }\n\n    @A_Feature.Extend()\n    /**\n     * Handles the 'drop' operation for removing a value from memory\n     */\n    async [A_MemoryFeatures.onDrop](\n        @A_Dependency.Required()\n        @A_Inject(A_OperationContext) operation: A_MemoryOperationContext,\n        @A_Inject(A_MemoryContext) context: A_MemoryContext<_StorageType>,\n        ...args: any[]\n    ): Promise<void> {\n        // Handle drop operation\n        context.delete(operation.params.key);\n    }\n\n    @A_Feature.Extend()\n    /**\n     * Handles the 'clear' operation for clearing all values from memory\n     */\n    async [A_MemoryFeatures.onClear](\n        @A_Dependency.Required()\n        @A_Inject(A_OperationContext) operation: A_MemoryOperationContext,\n        @A_Inject(A_MemoryContext) context: A_MemoryContext<_StorageType>,\n        ...args: any[]\n    ): Promise<void> {\n        // Handle clear operation\n        context.clear();\n    }\n\n\n\n    // ======================================================================\n    // =========================A-Memory Methods=============================\n    // ======================================================================\n\n    /**\n     * Initializes the memory context\n     */\n    async init() {\n        if (this._ready)\n            return this._ready;\n\n        const scope = new A_Scope({ name: 'A-Memory-Init-Scope' })\n            .inherit(A_Context.scope(this));\n\n        try {\n            await this.call(A_MemoryFeatures.onInit, scope);\n\n        } catch (error) {\n            const initError = new A_MemoryError({\n                title: A_MemoryError.MemoryInitializationError,\n                description: 'An error occurred during memory initialization',\n                originalError: error\n            })\n\n            scope.register(initError);\n\n            await this.call(A_MemoryFeatures.onError, scope);\n\n            scope.destroy();\n\n            throw initError;\n        }\n    }\n\n    /**\n     * Destroys the memory context\n     *\n     * This method is responsible for cleaning up any resources\n     * used by the memory context and resetting its state.\n     */\n    async destroy() {\n\n        const scope = new A_Scope({ name: 'A-Memory-Destroy-Scope' })\n            .inherit(A_Context.scope(this));\n\n        try {\n            this._ready = undefined;\n\n            await this.call(A_MemoryFeatures.onDestroy, scope);\n\n        } catch (error) {\n            const destroyError = new A_MemoryError({\n                title: A_MemoryError.MemoryDestructionError,\n                description: 'An error occurred during memory destruction',\n                originalError: error\n            })\n\n            scope.register(destroyError);\n\n\n            await this.call(A_MemoryFeatures.onError, scope);\n\n            scope.destroy();\n\n            throw destroyError;\n        }\n    }\n\n    /**\n      * Retrieves a value from the context memory\n      * \n      * @param key - memory key to retrieve\n      * @returns - value associated with the key or undefined if not found\n      */\n    async get<K extends keyof _StorageType>(\n        /**\n         * Key to retrieve the value for\n         */\n        key: K\n    ): Promise<_StorageType[K] | undefined> {\n\n        const operation = new A_OperationContext('get', { key });\n\n        const scope = new A_Scope({\n            name: 'A-Memory-Get-Operation-Scope',\n            fragments: [operation]\n        })\n            .inherit(A_Context.scope(this));\n\n        try {\n\n            await this.call(A_MemoryFeatures.onGet, scope);\n\n            scope.destroy();\n\n            return operation.result;\n\n        } catch (error) {\n            const getError = new A_MemoryError({\n                title: A_MemoryError.MemoryGetError,\n                description: `An error occurred while getting the value for key \"${String(key)}\"`,\n                originalError: error\n            });\n\n            scope.register(getError);\n\n            await this.call(A_MemoryFeatures.onError, scope);\n\n            scope.destroy();\n\n            throw getError;\n        }\n    }\n\n    /**\n     * Checks if a value exists in the context memory\n     * \n     * @param key - memory key to check\n     * @returns - true if key exists, false otherwise\n     */\n    async has(key: keyof _StorageType): Promise<boolean> {\n        const operation = new A_OperationContext('has', { key });\n\n        const scope = new A_Scope({\n            name: 'A-Memory-Has-Operation-Scope',\n            fragments: [operation]\n        })\n            .inherit(A_Context.scope(this));\n\n        try {\n\n            await this.call(A_MemoryFeatures.onHas, scope);\n\n            scope.destroy();\n\n            return operation.result;\n\n        } catch (error) {\n            const getError = new A_MemoryError({\n                title: A_MemoryError.MemoryHasError,\n                description: `An error occurred while checking existence for key \"${String(key)}\"`,\n                originalError: error\n            });\n\n            scope.register(getError);\n\n            await this.call(A_MemoryFeatures.onError, scope);\n\n            scope.destroy();\n\n            throw getError;\n        }\n    }\n\n    /**\n     * Saves a value in the context memory\n     * \n     * @param key \n     * @param value \n     */\n    async set<K extends keyof _StorageType>(\n        /**\n         * Key to save the value under\n         */\n        key: K,\n        /**\n         * Value to save\n         */\n        value: _StorageType[K]\n    ): Promise<void> {\n        const operation = new A_OperationContext('set', { key, value });\n\n        const scope = new A_Scope({\n            name: 'A-Memory-Set-Operation-Scope',\n            fragments: [operation]\n        })\n            .inherit(A_Context.scope(this));\n\n        try {\n\n            await this.call(A_MemoryFeatures.onSet, scope);\n\n        } catch (error) {\n            const setError = new A_MemoryError({\n                title: A_MemoryError.MemorySetError,\n                description: `An error occurred while setting the value for key \"${String(key)}\"`,\n                originalError: error\n            });\n\n            scope.register(setError);\n\n            await this.call(A_MemoryFeatures.onError, scope);\n\n            scope.destroy();\n\n            throw setError;\n        }\n    }\n\n\n    /**\n     * Removes a value from the context memory by key\n     * \n     * @param key \n     */\n    async drop(key: keyof _StorageType): Promise<void> {\n\n        const operation = new A_OperationContext('drop', { key });\n\n        const scope = new A_Scope({\n            name: 'A-Memory-Drop-Operation-Scope',\n            fragments: [operation]\n        })\n            .inherit(A_Context.scope(this));\n\n        try {\n\n            await this.call(A_MemoryFeatures.onDrop, scope);\n\n        } catch (error) {\n            const dropError = new A_MemoryError({\n                title: A_MemoryError.MemoryDropError,\n                description: `An error occurred while dropping the value for key \"${String(key)}\"`,\n                originalError: error\n            });\n\n            scope.register(dropError);\n\n            await this.call(A_MemoryFeatures.onError, scope);\n\n            scope.destroy();\n\n            throw dropError;\n        }\n    }\n\n    /**\n     * Clears all stored values in the context memory\n     */\n    async clear(): Promise<void> {\n        const operation = new A_OperationContext('clear');\n\n        const scope = new A_Scope({\n            name: 'A-Memory-Clear-Operation-Scope',\n            fragments: [operation]\n        })\n            .inherit(A_Context.scope(this));\n\n        try {\n\n            await this.call(A_MemoryFeatures.onClear, scope);\n\n        } catch (error) {\n            const clearError = new A_MemoryError({\n                title: A_MemoryError.MemoryClearError,\n                description: `An error occurred while clearing the memory`,\n                originalError: error\n            });\n\n            scope.register(clearError);\n\n            await this.call(A_MemoryFeatures.onError, scope);\n\n            scope.destroy();\n\n            throw clearError;\n        }\n    }\n\n\n    /**\n     * Serializes the memory context to a JSON object\n     *  \n     * @returns - serialized memory object \n     */\n    async toJSON(): Promise<_SerializedType> {\n        const operation = new A_OperationContext('serialize');\n\n        const scope = new A_Scope({\n            name: 'A-Memory-Serialize-Operation-Scope',\n            fragments: [operation]\n        })\n            .inherit(A_Context.scope(this));\n\n        try {\n\n            await this.call(A_MemoryFeatures.onSerialize, scope);\n\n            return operation.result as _SerializedType;\n\n        } catch (error) {\n            const serializeError = new A_MemoryError({\n                title: A_MemoryError.MemorySerializeError,\n                description: `An error occurred while serializing the memory`,\n                originalError: error\n            });\n\n            scope.register(serializeError);\n\n            await this.call(A_MemoryFeatures.onError, scope);\n\n            scope.destroy();\n\n            throw serializeError;\n        }\n\n    }\n}"]}

package/dist/node/lib/A-Memory/A-Memory.constants.d.mts

@@ -0,0 +1,44 @@
+declare enum A_MemoryFeatures {
+    /**
+     * Allows to extend initialization logic and behavior
+     */
+    onInit = "_A_Memory_onInit",
+    /**
+     * Allows to extend destruction logic and behavior
+     */
+    onDestroy = "_A_Memory_onDestroy",
+    /**
+     * Allows to extend expiration logic and behavior
+     */
+    onExpire = "_A_Memory_onExpire",
+    /**
+     * Allows to extend error handling logic and behavior
+     */
+    onError = "_A_Memory_onError",
+    /**
+     * Allows to extend serialization logic and behavior
+     */
+    onSerialize = "_A_Memory_onSerialize",
+    /**
+     * Allows to extend set operation logic and behavior
+     */
+    onSet = "_A_Memory_onSet",
+    /**
+     * Allows to extend get operation logic and behavior
+     */
+    onGet = "_A_Memory_onGet",
+    /**
+     * Allows to extend drop operation logic and behavior
+     */
+    onDrop = "_A_Memory_onDrop",
+    /**
+     * Allows to extend clear operation logic and behavior
+     */
+    onClear = "_A_Memory_onClear",
+    /**
+     * Allows to extend has operation logic and behavior
+     */
+    onHas = "_A_Memory_onHas"
+}
+
+export { A_MemoryFeatures };

package/dist/node/lib/A-Memory/A-Memory.constants.d.ts

@@ -0,0 +1,44 @@
+declare enum A_MemoryFeatures {
+    /**
+     * Allows to extend initialization logic and behavior
+     */
+    onInit = "_A_Memory_onInit",
+    /**
+     * Allows to extend destruction logic and behavior
+     */
+    onDestroy = "_A_Memory_onDestroy",
+    /**
+     * Allows to extend expiration logic and behavior
+     */
+    onExpire = "_A_Memory_onExpire",
+    /**
+     * Allows to extend error handling logic and behavior
+     */
+    onError = "_A_Memory_onError",
+    /**
+     * Allows to extend serialization logic and behavior
+     */
+    onSerialize = "_A_Memory_onSerialize",
+    /**
+     * Allows to extend set operation logic and behavior
+     */
+    onSet = "_A_Memory_onSet",
+    /**
+     * Allows to extend get operation logic and behavior
+     */
+    onGet = "_A_Memory_onGet",
+    /**
+     * Allows to extend drop operation logic and behavior
+     */
+    onDrop = "_A_Memory_onDrop",
+    /**
+     * Allows to extend clear operation logic and behavior
+     */
+    onClear = "_A_Memory_onClear",
+    /**
+     * Allows to extend has operation logic and behavior
+     */
+    onHas = "_A_Memory_onHas"
+}
+
+export { A_MemoryFeatures };

package/dist/node/lib/A-Memory/A-Memory.constants.js

@@ -0,0 +1,19 @@
+'use strict';
+
+var A_MemoryFeatures = /* @__PURE__ */ ((A_MemoryFeatures2) => {
+  A_MemoryFeatures2["onInit"] = "_A_Memory_onInit";
+  A_MemoryFeatures2["onDestroy"] = "_A_Memory_onDestroy";
+  A_MemoryFeatures2["onExpire"] = "_A_Memory_onExpire";
+  A_MemoryFeatures2["onError"] = "_A_Memory_onError";
+  A_MemoryFeatures2["onSerialize"] = "_A_Memory_onSerialize";
+  A_MemoryFeatures2["onSet"] = "_A_Memory_onSet";
+  A_MemoryFeatures2["onGet"] = "_A_Memory_onGet";
+  A_MemoryFeatures2["onDrop"] = "_A_Memory_onDrop";
+  A_MemoryFeatures2["onClear"] = "_A_Memory_onClear";
+  A_MemoryFeatures2["onHas"] = "_A_Memory_onHas";
+  return A_MemoryFeatures2;
+})(A_MemoryFeatures || {});
+
+exports.A_MemoryFeatures = A_MemoryFeatures;
+//# sourceMappingURL=A-Memory.constants.js.map
+//# sourceMappingURL=A-Memory.constants.js.map

package/dist/node/lib/A-Memory/A-Memory.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Memory/A-Memory.constants.ts"],"names":["A_MemoryFeatures"],"mappings":";;AAEO,IAAK,gBAAA,qBAAAA,iBAAAA,KAAL;AAIH,EAAAA,kBAAA,QAAA,CAAA,GAAS,kBAAA;AAKT,EAAAA,kBAAA,WAAA,CAAA,GAAY,qBAAA;AAKZ,EAAAA,kBAAA,UAAA,CAAA,GAAW,oBAAA;AAKX,EAAAA,kBAAA,SAAA,CAAA,GAAU,mBAAA;AAKV,EAAAA,kBAAA,aAAA,CAAA,GAAc,uBAAA;AAKd,EAAAA,kBAAA,OAAA,CAAA,GAAQ,iBAAA;AAIR,EAAAA,kBAAA,OAAA,CAAA,GAAQ,iBAAA;AAIR,EAAAA,kBAAA,QAAA,CAAA,GAAS,kBAAA;AAIT,EAAAA,kBAAA,SAAA,CAAA,GAAU,mBAAA;AAIV,EAAAA,kBAAA,OAAA,CAAA,GAAQ,iBAAA;AA7CA,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA","file":"A-Memory.constants.js","sourcesContent":["\n\nexport enum A_MemoryFeatures {\n    /**\n     * Allows to extend initialization logic and behavior\n     */\n    onInit = '_A_Memory_onInit',\n\n    /**\n     * Allows to extend destruction logic and behavior\n     */\n    onDestroy = '_A_Memory_onDestroy',\n\n    /**\n     * Allows to extend expiration logic and behavior\n     */\n    onExpire = '_A_Memory_onExpire',\n\n    /**\n     * Allows to extend error handling logic and behavior\n     */\n    onError = '_A_Memory_onError',\n\n    /**\n     * Allows to extend serialization logic and behavior\n     */\n    onSerialize = '_A_Memory_onSerialize',\n\n    /**\n     * Allows to extend set operation logic and behavior\n     */\n    onSet = '_A_Memory_onSet',\n    /**\n     * Allows to extend get operation logic and behavior\n     */\n    onGet = '_A_Memory_onGet',\n    /**\n     * Allows to extend drop operation logic and behavior\n     */\n    onDrop = '_A_Memory_onDrop',\n    /**\n     * Allows to extend clear operation logic and behavior\n     */\n    onClear = '_A_Memory_onClear',\n    /**\n     * Allows to extend has operation logic and behavior\n     */\n    onHas = '_A_Memory_onHas',\n}"]}

package/dist/node/lib/A-Memory/A-Memory.constants.mjs

@@ -0,0 +1,19 @@
+import '../../chunk-EQQGB2QZ.mjs';
+
+var A_MemoryFeatures = /* @__PURE__ */ ((A_MemoryFeatures2) => {
+  A_MemoryFeatures2["onInit"] = "_A_Memory_onInit";
+  A_MemoryFeatures2["onDestroy"] = "_A_Memory_onDestroy";
+  A_MemoryFeatures2["onExpire"] = "_A_Memory_onExpire";
+  A_MemoryFeatures2["onError"] = "_A_Memory_onError";
+  A_MemoryFeatures2["onSerialize"] = "_A_Memory_onSerialize";
+  A_MemoryFeatures2["onSet"] = "_A_Memory_onSet";
+  A_MemoryFeatures2["onGet"] = "_A_Memory_onGet";
+  A_MemoryFeatures2["onDrop"] = "_A_Memory_onDrop";
+  A_MemoryFeatures2["onClear"] = "_A_Memory_onClear";
+  A_MemoryFeatures2["onHas"] = "_A_Memory_onHas";
+  return A_MemoryFeatures2;
+})(A_MemoryFeatures || {});
+
+export { A_MemoryFeatures };
+//# sourceMappingURL=A-Memory.constants.mjs.map
+//# sourceMappingURL=A-Memory.constants.mjs.map

package/dist/node/lib/A-Memory/A-Memory.constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Memory/A-Memory.constants.ts"],"names":["A_MemoryFeatures"],"mappings":";;AAEO,IAAK,gBAAA,qBAAAA,iBAAAA,KAAL;AAIH,EAAAA,kBAAA,QAAA,CAAA,GAAS,kBAAA;AAKT,EAAAA,kBAAA,WAAA,CAAA,GAAY,qBAAA;AAKZ,EAAAA,kBAAA,UAAA,CAAA,GAAW,oBAAA;AAKX,EAAAA,kBAAA,SAAA,CAAA,GAAU,mBAAA;AAKV,EAAAA,kBAAA,aAAA,CAAA,GAAc,uBAAA;AAKd,EAAAA,kBAAA,OAAA,CAAA,GAAQ,iBAAA;AAIR,EAAAA,kBAAA,OAAA,CAAA,GAAQ,iBAAA;AAIR,EAAAA,kBAAA,QAAA,CAAA,GAAS,kBAAA;AAIT,EAAAA,kBAAA,SAAA,CAAA,GAAU,mBAAA;AAIV,EAAAA,kBAAA,OAAA,CAAA,GAAQ,iBAAA;AA7CA,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA","file":"A-Memory.constants.mjs","sourcesContent":["\n\nexport enum A_MemoryFeatures {\n    /**\n     * Allows to extend initialization logic and behavior\n     */\n    onInit = '_A_Memory_onInit',\n\n    /**\n     * Allows to extend destruction logic and behavior\n     */\n    onDestroy = '_A_Memory_onDestroy',\n\n    /**\n     * Allows to extend expiration logic and behavior\n     */\n    onExpire = '_A_Memory_onExpire',\n\n    /**\n     * Allows to extend error handling logic and behavior\n     */\n    onError = '_A_Memory_onError',\n\n    /**\n     * Allows to extend serialization logic and behavior\n     */\n    onSerialize = '_A_Memory_onSerialize',\n\n    /**\n     * Allows to extend set operation logic and behavior\n     */\n    onSet = '_A_Memory_onSet',\n    /**\n     * Allows to extend get operation logic and behavior\n     */\n    onGet = '_A_Memory_onGet',\n    /**\n     * Allows to extend drop operation logic and behavior\n     */\n    onDrop = '_A_Memory_onDrop',\n    /**\n     * Allows to extend clear operation logic and behavior\n     */\n    onClear = '_A_Memory_onClear',\n    /**\n     * Allows to extend has operation logic and behavior\n     */\n    onHas = '_A_Memory_onHas',\n}"]}

package/dist/node/lib/A-Memory/A-Memory.context.d.mts

@@ -0,0 +1,12 @@
+import { A_TYPES__Fragment_Serialized, A_Fragment } from '@adaas/a-concept';
+
+declare class A_MemoryContext<_MemoryType extends Record<string, any> = Record<string, any>, _SerializedType extends A_TYPES__Fragment_Serialized = A_TYPES__Fragment_Serialized> extends A_Fragment {
+    protected _storage: Map<keyof _MemoryType, _MemoryType[keyof _MemoryType]>;
+    set<K extends keyof _MemoryType>(param: K, value: _MemoryType[K]): void;
+    get<K extends keyof _MemoryType>(param: K): _MemoryType[K] | undefined;
+    delete<K extends keyof _MemoryType>(param: K): void;
+    has<K extends keyof _MemoryType>(param: K): boolean;
+    clear(): void;
+}
+
+export { A_MemoryContext };

package/dist/node/lib/A-Memory/A-Memory.context.d.ts

@@ -0,0 +1,12 @@
+import { A_TYPES__Fragment_Serialized, A_Fragment } from '@adaas/a-concept';
+
+declare class A_MemoryContext<_MemoryType extends Record<string, any> = Record<string, any>, _SerializedType extends A_TYPES__Fragment_Serialized = A_TYPES__Fragment_Serialized> extends A_Fragment {
+    protected _storage: Map<keyof _MemoryType, _MemoryType[keyof _MemoryType]>;
+    set<K extends keyof _MemoryType>(param: K, value: _MemoryType[K]): void;
+    get<K extends keyof _MemoryType>(param: K): _MemoryType[K] | undefined;
+    delete<K extends keyof _MemoryType>(param: K): void;
+    has<K extends keyof _MemoryType>(param: K): boolean;
+    clear(): void;
+}
+
+export { A_MemoryContext };

package/dist/node/lib/A-Memory/A-Memory.context.js

@@ -0,0 +1,43 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var aFrame = require('@adaas/a-frame');
+
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(result)) || result;
+  return result;
+};
+exports.A_MemoryContext = class A_MemoryContext extends aConcept.A_Fragment {
+  constructor() {
+    super(...arguments);
+    this._storage = /* @__PURE__ */ new Map();
+  }
+  set(param, value) {
+    this._storage.set(param, value);
+  }
+  get(param) {
+    return this._storage.get(param);
+  }
+  delete(param) {
+    this._storage.delete(param);
+  }
+  has(param) {
+    return this._storage.has(param);
+  }
+  clear() {
+    this._storage.clear();
+  }
+};
+exports.A_MemoryContext = __decorateClass([
+  aFrame.A_Frame.Fragment({
+    namespace: "A-Utils",
+    name: "A-MemoryContext",
+    description: "In-memory context fragment that provides a simple key-value store for temporary data storage during application runtime. It allows setting, getting, deleting, and checking the existence of key-value pairs, facilitating quick access to transient data without persistent storage. This context is useful for scenarios where data needs to be shared across different components or operations within the same execution context."
+  })
+], exports.A_MemoryContext);
+//# sourceMappingURL=A-Memory.context.js.map
+//# sourceMappingURL=A-Memory.context.js.map

package/dist/node/lib/A-Memory/A-Memory.context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Memory/A-Memory.context.ts"],"names":["A_MemoryContext","A_Fragment","A_Frame"],"mappings":";;;;;;;;;;;;;AAYaA,uBAAA,GAAN,8BAGGC,mBAAA,CAAW;AAAA,EAHd,WAAA,GAAA;AAAA,IAAA,KAAA,CAAA,GAAA,SAAA,CAAA;AAIH,IAAA,IAAA,CAAU,QAAA,uBAAuE,GAAA,EAAI;AAAA,EAAA;AAAA,EAErF,GAAA,CAAiC,OAAU,KAAA,EAA6B;AACpE,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAA,EAAO,KAAK,CAAA;AAAA,EAClC;AAAA,EAGA,IAAiC,KAAA,EAAsC;AACnE,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAK,CAAA;AAAA,EAClC;AAAA,EAGA,OAAoC,KAAA,EAAgB;AAChD,IAAA,IAAA,CAAK,QAAA,CAAS,OAAO,KAAK,CAAA;AAAA,EAC9B;AAAA,EAGA,IAAiC,KAAA,EAAmB;AAChD,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAK,CAAA;AAAA,EAClC;AAAA,EAEA,KAAA,GAAc;AACV,IAAA,IAAA,CAAK,SAAS,KAAA,EAAM;AAAA,EACxB;AACJ;AA5BaD,uBAAA,GAAN,eAAA,CAAA;AAAA,EALNE,eAAQ,QAAA,CAAS;AAAA,IACd,SAAA,EAAW,SAAA;AAAA,IACX,IAAA,EAAM,iBAAA;AAAA,IACN,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACYF,uBAAA,CAAA","file":"A-Memory.context.js","sourcesContent":["import { A_Error, A_Fragment, A_TYPES__Fragment_Serialized } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { error } from \"console\";\n\n\n\n\n@A_Frame.Fragment({\n    namespace: 'A-Utils',\n    name: 'A-MemoryContext',\n    description: 'In-memory context fragment that provides a simple key-value store for temporary data storage during application runtime. It allows setting, getting, deleting, and checking the existence of key-value pairs, facilitating quick access to transient data without persistent storage. This context is useful for scenarios where data needs to be shared across different components or operations within the same execution context.'\n})\nexport class A_MemoryContext<\n    _MemoryType extends Record<string, any> = Record<string, any>,\n    _SerializedType extends A_TYPES__Fragment_Serialized = A_TYPES__Fragment_Serialized\n> extends A_Fragment {\n    protected _storage: Map<keyof _MemoryType, _MemoryType[keyof _MemoryType]> = new Map();\n\n    set<K extends keyof _MemoryType>(param: K, value: _MemoryType[K]): void {\n        this._storage.set(param, value);\n    }\n\n\n    get<K extends keyof _MemoryType>(param: K): _MemoryType[K] | undefined {\n        return this._storage.get(param);\n    }\n\n\n    delete<K extends keyof _MemoryType>(param: K): void {\n        this._storage.delete(param);\n    }\n\n\n    has<K extends keyof _MemoryType>(param: K): boolean {\n        return this._storage.has(param);\n    }\n\n    clear(): void {\n        this._storage.clear();\n    }\n}"]}

package/dist/node/lib/A-Memory/A-Memory.context.mjs

@@ -0,0 +1,36 @@
+import { __decorateClass } from '../../chunk-EQQGB2QZ.mjs';
+import { A_Fragment } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+
+let A_MemoryContext = class extends A_Fragment {
+  constructor() {
+    super(...arguments);
+    this._storage = /* @__PURE__ */ new Map();
+  }
+  set(param, value) {
+    this._storage.set(param, value);
+  }
+  get(param) {
+    return this._storage.get(param);
+  }
+  delete(param) {
+    this._storage.delete(param);
+  }
+  has(param) {
+    return this._storage.has(param);
+  }
+  clear() {
+    this._storage.clear();
+  }
+};
+A_MemoryContext = __decorateClass([
+  A_Frame.Fragment({
+    namespace: "A-Utils",
+    name: "A-MemoryContext",
+    description: "In-memory context fragment that provides a simple key-value store for temporary data storage during application runtime. It allows setting, getting, deleting, and checking the existence of key-value pairs, facilitating quick access to transient data without persistent storage. This context is useful for scenarios where data needs to be shared across different components or operations within the same execution context."
+  })
+], A_MemoryContext);
+
+export { A_MemoryContext };
+//# sourceMappingURL=A-Memory.context.mjs.map
+//# sourceMappingURL=A-Memory.context.mjs.map

package/dist/node/lib/A-Memory/A-Memory.context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Memory/A-Memory.context.ts"],"names":[],"mappings":";;;;AAYO,IAAM,eAAA,GAAN,cAGG,UAAA,CAAW;AAAA,EAHd,WAAA,GAAA;AAAA,IAAA,KAAA,CAAA,GAAA,SAAA,CAAA;AAIH,IAAA,IAAA,CAAU,QAAA,uBAAuE,GAAA,EAAI;AAAA,EAAA;AAAA,EAErF,GAAA,CAAiC,OAAU,KAAA,EAA6B;AACpE,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAA,EAAO,KAAK,CAAA;AAAA,EAClC;AAAA,EAGA,IAAiC,KAAA,EAAsC;AACnE,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAK,CAAA;AAAA,EAClC;AAAA,EAGA,OAAoC,KAAA,EAAgB;AAChD,IAAA,IAAA,CAAK,QAAA,CAAS,OAAO,KAAK,CAAA;AAAA,EAC9B;AAAA,EAGA,IAAiC,KAAA,EAAmB;AAChD,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAK,CAAA;AAAA,EAClC;AAAA,EAEA,KAAA,GAAc;AACV,IAAA,IAAA,CAAK,SAAS,KAAA,EAAM;AAAA,EACxB;AACJ;AA5Ba,eAAA,GAAN,eAAA,CAAA;AAAA,EALN,QAAQ,QAAA,CAAS;AAAA,IACd,SAAA,EAAW,SAAA;AAAA,IACX,IAAA,EAAM,iBAAA;AAAA,IACN,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACY,eAAA,CAAA","file":"A-Memory.context.mjs","sourcesContent":["import { A_Error, A_Fragment, A_TYPES__Fragment_Serialized } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { error } from \"console\";\n\n\n\n\n@A_Frame.Fragment({\n    namespace: 'A-Utils',\n    name: 'A-MemoryContext',\n    description: 'In-memory context fragment that provides a simple key-value store for temporary data storage during application runtime. It allows setting, getting, deleting, and checking the existence of key-value pairs, facilitating quick access to transient data without persistent storage. This context is useful for scenarios where data needs to be shared across different components or operations within the same execution context.'\n})\nexport class A_MemoryContext<\n    _MemoryType extends Record<string, any> = Record<string, any>,\n    _SerializedType extends A_TYPES__Fragment_Serialized = A_TYPES__Fragment_Serialized\n> extends A_Fragment {\n    protected _storage: Map<keyof _MemoryType, _MemoryType[keyof _MemoryType]> = new Map();\n\n    set<K extends keyof _MemoryType>(param: K, value: _MemoryType[K]): void {\n        this._storage.set(param, value);\n    }\n\n\n    get<K extends keyof _MemoryType>(param: K): _MemoryType[K] | undefined {\n        return this._storage.get(param);\n    }\n\n\n    delete<K extends keyof _MemoryType>(param: K): void {\n        this._storage.delete(param);\n    }\n\n\n    has<K extends keyof _MemoryType>(param: K): boolean {\n        return this._storage.has(param);\n    }\n\n    clear(): void {\n        this._storage.clear();\n    }\n}"]}

package/dist/node/lib/A-Memory/A-Memory.error.d.mts

@@ -0,0 +1,14 @@
+import { A_Error } from '@adaas/a-concept';
+
+declare class A_MemoryError extends A_Error {
+    static readonly MemoryInitializationError = "Memory initialization error";
+    static readonly MemoryDestructionError = "Memory destruction error";
+    static readonly MemoryGetError = "Memory GET operation failed";
+    static readonly MemorySetError = "Memory SET operation failed";
+    static readonly MemoryDropError = "Memory DROP operation failed";
+    static readonly MemoryClearError = "Memory CLEAR operation failed";
+    static readonly MemoryHasError = "Memory HAS operation failed";
+    static readonly MemorySerializeError = "Memory toJSON operation failed";
+}
+
+export { A_MemoryError };