From 30cd86b184ba38713c3b484cb78d5804b46756af Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Tue, 17 Oct 2023 16:29:54 +0200
Subject: [PATCH 01/37] [Docs] Fix component name

---
 docs/src/pages/who-is-using-foal.jsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/pages/who-is-using-foal.jsx b/docs/src/pages/who-is-using-foal.jsx
index c0f4a5b536..cce16bd27e 100644
--- a/docs/src/pages/who-is-using-foal.jsx
+++ b/docs/src/pages/who-is-using-foal.jsx
@@ -14,7 +14,7 @@ const posts = [
   },
 ];
 
-export default function Newsletter() {
+export default function WhoIsUsingFoal() {
   return (
     <Layout
       description='Who is using Foal'>

From 43d47c9fb88cb6a459e574e4b1c3895df2ab9c11 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 10:33:14 +0200
Subject: [PATCH 02/37] Add Foal logger

---
 packages/core/src/common/index.ts             |   1 +
 packages/core/src/common/logging/index.ts     |   1 +
 .../core/src/common/logging/logger.spec.ts    | 298 ++++++++++++++++++
 packages/core/src/common/logging/logger.ts    | 170 ++++++++++
 packages/core/src/index.ts                    |   1 +
 5 files changed, 471 insertions(+)
 create mode 100644 packages/core/src/common/logging/index.ts
 create mode 100644 packages/core/src/common/logging/logger.spec.ts
 create mode 100644 packages/core/src/common/logging/logger.ts

diff --git a/packages/core/src/common/index.ts b/packages/core/src/common/index.ts
index 0bb0e9d37b..61e6d65bdb 100644
--- a/packages/core/src/common/index.ts
+++ b/packages/core/src/common/index.ts
@@ -1,6 +1,7 @@
 export * from './auth';
 export * from './encoding';
 export * from './file';
+export * from './logging';
 export * from './templates';
 export * from './tokens';
 export * from './utils';
diff --git a/packages/core/src/common/logging/index.ts b/packages/core/src/common/logging/index.ts
new file mode 100644
index 0000000000..0a9e39b0e0
--- /dev/null
+++ b/packages/core/src/common/logging/index.ts
@@ -0,0 +1 @@
+export { Logger } from './logger';
\ No newline at end of file
diff --git a/packages/core/src/common/logging/logger.spec.ts b/packages/core/src/common/logging/logger.spec.ts
new file mode 100644
index 0000000000..89e1722cd5
--- /dev/null
+++ b/packages/core/src/common/logging/logger.spec.ts
@@ -0,0 +1,298 @@
+import { deepStrictEqual, strictEqual, throws } from 'assert';
+import { Logger } from './logger';
+import { Config } from '../../core';
+
+const testStack = `Error: aaa
+    at createTestParams (/somewhere/logger.spec.ts:6:11)
+    at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`;
+
+function createTestParams() {
+  const err = new Error('aaa');
+  err.stack = testStack;
+  return {
+    myBoolean: false,
+    myNull: null,
+    myUndefined: undefined,
+    myNumber: 0,
+    myString: 'xxx',
+    mySymbol: Symbol('yyy'),
+    myObject: { foo: 'bar' },
+    err
+  };
+}
+
+function createLogger(): {
+  logger: Logger,
+  mocks: { logWithConsoleHasBeenCalledWith: any },
+  now: Date,
+  isoNow: string,
+  localTimeNow: string
+} {
+  const mocks: { logWithConsoleHasBeenCalledWith: any } = { logWithConsoleHasBeenCalledWith: undefined };
+
+  const isoNow = '2023-02-03T01:12:03.000Z';
+  const localTimeNow = '2:12:03 AM';
+  const now = new Date(isoNow);
+
+  class Logger2 extends Logger {
+    logWithConsole(message: string): void {
+      mocks.logWithConsoleHasBeenCalledWith = message;
+    }
+
+    getNow(): Date {
+      return now;
+    }
+  }
+
+  const logger = new Logger2();
+
+  return {
+    logger,
+    mocks,
+    now,
+    isoNow,
+    localTimeNow,
+  };
+}
+
+describe('Logger', () => {
+
+  afterEach(() => {
+    Config.remove('settings.logger.format');
+  })
+
+  describe('when debug is called', () => {
+    context('given the configuration "settings.logger.format" is NOT defined', () => {
+      it('should log a text with an exhaustive timestamp, with params but with no colors', () => {
+        const { logger, mocks, isoNow } = createLogger();
+
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        logger.debug(message, params);
+
+        const actual = mocks.logWithConsoleHasBeenCalledWith;
+        const expected = `[${isoNow}] [DEBUG] Hello world`
+          + `\n    myBoolean: false`
+          + `\n    myNull: null`
+          + `\n    myNumber: 0`
+          + `\n    myString: "xxx"`
+          + `\n    myObject: {`
+          + `\n      "foo": "bar"`
+          + `\n    }`
+          + `\n    err: {`
+          + `\n      name: "Error"`
+          + `\n      message: "aaa"`
+          + `\n      stack: Error: aaa`
+          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
+          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
+          + `\n    }`;
+
+        strictEqual(actual, expected);
+      });
+    });
+
+    context('given the configuration "settings.logger.format" is "raw"', () => {
+      beforeEach(() => {
+        Config.set('settings.logger.format', 'raw');
+      });
+
+      it('should log a text with an exhaustive timestamp, with params but with no colors', () => {
+        const { logger, mocks, isoNow } = createLogger();
+
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        logger.debug(message, params);
+
+        const actual = mocks.logWithConsoleHasBeenCalledWith;
+        const expected = `[${isoNow}] [DEBUG] Hello world`
+          + `\n    myBoolean: false`
+          + `\n    myNull: null`
+          + `\n    myNumber: 0`
+          + `\n    myString: "xxx"`
+          + `\n    myObject: {`
+          + `\n      "foo": "bar"`
+          + `\n    }`
+          + `\n    err: {`
+          + `\n      name: "Error"`
+          + `\n      message: "aaa"`
+          + `\n      stack: Error: aaa`
+          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
+          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
+          + `\n    }`;
+
+        strictEqual(actual, expected);
+      });
+    });
+
+
+    context('given the configuration "settings.logger.format" is "dev"', () => {
+      beforeEach(() => {
+        Config.set('settings.logger.format', 'dev');
+      });
+
+      it('should log a text with a short timestamp, with colors but with no params (except the "err" param)', () => {
+        const { logger, mocks, localTimeNow } = createLogger();
+
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        logger.debug(message, params);
+
+        const actual = mocks.logWithConsoleHasBeenCalledWith;
+        // Pink color
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[35mDEBUG\u001b[39m Hello world`
+          + `\n    err: {`
+          + `\n      name: "Error"`
+          + `\n      message: "aaa"`
+          + `\n      stack: Error: aaa`
+          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
+          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
+          + `\n    }`;
+
+        strictEqual(actual, expected);
+      });
+    });
+
+    context('given the configuration "settings.logger.format" is "json"', () => {
+      beforeEach(() => {
+        Config.set('settings.logger.format', 'json');
+      });
+
+      it('should log a JSON', () => {
+        const { logger, mocks, isoNow } = createLogger();
+
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        logger.debug(message, params);
+
+        const actual = JSON.parse(mocks.logWithConsoleHasBeenCalledWith);
+        const expected = {
+          message,
+          timestamp: isoNow,
+          level: 'debug',
+          myBoolean: false,
+          myNull: null,
+          myNumber: 0,
+          myString: 'xxx',
+          myObject: { foo: 'bar' },
+          err: {
+            name: 'Error',
+            message: 'aaa',
+            stack: testStack,
+          }
+        };
+
+        deepStrictEqual(actual, expected);
+      });
+    });
+
+    context('given the configuration "settings.logger.format" is "none"', () => {
+      beforeEach(() => {
+        Config.set('settings.logger.format', 'none');
+      });
+
+      it('should log nothing', () => {
+        const { logger, mocks, isoNow } = createLogger();
+
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        logger.debug(message, params);
+
+        const actual = mocks.logWithConsoleHasBeenCalledWith;
+        const expected = undefined;
+
+        strictEqual(actual, expected);
+      });
+    });
+
+    context('given the configuration "settings.logger.format" has an incorrect value', () => {
+      beforeEach(() => {
+        Config.set('settings.logger.format', 'foobar');
+      });
+
+      it('should throw an error', () => {
+        const { logger } = createLogger();
+
+        const message = 'Hello world';
+
+        throws(
+          () => logger.debug(message),
+          (error: any) => error.message === '[CONFIG] Invalid "settings.logger.format" configuration value: "foobar"'
+        );
+      });
+    });
+  });
+
+  describe('when info is called', () => {
+    context('given the configuration "settings.logger.format" is "dev"', () => {
+      beforeEach(() => {
+        Config.set('settings.logger.format', 'dev');
+      });
+
+      it('should log a text with the proper color on the log level', () => {
+        const { logger, mocks, localTimeNow } = createLogger();
+
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        logger.info(message, params);
+
+        const actual = mocks.logWithConsoleHasBeenCalledWith;
+        // Cyan color
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m Hello world`;
+
+        strictEqual(actual.split('\n')[0], expected);
+      });
+    });
+  });
+
+  describe('when warn is called', () => {
+    context('given the configuration "settings.logger.format" is "dev"', () => {
+      beforeEach(() => {
+        Config.set('settings.logger.format', 'dev');
+      });
+
+      it('should log a text with the proper color on the log level', () => {
+        const { logger, mocks, localTimeNow } = createLogger();
+
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        logger.warn(message, params);
+
+        const actual = mocks.logWithConsoleHasBeenCalledWith;
+        // Yellow color
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[33mWARN\u001b[39m Hello world`;
+
+        strictEqual(actual.split('\n')[0], expected);
+      });
+    });
+  });
+
+  describe('when error is called', () => {
+    context('given the configuration "settings.logger.format" is "dev"', () => {
+      beforeEach(() => {
+        Config.set('settings.logger.format', 'dev');
+      });
+
+      it('should log a text with the proper color on the log level', () => {
+        const { logger, mocks, localTimeNow } = createLogger();
+
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        logger.error(message, params);
+
+        const actual = mocks.logWithConsoleHasBeenCalledWith;
+        // Red color
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[31mERROR\u001b[39m Hello world`;
+
+        strictEqual(actual.split('\n')[0], expected);
+      });
+    });
+  });
+});
diff --git a/packages/core/src/common/logging/logger.ts b/packages/core/src/common/logging/logger.ts
new file mode 100644
index 0000000000..f78064c4a0
--- /dev/null
+++ b/packages/core/src/common/logging/logger.ts
@@ -0,0 +1,170 @@
+import { Config } from '../../core';
+
+type Level = 'debug'|'info'|'warn'|'error';
+
+function formatObjectToJson(obj: Record<string, any>): string {
+  if (obj.err instanceof Error) {
+    return JSON.stringify({
+      ...obj,
+      err: {
+        name: obj.err.name,
+        message: obj.err.message,
+        stack: obj.err.stack,
+      },
+    });
+  };
+  return JSON.stringify(obj);
+}
+
+function formatObjectToTextParameters(obj: Record<string, any>): string {
+  const tab = '    ';
+  const space = '  ';
+  const spaceSize = space.length;
+
+  return Object
+    .entries(obj)
+    .reduce((lines, [key, value]) => {
+      if (value instanceof Error) {
+        return [
+          ...lines,
+          `${key}: {`,
+          `${space}name: "${value.name}"`,
+          `${space}message: "${value.message}"`,
+          `${space}stack: ${value.stack?.split('\n').join(`\n${space}${space}`)}`,
+          `}`,
+        ];
+      }
+
+      const formattedValue = JSON.stringify(value, null, spaceSize)?.split('\n').join(`\n${tab}`);
+      if (formattedValue !== undefined) {
+        return [
+          ...lines,
+          `${key}: ${formattedValue}`,
+        ];
+      }
+
+      return lines;
+    }, [] as string[])
+    .map(str => `\n${tab}${str}`)
+    .join('');
+}
+
+export class Logger {
+
+  private formatMessageToJson(
+    now: Date,
+    level: Level,
+    message: string,
+    params: { [name: string]: any }
+  ): string {
+    const json = {
+      timestamp: now,
+      level,
+      message,
+      ...params,
+    };
+
+    return formatObjectToJson(json);
+  }
+
+  private formatMessageToRawText(
+    now: Date,
+    level: Level,
+    message: string,
+    params: { [name: string]: any }
+  ): string {
+    const timestamp = `[${now.toISOString()}]`;
+    const logLevel = `[${level.toUpperCase()}]`;
+    const parameters = formatObjectToTextParameters(params);
+
+    return `${timestamp} ${logLevel} ${message}${parameters}`;
+  }
+
+  private formatMessageToDevText(
+    now: Date,
+    level: Level,
+    message: string,
+    params: { [name: string]: any }
+  ): string {
+    const colors = {
+      debug: '\u001b[35m', // Pink
+      info: '\u001b[36m', // Cyan
+      warn: '\u001b[33m', // Yellow
+      error: '\u001b[31m', // Red
+    };
+    const timestampColor = '\u001b[90m'; // Gray
+    const endTagColor = '\u001b[39m';
+
+    const timestamp = `${timestampColor}[${now.toLocaleTimeString()}]${endTagColor}`;
+    const logLevel = `${colors[level]}${level.toUpperCase()}${endTagColor}`;
+    const parameters = formatObjectToTextParameters({ err: params.err });
+
+    return `${timestamp} ${logLevel} ${message}${parameters}`;
+  }
+
+  private formatMessage(
+    level: Level,
+    message: string,
+    params: { [name: string]: any },
+    now: Date,
+    format: string,
+  ): string|null {
+    switch (format) {
+      case 'raw':
+        return this.formatMessageToRawText(now, level, message, params);
+      case 'dev':
+        return this.formatMessageToDevText(now, level, message, params);
+      case 'json':
+        return this.formatMessageToJson(now, level, message, params);
+      case 'none':
+        return null;
+      default:
+        throw new Error(`[CONFIG] Invalid "settings.logger.format" configuration value: "${format}"`);
+    }
+  }
+
+  private log(
+    level: Level,
+    message: string,
+    params: { [name: string]: any }
+  ): void {
+    const format = Config.get('settings.logger.format', 'string', 'raw');
+    const now = this.getNow();
+
+    const messageFormatted = this.formatMessage(
+      level,
+      message,
+      params,
+      now,
+      format,
+    );
+
+    if (messageFormatted !== null) {
+      this.logWithConsole(messageFormatted);
+    }
+  }
+
+  protected logWithConsole(message: string): void {
+    console.log(message);
+  }
+
+  protected getNow(): Date {
+    return new Date();
+  }
+
+  debug(message: string, params: { err?: Error, [name: string]: any } = {}): void {
+    this.log('debug', message, params);
+  }
+
+  info(message: string, params: { err?: Error, [name: string]: any } = {}): void {
+    this.log('info', message, params);
+  }
+
+  warn(message: string, params: { err?: Error, [name: string]: any } = {}): void {
+    this.log('warn', message, params);
+  }
+
+  error(message: string, params: { err?: Error, [name: string]: any } = {}): void {
+    this.log('error', message, params);
+  }
+}
\ No newline at end of file
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index 63d808c3c1..e341aa9eb8 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -36,6 +36,7 @@ export {
   hashPassword,
   passwordHashNeedsToBeRefreshed,
   isInFile,
+  Logger,
   render,
   renderToString,
   renderError,

From 5fc71a05ee38eb6a4f6a1090a57b87e8dac4d568 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 10:39:47 +0200
Subject: [PATCH 03/37] Remove incorrect console.log

---
 packages/graphql/src/acceptance-test.spec.ts | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/graphql/src/acceptance-test.spec.ts b/packages/graphql/src/acceptance-test.spec.ts
index 3c5bf8f643..dcc809af5e 100644
--- a/packages/graphql/src/acceptance-test.spec.ts
+++ b/packages/graphql/src/acceptance-test.spec.ts
@@ -244,7 +244,6 @@ describe('[Acceptance test] GraphQLController', () => {
           data += chunk;
         });
         resp.on('end', () => {
-          console.log(data);
           resolve(JSON.parse(data));
         });
       }).on('error', err => {

From 41786922d7317d1514b1214e93496e5157cf93ba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 12:27:33 +0200
Subject: [PATCH 04/37] Rename err to error

---
 .../core/src/common/logging/logger.spec.ts    | 16 +++++++--------
 packages/core/src/common/logging/logger.ts    | 20 +++++++++----------
 2 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/packages/core/src/common/logging/logger.spec.ts b/packages/core/src/common/logging/logger.spec.ts
index 89e1722cd5..1ff5f7ac6c 100644
--- a/packages/core/src/common/logging/logger.spec.ts
+++ b/packages/core/src/common/logging/logger.spec.ts
@@ -7,8 +7,8 @@ const testStack = `Error: aaa
     at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`;
 
 function createTestParams() {
-  const err = new Error('aaa');
-  err.stack = testStack;
+  const error = new Error('aaa');
+  error.stack = testStack;
   return {
     myBoolean: false,
     myNull: null,
@@ -17,7 +17,7 @@ function createTestParams() {
     myString: 'xxx',
     mySymbol: Symbol('yyy'),
     myObject: { foo: 'bar' },
-    err
+    error
   };
 }
 
@@ -80,7 +80,7 @@ describe('Logger', () => {
           + `\n    myObject: {`
           + `\n      "foo": "bar"`
           + `\n    }`
-          + `\n    err: {`
+          + `\n    error: {`
           + `\n      name: "Error"`
           + `\n      message: "aaa"`
           + `\n      stack: Error: aaa`
@@ -114,7 +114,7 @@ describe('Logger', () => {
           + `\n    myObject: {`
           + `\n      "foo": "bar"`
           + `\n    }`
-          + `\n    err: {`
+          + `\n    error: {`
           + `\n      name: "Error"`
           + `\n      message: "aaa"`
           + `\n      stack: Error: aaa`
@@ -132,7 +132,7 @@ describe('Logger', () => {
         Config.set('settings.logger.format', 'dev');
       });
 
-      it('should log a text with a short timestamp, with colors but with no params (except the "err" param)', () => {
+      it('should log a text with a short timestamp, with colors but with no params (except the "error" param)', () => {
         const { logger, mocks, localTimeNow } = createLogger();
 
         const message = 'Hello world';
@@ -143,7 +143,7 @@ describe('Logger', () => {
         const actual = mocks.logWithConsoleHasBeenCalledWith;
         // Pink color
         const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[35mDEBUG\u001b[39m Hello world`
-          + `\n    err: {`
+          + `\n    error: {`
           + `\n      name: "Error"`
           + `\n      message: "aaa"`
           + `\n      stack: Error: aaa`
@@ -178,7 +178,7 @@ describe('Logger', () => {
           myNumber: 0,
           myString: 'xxx',
           myObject: { foo: 'bar' },
-          err: {
+          error: {
             name: 'Error',
             message: 'aaa',
             stack: testStack,
diff --git a/packages/core/src/common/logging/logger.ts b/packages/core/src/common/logging/logger.ts
index f78064c4a0..0290b50f90 100644
--- a/packages/core/src/common/logging/logger.ts
+++ b/packages/core/src/common/logging/logger.ts
@@ -3,13 +3,13 @@ import { Config } from '../../core';
 type Level = 'debug'|'info'|'warn'|'error';
 
 function formatObjectToJson(obj: Record<string, any>): string {
-  if (obj.err instanceof Error) {
+  if (obj.error instanceof Error) {
     return JSON.stringify({
       ...obj,
-      err: {
-        name: obj.err.name,
-        message: obj.err.message,
-        stack: obj.err.stack,
+      error: {
+        name: obj.error.name,
+        message: obj.error.message,
+        stack: obj.error.stack,
       },
     });
   };
@@ -97,7 +97,7 @@ export class Logger {
 
     const timestamp = `${timestampColor}[${now.toLocaleTimeString()}]${endTagColor}`;
     const logLevel = `${colors[level]}${level.toUpperCase()}${endTagColor}`;
-    const parameters = formatObjectToTextParameters({ err: params.err });
+    const parameters = formatObjectToTextParameters({ error: params.error });
 
     return `${timestamp} ${logLevel} ${message}${parameters}`;
   }
@@ -152,19 +152,19 @@ export class Logger {
     return new Date();
   }
 
-  debug(message: string, params: { err?: Error, [name: string]: any } = {}): void {
+  debug(message: string, params: { error?: Error, [name: string]: any } = {}): void {
     this.log('debug', message, params);
   }
 
-  info(message: string, params: { err?: Error, [name: string]: any } = {}): void {
+  info(message: string, params: { error?: Error, [name: string]: any } = {}): void {
     this.log('info', message, params);
   }
 
-  warn(message: string, params: { err?: Error, [name: string]: any } = {}): void {
+  warn(message: string, params: { error?: Error, [name: string]: any } = {}): void {
     this.log('warn', message, params);
   }
 
-  error(message: string, params: { err?: Error, [name: string]: any } = {}): void {
+  error(message: string, params: { error?: Error, [name: string]: any } = {}): void {
     this.log('error', message, params);
   }
 }
\ No newline at end of file

From 9d3e72fa0432cc5aa093be70e30e302339ec341a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 12:28:50 +0200
Subject: [PATCH 05/37] Remove useless try/catch

---
 .../additional/authentication/jwt.jwks.spec.ts | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/packages/acceptance-tests/src/additional/authentication/jwt.jwks.spec.ts b/packages/acceptance-tests/src/additional/authentication/jwt.jwks.spec.ts
index 76a5009cc3..0198edecbf 100644
--- a/packages/acceptance-tests/src/additional/authentication/jwt.jwks.spec.ts
+++ b/packages/acceptance-tests/src/additional/authentication/jwt.jwks.spec.ts
@@ -68,17 +68,13 @@ describe('[Authentication|JWT|JWKS] Users can be authenticated with a JWKS retre
 
     server = (await createApp(AppController)).listen(3000);
 
-    try {
-      const response = await superagent
-        .get('http://localhost:3000/api/users/me')
-        .set('Authorization', 'Bearer ' + sign({}, privateKey, { algorithm: 'RS256', header: { kid: 'aaa' } }));
-      deepStrictEqual(response.body, {
-        name: 'Alix'
-      });
-    } catch (error: any) {
-      console.log(error);
-      throw error;
-    }
+    const response = await superagent
+      .get('http://localhost:3000/api/users/me')
+      .set('Authorization', 'Bearer ' + sign({}, privateKey, { algorithm: 'RS256', header: { kid: 'aaa' } }));
+
+    deepStrictEqual(response.body, {
+      name: 'Alix'
+    });
   });
 
 });

From 5ed120300d126b562fe1b90c299f99176509be06 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 12:56:25 +0200
Subject: [PATCH 06/37] Remove unused variable

---
 packages/core/src/common/logging/logger.spec.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/core/src/common/logging/logger.spec.ts b/packages/core/src/common/logging/logger.spec.ts
index 1ff5f7ac6c..7430fbee35 100644
--- a/packages/core/src/common/logging/logger.spec.ts
+++ b/packages/core/src/common/logging/logger.spec.ts
@@ -195,7 +195,7 @@ describe('Logger', () => {
       });
 
       it('should log nothing', () => {
-        const { logger, mocks, isoNow } = createLogger();
+        const { logger, mocks } = createLogger();
 
         const message = 'Hello world';
         const params = createTestParams();

From 0f0a02c20b4ce180a12a81e76f36710a680456f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 13:04:17 +0200
Subject: [PATCH 07/37] Use Foal logger when an error is thrown in HTTP
 controller

---
 .../routes/convert-error-to-response.spec.ts  | 42 +++++++++++++------
 .../core/routes/convert-error-to-response.ts  |  9 +++-
 packages/core/src/core/routes/get-response.ts | 11 +++--
 3 files changed, 43 insertions(+), 19 deletions(-)

diff --git a/packages/core/src/core/routes/convert-error-to-response.spec.ts b/packages/core/src/core/routes/convert-error-to-response.spec.ts
index fe3ba303c3..b6a2f9899b 100644
--- a/packages/core/src/core/routes/convert-error-to-response.spec.ts
+++ b/packages/core/src/core/routes/convert-error-to-response.spec.ts
@@ -22,12 +22,20 @@ describe('convertErrorToResponse', () => {
   context('given the configuration settings.logErrors is true or not defined', () => {
 
     it('should log the error stack.', async () => {
-      let message = '';
-      const log = (msg: string) => message = msg;
+      let actualMessage: string|undefined;
+      let actualError: Error|undefined;
 
-      await convertErrorToResponse(error, ctx, new AppController(), log);
+      const logger = {
+        error(message: string, { error }: { error: Error }): void {
+          actualMessage = message;
+          actualError = error;
+        }
+      }
+
+      await convertErrorToResponse(error, ctx, new AppController(), logger);
 
-      strictEqual(message, error.stack);
+      strictEqual(actualMessage, error.message);
+      strictEqual(actualError, error);
     });
 
   });
@@ -38,13 +46,21 @@ describe('convertErrorToResponse', () => {
 
     afterEach(() => Config.remove('settings.logErrors'));
 
-    it('should not log the error stack.', async () => {
-      let message = '';
-      const log = (msg: string) => message = msg;
+    it('should not log the error.', async () => {
+      let actualMessage: string|undefined;
+      let actualError: Error|undefined;
+
+      const logger = {
+        error(message: string, { error }: { error: Error }): void {
+          actualMessage = message;
+          actualError = error;
+        }
+      }
 
-      await convertErrorToResponse(error, ctx, new AppController(), log);
+      await convertErrorToResponse(error, ctx, new AppController(), logger);
 
-      strictEqual(message, '');
+      strictEqual(actualMessage, undefined);
+      strictEqual(actualError, undefined);
     });
 
   });
@@ -52,7 +68,7 @@ describe('convertErrorToResponse', () => {
   context('given appController.handleError is not defined', () => {
 
     it('should return an HttpResponseInternalServerError object created by renderError.', async () => {
-      const response = await convertErrorToResponse(error, ctx, new AppController(), () => {});
+      const response = await convertErrorToResponse(error, ctx, new AppController(), { error: () => {} });
 
       if (!isHttpResponseInternalServerError(response)) {
         throw new Error('An HttpResponseInternalServerError should have been returned.');
@@ -82,7 +98,7 @@ describe('convertErrorToResponse', () => {
       }
 
       it('should return the response returned by handleError.', async () => {
-        const response = await convertErrorToResponse(error, ctx, new AppController(), () => {});
+        const response = await convertErrorToResponse(error, ctx, new AppController(), { error: () => {} });
 
         if (!isHttpResponseInternalServerError(response)) {
           throw new Error('An HttpResponseInternalServerError should have been returned.');
@@ -102,7 +118,7 @@ describe('convertErrorToResponse', () => {
       }
 
       it('should return an HttpResponseInternalServerError object created by renderError.', async () => {
-        const response = await convertErrorToResponse(error, ctx, new AppController(), () => {});
+        const response = await convertErrorToResponse(error, ctx, new AppController(), { error: () => {} });
 
         if (!isHttpResponseInternalServerError(response)) {
           throw new Error('An HttpResponseInternalServerError should have been returned.');
@@ -123,7 +139,7 @@ describe('convertErrorToResponse', () => {
       }
 
       it('should return an HttpResponseInternalServerError object created by renderError.', async () => {
-        const response = await convertErrorToResponse(error, ctx, new AppController(), () => {});
+        const response = await convertErrorToResponse(error, ctx, new AppController(), { error: () => {} });
 
         if (!isHttpResponseInternalServerError(response)) {
           throw new Error('An HttpResponseInternalServerError should have been returned.');
diff --git a/packages/core/src/core/routes/convert-error-to-response.ts b/packages/core/src/core/routes/convert-error-to-response.ts
index 04311fd7d2..27ee838057 100644
--- a/packages/core/src/core/routes/convert-error-to-response.ts
+++ b/packages/core/src/core/routes/convert-error-to-response.ts
@@ -4,10 +4,15 @@ import { Config } from '../config';
 import { Context, HttpResponse } from '../http';
 
 export async function convertErrorToResponse(
-  error: Error, ctx: Context, appController: IAppController, log = console.error
+  error: Error,
+  ctx: Context,
+  appController: IAppController,
+  logger: {
+    error: (message: string, params: { error: Error }) => void
+  }
 ): Promise<HttpResponse> {
   if (Config.get('settings.logErrors', 'boolean', true)) {
-    log(error.stack);
+    logger.error(error.message, { error });
   }
 
   if (appController.handleError) {
diff --git a/packages/core/src/core/routes/get-response.ts b/packages/core/src/core/routes/get-response.ts
index cb4da5b6eb..dcbb35aa10 100644
--- a/packages/core/src/core/routes/get-response.ts
+++ b/packages/core/src/core/routes/get-response.ts
@@ -1,3 +1,4 @@
+import { Logger } from '../../common';
 import { IAppController } from '../app.controller.interface';
 import { HookPostFunction } from '../hooks';
 import { Context, HttpResponse, isHttpResponse } from '../http';
@@ -8,6 +9,8 @@ import { Route } from './route.interface';
 export async function getResponse(
   route: Route, ctx: Context, services: ServiceManager, appController: IAppController
 ): Promise<HttpResponse> {
+  const logger = services.get(Logger);
+
   let response: undefined | HttpResponse;
 
   const hookPostFunctions: HookPostFunction[] = [];
@@ -17,7 +20,7 @@ export async function getResponse(
     try {
       result = await hook(ctx, services);
     } catch (error: any) {
-      result = await convertErrorToResponse(error, ctx, appController);
+      result = await convertErrorToResponse(error, ctx, appController, logger);
     }
     if (isHttpResponse(result)) {
       response = result;
@@ -31,20 +34,20 @@ export async function getResponse(
     try {
       response = await route.controller[route.propertyKey](ctx, ctx.request.params, ctx.request.body);
     } catch (error: any) {
-      response = await convertErrorToResponse(error, ctx, appController);
+      response = await convertErrorToResponse(error, ctx, appController, logger);
     }
   }
 
   if (!isHttpResponse(response)) {
     const error = new Error(`The controller method "${route.propertyKey}" should return an HttpResponse.`);
-    response = await convertErrorToResponse(error, ctx, appController);
+    response = await convertErrorToResponse(error, ctx, appController, logger);
   }
 
   for (const postFn of hookPostFunctions) {
     try {
       await postFn(response);
     } catch (error: any) {
-      response = await convertErrorToResponse(error, ctx, appController);
+      response = await convertErrorToResponse(error, ctx, appController, logger);
     }
   }
 

From 5f5c60941b13f1d6aee949d7c7a4b3916269adc9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 13:07:38 +0200
Subject: [PATCH 08/37] Use Foal logger when an error is thrown in WS
 controller

---
 ...onvert-error-to-websocket-response.spec.ts | 39 +++++++++++++------
 .../convert-error-to-websocket-response.ts    |  9 ++++-
 .../src/routes/get-websocket-response.ts      | 12 +++---
 3 files changed, 41 insertions(+), 19 deletions(-)

diff --git a/packages/socket.io/src/errors/convert-error-to-websocket-response.spec.ts b/packages/socket.io/src/errors/convert-error-to-websocket-response.spec.ts
index f3cfb36283..b3ed99804f 100644
--- a/packages/socket.io/src/errors/convert-error-to-websocket-response.spec.ts
+++ b/packages/socket.io/src/errors/convert-error-to-websocket-response.spec.ts
@@ -23,12 +23,20 @@ describe('convertErrorToWebsocketResponse', () => {
   context('given the configuration settings.logErrors is true or not defined', () => {
 
     it('should log the error stack.', async () => {
-      let message = '';
-      const log = (msg: string) => message = msg;
+      let actualMessage: string|undefined;
+      let actualError: Error|undefined;
 
-      await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), log);
+      const logger = {
+        error(message: string, { error }: { error: Error }): void {
+          actualMessage = message;
+          actualError = error;
+        }
+      }
+
+      await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), logger);
 
-      strictEqual(message, error.stack);
+      strictEqual(actualMessage, error.message);
+      strictEqual(actualError, error);
     });
 
   });
@@ -40,12 +48,19 @@ describe('convertErrorToWebsocketResponse', () => {
     afterEach(() => Config.remove('settings.logErrors'));
 
     it('should not log the error stack.', async () => {
-      let message = '';
-      const log = (msg: string) => message = msg;
+      let actualMessage: string|undefined;
+      let actualError: Error|undefined;
 
-      await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), log);
+      const logger = {
+        error(message: string, { error }: { error: Error }): void {
+          actualMessage = message;
+          actualError = error;
+        }
+      }
+      await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), logger);
 
-      strictEqual(message, '');
+      strictEqual(actualMessage, undefined);
+      strictEqual(actualError, undefined);
     });
 
   });
@@ -53,7 +68,7 @@ describe('convertErrorToWebsocketResponse', () => {
   context('given socketioController.handleError is not defined', () => {
 
     it('should return an WebsocketErrorResponse object created by renderWebsocketError.', async () => {
-      const response = await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), () => {});
+      const response = await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), { error: () => {} });
 
       if (!(response instanceof WebsocketErrorResponse)) {
         throw new Error('An WebsocketErrorResponse should have been returned.');
@@ -83,7 +98,7 @@ describe('convertErrorToWebsocketResponse', () => {
       }
 
       it('should return the response returned by handleError.', async () => {
-        const response = await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), () => {});
+        const response = await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), { error: () => {} });
 
         if (!(response instanceof WebsocketErrorResponse)) {
           throw new Error('An WebsocketErrorResponse should have been returned.');
@@ -103,7 +118,7 @@ describe('convertErrorToWebsocketResponse', () => {
       }
 
       it('should return an WebsocketErrorResponse object created by renderWebsocketError.', async () => {
-        const response = await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), () => {});
+        const response = await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), { error: () => {} });
 
         if (!(response instanceof WebsocketErrorResponse)) {
           throw new Error('An WebsocketErrorResponse should have been returned.');
@@ -124,7 +139,7 @@ describe('convertErrorToWebsocketResponse', () => {
       }
 
       it('should return an WebsocketErrorResponse object created by renderWebsocketError.', async () => {
-        const response = await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), () => {});
+        const response = await convertErrorToWebsocketResponse(error, ctx, new SocketIOController(), { error: () => {} });
 
         if (!(response instanceof WebsocketErrorResponse)) {
           throw new Error('An WebsocketErrorResponse should have been returned.');
diff --git a/packages/socket.io/src/errors/convert-error-to-websocket-response.ts b/packages/socket.io/src/errors/convert-error-to-websocket-response.ts
index d15c568ad1..06f5e07242 100644
--- a/packages/socket.io/src/errors/convert-error-to-websocket-response.ts
+++ b/packages/socket.io/src/errors/convert-error-to-websocket-response.ts
@@ -6,10 +6,15 @@ import { ISocketIOController, WebsocketContext, WebsocketErrorResponse, Websocke
 import { renderWebsocketError } from './render-websocket-error';
 
 export async function convertErrorToWebsocketResponse(
-  error: Error, ctx: WebsocketContext, socketIOController: ISocketIOController, log = console.error
+  error: Error,
+  ctx: WebsocketContext,
+  socketIOController: ISocketIOController,
+  logger: {
+    error: (message: string, params: { error: Error }) => void
+  }
 ): Promise<WebsocketResponse | WebsocketErrorResponse> {
   if (Config.get('settings.logErrors', 'boolean', true)) {
-    log(error.stack);
+    logger.error(error.message, { error });
   }
 
   if (socketIOController.handleError) {
diff --git a/packages/socket.io/src/routes/get-websocket-response.ts b/packages/socket.io/src/routes/get-websocket-response.ts
index 644bf17c03..21b66f9fb0 100644
--- a/packages/socket.io/src/routes/get-websocket-response.ts
+++ b/packages/socket.io/src/routes/get-websocket-response.ts
@@ -1,5 +1,5 @@
 // 3p
-import { ServiceManager } from '@foal/core';
+import { Logger, ServiceManager } from '@foal/core';
 
 // FoalTS
 import {
@@ -15,6 +15,8 @@ import { convertErrorToWebsocketResponse } from '../errors';
 export async function getWebsocketResponse(
   route: WebsocketRoute, ctx: WebsocketContext, services: ServiceManager, socketIOController: ISocketIOController
 ): Promise<WebsocketResponse | WebsocketErrorResponse> {
+  const logger = services.get(Logger);
+
   let response: undefined | WebsocketResponse | WebsocketErrorResponse;
 
   const hookPostFunctions: WebsocketHookPostFunction[] = [];
@@ -24,7 +26,7 @@ export async function getWebsocketResponse(
     try {
       result = await hook(ctx, services);
     } catch (error: any) {
-      result = await convertErrorToWebsocketResponse(error, ctx, socketIOController);
+      result = await convertErrorToWebsocketResponse(error, ctx, socketIOController, logger);
     }
     if ((result instanceof WebsocketResponse) || (result instanceof WebsocketErrorResponse)) {
       response = result;
@@ -38,20 +40,20 @@ export async function getWebsocketResponse(
     try {
       response = await route.controller[route.propertyKey](ctx, ctx.payload);
     } catch (error: any) {
-      response = await convertErrorToWebsocketResponse(error, ctx, socketIOController);
+      response = await convertErrorToWebsocketResponse(error, ctx, socketIOController, logger);
     }
   }
 
   if (!((response instanceof WebsocketResponse) || (response instanceof WebsocketErrorResponse))) {
     const error = new Error(`The controller method "${route.propertyKey}" should return a WebsocketResponse or a WebsocketErrorResponse.`);
-    response = await convertErrorToWebsocketResponse(error, ctx, socketIOController);
+    response = await convertErrorToWebsocketResponse(error, ctx, socketIOController, logger);
   }
 
   for (const postFn of hookPostFunctions) {
     try {
       await postFn(response);
     } catch (error: any) {
-      response = await convertErrorToWebsocketResponse(error, ctx, socketIOController);
+      response = await convertErrorToWebsocketResponse(error, ctx, socketIOController, logger);
     }
   }
 

From 40c7f2357933787ac65ceb295b95bc70835da6a1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 13:12:29 +0200
Subject: [PATCH 09/37] Use Foal logger when a stream error is thrown

---
 packages/core/src/express/create-app.ts         | 10 +++++++---
 packages/core/src/express/send-response.spec.ts |  2 +-
 packages/core/src/express/send-response.ts      | 14 +++++++++++---
 3 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/packages/core/src/express/create-app.ts b/packages/core/src/express/create-app.ts
index 5a3c9f6e95..01562235d3 100644
--- a/packages/core/src/express/create-app.ts
+++ b/packages/core/src/express/create-app.ts
@@ -1,7 +1,7 @@
 // 3p
 import * as cookieParser from 'cookie-parser';
 import * as express from 'express';
-import * as logger from 'morgan';
+import * as morgan from 'morgan';
 
 // FoalTS
 import {
@@ -15,6 +15,7 @@ import {
   ServiceManager,
 } from '../core';
 import { sendResponse } from './send-response';
+import { Logger } from '../common';
 
 export const OPENAPI_SERVICE_ID = 'OPENAPI_SERVICE_ID_a5NWKbBNBxVVZ';
 
@@ -86,7 +87,7 @@ export async function createApp(
     '[:date] ":method :url HTTP/:http-version" :status - :response-time ms'
   );
   if (loggerFormat !== 'none') {
-    app.use(logger(loggerFormat));
+    app.use(morgan(loggerFormat));
   }
 
   app.use(protectionHeaders);
@@ -116,6 +117,9 @@ export async function createApp(
   const services = options.serviceManager || new ServiceManager();
   app.foal = { services };
 
+  // Retrieve the logger.
+  const logger = services.get(Logger);
+
   // Inject the OpenAPI service with an ID string to avoid duplicated singletons
   // across several npm packages.
   services.set(OPENAPI_SERVICE_ID, services.get(OpenApi));
@@ -131,7 +135,7 @@ export async function createApp(
         const ctx = new Context(req, route.controller.constructor.name, route.propertyKey);
         // TODO: better test this line.
         const response = await getResponse(route, ctx, services, appController);
-        sendResponse(response, res);
+        sendResponse(response, res, logger);
       } catch (error: any) {
         // This try/catch will never be called: the `getResponse` function catches any errors
         // thrown or rejected in the application and converts it into a response.
diff --git a/packages/core/src/express/send-response.spec.ts b/packages/core/src/express/send-response.spec.ts
index 0ba321c7cb..06cee9f07e 100644
--- a/packages/core/src/express/send-response.spec.ts
+++ b/packages/core/src/express/send-response.spec.ts
@@ -16,7 +16,7 @@ import { sendResponse } from './send-response';
 
 function execSendResponse(response: HttpResponse): request.Test {
   const app = express()
-    .use((req: any, res: any) => sendResponse(response, res));
+    .use((req: any, res: any) => sendResponse(response, res, { error: () => {} }));
   return request(app).get('/');
 }
 
diff --git a/packages/core/src/express/send-response.ts b/packages/core/src/express/send-response.ts
index 7678bcff9f..7585c7b526 100644
--- a/packages/core/src/express/send-response.ts
+++ b/packages/core/src/express/send-response.ts
@@ -12,7 +12,13 @@ import { HttpResponse, isHttpResponseMovedPermanently, isHttpResponseRedirect }
  * @param {any} res - Express response used in middlewares.
  * @returns {void}
  */
-export function sendResponse(response: HttpResponse, res: any): void {
+export function sendResponse(
+  response: HttpResponse,
+  res: any,
+  logger: {
+    error: (message: string, params: { error: Error }) => void
+  }
+): void {
   res.status(response.statusCode);
   res.set(response.getHeaders());
   const cookies = response.getCookies();
@@ -35,8 +41,10 @@ export function sendResponse(response: HttpResponse, res: any): void {
   }
 
   if (response.stream === true) {
-    pipeline(response.body, res, (err: any) => {
-      if (err) { console.log(err); }
+    pipeline(response.body, res, (error: any) => {
+      if (error) {
+        logger.error(error.message, { error });
+      }
     });
     return;
   }

From fcf298ff379e0618fdc996a86a788ff94238678b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 13:16:59 +0200
Subject: [PATCH 10/37] [CLI] Configure Foal logger for different environments

---
 .../cli/src/generate/specs/app/config/development.json     | 7 +++++--
 packages/cli/src/generate/specs/app/config/development.yml | 4 +++-
 packages/cli/src/generate/specs/app/config/e2e.json        | 7 +++++--
 .../cli/src/generate/specs/app/config/e2e.mongodb.json     | 5 ++++-
 packages/cli/src/generate/specs/app/config/e2e.mongodb.yml | 2 ++
 packages/cli/src/generate/specs/app/config/e2e.yml         | 2 ++
 .../cli/src/generate/templates/app/config/development.json | 7 +++++--
 .../cli/src/generate/templates/app/config/development.yml  | 4 +++-
 packages/cli/src/generate/templates/app/config/e2e.json    | 7 +++++--
 .../cli/src/generate/templates/app/config/e2e.mongodb.json | 5 ++++-
 .../cli/src/generate/templates/app/config/e2e.mongodb.yml  | 2 ++
 packages/cli/src/generate/templates/app/config/e2e.yml     | 2 ++
 12 files changed, 42 insertions(+), 12 deletions(-)

diff --git a/packages/cli/src/generate/specs/app/config/development.json b/packages/cli/src/generate/specs/app/config/development.json
index 11141fbb0f..a9481b4c2e 100644
--- a/packages/cli/src/generate/specs/app/config/development.json
+++ b/packages/cli/src/generate/specs/app/config/development.json
@@ -1,6 +1,9 @@
 {
   "settings": {
     "debug": true,
-    "loggerFormat": "dev"
+    "loggerFormat": "dev",
+    "logger": {
+      "format": "dev"
+    }
   }
-}
+}
\ No newline at end of file
diff --git a/packages/cli/src/generate/specs/app/config/development.yml b/packages/cli/src/generate/specs/app/config/development.yml
index b7f97731c5..fb65913555 100644
--- a/packages/cli/src/generate/specs/app/config/development.yml
+++ b/packages/cli/src/generate/specs/app/config/development.yml
@@ -1,3 +1,5 @@
 settings:
   debug: true
-  loggerFormat: dev
\ No newline at end of file
+  loggerFormat: dev
+  logger: 
+    format: dev
\ No newline at end of file
diff --git a/packages/cli/src/generate/specs/app/config/e2e.json b/packages/cli/src/generate/specs/app/config/e2e.json
index ed22ed8551..052e0449c5 100644
--- a/packages/cli/src/generate/specs/app/config/e2e.json
+++ b/packages/cli/src/generate/specs/app/config/e2e.json
@@ -1,10 +1,13 @@
 {
   "settings": {
-    "loggerFormat": "none"
+    "loggerFormat": "none",
+    "logger": {
+      "format": "none"
+    }
   },
   "database": {
     "database": "./e2e_db.sqlite3",
     "dropSchema": true,
     "synchronize": true
   }
-}
+}
\ No newline at end of file
diff --git a/packages/cli/src/generate/specs/app/config/e2e.mongodb.json b/packages/cli/src/generate/specs/app/config/e2e.mongodb.json
index 0557ec9654..7de247fad9 100644
--- a/packages/cli/src/generate/specs/app/config/e2e.mongodb.json
+++ b/packages/cli/src/generate/specs/app/config/e2e.mongodb.json
@@ -1,6 +1,9 @@
 {
   "settings": {
-    "loggerFormat": "none"
+    "loggerFormat": "none",
+    "logger": {
+      "format": "none"
+    }
   },
   "database": {
     "url": "mongodb://localhost:27017/e2e-test-foo-bar"
diff --git a/packages/cli/src/generate/specs/app/config/e2e.mongodb.yml b/packages/cli/src/generate/specs/app/config/e2e.mongodb.yml
index 281daa0052..7bc7bb3448 100644
--- a/packages/cli/src/generate/specs/app/config/e2e.mongodb.yml
+++ b/packages/cli/src/generate/specs/app/config/e2e.mongodb.yml
@@ -1,5 +1,7 @@
 settings:
   loggerFormat: 'none'
+  logger:
+    format: 'none'
 
 database:
   url: mongodb://localhost:27017/e2e-test-foo-bar
diff --git a/packages/cli/src/generate/specs/app/config/e2e.yml b/packages/cli/src/generate/specs/app/config/e2e.yml
index 06a4add77f..60f92f0c56 100644
--- a/packages/cli/src/generate/specs/app/config/e2e.yml
+++ b/packages/cli/src/generate/specs/app/config/e2e.yml
@@ -1,5 +1,7 @@
 settings:
   loggerFormat: 'none'
+  logger:
+    format: 'none'
 
 database:
   database: './e2e_db.sqlite3'
diff --git a/packages/cli/src/generate/templates/app/config/development.json b/packages/cli/src/generate/templates/app/config/development.json
index 11141fbb0f..a9481b4c2e 100644
--- a/packages/cli/src/generate/templates/app/config/development.json
+++ b/packages/cli/src/generate/templates/app/config/development.json
@@ -1,6 +1,9 @@
 {
   "settings": {
     "debug": true,
-    "loggerFormat": "dev"
+    "loggerFormat": "dev",
+    "logger": {
+      "format": "dev"
+    }
   }
-}
+}
\ No newline at end of file
diff --git a/packages/cli/src/generate/templates/app/config/development.yml b/packages/cli/src/generate/templates/app/config/development.yml
index b7f97731c5..c4ec70c649 100644
--- a/packages/cli/src/generate/templates/app/config/development.yml
+++ b/packages/cli/src/generate/templates/app/config/development.yml
@@ -1,3 +1,5 @@
 settings:
   debug: true
-  loggerFormat: dev
\ No newline at end of file
+  loggerFormat: dev
+  logger:
+    format: dev
\ No newline at end of file
diff --git a/packages/cli/src/generate/templates/app/config/e2e.json b/packages/cli/src/generate/templates/app/config/e2e.json
index ed22ed8551..052e0449c5 100644
--- a/packages/cli/src/generate/templates/app/config/e2e.json
+++ b/packages/cli/src/generate/templates/app/config/e2e.json
@@ -1,10 +1,13 @@
 {
   "settings": {
-    "loggerFormat": "none"
+    "loggerFormat": "none",
+    "logger": {
+      "format": "none"
+    }
   },
   "database": {
     "database": "./e2e_db.sqlite3",
     "dropSchema": true,
     "synchronize": true
   }
-}
+}
\ No newline at end of file
diff --git a/packages/cli/src/generate/templates/app/config/e2e.mongodb.json b/packages/cli/src/generate/templates/app/config/e2e.mongodb.json
index 0526879660..6ad1e7e7e4 100644
--- a/packages/cli/src/generate/templates/app/config/e2e.mongodb.json
+++ b/packages/cli/src/generate/templates/app/config/e2e.mongodb.json
@@ -1,6 +1,9 @@
 {
   "settings": {
-    "loggerFormat": "none"
+    "loggerFormat": "none",
+    "logger": {
+      "format": "none"
+    }
   },
   "database": {
     "url": "mongodb://localhost:27017/e2e-/* kebabName */"
diff --git a/packages/cli/src/generate/templates/app/config/e2e.mongodb.yml b/packages/cli/src/generate/templates/app/config/e2e.mongodb.yml
index f3ea49f64c..609d06f307 100644
--- a/packages/cli/src/generate/templates/app/config/e2e.mongodb.yml
+++ b/packages/cli/src/generate/templates/app/config/e2e.mongodb.yml
@@ -1,5 +1,7 @@
 settings:
   loggerFormat: 'none'
+  logger:
+    format: 'none'
 
 database:
   url: mongodb://localhost:27017/e2e-/* kebabName */
diff --git a/packages/cli/src/generate/templates/app/config/e2e.yml b/packages/cli/src/generate/templates/app/config/e2e.yml
index 06a4add77f..60f92f0c56 100644
--- a/packages/cli/src/generate/templates/app/config/e2e.yml
+++ b/packages/cli/src/generate/templates/app/config/e2e.yml
@@ -1,5 +1,7 @@
 settings:
   loggerFormat: 'none'
+  logger:
+    format: 'none'
 
 database:
   database: './e2e_db.sqlite3'

From 5d797ca19744590401007c061c5dc9077a9f67df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 13:18:50 +0200
Subject: [PATCH 11/37] Use Foal logger in examples

---
 packages/examples/config/default.yml                       | 2 --
 packages/examples/config/development.yml                   | 5 +++++
 .../examples/src/app/controllers/profile.controller.ts     | 7 +++++--
 3 files changed, 10 insertions(+), 4 deletions(-)
 create mode 100644 packages/examples/config/development.yml

diff --git a/packages/examples/config/default.yml b/packages/examples/config/default.yml
index 304432adae..ee139f9d52 100644
--- a/packages/examples/config/default.yml
+++ b/packages/examples/config/default.yml
@@ -3,8 +3,6 @@ port: 3001
 settings:
   openapi:
     useHooks: true
-  debug: true
-  loggerFormat: dev
   session:
     secret: 'my secret'
   staticPath: 'public/'
diff --git a/packages/examples/config/development.yml b/packages/examples/config/development.yml
new file mode 100644
index 0000000000..c4ec70c649
--- /dev/null
+++ b/packages/examples/config/development.yml
@@ -0,0 +1,5 @@
+settings:
+  debug: true
+  loggerFormat: dev
+  logger:
+    format: dev
\ No newline at end of file
diff --git a/packages/examples/src/app/controllers/profile.controller.ts b/packages/examples/src/app/controllers/profile.controller.ts
index e8e9a34034..21e21eeb98 100644
--- a/packages/examples/src/app/controllers/profile.controller.ts
+++ b/packages/examples/src/app/controllers/profile.controller.ts
@@ -1,5 +1,5 @@
 import {
-  ApiInfo, ApiServer, Context, dependency, Get, Hook, HttpResponseNotFound, HttpResponseRedirect, Post, render, UserRequired
+  ApiInfo, ApiServer, Context, dependency, Get, Hook, HttpResponseNotFound, HttpResponseRedirect, Logger, Post, render, UserRequired
 } from '@foal/core';
 import { Disk, ParseAndValidateFiles } from '@foal/storage';
 
@@ -16,6 +16,9 @@ export class ProfileController {
   @dependency
   disk: Disk;
 
+  @dependency
+  logger: Logger;
+
   @Post('/image')
   @Hook(async ctx => { ctx.user = await User.findOneBy({ email: 'john@foalts.org' }); })
   @UserRequired()
@@ -28,7 +31,7 @@ export class ProfileController {
       try {
         await this.disk.delete(user.profile);
       } catch (error: any) {
-        console.log(error.message);
+        this.logger.error(error.message, { err: error });
       }
     }
 

From d5b40764e6cd925a10d8de4a45cfbe675f786f82 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Wed, 18 Oct 2023 22:28:29 +0200
Subject: [PATCH 12/37] [CLI] Fix template

---
 packages/cli/src/generate/specs/app/config/development.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/cli/src/generate/specs/app/config/development.yml b/packages/cli/src/generate/specs/app/config/development.yml
index fb65913555..c4ec70c649 100644
--- a/packages/cli/src/generate/specs/app/config/development.yml
+++ b/packages/cli/src/generate/specs/app/config/development.yml
@@ -1,5 +1,5 @@
 settings:
   debug: true
   loggerFormat: dev
-  logger: 
+  logger:
     format: dev
\ No newline at end of file

From 158170db4eeb03997486d40c5bb9a026cd4c6e8b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Thu, 19 Oct 2023 00:34:40 +0200
Subject: [PATCH 13/37] Move formatMessage to logger.utils

---
 .../core/src/common/logging/logger.spec.ts    |  71 +-------
 packages/core/src/common/logging/logger.ts    | 126 +------------
 .../src/common/logging/logger.utils.spec.ts   | 169 ++++++++++++++++++
 .../core/src/common/logging/logger.utils.ts   | 108 +++++++++++
 4 files changed, 281 insertions(+), 193 deletions(-)
 create mode 100644 packages/core/src/common/logging/logger.utils.spec.ts
 create mode 100644 packages/core/src/common/logging/logger.utils.ts

diff --git a/packages/core/src/common/logging/logger.spec.ts b/packages/core/src/common/logging/logger.spec.ts
index 7430fbee35..222052d8ab 100644
--- a/packages/core/src/common/logging/logger.spec.ts
+++ b/packages/core/src/common/logging/logger.spec.ts
@@ -221,78 +221,9 @@ describe('Logger', () => {
 
         throws(
           () => logger.debug(message),
-          (error: any) => error.message === '[CONFIG] Invalid "settings.logger.format" configuration value: "foobar"'
+          (error: any) => error.message === 'Invalid logging format: "foobar"'
         );
       });
     });
   });
-
-  describe('when info is called', () => {
-    context('given the configuration "settings.logger.format" is "dev"', () => {
-      beforeEach(() => {
-        Config.set('settings.logger.format', 'dev');
-      });
-
-      it('should log a text with the proper color on the log level', () => {
-        const { logger, mocks, localTimeNow } = createLogger();
-
-        const message = 'Hello world';
-        const params = createTestParams();
-
-        logger.info(message, params);
-
-        const actual = mocks.logWithConsoleHasBeenCalledWith;
-        // Cyan color
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m Hello world`;
-
-        strictEqual(actual.split('\n')[0], expected);
-      });
-    });
-  });
-
-  describe('when warn is called', () => {
-    context('given the configuration "settings.logger.format" is "dev"', () => {
-      beforeEach(() => {
-        Config.set('settings.logger.format', 'dev');
-      });
-
-      it('should log a text with the proper color on the log level', () => {
-        const { logger, mocks, localTimeNow } = createLogger();
-
-        const message = 'Hello world';
-        const params = createTestParams();
-
-        logger.warn(message, params);
-
-        const actual = mocks.logWithConsoleHasBeenCalledWith;
-        // Yellow color
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[33mWARN\u001b[39m Hello world`;
-
-        strictEqual(actual.split('\n')[0], expected);
-      });
-    });
-  });
-
-  describe('when error is called', () => {
-    context('given the configuration "settings.logger.format" is "dev"', () => {
-      beforeEach(() => {
-        Config.set('settings.logger.format', 'dev');
-      });
-
-      it('should log a text with the proper color on the log level', () => {
-        const { logger, mocks, localTimeNow } = createLogger();
-
-        const message = 'Hello world';
-        const params = createTestParams();
-
-        logger.error(message, params);
-
-        const actual = mocks.logWithConsoleHasBeenCalledWith;
-        // Red color
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[31mERROR\u001b[39m Hello world`;
-
-        strictEqual(actual.split('\n')[0], expected);
-      });
-    });
-  });
 });
diff --git a/packages/core/src/common/logging/logger.ts b/packages/core/src/common/logging/logger.ts
index 0290b50f90..7517f62cf8 100644
--- a/packages/core/src/common/logging/logger.ts
+++ b/packages/core/src/common/logging/logger.ts
@@ -1,128 +1,8 @@
 import { Config } from '../../core';
-
-type Level = 'debug'|'info'|'warn'|'error';
-
-function formatObjectToJson(obj: Record<string, any>): string {
-  if (obj.error instanceof Error) {
-    return JSON.stringify({
-      ...obj,
-      error: {
-        name: obj.error.name,
-        message: obj.error.message,
-        stack: obj.error.stack,
-      },
-    });
-  };
-  return JSON.stringify(obj);
-}
-
-function formatObjectToTextParameters(obj: Record<string, any>): string {
-  const tab = '    ';
-  const space = '  ';
-  const spaceSize = space.length;
-
-  return Object
-    .entries(obj)
-    .reduce((lines, [key, value]) => {
-      if (value instanceof Error) {
-        return [
-          ...lines,
-          `${key}: {`,
-          `${space}name: "${value.name}"`,
-          `${space}message: "${value.message}"`,
-          `${space}stack: ${value.stack?.split('\n').join(`\n${space}${space}`)}`,
-          `}`,
-        ];
-      }
-
-      const formattedValue = JSON.stringify(value, null, spaceSize)?.split('\n').join(`\n${tab}`);
-      if (formattedValue !== undefined) {
-        return [
-          ...lines,
-          `${key}: ${formattedValue}`,
-        ];
-      }
-
-      return lines;
-    }, [] as string[])
-    .map(str => `\n${tab}${str}`)
-    .join('');
-}
+import { Level, formatMessage } from './logger.utils';
 
 export class Logger {
 
-  private formatMessageToJson(
-    now: Date,
-    level: Level,
-    message: string,
-    params: { [name: string]: any }
-  ): string {
-    const json = {
-      timestamp: now,
-      level,
-      message,
-      ...params,
-    };
-
-    return formatObjectToJson(json);
-  }
-
-  private formatMessageToRawText(
-    now: Date,
-    level: Level,
-    message: string,
-    params: { [name: string]: any }
-  ): string {
-    const timestamp = `[${now.toISOString()}]`;
-    const logLevel = `[${level.toUpperCase()}]`;
-    const parameters = formatObjectToTextParameters(params);
-
-    return `${timestamp} ${logLevel} ${message}${parameters}`;
-  }
-
-  private formatMessageToDevText(
-    now: Date,
-    level: Level,
-    message: string,
-    params: { [name: string]: any }
-  ): string {
-    const colors = {
-      debug: '\u001b[35m', // Pink
-      info: '\u001b[36m', // Cyan
-      warn: '\u001b[33m', // Yellow
-      error: '\u001b[31m', // Red
-    };
-    const timestampColor = '\u001b[90m'; // Gray
-    const endTagColor = '\u001b[39m';
-
-    const timestamp = `${timestampColor}[${now.toLocaleTimeString()}]${endTagColor}`;
-    const logLevel = `${colors[level]}${level.toUpperCase()}${endTagColor}`;
-    const parameters = formatObjectToTextParameters({ error: params.error });
-
-    return `${timestamp} ${logLevel} ${message}${parameters}`;
-  }
-
-  private formatMessage(
-    level: Level,
-    message: string,
-    params: { [name: string]: any },
-    now: Date,
-    format: string,
-  ): string|null {
-    switch (format) {
-      case 'raw':
-        return this.formatMessageToRawText(now, level, message, params);
-      case 'dev':
-        return this.formatMessageToDevText(now, level, message, params);
-      case 'json':
-        return this.formatMessageToJson(now, level, message, params);
-      case 'none':
-        return null;
-      default:
-        throw new Error(`[CONFIG] Invalid "settings.logger.format" configuration value: "${format}"`);
-    }
-  }
-
   private log(
     level: Level,
     message: string,
@@ -131,12 +11,12 @@ export class Logger {
     const format = Config.get('settings.logger.format', 'string', 'raw');
     const now = this.getNow();
 
-    const messageFormatted = this.formatMessage(
+    const messageFormatted = formatMessage(
       level,
       message,
       params,
-      now,
       format,
+      now,
     );
 
     if (messageFormatted !== null) {
diff --git a/packages/core/src/common/logging/logger.utils.spec.ts b/packages/core/src/common/logging/logger.utils.spec.ts
new file mode 100644
index 0000000000..9252b9a957
--- /dev/null
+++ b/packages/core/src/common/logging/logger.utils.spec.ts
@@ -0,0 +1,169 @@
+import { deepStrictEqual, strictEqual, throws } from 'assert';
+import { formatMessage } from './logger.utils';
+
+const testStack = `Error: aaa
+    at createTestParams (/somewhere/logger.spec.ts:6:11)
+    at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`;
+
+function createTestParams() {
+  const error = new Error('aaa');
+  error.stack = testStack;
+  return {
+    myBoolean: false,
+    myNull: null,
+    myUndefined: undefined,
+    myNumber: 0,
+    myString: 'xxx',
+    mySymbol: Symbol('yyy'),
+    myObject: { foo: 'bar' },
+    error
+  };
+}
+
+describe('formatMessage', () => {
+  const isoNow = '2023-02-03T01:12:03.000Z';
+  const localTimeNow = '2:12:03 AM';
+  const now = new Date(isoNow);
+
+  context('given format is "raw"', () => {
+    it('should return a raw text with a full timestamp, detailed params but with no colors.', () => {
+      const message = 'Hello world';
+      const params = createTestParams();
+
+      const actual = formatMessage('debug', message, params, 'raw', now);
+      const expected = `[${isoNow}] [DEBUG] Hello world`
+        + `\n    myBoolean: false`
+        + `\n    myNull: null`
+        + `\n    myNumber: 0`
+        + `\n    myString: "xxx"`
+        + `\n    myObject: {`
+        + `\n      "foo": "bar"`
+        + `\n    }`
+        + `\n    error: {`
+        + `\n      name: "Error"`
+        + `\n      message: "aaa"`
+        + `\n      stack: Error: aaa`
+        + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
+        + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
+        + `\n    }`;
+
+      strictEqual(actual, expected);
+    });
+  });
+
+  context('given format is "dev"', () => {
+    context('given level is "debug"', () => {
+      it('should return a text with gray and pink colors, a short timestamp but with no detailed params (expect for the "error" param).', () => {
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        const actual = formatMessage('debug', message, params, 'dev', now)
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[35mDEBUG\u001b[39m Hello world`
+          + `\n    error: {`
+          + `\n      name: "Error"`
+          + `\n      message: "aaa"`
+          + `\n      stack: Error: aaa`
+          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
+          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
+          + `\n    }`;
+
+        strictEqual(actual, expected);
+      });
+    });
+
+    context('given level is "info"', () => {
+      it('should return a text with gray and cyan colors, a short timestamp but with no detailed params (expect for the "error" param).', () => {
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        const actual = formatMessage('info', message, params, 'dev', now)
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m Hello world`
+          + `\n    error: {`
+          + `\n      name: "Error"`
+          + `\n      message: "aaa"`
+          + `\n      stack: Error: aaa`
+          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
+          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
+          + `\n    }`;
+
+        strictEqual(actual, expected);
+      });
+    });
+
+    context('given level is "warn"', () => {
+      it('should return a text with gray and yellow colors, a short timestamp but with no detailed params (expect for the "error" param).', () => {
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        const actual = formatMessage('warn', message, params, 'dev', now)
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[33mWARN\u001b[39m Hello world`
+          + `\n    error: {`
+          + `\n      name: "Error"`
+          + `\n      message: "aaa"`
+          + `\n      stack: Error: aaa`
+          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
+          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
+          + `\n    }`;
+
+        strictEqual(actual, expected);
+      });
+    });
+
+    context('given level is "error"', () => {
+      it('should return a text with gray and red colors, a short timestamp but with no detailed params (expect for the "error" param).', () => {
+        const message = 'Hello world';
+        const params = createTestParams();
+
+        const actual = formatMessage('error', message, params, 'dev', now)
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[31mERROR\u001b[39m Hello world`
+          + `\n    error: {`
+          + `\n      name: "Error"`
+          + `\n      message: "aaa"`
+          + `\n      stack: Error: aaa`
+          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
+          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
+          + `\n    }`;
+
+        strictEqual(actual, expected);
+      });
+    });
+  });
+
+  context('given format is "json"', () => {
+    it('should return a JSON string.', () => {
+      const message = 'Hello world';
+      const params = createTestParams();
+
+      const actual = JSON.parse(formatMessage('debug', message, params, 'json', now) || '');
+      const expected = {
+        message,
+        timestamp: isoNow,
+        level: 'debug',
+        myBoolean: false,
+        myNull: null,
+        myNumber: 0,
+        myString: 'xxx',
+        myObject: { foo: 'bar' },
+        error: {
+          name: 'Error',
+          message: 'aaa',
+          stack: testStack,
+        }
+      };
+
+      deepStrictEqual(actual, expected);
+    });
+  });
+
+  context('given format is invalid', () => {
+    it('should throw an error.', () => {
+      const message = 'Hello world';
+      const params = createTestParams();
+
+      throws(
+        () => formatMessage('debug', message, params, 'invalid', now),
+        (error: any) => error.message === 'Invalid logging format: "invalid"'
+      );
+    });
+  });
+})
\ No newline at end of file
diff --git a/packages/core/src/common/logging/logger.utils.ts b/packages/core/src/common/logging/logger.utils.ts
new file mode 100644
index 0000000000..4092116947
--- /dev/null
+++ b/packages/core/src/common/logging/logger.utils.ts
@@ -0,0 +1,108 @@
+export type Level = 'debug'|'info'|'warn'|'error';
+
+function formatParamsToText(params: { error?: Error, [name: string]: any }): string {
+  const tabLength = 2;
+  const offsetLength = 4;
+
+  const tab = ' '.repeat(tabLength);
+  const offset = ' '.repeat(offsetLength);
+
+  const lines: string[] = [];
+
+  for (const key in params) {
+    const value = params[key];
+    if (value instanceof Error) {
+      lines.push(
+        `${key}: {`,
+        `${tab}name: "${value.name}"`,
+        `${tab}message: "${value.message}"`,
+        `${tab}stack: ${value.stack?.split('\n').join(`\n${tab}${tab}`)}`,
+        `}`
+      );
+      continue;
+    }
+
+    const formattedValue = JSON.stringify(value, null, tabLength);
+
+    if (formattedValue !== undefined) {
+      lines.push(...`${key}: ${formattedValue}`.split('\n'));
+    }
+  }
+
+  return lines
+    .map(line => `\n${offset}${line}`)
+    .join('');
+}
+
+function formatMessageToRawText(
+  level: Level,
+  message: string,
+  params: { error?: Error, [name: string]: any },
+  now: Date
+): string {
+  const timestamp = `[${now.toISOString()}]`;
+  const logLevel = `[${level.toUpperCase()}]`;
+
+  return `${timestamp} ${logLevel} ${message}` + formatParamsToText(params);
+}
+
+function formatMessageToDevText(
+  level: Level,
+  message: string,
+  params: { error?: Error, [name: string]: any },
+  now: Date
+): string {
+  const levelColorCodes: Record<Level, number> = {
+    debug: 35,
+    info: 36,
+    warn: 33,
+    error: 31,
+  };
+  const timestamp = `\u001b[90m[${now.toLocaleTimeString()}]\u001b[39m`;
+  const logLevel = `\u001b[${levelColorCodes[level]}m${level.toUpperCase()}\u001b[39m`;
+
+  return `${timestamp} ${logLevel} ${message}` + formatParamsToText({ error: params.error });
+}
+
+function formatMessageToJson(
+  level: Level,
+  message: string,
+  params: { error?: Error, [name: string]: any },
+  now: Date
+): string {
+  const json = {
+    timestamp: now.toISOString(),
+    level,
+    message,
+    ...params,
+  };
+
+  if (json.error instanceof Error) {
+    json.error = {
+      name: json.error.name,
+      message: json.error.message,
+      stack: json.error.stack,
+    };
+  }
+
+  return JSON.stringify(json);
+}
+
+export function formatMessage(
+  level: Level,
+  message: string,
+  params: { error?: Error, [name: string]: any },
+  format: string,
+  now: Date,
+): string {
+  switch (format) {
+    case 'raw':
+      return formatMessageToRawText(level, message, params, now);
+    case 'dev':
+      return formatMessageToDevText(level, message, params, now);
+    case 'json':
+      return formatMessageToJson(level, message, params, now);
+    default:
+      throw new Error(`Invalid logging format: "${format}"`);
+  }
+}

From 28aa931dbc358f423747a5aef5dbb0e014c99a3b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Thu, 19 Oct 2023 10:03:40 +0200
Subject: [PATCH 14/37] Update Node types

---
 packages/acceptance-tests/package-lock.json        | 14 +++++++-------
 packages/acceptance-tests/package.json             |  4 ++--
 packages/aws-s3/package-lock.json                  | 14 +++++++-------
 packages/aws-s3/package.json                       |  4 ++--
 packages/cli/package-lock.json                     | 14 +++++++-------
 packages/cli/package.json                          |  4 ++--
 packages/cli/src/generate/specs/app/package.json   |  2 +-
 .../src/generate/specs/app/package.mongodb.json    |  2 +-
 .../generate/specs/app/package.mongodb.yaml.json   |  2 +-
 .../cli/src/generate/specs/app/package.yaml.json   |  2 +-
 .../cli/src/generate/templates/app/package.json    |  2 +-
 .../generate/templates/app/package.mongodb.json    |  2 +-
 packages/core/package-lock.json                    | 14 +++++++-------
 packages/core/package.json                         |  4 ++--
 packages/examples/package-lock.json                | 14 +++++++-------
 packages/examples/package.json                     |  4 ++--
 packages/graphiql/package-lock.json                | 14 +++++++-------
 packages/graphiql/package.json                     |  4 ++--
 packages/graphql/package-lock.json                 | 14 +++++++-------
 packages/graphql/package.json                      |  4 ++--
 packages/jwks-rsa/package-lock.json                | 14 +++++++-------
 packages/jwks-rsa/package.json                     |  4 ++--
 packages/jwt/package-lock.json                     | 14 +++++++-------
 packages/jwt/package.json                          |  4 ++--
 packages/password/package-lock.json                | 14 +++++++-------
 packages/password/package.json                     |  4 ++--
 packages/redis/package-lock.json                   | 14 +++++++-------
 packages/redis/package.json                        |  4 ++--
 packages/social/package-lock.json                  | 14 +++++++-------
 packages/social/package.json                       |  4 ++--
 packages/socket.io/package-lock.json               | 14 +++++++-------
 packages/socket.io/package.json                    |  4 ++--
 packages/storage/package-lock.json                 | 14 +++++++-------
 packages/storage/package.json                      |  4 ++--
 packages/swagger/package-lock.json                 | 14 +++++++-------
 packages/swagger/package.json                      |  4 ++--
 packages/typestack/package-lock.json               | 14 +++++++-------
 packages/typestack/package.json                    |  4 ++--
 38 files changed, 150 insertions(+), 150 deletions(-)

diff --git a/packages/acceptance-tests/package-lock.json b/packages/acceptance-tests/package-lock.json
index edd5dcd273..6988816512 100644
--- a/packages/acceptance-tests/package-lock.json
+++ b/packages/acceptance-tests/package-lock.json
@@ -31,7 +31,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "@types/react": "18.2.21",
         "@types/react-dom": "18.2.7",
         "@types/supertest": "2.0.12",
@@ -387,9 +387,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg=="
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w=="
     },
     "node_modules/@types/prop-types": {
       "version": "15.7.5",
@@ -4577,9 +4577,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg=="
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w=="
     },
     "@types/prop-types": {
       "version": "15.7.5",
diff --git a/packages/acceptance-tests/package.json b/packages/acceptance-tests/package.json
index 9e9e2a657d..8144344cda 100644
--- a/packages/acceptance-tests/package.json
+++ b/packages/acceptance-tests/package.json
@@ -48,7 +48,7 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "@types/react": "18.2.21",
     "@types/react-dom": "18.2.7",
     "@types/supertest": "2.0.12",
@@ -56,4 +56,4 @@
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/aws-s3/package-lock.json b/packages/aws-s3/package-lock.json
index f0d5913838..4db9d6b482 100644
--- a/packages/aws-s3/package-lock.json
+++ b/packages/aws-s3/package-lock.json
@@ -14,7 +14,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "copy": "~0.3.2",
         "mocha": "~10.2.0",
         "rimraf": "~5.0.1",
@@ -1535,9 +1535,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/acorn": {
@@ -5018,9 +5018,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "acorn": {
diff --git a/packages/aws-s3/package.json b/packages/aws-s3/package.json
index 0810431a7e..bd7b015b38 100644
--- a/packages/aws-s3/package.json
+++ b/packages/aws-s3/package.json
@@ -50,11 +50,11 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "copy": "~0.3.2",
     "mocha": "~10.2.0",
     "rimraf": "~5.0.1",
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/cli/package-lock.json b/packages/cli/package-lock.json
index 15b7c9808b..843dad19eb 100644
--- a/packages/cli/package-lock.json
+++ b/packages/cli/package-lock.json
@@ -21,7 +21,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "copyfiles": "~2.4.1",
         "mocha": "~10.2.0",
         "rimraf": "~5.0.1",
@@ -209,9 +209,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/acorn": {
@@ -1936,9 +1936,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "acorn": {
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 46317d5533..7a907792e1 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -66,11 +66,11 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "copyfiles": "~2.4.1",
     "mocha": "~10.2.0",
     "rimraf": "~5.0.1",
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/cli/src/generate/specs/app/package.json b/packages/cli/src/generate/specs/app/package.json
index 8be1b7d30d..6de2dfece4 100644
--- a/packages/cli/src/generate/specs/app/package.json
+++ b/packages/cli/src/generate/specs/app/package.json
@@ -33,7 +33,7 @@
   "devDependencies": {
     "@foal/cli": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "concurrently": "~8.2.1",
     "mocha": "~10.2.0",
     "supertest": "~6.3.3",
diff --git a/packages/cli/src/generate/specs/app/package.mongodb.json b/packages/cli/src/generate/specs/app/package.mongodb.json
index 1eb5a87c29..56396ffb66 100644
--- a/packages/cli/src/generate/specs/app/package.mongodb.json
+++ b/packages/cli/src/generate/specs/app/package.mongodb.json
@@ -29,7 +29,7 @@
   "devDependencies": {
     "@foal/cli": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "concurrently": "~8.2.1",
     "mocha": "~10.2.0",
     "supertest": "~6.3.3",
diff --git a/packages/cli/src/generate/specs/app/package.mongodb.yaml.json b/packages/cli/src/generate/specs/app/package.mongodb.yaml.json
index d865bf872a..05b62efa16 100644
--- a/packages/cli/src/generate/specs/app/package.mongodb.yaml.json
+++ b/packages/cli/src/generate/specs/app/package.mongodb.yaml.json
@@ -30,7 +30,7 @@
   "devDependencies": {
     "@foal/cli": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "concurrently": "~8.2.1",
     "mocha": "~10.2.0",
     "supertest": "~6.3.3",
diff --git a/packages/cli/src/generate/specs/app/package.yaml.json b/packages/cli/src/generate/specs/app/package.yaml.json
index a8b15c7523..a82e4f1488 100644
--- a/packages/cli/src/generate/specs/app/package.yaml.json
+++ b/packages/cli/src/generate/specs/app/package.yaml.json
@@ -34,7 +34,7 @@
   "devDependencies": {
     "@foal/cli": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "concurrently": "~8.2.1",
     "mocha": "~10.2.0",
     "supertest": "~6.3.3",
diff --git a/packages/cli/src/generate/templates/app/package.json b/packages/cli/src/generate/templates/app/package.json
index 6129f3d0fd..7b4fea82d9 100644
--- a/packages/cli/src/generate/templates/app/package.json
+++ b/packages/cli/src/generate/templates/app/package.json
@@ -33,7 +33,7 @@
   "devDependencies": {
     "@foal/cli": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "concurrently": "~8.2.1",
     "mocha": "~10.2.0",
     "supertest": "~6.3.3",
diff --git a/packages/cli/src/generate/templates/app/package.mongodb.json b/packages/cli/src/generate/templates/app/package.mongodb.json
index ab49726db1..c27bf56cc2 100644
--- a/packages/cli/src/generate/templates/app/package.mongodb.json
+++ b/packages/cli/src/generate/templates/app/package.mongodb.json
@@ -29,7 +29,7 @@
   "devDependencies": {
     "@foal/cli": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "concurrently": "~8.2.1",
     "mocha": "~10.2.0",
     "supertest": "~6.3.3",
diff --git a/packages/core/package-lock.json b/packages/core/package-lock.json
index 81eb506e35..5e9360ed64 100644
--- a/packages/core/package-lock.json
+++ b/packages/core/package-lock.json
@@ -18,7 +18,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "@types/supertest": "2.0.12",
         "ajv-errors": "~3.0.0",
         "ejs": "~3.1.9",
@@ -230,9 +230,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/@types/superagent": {
@@ -2770,9 +2770,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "@types/superagent": {
diff --git a/packages/core/package.json b/packages/core/package.json
index 468a8561e5..1ce7355c4a 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -69,7 +69,7 @@
   "devDependencies": {
     "@foal/internal-test": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "@types/supertest": "2.0.12",
     "ajv-errors": "~3.0.0",
     "ejs": "~3.1.9",
@@ -82,4 +82,4 @@
     "typescript": "~4.9.5",
     "yamljs": "~0.3.0"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/examples/package-lock.json b/packages/examples/package-lock.json
index ca160dc4f8..0a1b7e1741 100644
--- a/packages/examples/package-lock.json
+++ b/packages/examples/package-lock.json
@@ -17,7 +17,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "concurrently": "~8.2.1",
         "copy": "~0.3.2",
         "mocha": "~10.2.0",
@@ -124,9 +124,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/abbrev": {
@@ -3661,9 +3661,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "abbrev": {
diff --git a/packages/examples/package.json b/packages/examples/package.json
index e4e329f285..93f999bd32 100644
--- a/packages/examples/package.json
+++ b/packages/examples/package.json
@@ -61,11 +61,11 @@
   "devDependencies": {
     "@foal/cli": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "concurrently": "~8.2.1",
     "copy": "~0.3.2",
     "mocha": "~10.2.0",
     "supervisor": "~0.12.0",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/graphiql/package-lock.json b/packages/graphiql/package-lock.json
index ee6d68704c..b918379760 100644
--- a/packages/graphiql/package-lock.json
+++ b/packages/graphiql/package-lock.json
@@ -10,7 +10,7 @@
       "license": "MIT",
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "graphiql": "~3.0.5",
         "mocha": "~10.2.0",
         "react": "~18.1.0",
@@ -1129,9 +1129,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/@types/tern": {
@@ -3645,9 +3645,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "@types/tern": {
diff --git a/packages/graphiql/package.json b/packages/graphiql/package.json
index 245df5c6b4..ce81265a5c 100644
--- a/packages/graphiql/package.json
+++ b/packages/graphiql/package.json
@@ -44,7 +44,7 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "graphiql": "~3.0.5",
     "mocha": "~10.2.0",
     "react": "~18.1.0",
@@ -53,4 +53,4 @@
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/graphql/package-lock.json b/packages/graphql/package-lock.json
index 5c847240df..b8a0a76585 100644
--- a/packages/graphql/package-lock.json
+++ b/packages/graphql/package-lock.json
@@ -14,7 +14,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "graphql": "~16.8.0",
         "graphql-request": "~6.1.0",
         "mocha": "~10.2.0",
@@ -208,9 +208,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/@types/semver": {
@@ -1863,9 +1863,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "@types/semver": {
diff --git a/packages/graphql/package.json b/packages/graphql/package.json
index 530072f37d..94d87234e6 100644
--- a/packages/graphql/package.json
+++ b/packages/graphql/package.json
@@ -46,7 +46,7 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "graphql": "~16.8.0",
     "graphql-request": "~6.1.0",
     "mocha": "~10.2.0",
@@ -58,4 +58,4 @@
   "peerDependencies": {
     "graphql": "^16.8.0"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/jwks-rsa/package-lock.json b/packages/jwks-rsa/package-lock.json
index 9baed060d6..4d43aecffd 100644
--- a/packages/jwks-rsa/package-lock.json
+++ b/packages/jwks-rsa/package-lock.json
@@ -13,7 +13,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "mocha": "~10.2.0",
         "rimraf": "~5.0.1",
         "ts-node": "~10.9.1",
@@ -289,9 +289,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg=="
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w=="
     },
     "node_modules/@types/qs": {
       "version": "6.9.7",
@@ -2731,9 +2731,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg=="
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w=="
     },
     "@types/qs": {
       "version": "6.9.7",
diff --git a/packages/jwks-rsa/package.json b/packages/jwks-rsa/package.json
index 7a26d471c2..51f361c77a 100644
--- a/packages/jwks-rsa/package.json
+++ b/packages/jwks-rsa/package.json
@@ -53,10 +53,10 @@
     "@foal/core": "^4.0.0",
     "@foal/jwt": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "mocha": "~10.2.0",
     "rimraf": "~5.0.1",
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/jwt/package-lock.json b/packages/jwt/package-lock.json
index 9a1cb95ce6..d5a3326259 100644
--- a/packages/jwt/package-lock.json
+++ b/packages/jwt/package-lock.json
@@ -13,7 +13,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "mocha": "~10.2.0",
         "rimraf": "~5.0.1",
         "ts-node": "~10.9.1",
@@ -200,9 +200,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/acorn": {
@@ -1728,9 +1728,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "acorn": {
diff --git a/packages/jwt/package.json b/packages/jwt/package.json
index 57f34b52a7..bd1b2b2439 100644
--- a/packages/jwt/package.json
+++ b/packages/jwt/package.json
@@ -47,10 +47,10 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "mocha": "~10.2.0",
     "rimraf": "~5.0.1",
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/password/package-lock.json b/packages/password/package-lock.json
index f37e65176e..71cbee1338 100644
--- a/packages/password/package-lock.json
+++ b/packages/password/package-lock.json
@@ -10,7 +10,7 @@
       "license": "MIT",
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "copy": "~0.3.2",
         "mocha": "~10.2.0",
         "rimraf": "~5.0.1",
@@ -148,9 +148,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/acorn": {
@@ -2485,9 +2485,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "acorn": {
diff --git a/packages/password/package.json b/packages/password/package.json
index 718364f7c5..07a19b9418 100644
--- a/packages/password/package.json
+++ b/packages/password/package.json
@@ -41,11 +41,11 @@
   ],
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "copy": "~0.3.2",
     "mocha": "~10.2.0",
     "rimraf": "~5.0.1",
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/redis/package-lock.json b/packages/redis/package-lock.json
index d815b63251..dc4dc27759 100644
--- a/packages/redis/package-lock.json
+++ b/packages/redis/package-lock.json
@@ -13,7 +13,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "mocha": "~10.2.0",
         "rimraf": "~5.0.1",
         "ts-node": "~10.9.1",
@@ -253,9 +253,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/acorn": {
@@ -1739,9 +1739,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "acorn": {
diff --git a/packages/redis/package.json b/packages/redis/package.json
index ccf80c046d..8d3d6d3a2e 100644
--- a/packages/redis/package.json
+++ b/packages/redis/package.json
@@ -46,10 +46,10 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "mocha": "~10.2.0",
     "rimraf": "~5.0.1",
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/social/package-lock.json b/packages/social/package-lock.json
index f2b1f59306..3b277df1ca 100644
--- a/packages/social/package-lock.json
+++ b/packages/social/package-lock.json
@@ -13,7 +13,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "copy": "~0.3.2",
         "jsonwebtoken": "~9.0.2",
         "mocha": "~10.2.0",
@@ -202,9 +202,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/acorn": {
@@ -2613,9 +2613,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "acorn": {
diff --git a/packages/social/package.json b/packages/social/package.json
index 233bca229c..831aaea9d2 100644
--- a/packages/social/package.json
+++ b/packages/social/package.json
@@ -57,7 +57,7 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "copy": "~0.3.2",
     "jsonwebtoken": "~9.0.2",
     "mocha": "~10.2.0",
@@ -65,4 +65,4 @@
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/socket.io/package-lock.json b/packages/socket.io/package-lock.json
index 418c03ca3e..a1ee7c0f8d 100644
--- a/packages/socket.io/package-lock.json
+++ b/packages/socket.io/package-lock.json
@@ -15,7 +15,7 @@
       "devDependencies": {
         "@socket.io/redis-adapter": "~8.2.1",
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "mocha": "~10.2.0",
         "redis": "~4.6.8",
         "rimraf": "~5.0.1",
@@ -298,9 +298,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg=="
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w=="
     },
     "node_modules/accepts": {
       "version": "1.3.8",
@@ -2045,9 +2045,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg=="
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w=="
     },
     "accepts": {
       "version": "1.3.8",
diff --git a/packages/socket.io/package.json b/packages/socket.io/package.json
index 338be9fcd4..6b0b54b1ca 100644
--- a/packages/socket.io/package.json
+++ b/packages/socket.io/package.json
@@ -46,7 +46,7 @@
   "devDependencies": {
     "@socket.io/redis-adapter": "~8.2.1",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "mocha": "~10.2.0",
     "redis": "~4.6.8",
     "rimraf": "~5.0.1",
@@ -59,4 +59,4 @@
     "reflect-metadata": "~0.1.13",
     "socket.io": "~4.7.2"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/storage/package-lock.json b/packages/storage/package-lock.json
index 772859b06a..b69013860a 100644
--- a/packages/storage/package-lock.json
+++ b/packages/storage/package-lock.json
@@ -14,7 +14,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "@types/supertest": "2.0.12",
         "copy": "~0.3.2",
         "mocha": "~10.2.0",
@@ -210,9 +210,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/@types/superagent": {
@@ -2821,9 +2821,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "@types/superagent": {
diff --git a/packages/storage/package.json b/packages/storage/package.json
index f3ad808c3b..82e520e6b1 100644
--- a/packages/storage/package.json
+++ b/packages/storage/package.json
@@ -51,7 +51,7 @@
   "devDependencies": {
     "@foal/internal-test": "^4.0.0",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "@types/supertest": "2.0.12",
     "copy": "~0.3.2",
     "mocha": "~10.2.0",
@@ -60,4 +60,4 @@
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/swagger/package-lock.json b/packages/swagger/package-lock.json
index 5a31312314..63994020d5 100644
--- a/packages/swagger/package-lock.json
+++ b/packages/swagger/package-lock.json
@@ -13,7 +13,7 @@
       },
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "copy": "~0.3.2",
         "mocha": "~10.2.0",
         "rimraf": "~5.0.1",
@@ -201,9 +201,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/acorn": {
@@ -2446,9 +2446,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "acorn": {
diff --git a/packages/swagger/package.json b/packages/swagger/package.json
index d507d23fb6..c8c2dc3c65 100644
--- a/packages/swagger/package.json
+++ b/packages/swagger/package.json
@@ -48,11 +48,11 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "copy": "~0.3.2",
     "mocha": "~10.2.0",
     "rimraf": "~5.0.1",
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/typestack/package-lock.json b/packages/typestack/package-lock.json
index 5ff62dfff6..52214ef965 100644
--- a/packages/typestack/package-lock.json
+++ b/packages/typestack/package-lock.json
@@ -10,7 +10,7 @@
       "license": "MIT",
       "devDependencies": {
         "@types/mocha": "10.0.1",
-        "@types/node": "18.11.9",
+        "@types/node": "18.18.6",
         "@types/validator": "13.11.1",
         "class-transformer": "~0.5.1",
         "class-validator": "~0.14.0",
@@ -205,9 +205,9 @@
       "dev": true
     },
     "node_modules/@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "node_modules/@types/validator": {
@@ -2483,9 +2483,9 @@
       "dev": true
     },
     "@types/node": {
-      "version": "18.11.9",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.11.9.tgz",
-      "integrity": "sha512-CRpX21/kGdzjOpFsZSkcrXMGIBWMGNIHXXBVFSH+ggkftxg+XYP20TESbh+zFvFj3EQOl5byk0HTRn1IL6hbqg==",
+      "version": "18.18.6",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-18.18.6.tgz",
+      "integrity": "sha512-wf3Vz+jCmOQ2HV1YUJuCWdL64adYxumkrxtc+H1VUQlnQI04+5HtH+qZCOE21lBE7gIrt+CwX2Wv8Acrw5Ak6w==",
       "dev": true
     },
     "@types/validator": {
diff --git a/packages/typestack/package.json b/packages/typestack/package.json
index 5aff6b98b3..ff13d7c232 100644
--- a/packages/typestack/package.json
+++ b/packages/typestack/package.json
@@ -52,7 +52,7 @@
   },
   "devDependencies": {
     "@types/mocha": "10.0.1",
-    "@types/node": "18.11.9",
+    "@types/node": "18.18.6",
     "@types/validator": "13.11.1",
     "class-transformer": "~0.5.1",
     "class-validator": "~0.14.0",
@@ -62,4 +62,4 @@
     "ts-node": "~10.9.1",
     "typescript": "~4.9.5"
   }
-}
+}
\ No newline at end of file

From 164ced0d5ca4ddef658c8e3d8c271922b843aff7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Thu, 19 Oct 2023 10:15:37 +0200
Subject: [PATCH 15/37] Add shouldLog util

---
 .../src/common/logging/logger.utils.spec.ts   | 51 ++++++++++++++++++-
 .../core/src/common/logging/logger.utils.ts   | 13 +++++
 2 files changed, 62 insertions(+), 2 deletions(-)

diff --git a/packages/core/src/common/logging/logger.utils.spec.ts b/packages/core/src/common/logging/logger.utils.spec.ts
index 9252b9a957..3075bf3cf3 100644
--- a/packages/core/src/common/logging/logger.utils.spec.ts
+++ b/packages/core/src/common/logging/logger.utils.spec.ts
@@ -1,5 +1,5 @@
 import { deepStrictEqual, strictEqual, throws } from 'assert';
-import { formatMessage } from './logger.utils';
+import { formatMessage, shouldLog } from './logger.utils';
 
 const testStack = `Error: aaa
     at createTestParams (/somewhere/logger.spec.ts:6:11)
@@ -166,4 +166,51 @@ describe('formatMessage', () => {
       );
     });
   });
-})
\ No newline at end of file
+});
+
+describe('shouldLog', () => {
+  context('given the configLogLevel is "debug"', () => {
+    it('should return true for all levels.', () => {
+      strictEqual(shouldLog('debug', 'debug'), true);
+      strictEqual(shouldLog('info', 'debug'), true);
+      strictEqual(shouldLog('warn', 'debug'), true);
+      strictEqual(shouldLog('error', 'debug'), true);
+    });
+  });
+
+  context('given the configLogLevel is "info"', () => {
+    it('should return false for "debug" and true for "info", "warn" and "error".', () => {
+      strictEqual(shouldLog('debug', 'info'), false);
+      strictEqual(shouldLog('info', 'info'), true);
+      strictEqual(shouldLog('warn', 'info'), true);
+      strictEqual(shouldLog('error', 'info'), true);
+    });
+  });
+
+  context('given the configLogLevel is "warn"', () => {
+    it('should return false for "debug" and "info" and true for "warn" and "error".', () => {
+      strictEqual(shouldLog('debug', 'warn'), false);
+      strictEqual(shouldLog('info', 'warn'), false);
+      strictEqual(shouldLog('warn', 'warn'), true);
+      strictEqual(shouldLog('error', 'warn'), true);
+    });
+  });
+
+  context('given the configLogLevel is "error"', () => {
+    it('should return false for "debug", "info" and "warn" and true for "error".', () => {
+      strictEqual(shouldLog('debug', 'error'), false);
+      strictEqual(shouldLog('info', 'error'), false);
+      strictEqual(shouldLog('warn', 'error'), false);
+      strictEqual(shouldLog('error', 'error'), true);
+    });
+  });
+
+  context('given the configLogLevel is invalid', () => {
+    it('should throw an error.', () => {
+      throws(
+        () => shouldLog('debug', 'invalid'),
+        (error: any) => error.message === 'Invalid log level: "invalid"'
+      );
+    });
+  });
+});
\ No newline at end of file
diff --git a/packages/core/src/common/logging/logger.utils.ts b/packages/core/src/common/logging/logger.utils.ts
index 4092116947..ff0f0c445b 100644
--- a/packages/core/src/common/logging/logger.utils.ts
+++ b/packages/core/src/common/logging/logger.utils.ts
@@ -106,3 +106,16 @@ export function formatMessage(
       throw new Error(`Invalid logging format: "${format}"`);
   }
 }
+
+export function shouldLog(level: Level, configLogLevel: string): boolean {
+  const levels: string[] = ['debug', 'info', 'warn', 'error'];
+
+  const levelIndex = levels.indexOf(level);
+  const configLogLevelIndex = levels.indexOf(configLogLevel);
+
+  if (configLogLevelIndex === -1) {
+    throw new Error(`Invalid log level: "${configLogLevel}"`);
+  }
+
+  return levelIndex >= configLogLevelIndex;
+}
\ No newline at end of file

From 48c6a2a0d5a0d0068b2142b244755eb0b89bc005 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Thu, 19 Oct 2023 10:46:07 +0200
Subject: [PATCH 16/37] Add log level config in Logger

---
 .../core/src/common/logging/logger.spec.ts    | 327 +++++++-----------
 packages/core/src/common/logging/logger.ts    |  63 ++--
 2 files changed, 157 insertions(+), 233 deletions(-)

diff --git a/packages/core/src/common/logging/logger.spec.ts b/packages/core/src/common/logging/logger.spec.ts
index 222052d8ab..49cfc6b119 100644
--- a/packages/core/src/common/logging/logger.spec.ts
+++ b/packages/core/src/common/logging/logger.spec.ts
@@ -1,229 +1,156 @@
-import { deepStrictEqual, strictEqual, throws } from 'assert';
-import { Logger } from './logger';
-import { Config } from '../../core';
-
-const testStack = `Error: aaa
-    at createTestParams (/somewhere/logger.spec.ts:6:11)
-    at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`;
-
-function createTestParams() {
-  const error = new Error('aaa');
-  error.stack = testStack;
-  return {
-    myBoolean: false,
-    myNull: null,
-    myUndefined: undefined,
-    myNumber: 0,
-    myString: 'xxx',
-    mySymbol: Symbol('yyy'),
-    myObject: { foo: 'bar' },
-    error
-  };
-}
-
-function createLogger(): {
-  logger: Logger,
-  mocks: { logWithConsoleHasBeenCalledWith: any },
-  now: Date,
-  isoNow: string,
-  localTimeNow: string
-} {
-  const mocks: { logWithConsoleHasBeenCalledWith: any } = { logWithConsoleHasBeenCalledWith: undefined };
-
-  const isoNow = '2023-02-03T01:12:03.000Z';
-  const localTimeNow = '2:12:03 AM';
-  const now = new Date(isoNow);
-
-  class Logger2 extends Logger {
-    logWithConsole(message: string): void {
-      mocks.logWithConsoleHasBeenCalledWith = message;
-    }
-
-    getNow(): Date {
-      return now;
-    }
-  }
-
-  const logger = new Logger2();
-
-  return {
-    logger,
-    mocks,
-    now,
-    isoNow,
-    localTimeNow,
-  };
-}
+// std
+import { strictEqual } from 'assert';
+import { mock } from 'node:test';
 
-describe('Logger', () => {
+// FoalTS
+import { Logger, log } from './logger';
+import { Config } from '../../core';
 
+describe('log', () => {
   afterEach(() => {
+    mock.reset();
     Config.remove('settings.logger.format');
-  })
+    Config.remove('settings.logger.logLevel');
+  });
 
-  describe('when debug is called', () => {
-    context('given the configuration "settings.logger.format" is NOT defined', () => {
-      it('should log a text with an exhaustive timestamp, with params but with no colors', () => {
-        const { logger, mocks, isoNow } = createLogger();
-
-        const message = 'Hello world';
-        const params = createTestParams();
-
-        logger.debug(message, params);
-
-        const actual = mocks.logWithConsoleHasBeenCalledWith;
-        const expected = `[${isoNow}] [DEBUG] Hello world`
-          + `\n    myBoolean: false`
-          + `\n    myNull: null`
-          + `\n    myNumber: 0`
-          + `\n    myString: "xxx"`
-          + `\n    myObject: {`
-          + `\n      "foo": "bar"`
-          + `\n    }`
-          + `\n    error: {`
-          + `\n      name: "Error"`
-          + `\n      message: "aaa"`
-          + `\n      stack: Error: aaa`
-          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
-          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
-          + `\n    }`;
-
-        strictEqual(actual, expected);
-      });
-    });
+  context('given the configuration "settings.logger.format" is NOT defined', () => {
+    it('should log the message to a raw text.', () => {
+      const consoleMock = mock.method(console, 'log', () => {});
 
-    context('given the configuration "settings.logger.format" is "raw"', () => {
-      beforeEach(() => {
-        Config.set('settings.logger.format', 'raw');
-      });
-
-      it('should log a text with an exhaustive timestamp, with params but with no colors', () => {
-        const { logger, mocks, isoNow } = createLogger();
-
-        const message = 'Hello world';
-        const params = createTestParams();
-
-        logger.debug(message, params);
-
-        const actual = mocks.logWithConsoleHasBeenCalledWith;
-        const expected = `[${isoNow}] [DEBUG] Hello world`
-          + `\n    myBoolean: false`
-          + `\n    myNull: null`
-          + `\n    myNumber: 0`
-          + `\n    myString: "xxx"`
-          + `\n    myObject: {`
-          + `\n      "foo": "bar"`
-          + `\n    }`
-          + `\n    error: {`
-          + `\n      name: "Error"`
-          + `\n      message: "aaa"`
-          + `\n      stack: Error: aaa`
-          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
-          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
-          + `\n    }`;
-
-        strictEqual(actual, expected);
-      });
-    });
+      log('error', 'Hello world', {});
+
+      strictEqual(consoleMock.mock.callCount(), 1);
 
+      const loggedMessage = consoleMock.mock.calls[0].arguments[0];
 
-    context('given the configuration "settings.logger.format" is "dev"', () => {
-      beforeEach(() => {
-        Config.set('settings.logger.format', 'dev');
-      });
+      strictEqual(loggedMessage.includes('[ERROR]'), true);
+    })
+  });
 
-      it('should log a text with a short timestamp, with colors but with no params (except the "error" param)', () => {
-        const { logger, mocks, localTimeNow } = createLogger();
+  context('given the configuration "settings.logger.format" is "json"', () => {
+    it('should log the message to a JSON.', () => {
+      Config.set('settings.logger.format', 'json');
 
-        const message = 'Hello world';
-        const params = createTestParams();
+      const consoleMock = mock.method(console, 'log', () => {});
 
-        logger.debug(message, params);
+      log('error', 'Hello world', {});
 
-        const actual = mocks.logWithConsoleHasBeenCalledWith;
-        // Pink color
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[35mDEBUG\u001b[39m Hello world`
-          + `\n    error: {`
-          + `\n      name: "Error"`
-          + `\n      message: "aaa"`
-          + `\n      stack: Error: aaa`
-          + `\n        at createTestParams (/somewhere/logger.spec.ts:6:11)`
-          + `\n        at Context.<anonymous> (/somewhere/logger.spec.ts:129:13)`
-          + `\n    }`;
+      strictEqual(consoleMock.mock.callCount(), 1);
 
-        strictEqual(actual, expected);
-      });
-    });
+      const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+      const json = JSON.parse(loggedMessage);
 
-    context('given the configuration "settings.logger.format" is "json"', () => {
-      beforeEach(() => {
-        Config.set('settings.logger.format', 'json');
-      });
-
-      it('should log a JSON', () => {
-        const { logger, mocks, isoNow } = createLogger();
-
-        const message = 'Hello world';
-        const params = createTestParams();
-
-        logger.debug(message, params);
-
-        const actual = JSON.parse(mocks.logWithConsoleHasBeenCalledWith);
-        const expected = {
-          message,
-          timestamp: isoNow,
-          level: 'debug',
-          myBoolean: false,
-          myNull: null,
-          myNumber: 0,
-          myString: 'xxx',
-          myObject: { foo: 'bar' },
-          error: {
-            name: 'Error',
-            message: 'aaa',
-            stack: testStack,
-          }
-        };
-
-        deepStrictEqual(actual, expected);
-      });
+      strictEqual(json.level, 'error');
     });
+  });
 
-    context('given the configuration "settings.logger.format" is "none"', () => {
-      beforeEach(() => {
-        Config.set('settings.logger.format', 'none');
-      });
+  context('given the configuration "settings.logger.format" is "none"', () => {
+    it('should log nothing.', () => {
+      Config.set('settings.logger.format', 'none');
 
-      it('should log nothing', () => {
-        const { logger, mocks } = createLogger();
+      const consoleMock = mock.method(console, 'log', () => {});
 
-        const message = 'Hello world';
-        const params = createTestParams();
+      log('error', 'Hello world', {});
 
-        logger.debug(message, params);
+      strictEqual(consoleMock.mock.callCount(), 0);
+    });
+  });
+
+  context('given the configuration "settings.logger.logLevel" is NOT defined', () => {
+    it('should log messages based on an "INFO" log level', () => {
+      const consoleMock = mock.method(console, 'log', () => {});
 
-        const actual = mocks.logWithConsoleHasBeenCalledWith;
-        const expected = undefined;
+      log('info', 'Hello world', {});
+      strictEqual(consoleMock.mock.callCount(), 1);
 
-        strictEqual(actual, expected);
-      });
+      consoleMock.mock.resetCalls();
+
+      log('debug', 'Hello world', {});
+      strictEqual(consoleMock.mock.callCount(), 0);
     });
+  });
+
+  context('given the configuration "settings.logger.logLevel" is "warn"', () => {
+    it('should log messages based on a "WARN" log level', () => {
+      Config.set('settings.logger.logLevel', 'warn');
 
-    context('given the configuration "settings.logger.format" has an incorrect value', () => {
-      beforeEach(() => {
-        Config.set('settings.logger.format', 'foobar');
-      });
+      const consoleMock = mock.method(console, 'log', () => {});
 
-      it('should throw an error', () => {
-        const { logger } = createLogger();
+      log('warn', 'Hello world', {});
+      strictEqual(consoleMock.mock.callCount(), 1);
 
-        const message = 'Hello world';
+      consoleMock.mock.resetCalls();
 
-        throws(
-          () => logger.debug(message),
-          (error: any) => error.message === 'Invalid logging format: "foobar"'
-        );
-      });
+      log('info', 'Hello world', {});
+      strictEqual(consoleMock.mock.callCount(), 0);
     });
   });
 });
+
+describe('Logger', () => {
+
+  beforeEach(() => {
+    Config.set('settings.logger.logLevel', 'debug');
+  });
+
+  afterEach(() => {
+    mock.reset();
+    Config.remove('settings.logger.logLevel');
+  })
+
+  it('has a debug(...args) method which is an alias for log("debug", ...args)', () => {
+    const logger = new Logger();
+
+    const consoleMock = mock.method(console, 'log', () => {});
+
+    logger.debug('Hello world', {});
+
+    strictEqual(consoleMock.mock.callCount(), 1);
+    strictEqual(
+      consoleMock.mock.calls[0].arguments[0].includes('[DEBUG]'),
+      true,
+    );
+  });
+
+  it('has an info(...args) method which is an alias for log("info", ...args)', () => {
+    const logger = new Logger();
+
+    const consoleMock = mock.method(console, 'log', () => {});
+
+    logger.info('Hello world', {});
+
+    strictEqual(consoleMock.mock.callCount(), 1);
+    strictEqual(
+      consoleMock.mock.calls[0].arguments[0].includes('[INFO]'),
+      true,
+    );
+  });
+
+  it('has a warn(...args) method which is an alias for log("warn", ...args)', () => {
+    const logger = new Logger();
+
+    const consoleMock = mock.method(console, 'log', () => {});
+
+    logger.warn('Hello world', {});
+
+    strictEqual(consoleMock.mock.callCount(), 1);
+    strictEqual(
+      consoleMock.mock.calls[0].arguments[0].includes('[WARN]'),
+      true,
+    );
+  });
+
+  it('has an error(...args) method which is an alias for log("error", ...args)', () => {
+    const logger = new Logger();
+
+    const consoleMock = mock.method(console, 'log', () => {});
+
+    logger.error('Hello world', {});
+
+    strictEqual(consoleMock.mock.callCount(), 1);
+    strictEqual(
+      consoleMock.mock.calls[0].arguments[0].includes('[ERROR]'),
+      true,
+    );
+  });
+});
diff --git a/packages/core/src/common/logging/logger.ts b/packages/core/src/common/logging/logger.ts
index 7517f62cf8..1dadb0d066 100644
--- a/packages/core/src/common/logging/logger.ts
+++ b/packages/core/src/common/logging/logger.ts
@@ -1,50 +1,47 @@
 import { Config } from '../../core';
-import { Level, formatMessage } from './logger.utils';
-
-export class Logger {
-
-  private log(
-    level: Level,
-    message: string,
-    params: { [name: string]: any }
-  ): void {
-    const format = Config.get('settings.logger.format', 'string', 'raw');
-    const now = this.getNow();
-
-    const messageFormatted = formatMessage(
-      level,
-      message,
-      params,
-      format,
-      now,
-    );
-
-    if (messageFormatted !== null) {
-      this.logWithConsole(messageFormatted);
-    }
+import { Level, formatMessage, shouldLog } from './logger.utils';
+
+export function log(
+  level: Level,
+  message: string,
+  params: { [name: string]: any }
+): void {
+  const format = Config.get('settings.logger.format', 'string', 'raw');
+  if (format === 'none') {
+    return;
   }
 
-  protected logWithConsole(message: string): void {
-    console.log(message);
-  }
+  const configLogLevel = Config.get('settings.logger.logLevel', 'string', 'info');
+  if (!shouldLog(level, configLogLevel)) {
+    return;
+  };
 
-  protected getNow(): Date {
-    return new Date();
-  }
+  const now = new Date();
+  const formattedMessage = formatMessage(
+    level,
+    message,
+    params,
+    format,
+    now,
+  );
+
+  console.log(formattedMessage);
+}
 
+export class Logger {
   debug(message: string, params: { error?: Error, [name: string]: any } = {}): void {
-    this.log('debug', message, params);
+    log('debug', message, params);
   }
 
   info(message: string, params: { error?: Error, [name: string]: any } = {}): void {
-    this.log('info', message, params);
+    log('info', message, params);
   }
 
   warn(message: string, params: { error?: Error, [name: string]: any } = {}): void {
-    this.log('warn', message, params);
+    log('warn', message, params);
   }
 
   error(message: string, params: { error?: Error, [name: string]: any } = {}): void {
-    this.log('error', message, params);
+    log('error', message, params);
   }
 }
\ No newline at end of file

From 9c3ceb9a0cbadf545fdfd0dc27ae12ea35d87ef2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Thu, 19 Oct 2023 15:41:03 +0200
Subject: [PATCH 17/37] Support http pretty logging in Foal logger

---
 packages/core/src/common/logging/index.ts     |  3 +-
 .../src/common/logging/logger.utils.spec.ts   | 67 +++++++++++++++++++
 .../core/src/common/logging/logger.utils.ts   | 22 ++++++
 3 files changed, 91 insertions(+), 1 deletion(-)

diff --git a/packages/core/src/common/logging/index.ts b/packages/core/src/common/logging/index.ts
index 0a9e39b0e0..fc055d66fc 100644
--- a/packages/core/src/common/logging/index.ts
+++ b/packages/core/src/common/logging/index.ts
@@ -1 +1,2 @@
-export { Logger } from './logger';
\ No newline at end of file
+export { Logger } from './logger';
+export { httpRequestMessagePrefix } from './logger.utils';
\ No newline at end of file
diff --git a/packages/core/src/common/logging/logger.utils.spec.ts b/packages/core/src/common/logging/logger.utils.spec.ts
index 3075bf3cf3..c9c2b7c64d 100644
--- a/packages/core/src/common/logging/logger.utils.spec.ts
+++ b/packages/core/src/common/logging/logger.utils.spec.ts
@@ -127,6 +127,73 @@ describe('formatMessage', () => {
         strictEqual(actual, expected);
       });
     });
+
+    context('given the message is a HTTP log and is prefixed by "HTTP request -"', () => {
+      it('should return a text with a well-formatted message (1xx status).', () => {
+        const message = 'HTTP request - GET /foo/bar';
+        const params = {
+          statusCode: 100,
+          responseTime: 123,
+        };
+
+        const actual = formatMessage('info', message, params, 'dev', now);
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar 100 - 123 ms`
+
+        strictEqual(actual, expected);
+      });
+
+      it('should return a text with a well-formatted message (2xx status).', () => {
+        const message = 'HTTP request - GET /foo/bar';
+        const params = {
+          statusCode: 200,
+          responseTime: 123,
+        };
+
+        const actual = formatMessage('info', message, params, 'dev', now);
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[32m200\u001b[39m - 123 ms`
+
+        strictEqual(actual, expected);
+      });
+
+      it('should return a text with a well-formatted message (3xx status).', () => {
+        const message = 'HTTP request - GET /foo/bar';
+        const params = {
+          statusCode: 300,
+          responseTime: 123,
+        };
+
+        const actual = formatMessage('info', message, params, 'dev', now);
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[36m300\u001b[39m - 123 ms`
+
+        strictEqual(actual, expected);
+      });
+
+      it('should return a text with a well-formatted message (4xx status).', () => {
+        const message = 'HTTP request - GET /foo/bar';
+        const params = {
+          statusCode: 400,
+          responseTime: 123,
+        };
+
+        const actual = formatMessage('info', message, params, 'dev', now);
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[33m400\u001b[39m - 123 ms`
+
+        strictEqual(actual, expected);
+      });
+
+      it('should return a text with a well-formatted message (5xx status).', () => {
+        const message = 'HTTP request - GET /foo/bar';
+        const params = {
+          statusCode: 500,
+          responseTime: 123,
+        };
+
+        const actual = formatMessage('info', message, params, 'dev', now);
+        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[31m500\u001b[39m - 123 ms`
+
+        strictEqual(actual, expected);
+      });
+    });
   });
 
   context('given format is "json"', () => {
diff --git a/packages/core/src/common/logging/logger.utils.ts b/packages/core/src/common/logging/logger.utils.ts
index ff0f0c445b..31446c3e53 100644
--- a/packages/core/src/common/logging/logger.utils.ts
+++ b/packages/core/src/common/logging/logger.utils.ts
@@ -1,4 +1,5 @@
 export type Level = 'debug'|'info'|'warn'|'error';
+export const httpRequestMessagePrefix = 'HTTP request - ';
 
 function formatParamsToText(params: { error?: Error, [name: string]: any }): string {
   const tabLength = 2;
@@ -46,6 +47,22 @@ function formatMessageToRawText(
   return `${timestamp} ${logLevel} ${message}` + formatParamsToText(params);
 }
 
+function getColoredStatusCode(statusCode: number): string {
+  if (statusCode >= 500) {
+    return `\u001b[31m${statusCode}\u001b[39m`;
+  }
+  if (statusCode >= 400) {
+    return `\u001b[33m${statusCode}\u001b[39m`;
+  }
+  if (statusCode >= 300) {
+    return `\u001b[36m${statusCode}\u001b[39m`;
+  }
+  if (statusCode >= 200) {
+    return `\u001b[32m${statusCode}\u001b[39m`;
+  }
+  return statusCode.toString();
+}
+
 function formatMessageToDevText(
   level: Level,
   message: string,
@@ -61,6 +78,11 @@ function formatMessageToDevText(
   const timestamp = `\u001b[90m[${now.toLocaleTimeString()}]\u001b[39m`;
   const logLevel = `\u001b[${levelColorCodes[level]}m${level.toUpperCase()}\u001b[39m`;
 
+  if (message.startsWith(httpRequestMessagePrefix)) {
+    message = message.slice(httpRequestMessagePrefix.length);
+    message += ` ${getColoredStatusCode(params.statusCode)} - ${params.responseTime} ms`;
+  }
+
   return `${timestamp} ${logLevel} ${message}` + formatParamsToText({ error: params.error });
 }
 

From c32b437f18bf13d356f443d355c6c5eea2e58e9b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Thu, 19 Oct 2023 21:37:22 +0200
Subject: [PATCH 18/37] Allow to log HTTP requests with Foal logger

---
 packages/core/src/express/create-app.spec.ts | 74 +++++++++++++++++++-
 packages/core/src/express/create-app.ts      | 39 ++++++++---
 packages/examples/config/default.yml         |  1 +
 packages/examples/config/development.yml     |  1 -
 4 files changed, 104 insertions(+), 11 deletions(-)

diff --git a/packages/core/src/express/create-app.spec.ts b/packages/core/src/express/create-app.spec.ts
index ebb789c248..9cedda2e69 100644
--- a/packages/core/src/express/create-app.spec.ts
+++ b/packages/core/src/express/create-app.spec.ts
@@ -1,5 +1,5 @@
 // std
-import { strictEqual } from 'assert';
+import { deepStrictEqual, strictEqual } from 'assert';
 import { Buffer } from 'buffer';
 
 // 3p
@@ -25,6 +25,8 @@ import {
   ServiceManager
 } from '../core';
 import { createApp, OPENAPI_SERVICE_ID } from './create-app';
+import { mock } from 'node:test';
+import { Logger } from '../common';
 
 describe('createApp', () => {
 
@@ -48,10 +50,12 @@ describe('createApp', () => {
   });
 
   afterEach(() => {
+    mock.reset();
     Config.remove('settings.staticPathPrefix');
     Config.remove('settings.debug');
     Config.remove('settings.bodyParser.limit');
     Config.remove('settings.cookieParser.secret');
+    Config.remove('settings.loggerFormat');
   });
 
   const cookieSecret = 'strong-secret';
@@ -663,4 +667,72 @@ describe('createApp', () => {
     }
   });
 
+  context('given the configuration "settings.loggerFormat" is set to "foal"', () => {
+    it('should log the request with a detailed message and detail parameters.', async () => {
+      Config.set('settings.loggerFormat', 'foal');
+
+      class AppController {
+        @Get('/a')
+        getA(ctx: Context) {
+          return new HttpResponseOK('a');
+        }
+      }
+
+      const serviceManager = new ServiceManager();
+
+      const logger = serviceManager.get(Logger);
+      const loggerMock = mock.method(logger, 'info', () => {});
+
+      const app = await createApp(AppController, {
+        serviceManager
+      });
+
+      await request(app)
+        .get('/a')
+        .expect(200);
+
+      strictEqual(loggerMock.mock.callCount(), 1);
+
+      const message = loggerMock.mock.calls[0].arguments[0];
+      const params = loggerMock.mock.calls[0].arguments[1];
+
+      strictEqual(message, 'HTTP request - GET /a');
+      strictEqual(typeof params?.responseTime, 'number')
+
+      delete params?.responseTime;
+
+      deepStrictEqual(params, {
+        method: 'GET',
+        url: '/a',
+        statusCode: 200,
+        contentLength: '1',
+      });
+    })
+  });
+
+  context('given the configuration "settings.loggerFormat" is set to a value different from "none" or "foal"', () => {
+    it('should log a warning message.', async () => {
+      Config.set('settings.loggerFormat', 'dev');
+
+      class AppController {
+        @Get('/a')
+        getA(ctx: Context) {
+          return new HttpResponseOK('a');
+        }
+      }
+
+      const serviceManager = new ServiceManager();
+
+      const logger = serviceManager.get(Logger);
+      const loggerMock = mock.method(logger, 'warn', () => {});
+
+      const app = await createApp(AppController, {
+        serviceManager
+      });
+
+      strictEqual(loggerMock.mock.callCount(), 1);
+      strictEqual(loggerMock.mock.calls[0].arguments[0], '[CONFIG] Using another format than "foal" for "settings.loggerFormat" is deprecated.');
+    });
+  });
+
 });
diff --git a/packages/core/src/express/create-app.ts b/packages/core/src/express/create-app.ts
index 01562235d3..5236b859bb 100644
--- a/packages/core/src/express/create-app.ts
+++ b/packages/core/src/express/create-app.ts
@@ -15,7 +15,7 @@ import {
   ServiceManager,
 } from '../core';
 import { sendResponse } from './send-response';
-import { Logger } from '../common';
+import { httpRequestMessagePrefix, Logger } from '../common';
 
 export const OPENAPI_SERVICE_ID = 'OPENAPI_SERVICE_ID_a5NWKbBNBxVVZ';
 
@@ -80,13 +80,41 @@ export async function createApp(
     app.use(middleware);
   }
 
+  // Create the service and controller manager.
+  const services = options.serviceManager || new ServiceManager();
+  app.foal = { services };
+
+  // Retrieve the logger.
+  const logger = services.get(Logger);
+
   // Log requests.
   const loggerFormat = Config.get(
     'settings.loggerFormat',
     'string',
     '[:date] ":method :url HTTP/:http-version" :status - :response-time ms'
   );
-  if (loggerFormat !== 'none') {
+  if (loggerFormat === 'foal') {
+    app.use(morgan(
+      (tokens: any, req: any, res: any) => {
+        return JSON.stringify({
+          method: tokens.method(req, res),
+          url: tokens.url(req, res),
+          statusCode: parseInt(tokens.status(req, res), 10),
+          contentLength: tokens.res(req, res, 'content-length'),
+          responseTime: parseFloat(tokens['response-time'](req, res)),
+        });
+      },
+      {
+        stream: {
+          write: (message: string) => {
+            const data = JSON.parse(message);
+            logger.info(`${httpRequestMessagePrefix}${data.method} ${data.url}`, data);
+          },
+        },
+      }
+    ))
+  } else if (loggerFormat !== 'none') {
+    logger.warn('[CONFIG] Using another format than "foal" for "settings.loggerFormat" is deprecated.');
     app.use(morgan(loggerFormat));
   }
 
@@ -113,13 +141,6 @@ export async function createApp(
     app.use(middleware);
   }
 
-  // Create the service and controller manager.
-  const services = options.serviceManager || new ServiceManager();
-  app.foal = { services };
-
-  // Retrieve the logger.
-  const logger = services.get(Logger);
-
   // Inject the OpenAPI service with an ID string to avoid duplicated singletons
   // across several npm packages.
   services.set(OPENAPI_SERVICE_ID, services.get(OpenApi));
diff --git a/packages/examples/config/default.yml b/packages/examples/config/default.yml
index ee139f9d52..2b7a2a1c0f 100644
--- a/packages/examples/config/default.yml
+++ b/packages/examples/config/default.yml
@@ -3,6 +3,7 @@ port: 3001
 settings:
   openapi:
     useHooks: true
+  loggerFormat: foal
   session:
     secret: 'my secret'
   staticPath: 'public/'
diff --git a/packages/examples/config/development.yml b/packages/examples/config/development.yml
index c4ec70c649..259f5fb0fa 100644
--- a/packages/examples/config/development.yml
+++ b/packages/examples/config/development.yml
@@ -1,5 +1,4 @@
 settings:
   debug: true
-  loggerFormat: dev
   logger:
     format: dev
\ No newline at end of file

From a3e31f24d6043a5ab74797dbbd62222311517873 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Fri, 20 Oct 2023 14:50:58 +0200
Subject: [PATCH 19/37] Do not log query params

---
 packages/core/src/express/create-app.spec.ts | 2 +-
 packages/core/src/express/create-app.ts      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/core/src/express/create-app.spec.ts b/packages/core/src/express/create-app.spec.ts
index 9cedda2e69..4cf8e376a7 100644
--- a/packages/core/src/express/create-app.spec.ts
+++ b/packages/core/src/express/create-app.spec.ts
@@ -688,7 +688,7 @@ describe('createApp', () => {
       });
 
       await request(app)
-        .get('/a')
+        .get('/a?apiKey=a_secret_api_key')
         .expect(200);
 
       strictEqual(loggerMock.mock.callCount(), 1);
diff --git a/packages/core/src/express/create-app.ts b/packages/core/src/express/create-app.ts
index 5236b859bb..2c1df633e0 100644
--- a/packages/core/src/express/create-app.ts
+++ b/packages/core/src/express/create-app.ts
@@ -98,7 +98,7 @@ export async function createApp(
       (tokens: any, req: any, res: any) => {
         return JSON.stringify({
           method: tokens.method(req, res),
-          url: tokens.url(req, res),
+          url: tokens.url(req, res).split('?')[0],
           statusCode: parseInt(tokens.status(req, res), 10),
           contentLength: tokens.res(req, res, 'content-length'),
           responseTime: parseFloat(tokens['response-time'](req, res)),

From dbba1b8943df2892d55abf93e4a2010e6904761b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Fri, 20 Oct 2023 21:43:00 +0200
Subject: [PATCH 20/37] Fix linting

---
 packages/core/src/express/create-app.spec.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/core/src/express/create-app.spec.ts b/packages/core/src/express/create-app.spec.ts
index 4cf8e376a7..300edcc165 100644
--- a/packages/core/src/express/create-app.spec.ts
+++ b/packages/core/src/express/create-app.spec.ts
@@ -726,7 +726,7 @@ describe('createApp', () => {
       const logger = serviceManager.get(Logger);
       const loggerMock = mock.method(logger, 'warn', () => {});
 
-      const app = await createApp(AppController, {
+      await createApp(AppController, {
         serviceManager
       });
 

From 10490b83c08d760290a8a61f6895d50f76fb8c3b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Fri, 20 Oct 2023 21:48:58 +0200
Subject: [PATCH 21/37] [CLI] Use Foal logger for HTTP requests

---
 packages/cli/src/generate/specs/app/config/default.json       | 2 +-
 .../cli/src/generate/specs/app/config/default.mongodb.json    | 4 ++--
 .../cli/src/generate/specs/app/config/default.mongodb.yml     | 2 +-
 packages/cli/src/generate/specs/app/config/default.yml        | 2 +-
 packages/cli/src/generate/specs/app/config/development.json   | 1 -
 packages/cli/src/generate/specs/app/config/development.yml    | 1 -
 packages/cli/src/generate/templates/app/config/default.json   | 2 +-
 .../src/generate/templates/app/config/default.mongodb.json    | 4 ++--
 .../cli/src/generate/templates/app/config/default.mongodb.yml | 2 +-
 packages/cli/src/generate/templates/app/config/default.yml    | 2 +-
 .../cli/src/generate/templates/app/config/development.json    | 1 -
 .../cli/src/generate/templates/app/config/development.yml     | 1 -
 12 files changed, 10 insertions(+), 14 deletions(-)

diff --git a/packages/cli/src/generate/specs/app/config/default.json b/packages/cli/src/generate/specs/app/config/default.json
index 23b9f6e127..89e6cd04c8 100644
--- a/packages/cli/src/generate/specs/app/config/default.json
+++ b/packages/cli/src/generate/specs/app/config/default.json
@@ -1,7 +1,7 @@
 {
   "port": "env(PORT)",
   "settings": {
-    "loggerFormat": "tiny",
+    "loggerFormat": "foal",
     "session": {
       "store": "@foal/typeorm"
     }
diff --git a/packages/cli/src/generate/specs/app/config/default.mongodb.json b/packages/cli/src/generate/specs/app/config/default.mongodb.json
index cbe36e70aa..1e975a3cd8 100644
--- a/packages/cli/src/generate/specs/app/config/default.mongodb.json
+++ b/packages/cli/src/generate/specs/app/config/default.mongodb.json
@@ -1,10 +1,10 @@
 {
   "port": "env(PORT)",
   "settings": {
-    "loggerFormat": "tiny"
+    "loggerFormat": "foal"
   },
   "database": {
     "type": "mongodb",
     "url": "mongodb://localhost:27017/test-foo-bar"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/cli/src/generate/specs/app/config/default.mongodb.yml b/packages/cli/src/generate/specs/app/config/default.mongodb.yml
index ae86ee05bc..33bd271229 100644
--- a/packages/cli/src/generate/specs/app/config/default.mongodb.yml
+++ b/packages/cli/src/generate/specs/app/config/default.mongodb.yml
@@ -1,7 +1,7 @@
 port: env(PORT)
 
 settings:
-  loggerFormat: tiny
+  loggerFormat: foal
 
 database:
   type: mongodb
diff --git a/packages/cli/src/generate/specs/app/config/default.yml b/packages/cli/src/generate/specs/app/config/default.yml
index 664a2b41f7..b8d452a4a6 100644
--- a/packages/cli/src/generate/specs/app/config/default.yml
+++ b/packages/cli/src/generate/specs/app/config/default.yml
@@ -1,7 +1,7 @@
 port: env(PORT)
 
 settings:
-  loggerFormat: tiny
+  loggerFormat: foal
   session:
     store: '@foal/typeorm'
 
diff --git a/packages/cli/src/generate/specs/app/config/development.json b/packages/cli/src/generate/specs/app/config/development.json
index a9481b4c2e..dbf4a581d8 100644
--- a/packages/cli/src/generate/specs/app/config/development.json
+++ b/packages/cli/src/generate/specs/app/config/development.json
@@ -1,7 +1,6 @@
 {
   "settings": {
     "debug": true,
-    "loggerFormat": "dev",
     "logger": {
       "format": "dev"
     }
diff --git a/packages/cli/src/generate/specs/app/config/development.yml b/packages/cli/src/generate/specs/app/config/development.yml
index c4ec70c649..259f5fb0fa 100644
--- a/packages/cli/src/generate/specs/app/config/development.yml
+++ b/packages/cli/src/generate/specs/app/config/development.yml
@@ -1,5 +1,4 @@
 settings:
   debug: true
-  loggerFormat: dev
   logger:
     format: dev
\ No newline at end of file
diff --git a/packages/cli/src/generate/templates/app/config/default.json b/packages/cli/src/generate/templates/app/config/default.json
index 23b9f6e127..89e6cd04c8 100644
--- a/packages/cli/src/generate/templates/app/config/default.json
+++ b/packages/cli/src/generate/templates/app/config/default.json
@@ -1,7 +1,7 @@
 {
   "port": "env(PORT)",
   "settings": {
-    "loggerFormat": "tiny",
+    "loggerFormat": "foal",
     "session": {
       "store": "@foal/typeorm"
     }
diff --git a/packages/cli/src/generate/templates/app/config/default.mongodb.json b/packages/cli/src/generate/templates/app/config/default.mongodb.json
index 1f1a4f7734..f0e91cf5e5 100644
--- a/packages/cli/src/generate/templates/app/config/default.mongodb.json
+++ b/packages/cli/src/generate/templates/app/config/default.mongodb.json
@@ -1,10 +1,10 @@
 {
   "port": "env(PORT)",
   "settings": {
-    "loggerFormat": "tiny"
+    "loggerFormat": "foal"
   },
   "database": {
     "type": "mongodb",
     "url": "mongodb://localhost:27017//* kebabName */"
   }
-}
+}
\ No newline at end of file
diff --git a/packages/cli/src/generate/templates/app/config/default.mongodb.yml b/packages/cli/src/generate/templates/app/config/default.mongodb.yml
index 88d0e5b673..2afcb89e21 100644
--- a/packages/cli/src/generate/templates/app/config/default.mongodb.yml
+++ b/packages/cli/src/generate/templates/app/config/default.mongodb.yml
@@ -1,7 +1,7 @@
 port: env(PORT)
 
 settings:
-  loggerFormat: tiny
+  loggerFormat: foal
 
 database:
   type: mongodb
diff --git a/packages/cli/src/generate/templates/app/config/default.yml b/packages/cli/src/generate/templates/app/config/default.yml
index 664a2b41f7..b8d452a4a6 100644
--- a/packages/cli/src/generate/templates/app/config/default.yml
+++ b/packages/cli/src/generate/templates/app/config/default.yml
@@ -1,7 +1,7 @@
 port: env(PORT)
 
 settings:
-  loggerFormat: tiny
+  loggerFormat: foal
   session:
     store: '@foal/typeorm'
 
diff --git a/packages/cli/src/generate/templates/app/config/development.json b/packages/cli/src/generate/templates/app/config/development.json
index a9481b4c2e..dbf4a581d8 100644
--- a/packages/cli/src/generate/templates/app/config/development.json
+++ b/packages/cli/src/generate/templates/app/config/development.json
@@ -1,7 +1,6 @@
 {
   "settings": {
     "debug": true,
-    "loggerFormat": "dev",
     "logger": {
       "format": "dev"
     }
diff --git a/packages/cli/src/generate/templates/app/config/development.yml b/packages/cli/src/generate/templates/app/config/development.yml
index c4ec70c649..259f5fb0fa 100644
--- a/packages/cli/src/generate/templates/app/config/development.yml
+++ b/packages/cli/src/generate/templates/app/config/development.yml
@@ -1,5 +1,4 @@
 settings:
   debug: true
-  loggerFormat: dev
   logger:
     format: dev
\ No newline at end of file

From b7cc76728131613c374a9887cb26d9a4f0d68876 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Fri, 20 Oct 2023 23:19:43 +0200
Subject: [PATCH 22/37] [CLI] Rever config file changes

---
 packages/cli/src/generate/specs/app/config/e2e.json          | 5 +----
 packages/cli/src/generate/specs/app/config/e2e.mongodb.json  | 5 +----
 packages/cli/src/generate/specs/app/config/e2e.mongodb.yml   | 2 --
 packages/cli/src/generate/specs/app/config/e2e.yml           | 2 --
 packages/cli/src/generate/templates/app/config/e2e.json      | 5 +----
 .../cli/src/generate/templates/app/config/e2e.mongodb.json   | 5 +----
 .../cli/src/generate/templates/app/config/e2e.mongodb.yml    | 2 --
 packages/cli/src/generate/templates/app/config/e2e.yml       | 2 --
 8 files changed, 4 insertions(+), 24 deletions(-)

diff --git a/packages/cli/src/generate/specs/app/config/e2e.json b/packages/cli/src/generate/specs/app/config/e2e.json
index 052e0449c5..3aa0c9d436 100644
--- a/packages/cli/src/generate/specs/app/config/e2e.json
+++ b/packages/cli/src/generate/specs/app/config/e2e.json
@@ -1,9 +1,6 @@
 {
   "settings": {
-    "loggerFormat": "none",
-    "logger": {
-      "format": "none"
-    }
+    "loggerFormat": "none"
   },
   "database": {
     "database": "./e2e_db.sqlite3",
diff --git a/packages/cli/src/generate/specs/app/config/e2e.mongodb.json b/packages/cli/src/generate/specs/app/config/e2e.mongodb.json
index 7de247fad9..0557ec9654 100644
--- a/packages/cli/src/generate/specs/app/config/e2e.mongodb.json
+++ b/packages/cli/src/generate/specs/app/config/e2e.mongodb.json
@@ -1,9 +1,6 @@
 {
   "settings": {
-    "loggerFormat": "none",
-    "logger": {
-      "format": "none"
-    }
+    "loggerFormat": "none"
   },
   "database": {
     "url": "mongodb://localhost:27017/e2e-test-foo-bar"
diff --git a/packages/cli/src/generate/specs/app/config/e2e.mongodb.yml b/packages/cli/src/generate/specs/app/config/e2e.mongodb.yml
index 7bc7bb3448..281daa0052 100644
--- a/packages/cli/src/generate/specs/app/config/e2e.mongodb.yml
+++ b/packages/cli/src/generate/specs/app/config/e2e.mongodb.yml
@@ -1,7 +1,5 @@
 settings:
   loggerFormat: 'none'
-  logger:
-    format: 'none'
 
 database:
   url: mongodb://localhost:27017/e2e-test-foo-bar
diff --git a/packages/cli/src/generate/specs/app/config/e2e.yml b/packages/cli/src/generate/specs/app/config/e2e.yml
index 60f92f0c56..06a4add77f 100644
--- a/packages/cli/src/generate/specs/app/config/e2e.yml
+++ b/packages/cli/src/generate/specs/app/config/e2e.yml
@@ -1,7 +1,5 @@
 settings:
   loggerFormat: 'none'
-  logger:
-    format: 'none'
 
 database:
   database: './e2e_db.sqlite3'
diff --git a/packages/cli/src/generate/templates/app/config/e2e.json b/packages/cli/src/generate/templates/app/config/e2e.json
index 052e0449c5..3aa0c9d436 100644
--- a/packages/cli/src/generate/templates/app/config/e2e.json
+++ b/packages/cli/src/generate/templates/app/config/e2e.json
@@ -1,9 +1,6 @@
 {
   "settings": {
-    "loggerFormat": "none",
-    "logger": {
-      "format": "none"
-    }
+    "loggerFormat": "none"
   },
   "database": {
     "database": "./e2e_db.sqlite3",
diff --git a/packages/cli/src/generate/templates/app/config/e2e.mongodb.json b/packages/cli/src/generate/templates/app/config/e2e.mongodb.json
index 6ad1e7e7e4..0526879660 100644
--- a/packages/cli/src/generate/templates/app/config/e2e.mongodb.json
+++ b/packages/cli/src/generate/templates/app/config/e2e.mongodb.json
@@ -1,9 +1,6 @@
 {
   "settings": {
-    "loggerFormat": "none",
-    "logger": {
-      "format": "none"
-    }
+    "loggerFormat": "none"
   },
   "database": {
     "url": "mongodb://localhost:27017/e2e-/* kebabName */"
diff --git a/packages/cli/src/generate/templates/app/config/e2e.mongodb.yml b/packages/cli/src/generate/templates/app/config/e2e.mongodb.yml
index 609d06f307..f3ea49f64c 100644
--- a/packages/cli/src/generate/templates/app/config/e2e.mongodb.yml
+++ b/packages/cli/src/generate/templates/app/config/e2e.mongodb.yml
@@ -1,7 +1,5 @@
 settings:
   loggerFormat: 'none'
-  logger:
-    format: 'none'
 
 database:
   url: mongodb://localhost:27017/e2e-/* kebabName */
diff --git a/packages/cli/src/generate/templates/app/config/e2e.yml b/packages/cli/src/generate/templates/app/config/e2e.yml
index 60f92f0c56..06a4add77f 100644
--- a/packages/cli/src/generate/templates/app/config/e2e.yml
+++ b/packages/cli/src/generate/templates/app/config/e2e.yml
@@ -1,7 +1,5 @@
 settings:
   loggerFormat: 'none'
-  logger:
-    format: 'none'
 
 database:
   database: './e2e_db.sqlite3'

From f096bd4e5fb2a915ee7480ccdea07da39c1cda82 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Fri, 20 Oct 2023 23:19:57 +0200
Subject: [PATCH 23/37] Pretty display error in @foal/examples

---
 packages/examples/src/app/controllers/profile.controller.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/examples/src/app/controllers/profile.controller.ts b/packages/examples/src/app/controllers/profile.controller.ts
index 21e21eeb98..7a49bb1881 100644
--- a/packages/examples/src/app/controllers/profile.controller.ts
+++ b/packages/examples/src/app/controllers/profile.controller.ts
@@ -31,7 +31,7 @@ export class ProfileController {
       try {
         await this.disk.delete(user.profile);
       } catch (error: any) {
-        this.logger.error(error.message, { err: error });
+        this.logger.error(error.message, { error });
       }
     }
 

From 1599a9b020bd55ea9746d3f9b22b89a9389c8a66 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sat, 21 Oct 2023 12:17:41 +0200
Subject: [PATCH 24/37] Mark @Log as deprecated

---
 .../core/src/common/utils/log.hook.spec.ts    | 24 +++++++++++++++++++
 packages/core/src/common/utils/log.hook.ts    |  7 +++++-
 2 files changed, 30 insertions(+), 1 deletion(-)

diff --git a/packages/core/src/common/utils/log.hook.spec.ts b/packages/core/src/common/utils/log.hook.spec.ts
index 1715f39907..c5f2920b09 100644
--- a/packages/core/src/common/utils/log.hook.spec.ts
+++ b/packages/core/src/common/utils/log.hook.spec.ts
@@ -4,6 +4,8 @@ import { strictEqual } from 'assert';
 // FoalTS
 import { Context, getHookFunction, ServiceManager } from '../../core';
 import { Log } from './log.hook';
+import { mock } from 'node:test';
+import { Logger } from '../logging';
 
 describe('Log', () => {
 
@@ -15,6 +17,28 @@ describe('Log', () => {
     logFn = (...args) => msgs.push(args);
   });
 
+  afterEach(() => {
+    mock.reset();
+  })
+
+  it('should log a deprecation message.', () => {
+    const hook = getHookFunction(Log('foo', { logFn }));
+
+    const ctx = new Context({});
+    const services = new ServiceManager();
+
+    const logger = services.get(Logger);
+    const loggerMock = mock.method(logger, 'warn');
+
+    hook(ctx, services);
+
+    strictEqual(loggerMock.mock.callCount(), 1);
+    strictEqual(
+      loggerMock.mock.calls[0].arguments[0],
+      'Using the @Log hook is deprecated. Use the Logger service in a custom hook instead.'
+    );
+  });
+
   it('should log the message.', () => {
     const hook = getHookFunction(Log('foo', { logFn }));
 
diff --git a/packages/core/src/common/utils/log.hook.ts b/packages/core/src/common/utils/log.hook.ts
index 067d349ccf..871d2c3cc5 100644
--- a/packages/core/src/common/utils/log.hook.ts
+++ b/packages/core/src/common/utils/log.hook.ts
@@ -1,4 +1,5 @@
 import { Context, Hook, HookDecorator } from '../../core';
+import { Logger } from '../logging';
 
 /**
  * Options of the `Log` hook.
@@ -25,13 +26,17 @@ export interface LogOptions {
  * Hook factory logging a message with optional information on the HTTP request.
  *
  * @export
+ * @deprecated Use the Logger service in a custom hook instead.
  * @param {string} message - The message to print on each request.
  * @param {LogOptions} [options={}] - Options to specify which information on the HTTP request should be printed.
  * @returns {HookDecorator} The hook.
  */
 export function Log(message: string, options: LogOptions = {}): HookDecorator {
   const logFn = options.logFn || console.log;
-  return Hook((ctx: Context) => {
+  return Hook((ctx: Context, services) => {
+    const logger = services.get(Logger);
+    logger.warn('Using the @Log hook is deprecated. Use the Logger service in a custom hook instead.');
+
     logFn(message);
     if (options.body) {
       logFn('Body: ', ctx.request.body);

From 00baeca6328d2b6deb54de773a9af3ebad6547b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sat, 21 Oct 2023 16:38:19 +0200
Subject: [PATCH 25/37] Add random ID on each request

---
 packages/core/src/core/http/context.ts       |  3 ++
 packages/core/src/express/create-app.spec.ts | 55 ++++++++++++++++++++
 packages/core/src/express/create-app.ts      | 12 +++++
 3 files changed, 70 insertions(+)

diff --git a/packages/core/src/core/http/context.ts b/packages/core/src/core/http/context.ts
index 622bdb6903..f0db4e3c1f 100644
--- a/packages/core/src/core/http/context.ts
+++ b/packages/core/src/core/http/context.ts
@@ -58,6 +58,9 @@ interface Request extends IncomingMessage {
   // This line has been added based on @types/express in order not to make the url possibly undefined.
   url: string;
 
+  // Extra attribute added for Foal
+  id: string;
+
   // This line has been added based on @types/express but it is not present in Express official documentation.
   accepts(): string[];
   accepts(types: string|string[]): string|false;
diff --git a/packages/core/src/express/create-app.spec.ts b/packages/core/src/express/create-app.spec.ts
index 300edcc165..f8893f308d 100644
--- a/packages/core/src/express/create-app.spec.ts
+++ b/packages/core/src/express/create-app.spec.ts
@@ -735,4 +735,59 @@ describe('createApp', () => {
     });
   });
 
+  context('given a "X-Request-ID" header is present in the request', () => {
+    it('should add the request ID to the request object.', async () => {
+      const requestId = 'a_request_id';
+
+      class AppController {
+        @Get('/')
+        get(ctx: Context) {
+          return new HttpResponseOK({
+            requestId: ctx.request.id
+          });
+        }
+      }
+
+      const serviceManager = new ServiceManager();
+      const app = await createApp(AppController, {
+        serviceManager
+      });
+
+      await request(app)
+        .get('/')
+        .set('X-Request-ID', requestId)
+        .expect(200)
+        .expect({
+          requestId,
+        });
+    });
+  });
+
+  context('given a "X-Request-ID" header is NOT present in the request', () => {
+    it('should add a request ID to the request object.', async () => {
+      class AppController {
+        @Get('/')
+        get(ctx: Context) {
+          return new HttpResponseOK({
+            requestId: ctx.request.id
+          });
+        }
+      }
+
+      const serviceManager = new ServiceManager();
+      const app = await createApp(AppController, {
+        serviceManager
+      });
+
+      await request(app)
+        .get('/')
+        .expect(200)
+        .expect(response => {
+          if (!response.body.requestId) {
+            throw new Error('The request ID should exist.');
+          }
+        });
+
+    });
+  });
 });
diff --git a/packages/core/src/express/create-app.ts b/packages/core/src/express/create-app.ts
index 2c1df633e0..6ad60b9e63 100644
--- a/packages/core/src/express/create-app.ts
+++ b/packages/core/src/express/create-app.ts
@@ -1,3 +1,6 @@
+// std
+import { randomUUID } from 'node:crypto';
+
 // 3p
 import * as cookieParser from 'cookie-parser';
 import * as express from 'express';
@@ -87,6 +90,15 @@ export async function createApp(
   // Retrieve the logger.
   const logger = services.get(Logger);
 
+  // Generate a unique ID for each request.
+  app.use((req: any, res: any, next: (err?: any) => any) => {
+    const requestId = req.get('x-request-id') || randomUUID();
+
+    req.id = requestId;
+
+    next();
+  });
+
   // Log requests.
   const loggerFormat = Config.get(
     'settings.loggerFormat',

From 0a82607483ce18482cee11b4439d3c8d8f436e8c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sat, 21 Oct 2023 17:01:51 +0200
Subject: [PATCH 26/37] Add Logger.log

---
 .../core/src/common/logging/logger.spec.ts    | 115 +++++++++---------
 packages/core/src/common/logging/logger.ts    |  60 ++++-----
 2 files changed, 87 insertions(+), 88 deletions(-)

diff --git a/packages/core/src/common/logging/logger.spec.ts b/packages/core/src/common/logging/logger.spec.ts
index 49cfc6b119..af26bf542f 100644
--- a/packages/core/src/common/logging/logger.spec.ts
+++ b/packages/core/src/common/logging/logger.spec.ts
@@ -3,102 +3,101 @@ import { strictEqual } from 'assert';
 import { mock } from 'node:test';
 
 // FoalTS
-import { Logger, log } from './logger';
+import { Logger } from './logger';
 import { Config } from '../../core';
 
-describe('log', () => {
+describe('Logger', () => {
+
   afterEach(() => {
     mock.reset();
     Config.remove('settings.logger.format');
     Config.remove('settings.logger.logLevel');
-  });
+  })
 
-  context('given the configuration "settings.logger.format" is NOT defined', () => {
-    it('should log the message to a raw text.', () => {
-      const consoleMock = mock.method(console, 'log', () => {});
+  describe('has a "log" method that', () => {
 
-      log('error', 'Hello world', {});
+    context('given the configuration "settings.logger.format" is NOT defined', () => {
+      it('should log the message to a raw text.', () => {
+        const consoleMock = mock.method(console, 'log', () => {});
 
-      strictEqual(consoleMock.mock.callCount(), 1);
+        const logger = new Logger();
+        logger.log('error', 'Hello world', {});
 
-      const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+        strictEqual(consoleMock.mock.callCount(), 1);
 
-      strictEqual(loggedMessage.includes('[ERROR]'), true);
-    })
-  });
+        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
 
-  context('given the configuration "settings.logger.format" is "json"', () => {
-    it('should log the message to a JSON.', () => {
-      Config.set('settings.logger.format', 'json');
+        strictEqual(loggedMessage.includes('[ERROR]'), true);
+      })
+    });
 
-      const consoleMock = mock.method(console, 'log', () => {});
+    context('given the configuration "settings.logger.format" is "json"', () => {
+      it('should log the message to a JSON.', () => {
+        Config.set('settings.logger.format', 'json');
 
-      log('error', 'Hello world', {});
+        const consoleMock = mock.method(console, 'log', () => {});
 
-      strictEqual(consoleMock.mock.callCount(), 1);
+        const logger = new Logger();
+        logger.log('error', 'Hello world', {});
 
-      const loggedMessage = consoleMock.mock.calls[0].arguments[0];
-      const json = JSON.parse(loggedMessage);
+        strictEqual(consoleMock.mock.callCount(), 1);
 
-      strictEqual(json.level, 'error');
+        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+        const json = JSON.parse(loggedMessage);
+
+        strictEqual(json.level, 'error');
+      });
     });
-  });
 
-  context('given the configuration "settings.logger.format" is "none"', () => {
-    it('should log nothing.', () => {
-      Config.set('settings.logger.format', 'none');
+    context('given the configuration "settings.logger.format" is "none"', () => {
+      it('should log nothing.', () => {
+        Config.set('settings.logger.format', 'none');
 
-      const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {});
 
-      log('error', 'Hello world', {});
+        const logger = new Logger();
+        logger.log('error', 'Hello world', {});
 
-      strictEqual(consoleMock.mock.callCount(), 0);
+        strictEqual(consoleMock.mock.callCount(), 0);
+      });
     });
-  });
 
-  context('given the configuration "settings.logger.logLevel" is NOT defined', () => {
-    it('should log messages based on an "INFO" log level', () => {
-      const consoleMock = mock.method(console, 'log', () => {});
+    context('given the configuration "settings.logger.logLevel" is NOT defined', () => {
+      it('should log messages based on an "INFO" log level', () => {
+        const consoleMock = mock.method(console, 'log', () => {});
 
-      log('info', 'Hello world', {});
-      strictEqual(consoleMock.mock.callCount(), 1);
+        const logger = new Logger();
+        logger.log('info', 'Hello world', {});
+        strictEqual(consoleMock.mock.callCount(), 1);
 
-      consoleMock.mock.resetCalls();
+        consoleMock.mock.resetCalls();
 
-      log('debug', 'Hello world', {});
-      strictEqual(consoleMock.mock.callCount(), 0);
+        logger.log('debug', 'Hello world', {});
+        strictEqual(consoleMock.mock.callCount(), 0);
+      });
     });
-  });
 
-  context('given the configuration "settings.logger.logLevel" is "warn"', () => {
-    it('should log messages based on a "WARN" log level', () => {
-      Config.set('settings.logger.logLevel', 'warn');
+    context('given the configuration "settings.logger.logLevel" is "warn"', () => {
+      it('should log messages based on a "WARN" log level', () => {
+        Config.set('settings.logger.logLevel', 'warn');
 
-      const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {});
 
-      log('warn', 'Hello world', {});
-      strictEqual(consoleMock.mock.callCount(), 1);
+        const logger = new Logger();
+        logger.log('warn', 'Hello world', {});
+        strictEqual(consoleMock.mock.callCount(), 1);
 
-      consoleMock.mock.resetCalls();
+        consoleMock.mock.resetCalls();
 
-      log('info', 'Hello world', {});
-      strictEqual(consoleMock.mock.callCount(), 0);
+        logger.log('info', 'Hello world', {});
+        strictEqual(consoleMock.mock.callCount(), 0);
+      });
     });
   });
-});
 
-describe('Logger', () => {
-
-  beforeEach(() => {
+  it('has a debug(...args) method which is an alias for log("debug", ...args)', () => {
     Config.set('settings.logger.logLevel', 'debug');
-  });
-
-  afterEach(() => {
-    mock.reset();
-    Config.remove('settings.logger.logLevel');
-  })
 
-  it('has a debug(...args) method which is an alias for log("debug", ...args)', () => {
     const logger = new Logger();
 
     const consoleMock = mock.method(console, 'log', () => {});
diff --git a/packages/core/src/common/logging/logger.ts b/packages/core/src/common/logging/logger.ts
index 1dadb0d066..9a65d801b9 100644
--- a/packages/core/src/common/logging/logger.ts
+++ b/packages/core/src/common/logging/logger.ts
@@ -1,47 +1,47 @@
 import { Config } from '../../core';
 import { Level, formatMessage, shouldLog } from './logger.utils';
 
-export function log(
-  level: Level,
-  message: string,
-  params: { [name: string]: any }
-): void {
-  const format = Config.get('settings.logger.format', 'string', 'raw');
-  if (format === 'none') {
-    return;
+export class Logger {
+  log(
+    level: Level,
+    message: string,
+    params: { [name: string]: any } = {}
+  ): void {
+    const format = Config.get('settings.logger.format', 'string', 'raw');
+    if (format === 'none') {
+      return;
+    }
+
+    const configLogLevel = Config.get('settings.logger.logLevel', 'string', 'info');
+    if (!shouldLog(level, configLogLevel)) {
+      return;
+    };
+
+    const now = new Date();
+    const formattedMessage = formatMessage(
+      level,
+      message,
+      params,
+      format,
+      now,
+    );
+
+    console.log(formattedMessage);
   }
 
-  const configLogLevel = Config.get('settings.logger.logLevel', 'string', 'info');
-  if (!shouldLog(level, configLogLevel)) {
-    return;
-  };
-
-  const now = new Date();
-  const formattedMessage = formatMessage(
-    level,
-    message,
-    params,
-    format,
-    now,
-  );
-
-  console.log(formattedMessage);
-}
-
-export class Logger {
   debug(message: string, params: { error?: Error, [name: string]: any } = {}): void {
-    log('debug', message, params);
+    this.log('debug', message, params);
   }
 
   info(message: string, params: { error?: Error, [name: string]: any } = {}): void {
-    log('info', message, params);
+    this.log('info', message, params);
   }
 
   warn(message: string, params: { error?: Error, [name: string]: any } = {}): void {
-    log('warn', message, params);
+    this.log('warn', message, params);
   }
 
   error(message: string, params: { error?: Error, [name: string]: any } = {}): void {
-    log('error', message, params);
+    this.log('error', message, params);
   }
 }
\ No newline at end of file

From 0ca1b30db836838ed51f7dd6d7b3b7d4fa52ad24 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sat, 21 Oct 2023 19:16:17 +0200
Subject: [PATCH 27/37] Allow to add context to Logger

---
 .../core/src/common/logging/logger.spec.ts    | 74 ++++++++++++++++++-
 packages/core/src/common/logging/logger.ts    | 25 ++++++-
 packages/core/src/express/create-app.spec.ts  | 37 ++++++++++
 packages/core/src/express/create-app.ts       |  5 ++
 4 files changed, 137 insertions(+), 4 deletions(-)

diff --git a/packages/core/src/common/logging/logger.spec.ts b/packages/core/src/common/logging/logger.spec.ts
index af26bf542f..0c2e378c6f 100644
--- a/packages/core/src/common/logging/logger.spec.ts
+++ b/packages/core/src/common/logging/logger.spec.ts
@@ -1,5 +1,5 @@
 // std
-import { strictEqual } from 'assert';
+import { notStrictEqual, strictEqual } from 'assert';
 import { mock } from 'node:test';
 
 // FoalTS
@@ -16,18 +16,85 @@ describe('Logger', () => {
 
   describe('has a "log" method that', () => {
 
+    context('given the log context has been initialized', () => {
+      it('should log the message with the context.', () => {
+        const consoleMock = mock.method(console, 'log', () => {});
+
+        const logger = new Logger();
+        logger.initLogContext(() => {
+          logger.addLogContext('foo', 'bar');
+          logger.log('error', 'Hello world', {});
+        });
+        logger.initLogContext(() => {
+          logger.addLogContext('foo2', 'bar2');
+          logger.log('error', 'Hello world 2', {});
+        });
+
+        strictEqual(consoleMock.mock.callCount(), 2);
+
+        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+
+        strictEqual(loggedMessage.includes('[ERROR]'), true);
+        strictEqual(loggedMessage.includes('foo: "bar"'), true);
+        notStrictEqual(loggedMessage.includes('foo2: "bar2"'), true);
+
+        const loggedMessage2 = consoleMock.mock.calls[1].arguments[0];
+
+        strictEqual(loggedMessage2.includes('[ERROR]'), true);
+        strictEqual(loggedMessage2.includes('foo2: "bar2"'), true);
+        notStrictEqual(loggedMessage2.includes('foo: "bar"'), true);
+      });
+
+      it('should let given params override the context.', () => {
+        const consoleMock = mock.method(console, 'log', () => {});
+
+        const logger = new Logger();
+        logger.initLogContext(() => {
+          logger.addLogContext('foo', 'bar');
+          logger.log('error', 'Hello world', { foo: 'bar2' });
+        });
+
+        strictEqual(consoleMock.mock.callCount(), 1);
+
+        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+
+        strictEqual(loggedMessage.includes('[ERROR]'), true);
+        strictEqual(loggedMessage.includes('foo: "bar2"'), true);
+      });
+    });
+
+    context('given the log context has NOT been initialized', () => {
+      it('should log a warning message when adding log context.', () => {
+        const consoleMock = mock.method(console, 'log', () => {});
+
+        const logger = new Logger();
+        logger.addLogContext('foo', 'bar');
+
+        strictEqual(consoleMock.mock.callCount(), 1);
+
+        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+
+        strictEqual(loggedMessage.includes('[WARN]'), true);
+        strictEqual(
+          loggedMessage.includes('Impossible to add log context information. The logger context has not been initialized.'),
+          true
+        );
+      });
+    });
+
     context('given the configuration "settings.logger.format" is NOT defined', () => {
       it('should log the message to a raw text.', () => {
         const consoleMock = mock.method(console, 'log', () => {});
 
         const logger = new Logger();
-        logger.log('error', 'Hello world', {});
+        logger.log('error', 'Hello world', { foobar: 'bar' });
 
         strictEqual(consoleMock.mock.callCount(), 1);
 
         const loggedMessage = consoleMock.mock.calls[0].arguments[0];
 
         strictEqual(loggedMessage.includes('[ERROR]'), true);
+        strictEqual(loggedMessage.includes('foobar: "bar"'), true);
       })
     });
 
@@ -38,7 +105,7 @@ describe('Logger', () => {
         const consoleMock = mock.method(console, 'log', () => {});
 
         const logger = new Logger();
-        logger.log('error', 'Hello world', {});
+        logger.log('error', 'Hello world', { foobar: 'bar' });
 
         strictEqual(consoleMock.mock.callCount(), 1);
 
@@ -46,6 +113,7 @@ describe('Logger', () => {
         const json = JSON.parse(loggedMessage);
 
         strictEqual(json.level, 'error');
+        strictEqual(json.foobar, 'bar');
       });
     });
 
diff --git a/packages/core/src/common/logging/logger.ts b/packages/core/src/common/logging/logger.ts
index 9a65d801b9..f0da7a3b1c 100644
--- a/packages/core/src/common/logging/logger.ts
+++ b/packages/core/src/common/logging/logger.ts
@@ -1,7 +1,26 @@
+// std
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+// FoalTS
 import { Config } from '../../core';
 import { Level, formatMessage, shouldLog } from './logger.utils';
 
 export class Logger {
+  private asyncLocalStorage = new AsyncLocalStorage<Record<string, any>>();
+
+  initLogContext(callback: () => void): void {
+    this.asyncLocalStorage.run({}, callback);
+  }
+
+  addLogContext(name: string, value: any): void {
+    const store = this.asyncLocalStorage.getStore();
+    if (!store) {
+      this.log('warn', 'Impossible to add log context information. The logger context has not been initialized.');
+      return;
+    }
+    store[name] = value;
+  }
+
   log(
     level: Level,
     message: string,
@@ -18,10 +37,14 @@ export class Logger {
     };
 
     const now = new Date();
+    const contextParams = this.asyncLocalStorage.getStore();
     const formattedMessage = formatMessage(
       level,
       message,
-      params,
+      {
+        ...contextParams,
+        ...params,
+      },
       format,
       now,
     );
diff --git a/packages/core/src/express/create-app.spec.ts b/packages/core/src/express/create-app.spec.ts
index f8893f308d..048b42784d 100644
--- a/packages/core/src/express/create-app.spec.ts
+++ b/packages/core/src/express/create-app.spec.ts
@@ -16,6 +16,7 @@ import {
   dependency,
   Get,
   Head,
+  Hook,
   HttpResponseOK,
   OpenApi,
   Options,
@@ -56,6 +57,7 @@ describe('createApp', () => {
     Config.remove('settings.bodyParser.limit');
     Config.remove('settings.cookieParser.secret');
     Config.remove('settings.loggerFormat');
+    Config.remove('settings.logger.format');
   });
 
   const cookieSecret = 'strong-secret';
@@ -735,6 +737,41 @@ describe('createApp', () => {
     });
   });
 
+  it('should allow to add log context information.', async () => {
+    Config.set('settings.logger.format', 'json');
+
+    class AppController {
+      @dependency
+      logger: Logger;
+
+      @Get('/')
+      @Hook((ctx, services) => {
+        const logger = services.get(Logger);
+        logger.addLogContext('foo', 'bar');
+      })
+      getA(ctx: Context) {
+        this.logger.info('Hello world');
+        return new HttpResponseOK();
+      }
+    }
+
+    const serviceManager = new ServiceManager();
+
+    const consoleMock = mock.method(console, 'log', () => {});
+
+    const app = await createApp(AppController, {
+      serviceManager
+    });
+
+    await request(app)
+      .get('/')
+      .expect(200);
+
+    const messages = consoleMock.mock.calls.map(call => JSON.parse(call.arguments[0]));
+
+    strictEqual(messages.some(message => message.foo === 'bar'), true);
+  });
+
   context('given a "X-Request-ID" header is present in the request', () => {
     it('should add the request ID to the request object.', async () => {
       const requestId = 'a_request_id';
diff --git a/packages/core/src/express/create-app.ts b/packages/core/src/express/create-app.ts
index 6ad60b9e63..08d10e037d 100644
--- a/packages/core/src/express/create-app.ts
+++ b/packages/core/src/express/create-app.ts
@@ -90,6 +90,11 @@ export async function createApp(
   // Retrieve the logger.
   const logger = services.get(Logger);
 
+  // Allow to add log context.
+  app.use((req: any, res: any, next: (err?: any) => any) => {
+    logger.initLogContext(next);
+  });
+
   // Generate a unique ID for each request.
   app.use((req: any, res: any, next: (err?: any) => any) => {
     const requestId = req.get('x-request-id') || randomUUID();

From 39e63e61e3a1754ce0320502da436c06a5daaa29 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sat, 21 Oct 2023 19:22:42 +0200
Subject: [PATCH 28/37] Add request ID to log context

---
 packages/core/src/express/create-app.spec.ts | 33 ++++++++++++++++++++
 packages/core/src/express/create-app.ts      |  1 +
 2 files changed, 34 insertions(+)

diff --git a/packages/core/src/express/create-app.spec.ts b/packages/core/src/express/create-app.spec.ts
index 048b42784d..afaa3b1ebe 100644
--- a/packages/core/src/express/create-app.spec.ts
+++ b/packages/core/src/express/create-app.spec.ts
@@ -824,7 +824,40 @@ describe('createApp', () => {
             throw new Error('The request ID should exist.');
           }
         });
+    });
+  });
+
+  it('should add the request ID to the log context.', async () => {
+    class AppController {
+      @Get('/')
+      get(ctx: Context) {
+        return new HttpResponseOK({
+          requestId: ctx.request.id
+        });
+      }
+    }
+
+    const serviceManager = new ServiceManager();
+    const logger = serviceManager.get(Logger);
+    const loggerMock = mock.method(logger, 'addLogContext', () => {});
 
+    const app = await createApp(AppController, {
+      serviceManager
     });
+
+    let requestId: string|undefined;
+    await request(app)
+      .get('/')
+      .expect(200)
+      .then(response => {
+        requestId = response.body.requestId;
+      })
+
+    strictEqual(loggerMock.mock.callCount(), 1);
+
+    const [key, value] = loggerMock.mock.calls[0].arguments;
+
+    strictEqual(key, 'requestId');
+    strictEqual(value, requestId);
   });
 });
diff --git a/packages/core/src/express/create-app.ts b/packages/core/src/express/create-app.ts
index 08d10e037d..38ff29faf5 100644
--- a/packages/core/src/express/create-app.ts
+++ b/packages/core/src/express/create-app.ts
@@ -100,6 +100,7 @@ export async function createApp(
     const requestId = req.get('x-request-id') || randomUUID();
 
     req.id = requestId;
+    logger.addLogContext('requestId', requestId);
 
     next();
   });

From 7b8bf3c43a3eff5ad9ecdaf4707cc5f7386331e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sat, 21 Oct 2023 20:31:27 +0200
Subject: [PATCH 29/37] Add user ID to log context for sessions

---
 .../sessions/http/use-sessions.hook.spec.ts   | 26 ++++++++++++++++++-
 .../src/sessions/http/use-sessions.hook.ts    |  4 +++
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/packages/core/src/sessions/http/use-sessions.hook.spec.ts b/packages/core/src/sessions/http/use-sessions.hook.spec.ts
index 6f011b5c11..224bb68267 100644
--- a/packages/core/src/sessions/http/use-sessions.hook.spec.ts
+++ b/packages/core/src/sessions/http/use-sessions.hook.spec.ts
@@ -1,5 +1,6 @@
 // std
 import { deepStrictEqual, doesNotReject, rejects, strictEqual } from 'assert';
+import { mock } from 'node:test';
 
 // FoalTS
 import {
@@ -36,6 +37,7 @@ import {
   SessionStore,
 } from '../core';
 import { UseSessions } from './use-sessions.hook';
+import { Logger } from '../../common';
 
 describe('UseSessions', () => {
 
@@ -513,7 +515,7 @@ describe('UseSessions', () => {
       it('should throw an error if the session state has no CSRF token.', async () => {
         ctx = createContextWithPostMethod({}, { [SESSION_DEFAULT_COOKIE_NAME]: anonymousSessionID });
         return rejects(
-          () => hook(ctx, services),
+          async () => { await hook(ctx, services) },
           {
             message: 'Unexpected error: the session content does not have a "csrfToken" field. '
               + 'Are you sure you created the session with "createSession"?'
@@ -605,12 +607,34 @@ describe('UseSessions', () => {
         strictEqual(ctx.user, null);
       });
 
+      it('and add null as user ID to the log context.', async () => {
+        const logger = services.get(Logger);
+        const loggerMock = mock.method(logger, 'addLogContext', () => {});
+
+        await hook(ctx, services);
+
+        strictEqual(loggerMock.mock.callCount(), 1);
+
+        deepStrictEqual(loggerMock.mock.calls[0].arguments, ['userId', null]);
+      });
+
     });
 
     context('given the session has a user ID', () => {
 
       beforeEach(() => ctx = createContext({ Authorization: `Bearer ${authenticatedSessionID}`}));
 
+      it('and add null as user ID to the log context.', async () => {
+        const logger = services.get(Logger);
+        const loggerMock = mock.method(logger, 'addLogContext', () => {});
+
+        await hook(ctx, services);
+
+        strictEqual(loggerMock.mock.callCount(), 1);
+
+        deepStrictEqual(loggerMock.mock.calls[0].arguments, ['userId', userId]);
+      });
+
       context('given options.user is not defined', () => {
 
         it('with the null value.', async () => {
diff --git a/packages/core/src/sessions/http/use-sessions.hook.ts b/packages/core/src/sessions/http/use-sessions.hook.ts
index a9e2225d68..9d69af00f2 100644
--- a/packages/core/src/sessions/http/use-sessions.hook.ts
+++ b/packages/core/src/sessions/http/use-sessions.hook.ts
@@ -22,6 +22,7 @@ import { checkUserIdType } from './check-user-id-type';
 import { getSessionIDFromRequest, RequestValidationError } from './get-session-id-from-request';
 import { createSession, readSession, SessionStore } from '../core';
 import { getCsrfTokenFromRequest, removeSessionCookie, setSessionCookie, shouldVerifyCsrfToken } from './utils';
+import { Logger } from '../../common';
 
 export type UseSessionOptions = {
   store?: Class<SessionStore>;
@@ -142,6 +143,9 @@ export function UseSessions(options: UseSessionOptions = {}): HookDecorator {
 
     /* Set ctx.user */
 
+    const logger = services.get(Logger);
+    logger.addLogContext('userId', session.userId);
+
     if (session.userId !== null && options.user) {
       const userId = checkUserIdType(session.userId, options.userIdType);
       ctx.user = await options.user(userId as never, services);

From 0b809dd934cef1f4006563eb2d622c0b368137b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sat, 21 Oct 2023 20:43:13 +0200
Subject: [PATCH 30/37] Add user ID to log context for JWT

---
 packages/jwt/src/http/jwt.hook.spec.ts | 23 +++++++++++++++++++++++
 packages/jwt/src/http/jwt.hook.ts      |  5 +++++
 2 files changed, 28 insertions(+)

diff --git a/packages/jwt/src/http/jwt.hook.spec.ts b/packages/jwt/src/http/jwt.hook.spec.ts
index 54162d8e28..9fe53f6301 100644
--- a/packages/jwt/src/http/jwt.hook.spec.ts
+++ b/packages/jwt/src/http/jwt.hook.spec.ts
@@ -1,5 +1,6 @@
 // std
 import { deepStrictEqual, notStrictEqual, rejects, strictEqual } from 'assert';
+import { mock } from 'node:test';
 
 // 3p
 import {
@@ -20,6 +21,7 @@ import {
   isHttpResponseBadRequest,
   isHttpResponseForbidden,
   isHttpResponseUnauthorized,
+  Logger,
   ServiceManager
 } from '@foal/core';
 import { sign } from 'jsonwebtoken';
@@ -631,6 +633,27 @@ export function testSuite(JWT: typeof JWTOptional|typeof JWTRequired, required:
 
   describe('should set Context.user', () => {
 
+    it('and shoud add the user ID to the log context.', async () => {
+      const jwt = sign({}, secret, { subject: '123' });
+      ctx = createContext({ Authorization: `Bearer ${jwt}` });
+
+      hook = getHookFunction(JWT({
+        user: async () => null,
+        userIdType: 'number'
+      }));
+
+      const logger = services.get(Logger);
+      const loggerMock = mock.method(logger, 'addLogContext', () => {});
+
+      await hook(ctx, services);
+
+      strictEqual(loggerMock.mock.callCount(), 1);
+      deepStrictEqual(
+        loggerMock.mock.calls[0].arguments,
+        ['userId', 123],
+      );
+    })
+
     context('given options.user is not defined', () => {
 
       it('with the decoded payload (header & secret).', async () => {
diff --git a/packages/jwt/src/http/jwt.hook.ts b/packages/jwt/src/http/jwt.hook.ts
index 76716985e4..44d18db238 100644
--- a/packages/jwt/src/http/jwt.hook.ts
+++ b/packages/jwt/src/http/jwt.hook.ts
@@ -12,6 +12,7 @@ import {
   HttpResponseForbidden,
   HttpResponseUnauthorized,
   IApiSecurityScheme,
+  Logger,
   ServiceManager
 } from '@foal/core';
 import { decode, verify } from 'jsonwebtoken';
@@ -198,6 +199,10 @@ export function JWT(required: boolean, options: JWTOptions, verifyOptions: Verif
     }
 
     const userId = checkAndConvertUserIdType(payload.sub, options.userIdType);
+
+    const logger = services.get(Logger);
+    logger.addLogContext('userId', userId);
+
     const user = await options.user(userId as never, services);
     if (!user) {
       return new InvalidTokenResponse('The token subject does not match any user.');

From 37808375adc1c42937746cec44c348b6334f1dec Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sat, 21 Oct 2023 20:49:01 +0200
Subject: [PATCH 31/37] Make use of mocks consistent

---
 .../core/src/common/logging/logger.spec.ts    | 76 +++++++++----------
 .../core/src/common/utils/log.hook.spec.ts    |  6 +-
 packages/core/src/express/create-app.spec.ts  | 24 +++---
 .../sessions/http/use-sessions.hook.spec.ts   | 12 +--
 packages/jwt/src/http/jwt.hook.spec.ts        |  6 +-
 5 files changed, 62 insertions(+), 62 deletions(-)

diff --git a/packages/core/src/common/logging/logger.spec.ts b/packages/core/src/common/logging/logger.spec.ts
index 0c2e378c6f..725c613ae0 100644
--- a/packages/core/src/common/logging/logger.spec.ts
+++ b/packages/core/src/common/logging/logger.spec.ts
@@ -18,7 +18,7 @@ describe('Logger', () => {
 
     context('given the log context has been initialized', () => {
       it('should log the message with the context.', () => {
-        const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {}).mock;
 
         const logger = new Logger();
         logger.initLogContext(() => {
@@ -30,15 +30,15 @@ describe('Logger', () => {
           logger.log('error', 'Hello world 2', {});
         });
 
-        strictEqual(consoleMock.mock.callCount(), 2);
+        strictEqual(consoleMock.callCount(), 2);
 
-        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+        const loggedMessage = consoleMock.calls[0].arguments[0];
 
         strictEqual(loggedMessage.includes('[ERROR]'), true);
         strictEqual(loggedMessage.includes('foo: "bar"'), true);
         notStrictEqual(loggedMessage.includes('foo2: "bar2"'), true);
 
-        const loggedMessage2 = consoleMock.mock.calls[1].arguments[0];
+        const loggedMessage2 = consoleMock.calls[1].arguments[0];
 
         strictEqual(loggedMessage2.includes('[ERROR]'), true);
         strictEqual(loggedMessage2.includes('foo2: "bar2"'), true);
@@ -46,7 +46,7 @@ describe('Logger', () => {
       });
 
       it('should let given params override the context.', () => {
-        const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {}).mock;
 
         const logger = new Logger();
         logger.initLogContext(() => {
@@ -54,9 +54,9 @@ describe('Logger', () => {
           logger.log('error', 'Hello world', { foo: 'bar2' });
         });
 
-        strictEqual(consoleMock.mock.callCount(), 1);
+        strictEqual(consoleMock.callCount(), 1);
 
-        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+        const loggedMessage = consoleMock.calls[0].arguments[0];
 
         strictEqual(loggedMessage.includes('[ERROR]'), true);
         strictEqual(loggedMessage.includes('foo: "bar2"'), true);
@@ -65,14 +65,14 @@ describe('Logger', () => {
 
     context('given the log context has NOT been initialized', () => {
       it('should log a warning message when adding log context.', () => {
-        const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {}).mock;
 
         const logger = new Logger();
         logger.addLogContext('foo', 'bar');
 
-        strictEqual(consoleMock.mock.callCount(), 1);
+        strictEqual(consoleMock.callCount(), 1);
 
-        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+        const loggedMessage = consoleMock.calls[0].arguments[0];
 
         strictEqual(loggedMessage.includes('[WARN]'), true);
         strictEqual(
@@ -84,14 +84,14 @@ describe('Logger', () => {
 
     context('given the configuration "settings.logger.format" is NOT defined', () => {
       it('should log the message to a raw text.', () => {
-        const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {}).mock;
 
         const logger = new Logger();
         logger.log('error', 'Hello world', { foobar: 'bar' });
 
-        strictEqual(consoleMock.mock.callCount(), 1);
+        strictEqual(consoleMock.callCount(), 1);
 
-        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+        const loggedMessage = consoleMock.calls[0].arguments[0];
 
         strictEqual(loggedMessage.includes('[ERROR]'), true);
         strictEqual(loggedMessage.includes('foobar: "bar"'), true);
@@ -102,14 +102,14 @@ describe('Logger', () => {
       it('should log the message to a JSON.', () => {
         Config.set('settings.logger.format', 'json');
 
-        const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {}).mock;
 
         const logger = new Logger();
         logger.log('error', 'Hello world', { foobar: 'bar' });
 
-        strictEqual(consoleMock.mock.callCount(), 1);
+        strictEqual(consoleMock.callCount(), 1);
 
-        const loggedMessage = consoleMock.mock.calls[0].arguments[0];
+        const loggedMessage = consoleMock.calls[0].arguments[0];
         const json = JSON.parse(loggedMessage);
 
         strictEqual(json.level, 'error');
@@ -121,27 +121,27 @@ describe('Logger', () => {
       it('should log nothing.', () => {
         Config.set('settings.logger.format', 'none');
 
-        const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {}).mock;
 
         const logger = new Logger();
         logger.log('error', 'Hello world', {});
 
-        strictEqual(consoleMock.mock.callCount(), 0);
+        strictEqual(consoleMock.callCount(), 0);
       });
     });
 
     context('given the configuration "settings.logger.logLevel" is NOT defined', () => {
       it('should log messages based on an "INFO" log level', () => {
-        const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {}).mock;
 
         const logger = new Logger();
         logger.log('info', 'Hello world', {});
-        strictEqual(consoleMock.mock.callCount(), 1);
+        strictEqual(consoleMock.callCount(), 1);
 
-        consoleMock.mock.resetCalls();
+        consoleMock.resetCalls();
 
         logger.log('debug', 'Hello world', {});
-        strictEqual(consoleMock.mock.callCount(), 0);
+        strictEqual(consoleMock.callCount(), 0);
       });
     });
 
@@ -149,16 +149,16 @@ describe('Logger', () => {
       it('should log messages based on a "WARN" log level', () => {
         Config.set('settings.logger.logLevel', 'warn');
 
-        const consoleMock = mock.method(console, 'log', () => {});
+        const consoleMock = mock.method(console, 'log', () => {}).mock;
 
         const logger = new Logger();
         logger.log('warn', 'Hello world', {});
-        strictEqual(consoleMock.mock.callCount(), 1);
+        strictEqual(consoleMock.callCount(), 1);
 
-        consoleMock.mock.resetCalls();
+        consoleMock.resetCalls();
 
         logger.log('info', 'Hello world', {});
-        strictEqual(consoleMock.mock.callCount(), 0);
+        strictEqual(consoleMock.callCount(), 0);
       });
     });
   });
@@ -168,13 +168,13 @@ describe('Logger', () => {
 
     const logger = new Logger();
 
-    const consoleMock = mock.method(console, 'log', () => {});
+    const consoleMock = mock.method(console, 'log', () => {}).mock;
 
     logger.debug('Hello world', {});
 
-    strictEqual(consoleMock.mock.callCount(), 1);
+    strictEqual(consoleMock.callCount(), 1);
     strictEqual(
-      consoleMock.mock.calls[0].arguments[0].includes('[DEBUG]'),
+      consoleMock.calls[0].arguments[0].includes('[DEBUG]'),
       true,
     );
   });
@@ -182,13 +182,13 @@ describe('Logger', () => {
   it('has an info(...args) method which is an alias for log("info", ...args)', () => {
     const logger = new Logger();
 
-    const consoleMock = mock.method(console, 'log', () => {});
+    const consoleMock = mock.method(console, 'log', () => {}).mock;
 
     logger.info('Hello world', {});
 
-    strictEqual(consoleMock.mock.callCount(), 1);
+    strictEqual(consoleMock.callCount(), 1);
     strictEqual(
-      consoleMock.mock.calls[0].arguments[0].includes('[INFO]'),
+      consoleMock.calls[0].arguments[0].includes('[INFO]'),
       true,
     );
   });
@@ -196,13 +196,13 @@ describe('Logger', () => {
   it('has a warn(...args) method which is an alias for log("warn", ...args)', () => {
     const logger = new Logger();
 
-    const consoleMock = mock.method(console, 'log', () => {});
+    const consoleMock = mock.method(console, 'log', () => {}).mock;
 
     logger.warn('Hello world', {});
 
-    strictEqual(consoleMock.mock.callCount(), 1);
+    strictEqual(consoleMock.callCount(), 1);
     strictEqual(
-      consoleMock.mock.calls[0].arguments[0].includes('[WARN]'),
+      consoleMock.calls[0].arguments[0].includes('[WARN]'),
       true,
     );
   });
@@ -210,13 +210,13 @@ describe('Logger', () => {
   it('has an error(...args) method which is an alias for log("error", ...args)', () => {
     const logger = new Logger();
 
-    const consoleMock = mock.method(console, 'log', () => {});
+    const consoleMock = mock.method(console, 'log', () => {}).mock;
 
     logger.error('Hello world', {});
 
-    strictEqual(consoleMock.mock.callCount(), 1);
+    strictEqual(consoleMock.callCount(), 1);
     strictEqual(
-      consoleMock.mock.calls[0].arguments[0].includes('[ERROR]'),
+      consoleMock.calls[0].arguments[0].includes('[ERROR]'),
       true,
     );
   });
diff --git a/packages/core/src/common/utils/log.hook.spec.ts b/packages/core/src/common/utils/log.hook.spec.ts
index c5f2920b09..5bdcdbd22c 100644
--- a/packages/core/src/common/utils/log.hook.spec.ts
+++ b/packages/core/src/common/utils/log.hook.spec.ts
@@ -28,13 +28,13 @@ describe('Log', () => {
     const services = new ServiceManager();
 
     const logger = services.get(Logger);
-    const loggerMock = mock.method(logger, 'warn');
+    const loggerMock = mock.method(logger, 'warn').mock;
 
     hook(ctx, services);
 
-    strictEqual(loggerMock.mock.callCount(), 1);
+    strictEqual(loggerMock.callCount(), 1);
     strictEqual(
-      loggerMock.mock.calls[0].arguments[0],
+      loggerMock.calls[0].arguments[0],
       'Using the @Log hook is deprecated. Use the Logger service in a custom hook instead.'
     );
   });
diff --git a/packages/core/src/express/create-app.spec.ts b/packages/core/src/express/create-app.spec.ts
index afaa3b1ebe..6ae40ba15e 100644
--- a/packages/core/src/express/create-app.spec.ts
+++ b/packages/core/src/express/create-app.spec.ts
@@ -683,7 +683,7 @@ describe('createApp', () => {
       const serviceManager = new ServiceManager();
 
       const logger = serviceManager.get(Logger);
-      const loggerMock = mock.method(logger, 'info', () => {});
+      const loggerMock = mock.method(logger, 'info', () => {}).mock;
 
       const app = await createApp(AppController, {
         serviceManager
@@ -693,10 +693,10 @@ describe('createApp', () => {
         .get('/a?apiKey=a_secret_api_key')
         .expect(200);
 
-      strictEqual(loggerMock.mock.callCount(), 1);
+      strictEqual(loggerMock.callCount(), 1);
 
-      const message = loggerMock.mock.calls[0].arguments[0];
-      const params = loggerMock.mock.calls[0].arguments[1];
+      const message = loggerMock.calls[0].arguments[0];
+      const params = loggerMock.calls[0].arguments[1];
 
       strictEqual(message, 'HTTP request - GET /a');
       strictEqual(typeof params?.responseTime, 'number')
@@ -726,14 +726,14 @@ describe('createApp', () => {
       const serviceManager = new ServiceManager();
 
       const logger = serviceManager.get(Logger);
-      const loggerMock = mock.method(logger, 'warn', () => {});
+      const loggerMock = mock.method(logger, 'warn', () => {}).mock;
 
       await createApp(AppController, {
         serviceManager
       });
 
-      strictEqual(loggerMock.mock.callCount(), 1);
-      strictEqual(loggerMock.mock.calls[0].arguments[0], '[CONFIG] Using another format than "foal" for "settings.loggerFormat" is deprecated.');
+      strictEqual(loggerMock.callCount(), 1);
+      strictEqual(loggerMock.calls[0].arguments[0], '[CONFIG] Using another format than "foal" for "settings.loggerFormat" is deprecated.');
     });
   });
 
@@ -757,7 +757,7 @@ describe('createApp', () => {
 
     const serviceManager = new ServiceManager();
 
-    const consoleMock = mock.method(console, 'log', () => {});
+    const consoleMock = mock.method(console, 'log', () => {}).mock;
 
     const app = await createApp(AppController, {
       serviceManager
@@ -767,7 +767,7 @@ describe('createApp', () => {
       .get('/')
       .expect(200);
 
-    const messages = consoleMock.mock.calls.map(call => JSON.parse(call.arguments[0]));
+    const messages = consoleMock.calls.map(call => JSON.parse(call.arguments[0]));
 
     strictEqual(messages.some(message => message.foo === 'bar'), true);
   });
@@ -839,7 +839,7 @@ describe('createApp', () => {
 
     const serviceManager = new ServiceManager();
     const logger = serviceManager.get(Logger);
-    const loggerMock = mock.method(logger, 'addLogContext', () => {});
+    const loggerMock = mock.method(logger, 'addLogContext', () => {}).mock;
 
     const app = await createApp(AppController, {
       serviceManager
@@ -853,9 +853,9 @@ describe('createApp', () => {
         requestId = response.body.requestId;
       })
 
-    strictEqual(loggerMock.mock.callCount(), 1);
+    strictEqual(loggerMock.callCount(), 1);
 
-    const [key, value] = loggerMock.mock.calls[0].arguments;
+    const [key, value] = loggerMock.calls[0].arguments;
 
     strictEqual(key, 'requestId');
     strictEqual(value, requestId);
diff --git a/packages/core/src/sessions/http/use-sessions.hook.spec.ts b/packages/core/src/sessions/http/use-sessions.hook.spec.ts
index 224bb68267..e31ebafb0f 100644
--- a/packages/core/src/sessions/http/use-sessions.hook.spec.ts
+++ b/packages/core/src/sessions/http/use-sessions.hook.spec.ts
@@ -609,13 +609,13 @@ describe('UseSessions', () => {
 
       it('and add null as user ID to the log context.', async () => {
         const logger = services.get(Logger);
-        const loggerMock = mock.method(logger, 'addLogContext', () => {});
+        const loggerMock = mock.method(logger, 'addLogContext', () => {}).mock;
 
         await hook(ctx, services);
 
-        strictEqual(loggerMock.mock.callCount(), 1);
+        strictEqual(loggerMock.callCount(), 1);
 
-        deepStrictEqual(loggerMock.mock.calls[0].arguments, ['userId', null]);
+        deepStrictEqual(loggerMock.calls[0].arguments, ['userId', null]);
       });
 
     });
@@ -626,13 +626,13 @@ describe('UseSessions', () => {
 
       it('and add null as user ID to the log context.', async () => {
         const logger = services.get(Logger);
-        const loggerMock = mock.method(logger, 'addLogContext', () => {});
+        const loggerMock = mock.method(logger, 'addLogContext', () => {}).mock;
 
         await hook(ctx, services);
 
-        strictEqual(loggerMock.mock.callCount(), 1);
+        strictEqual(loggerMock.callCount(), 1);
 
-        deepStrictEqual(loggerMock.mock.calls[0].arguments, ['userId', userId]);
+        deepStrictEqual(loggerMock.calls[0].arguments, ['userId', userId]);
       });
 
       context('given options.user is not defined', () => {
diff --git a/packages/jwt/src/http/jwt.hook.spec.ts b/packages/jwt/src/http/jwt.hook.spec.ts
index 9fe53f6301..cdfa648f78 100644
--- a/packages/jwt/src/http/jwt.hook.spec.ts
+++ b/packages/jwt/src/http/jwt.hook.spec.ts
@@ -643,13 +643,13 @@ export function testSuite(JWT: typeof JWTOptional|typeof JWTRequired, required:
       }));
 
       const logger = services.get(Logger);
-      const loggerMock = mock.method(logger, 'addLogContext', () => {});
+      const loggerMock = mock.method(logger, 'addLogContext', () => {}).mock;
 
       await hook(ctx, services);
 
-      strictEqual(loggerMock.mock.callCount(), 1);
+      strictEqual(loggerMock.callCount(), 1);
       deepStrictEqual(
-        loggerMock.mock.calls[0].arguments,
+        loggerMock.calls[0].arguments,
         ['userId', 123],
       );
     })

From 6a9f0681f84a8bdb14ae84216a6719837f588ac4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sun, 22 Oct 2023 11:46:05 +0200
Subject: [PATCH 32/37] Allow to customize logged morgan params

---
 packages/core/src/express/create-app.spec.ts | 45 +++++++++++++++++++-
 packages/core/src/express/create-app.ts      | 22 ++++++----
 packages/core/src/express/index.ts           |  2 +-
 packages/core/src/index.ts                   |  1 +
 4 files changed, 59 insertions(+), 11 deletions(-)

diff --git a/packages/core/src/express/create-app.spec.ts b/packages/core/src/express/create-app.spec.ts
index 6ae40ba15e..10de1e3e36 100644
--- a/packages/core/src/express/create-app.spec.ts
+++ b/packages/core/src/express/create-app.spec.ts
@@ -709,7 +709,50 @@ describe('createApp', () => {
         statusCode: 200,
         contentLength: '1',
       });
-    })
+    });
+
+    it('should use the options.getHttpLogParams if provided', async () => {
+      Config.set('settings.loggerFormat', 'foal');
+
+      class AppController {
+        @Get('/a')
+        getA(ctx: Context) {
+          return new HttpResponseOK('a');
+        }
+      }
+
+      const serviceManager = new ServiceManager();
+
+      const logger = serviceManager.get(Logger);
+      const loggerMock = mock.method(logger, 'info', () => {}).mock;
+
+      const app = await createApp(AppController, {
+        serviceManager,
+        getHttpLogParams: (tokens: any, req: any, res: any) => ({
+          method: tokens.method(req, res),
+          url: tokens.url(req, res).split('?')[0],
+          myCustomHeader: req.get('my-custom-header')
+        }),
+      });
+
+      await request(app)
+        .get('/a')
+        .set('my-custom-header', 'my-custom-value')
+        .expect(200);
+
+      strictEqual(loggerMock.callCount(), 1);
+
+      const message = loggerMock.calls[0].arguments[0];
+      const params = loggerMock.calls[0].arguments[1];
+
+      strictEqual(message, 'HTTP request - GET /a');
+
+      deepStrictEqual(params, {
+        method: 'GET',
+        url: '/a',
+        myCustomHeader: 'my-custom-value',
+      });
+    });
   });
 
   context('given the configuration "settings.loggerFormat" is set to a value different from "none" or "foal"', () => {
diff --git a/packages/core/src/express/create-app.ts b/packages/core/src/express/create-app.ts
index 38ff29faf5..d63765a6ee 100644
--- a/packages/core/src/express/create-app.ts
+++ b/packages/core/src/express/create-app.ts
@@ -28,6 +28,7 @@ type ErrorMiddleware = (err: any, req: any, res: any, next: (err?: any) => any)
 export interface CreateAppOptions {
   expressInstance?: any;
   serviceManager?: ServiceManager;
+  getHttpLogParams?: (tokens: any, req: any, res: any) => Record<string, any>;
   preMiddlewares?: (Middleware|ErrorMiddleware)[];
   afterPreMiddlewares?: (Middleware|ErrorMiddleware)[];
   postMiddlewares?: (Middleware|ErrorMiddleware)[];
@@ -53,6 +54,16 @@ function protectionHeaders(req: any, res: any, next: (err?: any) => any) {
   next();
 }
 
+export function getHttpLogParamsDefault(tokens: any, req: any, res: any): Record<string, any> {
+  return {
+    method: tokens.method(req, res),
+    url: tokens.url(req, res).split('?')[0],
+    statusCode: parseInt(tokens.status(req, res), 10),
+    contentLength: tokens.res(req, res, 'content-length'),
+    responseTime: parseFloat(tokens['response-time'](req, res)),
+  };
+}
+
 /**
  * Create an Express application from the root controller.
  *
@@ -112,16 +123,9 @@ export async function createApp(
     '[:date] ":method :url HTTP/:http-version" :status - :response-time ms'
   );
   if (loggerFormat === 'foal') {
+    const getHttpLogParams = options.getHttpLogParams || getHttpLogParamsDefault;
     app.use(morgan(
-      (tokens: any, req: any, res: any) => {
-        return JSON.stringify({
-          method: tokens.method(req, res),
-          url: tokens.url(req, res).split('?')[0],
-          statusCode: parseInt(tokens.status(req, res), 10),
-          contentLength: tokens.res(req, res, 'content-length'),
-          responseTime: parseFloat(tokens['response-time'](req, res)),
-        });
-      },
+      (tokens: any, req: any, res: any) => JSON.stringify(getHttpLogParams(tokens, req, res)),
       {
         stream: {
           write: (message: string) => {
diff --git a/packages/core/src/express/index.ts b/packages/core/src/express/index.ts
index d481ac92dc..2acd84f439 100644
--- a/packages/core/src/express/index.ts
+++ b/packages/core/src/express/index.ts
@@ -1 +1 @@
-export { createApp, OPENAPI_SERVICE_ID } from './create-app';
+export { createApp, OPENAPI_SERVICE_ID, getHttpLogParamsDefault } from './create-app';
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index e341aa9eb8..acd0200cce 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -218,6 +218,7 @@ export {
 export {
   OPENAPI_SERVICE_ID,
   createApp,
+  getHttpLogParamsDefault,
 } from './express';
 export {
   Session,

From da08345f5b28661dc6c4bcaac44c4ffc8ee68b79 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sun, 22 Oct 2023 11:50:30 +0200
Subject: [PATCH 33/37] Fix test on locale time

---
 .../src/common/logging/logger.utils.spec.ts   | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/core/src/common/logging/logger.utils.spec.ts b/packages/core/src/common/logging/logger.utils.spec.ts
index c9c2b7c64d..ff5e6bc722 100644
--- a/packages/core/src/common/logging/logger.utils.spec.ts
+++ b/packages/core/src/common/logging/logger.utils.spec.ts
@@ -22,8 +22,8 @@ function createTestParams() {
 
 describe('formatMessage', () => {
   const isoNow = '2023-02-03T01:12:03.000Z';
-  const localTimeNow = '2:12:03 AM';
   const now = new Date(isoNow);
+  const localeTimeNow = now.toLocaleTimeString();
 
   context('given format is "raw"', () => {
     it('should return a raw text with a full timestamp, detailed params but with no colors.', () => {
@@ -58,7 +58,7 @@ describe('formatMessage', () => {
         const params = createTestParams();
 
         const actual = formatMessage('debug', message, params, 'dev', now)
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[35mDEBUG\u001b[39m Hello world`
+        const expected = `\u001b[90m[${localeTimeNow}]\u001b[39m \u001b[35mDEBUG\u001b[39m Hello world`
           + `\n    error: {`
           + `\n      name: "Error"`
           + `\n      message: "aaa"`
@@ -77,7 +77,7 @@ describe('formatMessage', () => {
         const params = createTestParams();
 
         const actual = formatMessage('info', message, params, 'dev', now)
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m Hello world`
+        const expected = `\u001b[90m[${localeTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m Hello world`
           + `\n    error: {`
           + `\n      name: "Error"`
           + `\n      message: "aaa"`
@@ -96,7 +96,7 @@ describe('formatMessage', () => {
         const params = createTestParams();
 
         const actual = formatMessage('warn', message, params, 'dev', now)
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[33mWARN\u001b[39m Hello world`
+        const expected = `\u001b[90m[${localeTimeNow}]\u001b[39m \u001b[33mWARN\u001b[39m Hello world`
           + `\n    error: {`
           + `\n      name: "Error"`
           + `\n      message: "aaa"`
@@ -115,7 +115,7 @@ describe('formatMessage', () => {
         const params = createTestParams();
 
         const actual = formatMessage('error', message, params, 'dev', now)
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[31mERROR\u001b[39m Hello world`
+        const expected = `\u001b[90m[${localeTimeNow}]\u001b[39m \u001b[31mERROR\u001b[39m Hello world`
           + `\n    error: {`
           + `\n      name: "Error"`
           + `\n      message: "aaa"`
@@ -137,7 +137,7 @@ describe('formatMessage', () => {
         };
 
         const actual = formatMessage('info', message, params, 'dev', now);
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar 100 - 123 ms`
+        const expected = `\u001b[90m[${localeTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar 100 - 123 ms`
 
         strictEqual(actual, expected);
       });
@@ -150,7 +150,7 @@ describe('formatMessage', () => {
         };
 
         const actual = formatMessage('info', message, params, 'dev', now);
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[32m200\u001b[39m - 123 ms`
+        const expected = `\u001b[90m[${localeTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[32m200\u001b[39m - 123 ms`
 
         strictEqual(actual, expected);
       });
@@ -163,7 +163,7 @@ describe('formatMessage', () => {
         };
 
         const actual = formatMessage('info', message, params, 'dev', now);
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[36m300\u001b[39m - 123 ms`
+        const expected = `\u001b[90m[${localeTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[36m300\u001b[39m - 123 ms`
 
         strictEqual(actual, expected);
       });
@@ -176,7 +176,7 @@ describe('formatMessage', () => {
         };
 
         const actual = formatMessage('info', message, params, 'dev', now);
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[33m400\u001b[39m - 123 ms`
+        const expected = `\u001b[90m[${localeTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[33m400\u001b[39m - 123 ms`
 
         strictEqual(actual, expected);
       });
@@ -189,7 +189,7 @@ describe('formatMessage', () => {
         };
 
         const actual = formatMessage('info', message, params, 'dev', now);
-        const expected = `\u001b[90m[${localTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[31m500\u001b[39m - 123 ms`
+        const expected = `\u001b[90m[${localeTimeNow}]\u001b[39m \u001b[36mINFO\u001b[39m GET /foo/bar \u001b[31m500\u001b[39m - 123 ms`
 
         strictEqual(actual, expected);
       });

From 1fe6358a6a78eda0391882cfee49cd75e43623ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sun, 22 Oct 2023 12:37:29 +0200
Subject: [PATCH 34/37] Fix test to support latest version of Node 20

---
 packages/core/src/express/create-app.spec.ts | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/packages/core/src/express/create-app.spec.ts b/packages/core/src/express/create-app.spec.ts
index 10de1e3e36..dad7648616 100644
--- a/packages/core/src/express/create-app.spec.ts
+++ b/packages/core/src/express/create-app.spec.ts
@@ -493,9 +493,18 @@ describe('createApp', () => {
       .type('application/json')
       .send('{ "foo": "bar", }')
       .expect(400)
-      .expect({
-        body: '{ \"foo\": \"bar\", }',
-        message: 'Unexpected token } in JSON at position 16'
+      .then(response => {
+        try {
+          deepStrictEqual(response.body, {
+            body: '{ \"foo\": \"bar\", }',
+            message: 'Unexpected token } in JSON at position 16'
+          });
+        } catch (error) {
+          deepStrictEqual(response.body, {
+            body: '{ \"foo\": \"bar\", }',
+            message: 'Expected double-quoted property name in JSON at position 16'
+          })
+        }
       });
   });
 

From 931aa978f8b7f6768d4efd3a79c76ed19a6d49a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Sun, 22 Oct 2023 12:50:12 +0200
Subject: [PATCH 35/37] Allow to add transport

---
 .../core/src/common/logging/logger.spec.ts    | 20 +++++++++++++++++++
 packages/core/src/common/logging/logger.ts    | 11 +++++++++-
 2 files changed, 30 insertions(+), 1 deletion(-)

diff --git a/packages/core/src/common/logging/logger.spec.ts b/packages/core/src/common/logging/logger.spec.ts
index 725c613ae0..645551eeaf 100644
--- a/packages/core/src/common/logging/logger.spec.ts
+++ b/packages/core/src/common/logging/logger.spec.ts
@@ -161,6 +161,26 @@ describe('Logger', () => {
         strictEqual(consoleMock.callCount(), 0);
       });
     });
+
+    context('given transports have been registered', () => {
+      it('should send them the logs and their levels.', () => {
+        const transport1 = mock.fn((level, log) => {});
+        const transport2 = mock.fn((level, log) => {});
+
+        const logger = new Logger();
+        logger.addTransport(transport1);
+        logger.addTransport(transport2);
+        logger.log('error', 'Hello world', {});
+
+        strictEqual(transport1.mock.callCount(), 1);
+        strictEqual(transport1.mock.calls[0].arguments[0], 'error');
+        strictEqual(transport1.mock.calls[0].arguments[1].includes('Hello world'), true);
+
+        strictEqual(transport2.mock.callCount(), 1);
+        strictEqual(transport2.mock.calls[0].arguments[0], 'error');
+        strictEqual(transport2.mock.calls[0].arguments[1].includes('Hello world'), true);
+      });
+    })
   });
 
   it('has a debug(...args) method which is an alias for log("debug", ...args)', () => {
diff --git a/packages/core/src/common/logging/logger.ts b/packages/core/src/common/logging/logger.ts
index f0da7a3b1c..0ee9c253ce 100644
--- a/packages/core/src/common/logging/logger.ts
+++ b/packages/core/src/common/logging/logger.ts
@@ -7,6 +7,13 @@ import { Level, formatMessage, shouldLog } from './logger.utils';
 
 export class Logger {
   private asyncLocalStorage = new AsyncLocalStorage<Record<string, any>>();
+  private transports: ((level: Level, log: string) => void)[] = [
+    (level, log) => console.log(log),
+  ];
+
+  addTransport(transport: (level: Level, log: string) => void): void {
+    this.transports.push(transport);
+  }
 
   initLogContext(callback: () => void): void {
     this.asyncLocalStorage.run({}, callback);
@@ -49,7 +56,9 @@ export class Logger {
       now,
     );
 
-    console.log(formattedMessage);
+    for (const transport of this.transports) {
+      transport(level, formattedMessage);
+    }
   }
 
   debug(message: string, params: { error?: Error, [name: string]: any } = {}): void {

From 44d32191a2cb43185557bd82720995d732713d06 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Mon, 23 Oct 2023 23:44:39 +0200
Subject: [PATCH 36/37] [Docs] Add docs on logging

---
 docs/docs/common/images/dev-format.png        | Bin 0 -> 75820 bytes
 docs/docs/common/images/json-format.png       | Bin 0 -> 96046 bytes
 docs/docs/common/images/raw-format.png        | Bin 0 -> 112165 bytes
 docs/docs/common/logging.md                   | 359 ++++++++++--------
 .../current/architecture/controllers.md       |   5 +
 5 files changed, 196 insertions(+), 168 deletions(-)
 create mode 100644 docs/docs/common/images/dev-format.png
 create mode 100644 docs/docs/common/images/json-format.png
 create mode 100644 docs/docs/common/images/raw-format.png

diff --git a/docs/docs/common/images/dev-format.png b/docs/docs/common/images/dev-format.png
new file mode 100644
index 0000000000000000000000000000000000000000..78a18bf843a3d8e81f7e8c97f2bd7a312be9cece
GIT binary patch
literal 75820
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

literal 0
HcmV?d00001

diff --git a/docs/docs/common/images/json-format.png b/docs/docs/common/images/json-format.png
new file mode 100644
index 0000000000000000000000000000000000000000..872f0393cde0dd20b76c2b4e4d0caac420a09ee0
GIT binary patch
literal 96046
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

literal 0
HcmV?d00001

diff --git a/docs/docs/common/images/raw-format.png b/docs/docs/common/images/raw-format.png
new file mode 100644
index 0000000000000000000000000000000000000000..8a5762995301e66c2f2a709f3258e825bc601bb3
GIT binary patch
literal 112165
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

literal 0
HcmV?d00001

diff --git a/docs/docs/common/logging.md b/docs/docs/common/logging.md
index 2f068f009d..f45302656f 100644
--- a/docs/docs/common/logging.md
+++ b/docs/docs/common/logging.md
@@ -2,259 +2,282 @@
 title: Logging
 ---
 
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
+Foal provides an advanced built-in logger. This page shows how to use it.
 
+## Recommended Configuration
 
-## HTTP Request Logging
-
-FoalTS uses [morgan](https://www.npmjs.com/package/morgan) to log the HTTP requests. You can specify the output format using the environment variable `SETTINGS_LOGGER_FORMAT` or the `config/default.json` file:
-
-<Tabs
-  defaultValue="yaml"
-  values={[
-    {label: 'YAML', value: 'yaml'},
-    {label: 'JSON', value: 'json'},
-    {label: 'JS', value: 'js'},
-  ]}
->
-<TabItem value="yaml">
-
-```yaml
-settings:
-  loggerFormat: tiny
+*config/default.json*
+```json
+{
+  "settings": {
+    "loggerFormat": "foal"
+  }
+}
 ```
 
-</TabItem>
-<TabItem value="json">
-
+*config/development.json*
 ```json
 {
   "settings": {
-    "loggerFormat": "tiny"
+    "logger": {
+      "format": "dev"
+    }
   }
 }
 ```
 
-</TabItem>
-<TabItem value="js">
+## Accessing and Using the Logger
 
-```javascript
-module.exports = {
-  settings: {
-    loggerFormat: "tiny"
+To log a message anywhere in the application, you can inject the `Logger` service and use its `info` method. This methods takes two parameters:
+- a required `message` string,
+- and an optional `params` object if you wish to add additional data to the log.
+
+*Example with a controller*
+```typescript
+import { dependency, Logger, Post } from '@foal/core';
+
+export class AuthController {
+  @dependency
+  logger: Logger;
+
+  @Post('/signup')
+  signup() {
+    ...
+    this.logger.info('Someone signed up!');
   }
+
 }
 ```
 
-</TabItem>
-</Tabs>
+*Example with a hook*
+```typescript
+import { Hook, Logger } from '@foal/core';
 
-## Disabling HTTP Request Logging
+export function LogUserId() {
+  return Hook((ctx, services) => {
+    const logger = services.get(Logger);
+    logger.info(`Logging user ID`, { userId: ctx.user.id });
+  });
+}
+```
 
-In some scenarios and environments, you might want to disable http request logging. You can achieve this by setting the `loggerFormat` configuration option to `none`. 
+## Levels of Logs
 
-<Tabs
-  defaultValue="yaml"
-  values={[
-    {label: 'YAML', value: 'yaml'},
-    {label: 'JSON', value: 'json'},
-    {label: 'JS', value: 'js'},
-  ]}
->
-<TabItem value="yaml">
+The logger supports four levels of logs:
+- the `debug` level which is commonly used to log debugging data,
+- the `info` level which logs informative data,
+- the `warn` level which logs data that requires attention,
+- and the `error` level which logs errors.
 
-```yaml
-settings:
-  loggerFormat: none
+*Examples*
+```typescript
+this.logger.debug('This a debug message');
+this.logger.info('This an info message');
+this.logger.warn('This a warn message');
+this.logger.error('This an error message');
+
+this.logger.log('debug', 'This a debug message');
 ```
 
-</TabItem>
-<TabItem value="json">
+By default, only the `info`, `warn` and `error` messages are logged in the console. If you wish to log all messages, you can update your configuration as follows:
 
 ```json
 {
   "settings": {
-    "loggerFormat": "none"
+    "logger": {
+      "logLevel": "DEBUG"
+    }
   }
 }
 ```
 
-</TabItem>
-<TabItem value="js">
+| Value of `settings.logger.logLevel` | Levels of logs displayed |
+| --- | --- |
+| `DEBUG` | error, warn, info, debug |
+| `INFO` | error, warn, info |
+| `WARN` | error, warn |
+| `ERROR` | error |
+
+## Log Ouput Formats
+
+Foal's logger lets you log your messages in three different ways: `raw` (default), `dev` and `json`.
 
-```javascript
-module.exports = {
-  settings: {
-    loggerFormat: "none"
+*Example of configuration*
+```json
+{
+  "settings": {
+    "logger": {
+      "format": "json"
+    }
   }
 }
 ```
 
-</TabItem>
-</Tabs>
+### The `dev` format
+
+With this format, the logged output contains a small timestamp, beautiful colors and the message. The logger also displays an `error` if one is passed as parameter and it prettifies the HTTP request logs.
 
-## Disabling Error Logging
+This format is adapted to a development environment and focuses on reducing noise.
 
-In some scenarios, you might want to disable error logging (error stack traces that are displayed when an error is thrown in a controller or hook). You can achieve this by setting the `allErrors` configuration option to false. 
+![dev format](./images/dev-format.png)
 
-<Tabs
-  defaultValue="yaml"
-  values={[
-    {label: 'YAML', value: 'yaml'},
-    {label: 'JSON', value: 'json'},
-    {label: 'JS', value: 'js'},
-  ]}
->
-<TabItem value="yaml">
+### The `raw` format
 
-```yaml
-settings:
-  allErrors: false
+This format aims to log much more information and is suitable for a production environment.
+
+The output contains a complete time stamp, the log level, the message and all parameters passed to the logger if any.
+
+![raw format](./images/raw-format.png)
+
+### The `json` format
+
+Similar to the `raw` one, this format prints the same information except that it is displayed with a JSON. This format is useful if you need to diggest the logs with another log tool (such as an aggregator for example).
+
+![raw format](./images/json-format.png)
+
+### Hiding logs: the `none` format
+
+If you wish to completly mask logs, you can use the `none` format.
+
+## HTTP Request Logging
+
+Each request received by Foal is logged with the INFO level.
+
+With the configuration key `settings.loggerFormat` set to `"foal"`, the messages start with `HTTP request -` and end with the request method and URL. The log parameters include the response status code and content length as well as the response time and the request method and URL.
+
+> Note: the query parameters are not logged to avoid logging sensitive data (such as an API key).
+
+### Adding other parameters to the logs
+
+If the default logged HTTP parameters are not sufficient in your case, you can extend them with the option `getHttpLogParams` in `createApp`:
+
+```typescript
+import { createApp, getHttpLogParamsDefault } from '@foal/core';
+
+const app = await createApp({
+  getHttpLogParams: (tokens, req, res) => ({
+    ...getHttpLogParamsDefault(tokens, req, res),
+    myCustomHeader: req.get('my-custom-header'),
+  })
+})
 ```
 
-</TabItem>
-<TabItem value="json">
+### Formatting the log message (deprecated)
+
+If you wish to customize the HTTP log messages, you can set the value of the `loggerFormat.loggerFormat` configuration to a format supported by [morgan](https://www.npmjs.com/package/morgan). With this technique, no parameters will be logged though.
 
 ```json
 {
   "settings": {
-    "allErrors": false
+    "loggerFormat": "tiny"
   }
 }
 ```
 
-</TabItem>
-<TabItem value="js">
+### Disabling HTTP Request Logging
 
-```javascript
-module.exports = {
-  settings: {
-    allErrors: false
+In some scenarios and environments, you might want to disable HTTP request logging. You can achieve this by setting the `loggerFormat` configuration option to `none`. 
+
+```json
+{
+  "settings": {
+    "loggerFormat": "none"
   }
 }
 ```
 
-</TabItem>
-</Tabs>
+## Error Logging
 
-## Logging Hook
+When an error is thrown (or rejected) in a hook, controller or service and is not caught, the error is logged using the `Logger.error` method.
 
-FoalTS provides a convenient hook for logging debug messages: `Log(message: string, options: LogOptions = {})`.
+### Disabling Error Logging
 
-```typescript
-interface LogOptions {
-  body?: boolean;
-  params?: boolean;
-  headers?: string[]|boolean;
-  query?: boolean;
-}
-```
+In some scenarios, you might want to disable error logging. You can achieve this by setting the `allErrors` configuration option to false. 
 
-*Example:*
-```typescript
-import { Get, HttpResponseOK, Log } from '@foal/core';
-
-@Log('AppController', {
-  body: true,
-  headers: [ 'X-CSRF-Token' ],
-  params: true,
-  query: true
-})
-export class AppController {
-  @Get()
-  index() {
-    return new HttpResponseOK();
+```json
+{
+  "settings": {
+    "allErrors": false
   }
 }
 ```
 
-## Advanced Logging
+## Log correlation (by HTTP request, user ID, etc)
 
-If you need advanced logging, you might be interested in using [winston](https://www.npmjs.com/package/winston), a popular logger in the Node.js ecosystem.
+When logs are generated in large quantities, we often like to aggregate them by request or user. This can be done using Foal's log context.
 
-Here's an example on how to use it with Foal:
+When receiving a request, Foal adds the request ID to the logger context. On each subsequent call to the logger, it will behave as if the request ID had been passed as a parameter.
 
-*LoggerService*
+*Example*
 ```typescript
-import * as winston from 'winston';
-
-export class LoggerService {
-  private logger: any;
-
-  constructor() {
-    this.logger = winston.createLogger({
-      transports: [
-        new winston.transports.Console(),
-        new winston.transports.File({
-          filename: 'logs.txt'
-        })
-      ]
-    });
-  }
+export class AppController {
+  @dependency
+  logger: Logger;
 
-  info(msg: string) {
-    this.logger.info(msg);
-  }
+  @Get('/foo')
+  getFoo(ctx: Context) {
+    this.logger.info('Hello world');
+    // equivalent to this.logger.info('Hello world', { requestId: ctx.request.id });
 
-  warn(msg: string) {
-    this.logger.warn(msg);
+    setTimeout(() => {
+      this.logger.info('Hello world');
+      // equivalent to this.logger.info('Hello world', { requestId: ctx.request.id });
+    }, 1000)
+    return new HttpResponseOK();
   }
+}
+```
 
-  error(msg: string) {
-    this.logger.error(msg);
-  }
+In the same way, the authentification hooks `@JWTRequired`, `@JWTOptional` and `@UseSessions` will add the `userId` (if any) to the logger context.
 
-}
+This mecanism helps filter logs of a specific request or specific user in a logging tool.
 
+If needed, you call also add manually custom parameters to the logger context with this fonction:
+```typescript
+logger.addLogContext('myKey', 'myValue');
 ```
 
-*LogUserId hook*
-```typescript
-import { Hook } from '@foal/core';
-// LoggerService import.
+## Transports
 
-export function LogUserId() {
-  return Hook((ctx, services) => {
-    const logger = services.get(LoggerService);
-    logger.info(`UserId is: ${ctx.user.id}`);
-  });
-}
+All logs are printed using the `console.log` function.
 
-```
+If you also wish to consume the logs in another way (for example, to send them to a third-party error-tracking or logging tool), you can add one or more transports to the logger:
 
-*ProductController*
 ```typescript
-import { Get } from '@foal/core';
-// LogUserId import.
+logger.addTransport((level: 'debug'|'warn'|'info'|'error', log: string) => {
+  // Do something
+})
+```
 
-export class ProductController {
+## Logging Hook (deprecated)
 
-  @Get('/')
-  @LogUserId()
-  readProducts() {
-    ...
-  }
+> This hook is deprecated and will be removed in a next release. Use the `Logger` service in a custom hook instead.
 
-}
+FoalTS provides a convenient hook for logging debug messages: `Log(message: string, options: LogOptions = {})`.
 
+```typescript
+interface LogOptions {
+  body?: boolean;
+  params?: boolean;
+  headers?: string[]|boolean;
+  query?: boolean;
+}
 ```
 
-*AuthController*
+*Example:*
 ```typescript
-import { dependency, Post } from '@foal/core';
-// LoggerService import.
-
-export class AuthController {
-  @dependency
-  logger: LoggerService;
+import { Get, HttpResponseOK, Log } from '@foal/core';
 
-  @Post('/signup')
-  signup() {
-    ...
-    this.logger.info('Someone signed up!');
+@Log('AppController', {
+  body: true,
+  headers: [ 'X-CSRF-Token' ],
+  params: true,
+  query: true
+})
+export class AppController {
+  @Get()
+  index() {
+    return new HttpResponseOK();
   }
-
 }
-
-```
\ No newline at end of file
+```
diff --git a/docs/i18n/fr/docusaurus-plugin-content-docs/current/architecture/controllers.md b/docs/i18n/fr/docusaurus-plugin-content-docs/current/architecture/controllers.md
index 5030eb6d06..e5e8dfa971 100644
--- a/docs/i18n/fr/docusaurus-plugin-content-docs/current/architecture/controllers.md
+++ b/docs/i18n/fr/docusaurus-plugin-content-docs/current/architecture/controllers.md
@@ -250,6 +250,11 @@ class AppController {
 
 > In order to use signed cookies, you must provide a secret with the configuration key `settings.cookieParser.secret`.
 
+#### Read the request ID
+
+On each request, a request ID is generated randomly. It can be read through `ctx.request.id`.
+
+If the `X-Request-ID` header exists, then the header value is used as the request identifier.
 
 #### The Controller Method Arguments
 

From 40ab005fce318fa7f494d747fbe043d30aaae843 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Poullain?= <loic.poullain@centraliens.net>
Date: Tue, 24 Oct 2023 00:02:54 +0200
Subject: [PATCH 37/37] [Blog] Add v4.1 release notes

---
 .../assets/version-4.1-is-here/banner.png     | Bin 0 -> 17182 bytes
 docs/blog/version-4.1-release-notes.md        |  49 ++++++++++++++++++
 .../version-4.1-release-notes.png             | Bin 0 -> 32560 bytes
 3 files changed, 49 insertions(+)
 create mode 100644 docs/blog/assets/version-4.1-is-here/banner.png
 create mode 100644 docs/blog/version-4.1-release-notes.md
 create mode 100644 docs/static/blog/twitter-banners/version-4.1-release-notes.png

diff --git a/docs/blog/assets/version-4.1-is-here/banner.png b/docs/blog/assets/version-4.1-is-here/banner.png
new file mode 100644
index 0000000000000000000000000000000000000000..555415de3252ae766bcec05194550a206fa9f949
GIT binary patch
literal 17182
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
J*FLcc|6j^8Um*Yh

literal 0
HcmV?d00001

diff --git a/docs/blog/version-4.1-release-notes.md b/docs/blog/version-4.1-release-notes.md
new file mode 100644
index 0000000000..9749d5e6ba
--- /dev/null
+++ b/docs/blog/version-4.1-release-notes.md
@@ -0,0 +1,49 @@
+---
+title: Version 4.1 release notes
+author: Loïc Poullain
+author_title: Creator of FoalTS. Software engineer.
+author_url: https://loicpoullain.com
+author_image_url: https://avatars1.githubusercontent.com/u/13604533?v=4
+image: blog/twitter-banners/version-4.1-release-notes.png
+tags: [release]
+---
+
+![Banner](./assets/version-4.1-is-here/banner.png)
+
+Version 4.1 of [Foal](https://foalts.org/) is out!
+
+<!--truncate-->
+
+## Better logging
+
+Foal now features a true logging system. Full documentation can be found [here](../docs/common/logging).
+
+### New recommended configuration
+
+It is recommended to switch to this configuration to take full advantage of the new logging system.
+
+*config/default.json*
+```json
+{
+  "settings": {
+    "loggerFormat": "foal"
+  }
+}
+```
+
+*config/development.json*
+```json
+{
+  "settings": {
+    "logger": {
+      "format": "dev"
+    }
+  }
+}
+```
+
+## Request IDs
+
+On each request, a request ID is now generated randomly. It can be read through `ctx.request.id`.
+
+If the `X-Request-ID` header exists in the request, then the header value is used as the request identifier.
diff --git a/docs/static/blog/twitter-banners/version-4.1-release-notes.png b/docs/static/blog/twitter-banners/version-4.1-release-notes.png
new file mode 100644
index 0000000000000000000000000000000000000000..c742d8947b8c497bf841e0122577d0655c66f3b7
GIT binary patch
literal 32560
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
I<o@6P2TI7T;{X5v

literal 0
HcmV?d00001