@adaas/a-utils 0.2.8 → 0.3.1

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

@@ -0,0 +1,335 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var AMemory_constants = require('./A-Memory.constants');
+var AMemory_context = require('./A-Memory.context');
+var AMemory_error = require('./A-Memory.error');
+var aOperation = require('@adaas/a-utils/a-operation');
+var aFrame = require('@adaas/a-frame');
+
+var __defProp = Object.defineProperty;
+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 = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+exports.A_Memory = class A_Memory extends aConcept.A_Component {
+  get ready() {
+    if (!this._ready) {
+      this._ready = this.init();
+    }
+    return this._ready;
+  }
+  /**
+   * Handles errors during memory operations
+   */
+  async [_i = AMemory_constants.A_MemoryFeatures.onError](...args) {
+  }
+  /**
+   * Handles memory expiration
+   */
+  async [_h = AMemory_constants.A_MemoryFeatures.onExpire](...args) {
+  }
+  /**
+   * Initializes the memory context
+   */
+  async [_g = AMemory_constants.A_MemoryFeatures.onInit](context, ...args) {
+    if (!context) {
+      context = new AMemory_context.A_MemoryContext();
+      aConcept.A_Context.scope(this).register(context);
+    }
+  }
+  async [_f = AMemory_constants.A_MemoryFeatures.onDestroy](context, ...args) {
+    context.clear();
+  }
+  async [_e = AMemory_constants.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 = AMemory_constants.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 = AMemory_constants.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 = AMemory_constants.A_MemoryFeatures.onDrop](operation, context, ...args) {
+    context.delete(operation.params.key);
+  }
+  /**
+   * Handles the 'clear' operation for clearing all values from memory
+   */
+  async [_a = AMemory_constants.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 aConcept.A_Scope({ name: "A-Memory-Init-Scope" }).inherit(aConcept.A_Context.scope(this));
+    try {
+      await this.call(AMemory_constants.A_MemoryFeatures.onInit, scope);
+    } catch (error) {
+      const initError = new AMemory_error.A_MemoryError({
+        title: AMemory_error.A_MemoryError.MemoryInitializationError,
+        description: "An error occurred during memory initialization",
+        originalError: error
+      });
+      scope.register(initError);
+      await this.call(AMemory_constants.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 aConcept.A_Scope({ name: "A-Memory-Destroy-Scope" }).inherit(aConcept.A_Context.scope(this));
+    try {
+      this._ready = void 0;
+      await this.call(AMemory_constants.A_MemoryFeatures.onDestroy, scope);
+    } catch (error) {
+      const destroyError = new AMemory_error.A_MemoryError({
+        title: AMemory_error.A_MemoryError.MemoryDestructionError,
+        description: "An error occurred during memory destruction",
+        originalError: error
+      });
+      scope.register(destroyError);
+      await this.call(AMemory_constants.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 aOperation.A_OperationContext("get", { key });
+    const scope = new aConcept.A_Scope({
+      name: "A-Memory-Get-Operation-Scope",
+      fragments: [operation]
+    }).inherit(aConcept.A_Context.scope(this));
+    try {
+      await this.call(AMemory_constants.A_MemoryFeatures.onGet, scope);
+      scope.destroy();
+      return operation.result;
+    } catch (error) {
+      const getError = new AMemory_error.A_MemoryError({
+        title: AMemory_error.A_MemoryError.MemoryGetError,
+        description: `An error occurred while getting the value for key "${String(key)}"`,
+        originalError: error
+      });
+      scope.register(getError);
+      await this.call(AMemory_constants.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 aOperation.A_OperationContext("has", { key });
+    const scope = new aConcept.A_Scope({
+      name: "A-Memory-Has-Operation-Scope",
+      fragments: [operation]
+    }).inherit(aConcept.A_Context.scope(this));
+    try {
+      await this.call(AMemory_constants.A_MemoryFeatures.onHas, scope);
+      scope.destroy();
+      return operation.result;
+    } catch (error) {
+      const getError = new AMemory_error.A_MemoryError({
+        title: AMemory_error.A_MemoryError.MemoryHasError,
+        description: `An error occurred while checking existence for key "${String(key)}"`,
+        originalError: error
+      });
+      scope.register(getError);
+      await this.call(AMemory_constants.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 aOperation.A_OperationContext("set", { key, value });
+    const scope = new aConcept.A_Scope({
+      name: "A-Memory-Set-Operation-Scope",
+      fragments: [operation]
+    }).inherit(aConcept.A_Context.scope(this));
+    try {
+      await this.call(AMemory_constants.A_MemoryFeatures.onSet, scope);
+    } catch (error) {
+      const setError = new AMemory_error.A_MemoryError({
+        title: AMemory_error.A_MemoryError.MemorySetError,
+        description: `An error occurred while setting the value for key "${String(key)}"`,
+        originalError: error
+      });
+      scope.register(setError);
+      await this.call(AMemory_constants.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 aOperation.A_OperationContext("drop", { key });
+    const scope = new aConcept.A_Scope({
+      name: "A-Memory-Drop-Operation-Scope",
+      fragments: [operation]
+    }).inherit(aConcept.A_Context.scope(this));
+    try {
+      await this.call(AMemory_constants.A_MemoryFeatures.onDrop, scope);
+    } catch (error) {
+      const dropError = new AMemory_error.A_MemoryError({
+        title: AMemory_error.A_MemoryError.MemoryDropError,
+        description: `An error occurred while dropping the value for key "${String(key)}"`,
+        originalError: error
+      });
+      scope.register(dropError);
+      await this.call(AMemory_constants.A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw dropError;
+    }
+  }
+  /**
+   * Clears all stored values in the context memory
+   */
+  async clear() {
+    const operation = new aOperation.A_OperationContext("clear");
+    const scope = new aConcept.A_Scope({
+      name: "A-Memory-Clear-Operation-Scope",
+      fragments: [operation]
+    }).inherit(aConcept.A_Context.scope(this));
+    try {
+      await this.call(AMemory_constants.A_MemoryFeatures.onClear, scope);
+    } catch (error) {
+      const clearError = new AMemory_error.A_MemoryError({
+        title: AMemory_error.A_MemoryError.MemoryClearError,
+        description: `An error occurred while clearing the memory`,
+        originalError: error
+      });
+      scope.register(clearError);
+      await this.call(AMemory_constants.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 aOperation.A_OperationContext("serialize");
+    const scope = new aConcept.A_Scope({
+      name: "A-Memory-Serialize-Operation-Scope",
+      fragments: [operation]
+    }).inherit(aConcept.A_Context.scope(this));
+    try {
+      await this.call(AMemory_constants.A_MemoryFeatures.onSerialize, scope);
+      return operation.result;
+    } catch (error) {
+      const serializeError = new AMemory_error.A_MemoryError({
+        title: AMemory_error.A_MemoryError.MemorySerializeError,
+        description: `An error occurred while serializing the memory`,
+        originalError: error
+      });
+      scope.register(serializeError);
+      await this.call(AMemory_constants.A_MemoryFeatures.onError, scope);
+      scope.destroy();
+      throw serializeError;
+    }
+  }
+};
+__decorateClass([
+  aConcept.A_Feature.Extend()
+], exports.A_Memory.prototype, _i, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend()
+], exports.A_Memory.prototype, _h, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Inject(AMemory_context.A_MemoryContext))
+], exports.A_Memory.prototype, _g, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Inject(AMemory_context.A_MemoryContext))
+], exports.A_Memory.prototype, _f, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Dependency.Required()),
+  __decorateParam(0, aConcept.A_Inject(aOperation.A_OperationContext)),
+  __decorateParam(1, aConcept.A_Inject(AMemory_context.A_MemoryContext))
+], exports.A_Memory.prototype, _e, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Dependency.Required()),
+  __decorateParam(0, aConcept.A_Inject(aOperation.A_OperationContext)),
+  __decorateParam(1, aConcept.A_Inject(AMemory_context.A_MemoryContext))
+], exports.A_Memory.prototype, _d, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Dependency.Required()),
+  __decorateParam(0, aConcept.A_Inject(aOperation.A_OperationContext)),
+  __decorateParam(1, aConcept.A_Inject(AMemory_context.A_MemoryContext)),
+  __decorateParam(2, aConcept.A_Inject(aConcept.A_Scope))
+], exports.A_Memory.prototype, _c, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Dependency.Required()),
+  __decorateParam(0, aConcept.A_Inject(aOperation.A_OperationContext)),
+  __decorateParam(1, aConcept.A_Inject(AMemory_context.A_MemoryContext))
+], exports.A_Memory.prototype, _b, 1);
+__decorateClass([
+  aConcept.A_Feature.Extend(),
+  __decorateParam(0, aConcept.A_Dependency.Required()),
+  __decorateParam(0, aConcept.A_Inject(aOperation.A_OperationContext)),
+  __decorateParam(1, aConcept.A_Inject(AMemory_context.A_MemoryContext))
+], exports.A_Memory.prototype, _a, 1);
+exports.A_Memory = __decorateClass([
+  aFrame.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."
+  })
+], exports.A_Memory);
+//# sourceMappingURL=A-Memory.component.js.map
+//# sourceMappingURL=A-Memory.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Memory/A-Memory.component.ts"],"names":["A_Memory","A_Component","A_MemoryFeatures","A_MemoryContext","A_Context","A_Scope","A_MemoryError","A_OperationContext","A_Feature","A_Frame"],"mappings":"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","file":"A-Memory.component.js","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}"]}