@vario-software/vario-app-framework-backend 2025.41.0 → 2025.42.0

package/app.js

@@ -12,10 +12,17 @@ const OfflineToken = require('#backend/modules/offlineToken.js');
 const AccessToken = require('#backend/modules/accessToken.js');
 const BaseUrlCache = require('#backend/modules/baseUrlCache.js');
 
+let exceptionHandler;
+
 const VarioCloudApp = class
 {
   constructor(client, options = {})
   {
+    this.onUnhandledError = options.onUnhandledError ?? console.error;
+    this.onMigrationError = options.onMigrationError ?? console.error;
+
+    exceptionHandler = setupException(this);
+
     this.express = express();
     this.port = '8080';
     this.uiPath = null;
@@ -26,6 +33,7 @@ const VarioCloudApp = class
     this.client = client;
 
     this.log = options.log ?? log;
+
     this.offlineToken = options.offlineToken ?? new OfflineToken(this);
     this.accessToken = options.accessToken ?? new AccessToken(this);
     this.baseUrlCache = options.baseUrlCache ?? new BaseUrlCache(this);
@@ -78,7 +86,7 @@ const VarioCloudApp = class
       this.express.use(this.uiPrefix, this.uiServer);
     }
 
-    this.express.use(setupException(this));
+    this.express.use(exceptionHandler);
 
     return new Promise((resolve, reject) =>
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vario-software/vario-app-framework-backend",
-  "version": "2025.41.0",
+  "version": "2025.42.0",
   "repository": "https://github.com/vario-software/vario-app-framework",
   "author": "VARIO Software AG",
   "homepage": "https://www.vario.ag",

package/setup/exception.js

@@ -1,9 +1,57 @@
 const { getResponse, getApp } = require('#backend/utils/context.js');
 const HttpError = require('#backend/utils/httpError.js');
 
-function setupException()
+function setupException(app)
 {
+  async function errorHandling(error)
+  {
+    if (error.handled)
+    {
+      return;
+    }
+
+    error.handled = true;
+
+    const response = getResponse();
+    const statusCode = error.statusCode ?? 500;
+    const logLevel = error.logLevel ?? 'ERROR';
+    const logService = error.logService ?? 'setup/exception';
+    const stackTrace = error.stack?.split('\n').map(line => line.trim());
+    const { logInfo, data } = error;
+
+    let message = 'UNKNOWN_ERROR';
+
+    if (error instanceof HttpError)
+    {
+      if (error.message)
+      {
+        message = error.message;
+      }
+
+      await getApp()?.log(
+        {
+          statusCode,
+          message,
+          logInfo,
+          stackTrace,
+        },
+        logService,
+        logLevel,
+      );
+    }
+    else
+    {
+      await app.onUnhandledError(error);
+    }
+
+    if (response && !response.headersSent)
+    {
+      response.status(statusCode).send({ error: message, data }).end();
+    }
+  }
+
   process.on('unhandledRejection', reason => errorHandling(reason));
+  process.on('uncaughtException', reason => errorHandling(reason));
 
   // eslint-disable-next-line no-unused-vars
   return (error, req, res, next) =>
@@ -12,38 +60,4 @@ function setupException()
   };
 }
 
-async function errorHandling(error)
-{
-  const response = getResponse();
-  const statusCode = error.statusCode ?? 500;
-  const message = error.message ?? 'UNKNOWN_ERROR';
-  const logLevel = error.logLevel ?? 'ERROR';
-  const logService = error.logService ?? 'setup/exception';
-  const stackTrace = error.stack?.split('\n').map(line => line.trim());
-  const { logInfo, data } = error;
-
-  if (error instanceof HttpError)
-  {
-    await getApp()?.log(
-      {
-        statusCode,
-        message,
-        logInfo,
-        stackTrace,
-      },
-      logService,
-      logLevel,
-    );
-  }
-  else
-  {
-    console.warn(error);
-  }
-
-  if (response && !response.headersSent)
-  {
-    response.status(statusCode).send({ error: message, data }).end();
-  }
-}
-
 module.exports = setupException;

package/utils/migrator.js

@@ -47,6 +47,8 @@ const Migrator = class
     }
     catch (error)
     {
+      await this.app.onMigrationError(error);
+
       await this.methods.log(`Migration "${migration}" failed\n\n${error.message}`, 'ERROR', error.message);
     }
   };