refactor: rename items for standardization and improve doc

Author: rsaz

package.json

@@ -72,7 +72,7 @@
   "devDependencies": {
     "@commitlint/cli": "^18.0.0",
     "@commitlint/config-conventional": "17.7.0",
-    "@expressots/core": "2.10.0",
+    "@expressots/core": "latest",
     "@release-it/conventional-changelog": "7.0.1",
     "@types/express": "4.17.21",
     "@types/jest": "29.5.0",

src/adapter-express/application-express.base.ts

@@ -23,36 +23,30 @@ import { provide } from "inversify-binding-decorators";
 @provide(ApplicationBase)
 export abstract class ApplicationBase {
   /**
-   * Method to configure services that should be initialized
-   * before the server starts. It must be implemented by the
-   * extending class to set up necessary services or configurations.
-   * Can return a Promise for async configuration.
+   * Implement this method to set up required services or configurations before
+   * the server starts. This is essential for initializing dependencies or settings
+   * necessary for server operation. Supports asynchronous setup with a Promise.
    *
    * @abstract
    * @returns {void | Promise<void>}
    */
   protected abstract configureServices(): void | Promise<void>;
 
   /**
-   * Method to configure services or actions that should be executed
-   * after the server starts. It allows the extending class to perform
-   * any necessary operations once the server is up and running.
-   * Can return a Promise for async execution.
+   * Implement this method to execute actions or configurations after the server
+   * has started. Use this for operations that need to run once the server is
+   * operational. Supports asynchronous execution with a Promise.
    *
    * @abstract
    * @returns {void | Promise<void>}
    */
   protected abstract postServerInitialization(): void | Promise<void>;
 
   /**
-   * Method to perform any necessary actions or cleanup after the server
-   * is shutting down. This might include closing database connections,
-   * stopping background tasks, or other cleanup activities. It provides
-   * a clean exit point for the server.
-   * Can return a Promise for async cleanup.
-   *
-   * @abstract
-   * @returns {void | Promise<void>}
+   * Implement this method to handle cleanup and final actions when the server
+   * is shutting down. Ideal for closing resources, stopping tasks, or other
+   * cleanup procedures to ensure a graceful server shutdown. Supports asynchronous
+   * cleanup with a Promise.
    */
   protected abstract serverShutdown(): void | Promise<void>;
 }

src/adapter-express/application-express.ts

@@ -39,6 +39,7 @@ class AppExpress extends ApplicationBase implements IWebServer {
   private container: Container;
   private globalPrefix: string = "/";
   private middlewares: Array<ExpressHandler | MiddlewareConfig | ExpressoMiddleware> = [];
+  private console: Console;
 
   protected configureServices(): void | Promise<void> {}
   protected postServerInitialization(): void | Promise<void> {}
@@ -58,6 +59,7 @@ class AppExpress extends ApplicationBase implements IWebServer {
    */
   async configure(container: Container): Promise<void> {
     this.container = container;
+    this.console = this.container.get(Console);
   }
 
   /**
@@ -138,17 +140,14 @@ class AppExpress extends ApplicationBase implements IWebServer {
     environment: ServerEnvironment,
     consoleMessage?: IApplicationMessageToConsole,
   ): Promise<void> {
-    /* Initializes the application and executes the middleware pipeline */
     await this.init();
 
-    /* Sets the port and environment */
     this.port = port;
     this.environment = environment;
     this.app.set("env", environment);
 
     this.app.listen(this.port, () => {
-      const console: Console = this.container.get<Console>(Console);
-      console.messageServer(this.port, this.environment, consoleMessage);
+      this.console.messageServer(this.port, this.environment, consoleMessage);
 
       (["SIGTERM", "SIGHUP", "SIGBREAK", "SIGQUIT", "SIGINT"] as Array<NodeJS.Signals>).forEach(
         (signal) => {
@@ -157,7 +156,7 @@ class AppExpress extends ApplicationBase implements IWebServer {
       );
     });
 
-    await Promise.resolve(this.postServerInitialization());
+    await this.postServerInitialization();
   }
 
   /**