fix(logging): use logger instead of console in stack modules (#3442)

* fix(auth): clean up stale test users before signup in integration tests

Auth integration tests used hardcoded emails without cleaning the
database before each run. On shared MongoDB instances (e.g. ARC
self-hosted runners), stale data from previous CI runs caused
cascading test failures.

Add pre-signup cleanup in all beforeAll/beforeEach hooks across
the four auth integration test files to purge any leftover users
by email before attempting signup.

Closes #3437

* fix(auth): add @returns JSDoc to purgeUser helper

* fix(logging): replace console.* with Winston logger in stack modules

Replace console.error/log/warn/info with the Winston-based logger from
lib/services/logger.js across all production stack modules. This ensures
structured logging, Sentry capture, and consistent log formatting.

Files excluded from this change:
- config/index.js and lib/helpers/config.js (loaded before logger init)
- lib/services/logger.js (is the logger itself)
- scripts/seed.js (CLI script)
- Test files (except where assertions needed updating)

Closes #3434

* fix(logging): address review feedback — preserve error stacks, redact secrets

- Log full Error objects instead of just .message (server.js, mailer, sentry)
- Remove JSON.stringify wrapping on error messages (server.js)
- Fix 'develoment' typo → 'development' (lib/app.js)
- Redact DB URI credentials before logging (lib/app.js)
- Redact seed passwords from log output (lib/services/seed.js)

* fix(logging): address CodeRabbit review — full error objects, reorder close log

- Include error object in readiness-check warn (lib/app.js)
- Move success log after error check in server close callback (lib/app.js)
- Log full error object for migration failures (lib/services/migrations.js)

Author: PierreBrisorgueil

lib/app.js

@@ -6,6 +6,7 @@ import nodeHttp from 'http';
 import nodeHttps from 'https';
 
 import config from '../config/index.js';
+import logger from './services/logger.js';
 import express from './services/express.js';
 import mongooseService from './services/mongoose.js';
 import migrations from './services/migrations.js';
@@ -94,26 +95,25 @@ const logConfiguration = async () => {
   // Create server URL
   const server = `${(config.secure && config.secure.credentials ? 'https://' : 'http://') + config.api.host}:${config.api.port}`;
   // Logging initialization
-  console.log(chalk.green(config.app.title));
-  console.log();
-  console.log(chalk.green(`Environment:     ${process.env.NODE_ENV ? process.env.NODE_ENV : 'develoment'}`));
-  console.log(chalk.green(`Server:          ${server}`));
-  console.log(chalk.green(`Database:        ${config.db.uri}`));
-  if (config.cors.origin.length > 0) console.log(chalk.green(`Cors:            ${config.cors.origin}`));
+  logger.info(chalk.green(config.app.title));
+  logger.info(chalk.green(`Environment:     ${process.env.NODE_ENV ? process.env.NODE_ENV : 'development'}`));
+  logger.info(chalk.green(`Server:          ${server}`));
+  const safeUri = config.db.uri.replace(/\/\/[^@]+@/, '//***:***@');
+  logger.info(chalk.green(`Database:        ${safeUri}`));
+  if (config.cors.origin.length > 0) logger.info(chalk.green(`Cors:            ${config.cors.origin}`));
 
   // SaaS readiness summary (skip in test to keep output clean)
   if (process.env.NODE_ENV !== 'test') {
     try {
       const { default: HomeService } = await import('../modules/home/services/home.service.js');
       const checks = HomeService.getReadinessStatus();
-      console.log();
-      console.log(chalk.green('SaaS Readiness:'));
+      logger.info(chalk.green('SaaS Readiness:'));
       checks.forEach((c) => {
         const icon = c.status === 'ok' ? chalk.green('OK') : chalk.yellow('WARN');
-        console.log(`  ${icon}  ${c.category.padEnd(12)} ${c.message}`);
+        logger.info(`  ${icon}  ${c.category.padEnd(12)} ${c.message}`);
       });
     } catch (err) {
-      console.log(chalk.yellow(`  SaaS readiness check failed: ${err.message}`));
+      logger.warn(chalk.yellow(`  SaaS readiness check failed: ${err.message}`), err);
     }
   }
 };
@@ -160,7 +160,7 @@ const FORCE_SHUTDOWN_TIMEOUT_MS = 5000;
 const shutdown = async (server) => {
   // Force exit if graceful shutdown hangs
   const forceTimeout = setTimeout(() => {
-    console.error(chalk.red('Forced shutdown (timeout)'));
+    logger.error(chalk.red('Forced shutdown (timeout)'));
     process.exit(1);
   }, FORCE_SHUTDOWN_TIMEOUT_MS);
   forceTimeout.unref();
@@ -171,15 +171,16 @@ const shutdown = async (server) => {
     await SentryService.shutdown();
     await mongooseService.disconnect();
     value.http.close((err) => {
-      console.info(chalk.yellow('Server closed'));
       if (err) {
-        console.info(chalk.red('Error on server close.', err));
+        logger.error(chalk.red('Error on server close.'), err);
         process.exitCode = 1;
+      } else {
+        logger.info(chalk.yellow('Server closed'));
       }
       process.exit();
     });
   } catch (err) {
-    console.error(chalk.red('Shutdown error: server never started or shutdown failed'), err);
+    logger.error(chalk.red('Shutdown error: server never started or shutdown failed'), err);
     process.exit(1);
   }
 };

lib/helpers/mailer/index.js

@@ -2,6 +2,7 @@ import path from 'path';
 import handlebars from 'handlebars';
 
 import config from '../../../config/index.js';
+import logger from '../../services/logger.js';
 import files from '../files.js';
 import NodemailerProvider from './provider.nodemailer.js';
 import ResendProvider from './provider.resend.js';
@@ -93,7 +94,7 @@ const sendMail = async (mail) => {
     if (!Array.isArray(result?.accepted)) return { ...result, accepted: [mail.to], rejected: [] };
     return result;
   } catch (err) {
-    console.error(`Mail send error: ${err.message}`);
+    logger.error('Mail send error', err);
     return null;
   }
 };

lib/helpers/mailer/tests/mailer.unit.tests.js

@@ -29,6 +29,15 @@ jest.unstable_mockModule('../provider.nodemailer.js', () => ({
   default: jest.fn().mockImplementation(() => ({ send: jest.fn() })),
 }));
 
+jest.unstable_mockModule('../../../services/logger.js', () => ({
+  default: {
+    error: jest.fn(),
+    warn: jest.fn(),
+    info: jest.fn(),
+    debug: jest.fn(),
+  },
+}));
+
 const { default: mailer } = await import('../index.js');
 
 describe('mailer index with resend provider unit tests:', () => {

lib/services/express.js

@@ -117,12 +117,12 @@ const initPreParserRoutes = async (app) => {
     try {
       const route = await import(path.resolve(routePath));
       if (typeof route.default !== 'function') {
-        console.warn(`Pre-parser route ${routePath} does not export a default function`);
+        logger.warn(`Pre-parser route ${routePath} does not export a default function`);
         continue;
       }
       route.default(app);
     } catch (err) {
-      console.error(`Failed to load pre-parser route: ${routePath}`, err);
+      logger.error(`Failed to load pre-parser route: ${routePath}`, err);
       throw err;
     }
   }
@@ -237,7 +237,7 @@ const initModulesServerRoutes = async (app) => {
 const initErrorRoutes = (app) => {
   app.use((err, req, res, next) => {
     if (!err) return next();
-    console.error(err.stack);
+    logger.error(err.stack);
     res.status(err.status || 500).send({
       message: err.message,
       code: err.code,

lib/services/migrations.js

@@ -5,6 +5,7 @@ import chalk from 'chalk';
 import mongoose from 'mongoose';
 import path from 'path';
 import { glob } from 'glob';
+import logger from './logger.js';
 
 /**
  * Scan all modules for migration files matching `modules/*/migrations/*.js`.
@@ -89,7 +90,7 @@ const runMigration = async (filePath, executed) => {
   // Atomically claim the migration to prevent concurrent execution
   const claimed = await claimMigration(name);
   if (!claimed) {
-    console.log(chalk.yellow(`  Migration already claimed by another runner: ${name}`));
+    logger.warn(chalk.yellow(`  Migration already claimed by another runner: ${name}`));
     return false;
   }
 
@@ -115,7 +116,7 @@ const runMigration = async (filePath, executed) => {
     throw err;
   }
 
-  console.log(chalk.green(`  Migration executed: ${name}`));
+  logger.info(chalk.green(`  Migration executed: ${name}`));
   return true;
 };
 
@@ -133,30 +134,29 @@ const run = async () => {
   const files = await discoverMigrationFiles();
 
   if (files.length === 0) {
-    console.log(chalk.yellow('No migration files found.'));
+    logger.warn(chalk.yellow('No migration files found.'));
     return { total: 0, executed: 0 };
   }
 
   const executed = await getExecutedMigrations();
   let executedCount = 0;
 
-  console.log(chalk.yellow(`Running migrations (${files.length} found, ${executed.size} already executed)...`));
+  logger.info(chalk.yellow(`Running migrations (${files.length} found, ${executed.size} already executed)...`));
 
   for (const filePath of files) {
     try {
       const wasRun = await runMigration(filePath, executed);
       if (wasRun) executedCount++;
     } catch (err) {
-      console.error(chalk.red(`Migration failed: ${path.basename(filePath)}`));
-      console.error(chalk.red(err.message));
+      logger.error(chalk.red(`Migration failed: ${path.basename(filePath)}`), err);
       throw err;
     }
   }
 
   if (executedCount > 0) {
-    console.log(chalk.green(`Migrations complete: ${executedCount} executed.`));
+    logger.info(chalk.green(`Migrations complete: ${executedCount} executed.`));
   } else {
-    console.log(chalk.yellow('All migrations already up to date.'));
+    logger.info(chalk.yellow('All migrations already up to date.'));
   }
 
   return { total: files.length, executed: executedCount };

lib/services/mongoose.js

@@ -6,6 +6,7 @@ import chalk from 'chalk';
 import mongoose from 'mongoose';
 import path from 'path';
 import config from '../../config/index.js';
+import logger from './logger.js';
 
 /**
  * Load all mongoose related models
@@ -38,13 +39,13 @@ const connect = async () => {
 
     await mongoose.connect(config.db.uri, mongoOptions);
     mongoose.set('debug', config.db.debug);
-    console.info(chalk.yellow('Connected to MongoDB.'));
+    logger.info(chalk.yellow('Connected to MongoDB.'));
 
     return mongoose;
   } catch (err) {
     // Log Error
-    console.error(chalk.red('Could not connect to MongoDB!'));
-    console.log(err);
+    logger.error(chalk.red('Could not connect to MongoDB!'));
+    logger.error(err);
     throw err;
   }
 };
@@ -54,7 +55,7 @@ const connect = async () => {
  */
 const disconnect = async () => {
   await mongoose.disconnect();
-  console.info(chalk.yellow('Disconnected from MongoDB.'));
+  logger.info(chalk.yellow('Disconnected from MongoDB.'));
 };
 
 export default {

lib/services/seed.js

@@ -5,6 +5,7 @@ import _ from 'lodash';
 import chalk from 'chalk';
 
 import config from '../../config/index.js';
+import logger from './logger.js';
 
 import AppError from '../helpers/AppError.js';
 
@@ -19,10 +20,10 @@ const seedTheUser = (UserService, user) => async (password) => {
   if (process.env.NODE_ENV === 'test' && (await UserService.get(user))) UserService.remove(user);
   try {
     const result = await UserService.create(user);
-    if (seedOptions.logResults) console.log(chalk.bold.blue(`Database Seeding: Local ${user.email} added with password set to ${password}`));
+    if (seedOptions.logResults) logger.info(chalk.bold.blue(`Database Seeding: Local ${user.email} added with password set to ***`));
     return result;
   } catch (err) {
-    console.log(err);
+    logger.error(err);
     throw new AppError('Failed to seedTheUser.', { code: 'LIB_ERROR' });
   }
 };
@@ -31,10 +32,10 @@ const seedTheUser = (UserService, user) => async (password) => {
 const seedTasks = async (TaskService, task, user) => {
   try {
     const result = await TaskService.create(task, user);
-    if (seedOptions.logResults) console.log(chalk.bold.blue(`Database Seeding: Local ${task.title} added`));
+    if (seedOptions.logResults) logger.info(chalk.bold.blue(`Database Seeding: Local ${task.title} added`));
     return result;
   } catch (err) {
-    console.log(err);
+    logger.error(err);
     throw new AppError('Failed to seedTasks.', { code: 'LIB_ERROR' });
   }
 };
@@ -66,7 +67,7 @@ const start = async (options, UserService, AuthService, TaskService) => {
       }
     }
   } catch (err) {
-    console.log(err);
+    logger.error(err);
     return new AppError('Error on seed start.');
   }
 
@@ -84,7 +85,7 @@ const user = async (user, UserService, AuthService) => {
     pwd = await AuthService.generateRandomPassphrase();
     result.push(await seedTheUser(UserService, user)(pwd));
   } catch (err) {
-    console.log(err);
+    logger.error(err);
     return new AppError('Error on seed start.');
   }
 

lib/services/sentry.js

@@ -2,6 +2,7 @@
  * Module dependencies
  */
 import config from '../../config/index.js';
+import logger from './logger.js';
 
 /**
  * Sentry client reference (null when not configured).
@@ -32,7 +33,7 @@ const init = async () => {
       tracesSampleRate: process.env.NODE_ENV === 'production' ? 0.1 : 1.0,
     });
   } catch (err) {
-    console.error('Sentry init failed:', err.message);
+    logger.error('Sentry init failed:', err);
     Sentry = null;
   }
 };

lib/services/tests/sentry.unit.tests.js

@@ -10,6 +10,15 @@ jest.unstable_mockModule('../../../config/index.js', () => ({
   },
 }));
 
+jest.unstable_mockModule('../logger.js', () => ({
+  default: {
+    error: jest.fn(),
+    warn: jest.fn(),
+    info: jest.fn(),
+    debug: jest.fn(),
+  },
+}));
+
 describe('SentryService unit tests:', () => {
   let SentryService;
 

modules/audit/audit.init.js

@@ -2,6 +2,7 @@
  * Module dependencies
  */
 import config from '../../config/index.js';
+import logger from '../../lib/services/logger.js';
 import auditMiddleware from './middlewares/audit.middleware.js';
 
 /**
@@ -22,6 +23,6 @@ export default async (app) => {
 
   if (process.env.NODE_ENV !== 'test') {
     const enabled = config.audit?.enabled ?? false;
-    console.log(`Audit module: ${enabled ? 'enabled' : 'disabled'}`);
+    logger.info(`Audit module: ${enabled ? 'enabled' : 'disabled'}`);
   }
 };