feat: implement MailGun webhook service for logging email events

Implemented a production-ready TypeScript/Express.js service to receive
and log MailGun webhook events (delivered, failed, opened, clicked, etc.).

Key features:
- Webhook endpoint (POST /webhook) with comprehensive event logging
- Full TypeScript type definitions for all MailGun event types
- Prometheus metrics integration for monitoring
- Health check endpoint (GET /ping)
- Comprehensive Jest test suite with 87.76% coverage
- Docker containerization with build scripts

Removed template/example code:
- All SQL/MSSQL dependencies and related code
- Example auth router and middleware
- PRTG metrics support (simplified to Prometheus only)
- Unused middleware (CORS, IP whitelist, request parsing/validation)
- Template documentation (kept only MailGun webhook API spec)

The service is clean, minimal, and focused solely on receiving and
logging MailGun webhook events to the console.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

mailgun-webhook/src/entry.ts

@@ -0,0 +1,111 @@
+import app from './app';
+import http from 'http';
+import stoppable  from 'stoppable';
+import { logServer } from './lib/logger';
+
+/**
+* Normalize a port into a number, string, or false.
+*/
+const normalizePort = (val:string):string|number|boolean => {
+  const port = parseInt(val, 10);
+
+  if (isNaN(port)) {
+    // named pipe
+    return val;
+  }
+
+  if (port >= 0) {
+    // port number
+    return port;
+  }
+
+  return false;
+};
+
+/**
+* Event listener for HTTP server "error" event.
+*/
+const onError = (error:any):void => {
+  if (error.syscall !== 'listen') {
+    throw error;
+  }
+
+  const bind = typeof port === 'string'
+    ? 'Pipe ' + port
+    : 'Port ' + port;
+
+  // handle specific listen errors with friendly messages
+  switch (error.code) {
+    case 'EACCES':
+      console.error(bind + ' requires elevated privileges');
+      process.exit(1);
+      break;
+    case 'EADDRINUSE':
+      console.error(bind + ' is already in use');
+      process.exit(1);
+      break;
+    default:
+      throw error;
+  }
+};
+
+/**
+* Event listener for HTTP server "listening" event.
+*/
+const onListening = ():void => {
+  const addr = server.address();
+  const bind = typeof addr === 'string'
+    ? 'pipe ' + addr
+    : 'port ' + addr?.port;
+  logServer(`server is running at ${bind}`);
+};
+
+/**
+* Get port from environment and store in Express.
+*/
+const port:number|string|boolean = normalizePort(process.env.PORT || '3000');
+
+/**
+* How long should stoppable wait before it starts force-closing connections
+* @description wait max 10 seconds - needs to be shorter than `healthcheck.timeout` (=15sec)
+*/
+const FORCE_STOP_TIMEOUT = 10000;
+
+/**
+* Create HTTP server.
+*/
+const server = stoppable( http.createServer(app), FORCE_STOP_TIMEOUT );
+
+// Listen on provided port, on all network interfaces.
+server.listen(port);
+server.on('error', onError);
+server.on('listening', onListening);
+
+// quit on ctrl-c when running docker in terminal
+// (signal neće biti registriran ako je server pokrenuti via `npm` ili `nodemon` - mora biti pokrenuti izravno via Node)
+process.on('SIGINT', () => {
+    logServer('got SIGINT (aka ctrl-c in docker). Graceful shutdown ', new Date().toISOString());
+    shutdown();
+});
+
+// quit properly on docker stop
+// (signal neće biti registriran ako je server pokrenuti via `npm` ili `nodemon` - mora biti pokrenuti izravno via Node)
+process.on('SIGTERM', () => {
+    logServer('got SIGTERM (docker container stop). Graceful shutdown ', new Date().toISOString());
+    shutdown();
+});
+
+// shut down server
+const shutdown = () => {
+  // NOTE: server.close is for express based apps
+  // If using hapi, use `server.stop`
+  server.close((err) => {
+    if (err) {
+      console.error(err);
+      process.exitCode = 1;
+    } else {
+      logServer('Exiting server process...');
+    }
+    process.exit();
+  });
+};