@naman_deep_singh/server-utils 1.0.2 → 1.0.4

package/dist/server.js

@@ -39,7 +39,7 @@ class ExpressServer {
                 this.app.use(cors(corsOptions));
             }
             catch (error) {
-                console.warn('CORS middleware not available. Install cors package.');
+                console.warn(`${this.config.name}: CORS middleware not available. Install cors package.`);
             }
         }
         // Apply Helmet if enabled
@@ -49,7 +49,7 @@ class ExpressServer {
                 this.app.use(helmet());
             }
             catch (error) {
-                console.warn('Helmet middleware not available. Install helmet package.');
+                console.warn(`${this.config.name}: Helmet middleware not available. Install helmet package.`);
             }
         }
         // Apply JSON parser if enabled
@@ -146,11 +146,11 @@ class ExpressServer {
                 });
                 this.grpcServer.bindAsync(`0.0.0.0:${port}`, grpc.ServerCredentials.createInsecure(), () => {
                     this.grpcServer.start();
-                    console.log(`🔗 gRPC server running on port ${port}`);
+                    console.log(`🔗 ${this.config.name} gRPC server running on port ${port}`);
                 });
             }
             catch (error) {
-                console.warn('gRPC not available. Install @grpc/grpc-js to use gRPC features.');
+                console.warn(`${this.config.name}: gRPC not available. Install @grpc/grpc-js to use gRPC features.`);
             }
         }
     }
@@ -161,10 +161,10 @@ class ExpressServer {
             const jayson = require('jayson');
             const rpcServer = jayson.server(this.rpcMethods);
             this.app.use(path, rpcServer.middleware());
-            console.log(`📡 JSON-RPC server mounted on ${path}`);
+            console.log(`📡 ${this.config.name} JSON-RPC server mounted on ${path}`);
         }
         catch (error) {
-            console.warn('JSON-RPC not available. Install jayson to use RPC features.');
+            console.warn(`${this.config.name}: JSON-RPC not available. Install jayson to use RPC features.`);
         }
     }
     addWebhook(config) {
@@ -195,11 +195,11 @@ class ExpressServer {
                 res.status(500).json({ error: 'Webhook processing failed' });
             }
         });
-        console.log(`🪝 Webhook registered at ${config.path}`);
+        console.log(`🪝 ${this.config.name} webhook registered at ${config.path}${config.secret ? ' (with signature verification)' : ''}`);
     }
     addSocketIO(config = {}) {
         if (!this.server) {
-            throw new Error('Server must be started before adding Socket.IO');
+            throw new Error(`${this.config.name}: Server must be started before adding Socket.IO`);
         }
         try {
             // eslint-disable-next-line @typescript-eslint/no-var-requires
@@ -218,25 +218,25 @@ class ExpressServer {
             // Handle connections
             io.on('connection', (socket) => {
                 const typedSocket = socket;
-                console.log(`🔌 Socket connected: ${typedSocket.id}`);
+                console.log(`🔌 ${this.config.name}: Socket connected [${typedSocket.id}]`);
                 // Call user-defined connection handler
                 if (config.onConnection) {
                     config.onConnection(socket);
                 }
                 // Handle disconnection
                 typedSocket.on('disconnect', (reason) => {
-                    console.log(`🔌 Socket disconnected: ${typedSocket.id} - ${reason}`);
+                    console.log(`🔌 ${this.config.name}: Socket disconnected [${typedSocket.id}] - ${reason}`);
                     // Call user-defined disconnection handler
                     if (config.onDisconnection) {
                         config.onDisconnection(socket, reason);
                     }
                 });
             });
-            console.log(`🔌 Socket.IO server attached${config.path ? ` at ${config.path}` : ''}`);
+            console.log(`🔌 ${this.config.name} Socket.IO server attached${config.path ? ` at ${config.path}` : ''}${config.cors ? ' (CORS enabled)' : ''}`);
             return io;
         }
         catch (error) {
-            console.warn('Socket.IO not available. Install socket.io to use WebSocket features.');
+            console.warn(`${this.config.name}: Socket.IO not available. Install socket.io to use WebSocket features.`);
             return null;
         }
     }

package/dist/shutdown.d.ts

@@ -2,4 +2,4 @@ import { Server } from 'http';
 import { GracefulShutdownConfig, ServerPlugin } from './types';
 export declare function createGracefulShutdown(server: Server, config?: GracefulShutdownConfig): void;
 export declare function withGracefulShutdown(config?: GracefulShutdownConfig): ServerPlugin;
-export declare function startServerWithShutdown(app: any, port: number, shutdownConfig?: GracefulShutdownConfig): Server;
+export declare function startServerWithShutdown(app: any, port: number, shutdownConfig?: GracefulShutdownConfig, serverName?: string, serverVersion?: string): Server;

package/dist/shutdown.js

@@ -4,11 +4,12 @@ exports.createGracefulShutdown = createGracefulShutdown;
 exports.withGracefulShutdown = withGracefulShutdown;
 exports.startServerWithShutdown = startServerWithShutdown;
 function createGracefulShutdown(server, config = {}) {
-    const { timeout = 10000, onShutdown } = config;
+    const { timeout = 10000, onShutdown, serverName, serverVersion } = config;
+    const nameVersion = serverName && serverVersion ? `${serverName} v${serverVersion}` : 'Server';
     const shutdown = async (signal) => {
-        console.log(`🛑 Received ${signal}, shutting down gracefully...`);
+        console.log(`🛑 ${nameVersion} received ${signal}, shutting down gracefully...`);
         const shutdownTimer = setTimeout(() => {
-            console.log('⏰ Shutdown timeout reached, forcing exit');
+            console.log(`⏰ ${nameVersion} shutdown timeout reached, forcing exit`);
             process.exit(1);
         }, timeout);
         try {
@@ -19,13 +20,13 @@ function createGracefulShutdown(server, config = {}) {
             // Close server
             server.close(() => {
                 clearTimeout(shutdownTimer);
-                console.log('👋 Server closed. Exiting now.');
+                console.log(`👋 ${nameVersion} closed. Exiting now.`);
                 process.exit(0);
             });
         }
         catch (error) {
             clearTimeout(shutdownTimer);
-            console.error('❌ Error during shutdown:', error);
+            console.error(`❌ ${nameVersion} error during shutdown:`, error);
             process.exit(1);
         }
     };
@@ -39,12 +40,18 @@ function withGracefulShutdown(config = {}) {
         app.__gracefulShutdownConfig = config;
     };
 }
-function startServerWithShutdown(app, port, shutdownConfig = {}) {
+function startServerWithShutdown(app, port, shutdownConfig = {}, serverName, serverVersion) {
     const server = app.listen(port, () => {
-        console.log(`🚀 Server running on http://localhost:${port}`);
+        const nameVersion = serverName && serverVersion ? `${serverName} v${serverVersion}` : 'Server';
+        console.log(`🚀 ${nameVersion} running on http://localhost:${port}`);
     });
     // Apply graceful shutdown from stored config or provided config
     const config = app.__gracefulShutdownConfig || shutdownConfig;
-    createGracefulShutdown(server, config);
+    const enhancedConfig = {
+        ...config,
+        serverName,
+        serverVersion
+    };
+    createGracefulShutdown(server, enhancedConfig);
     return server;
 }

package/dist/types.d.ts

@@ -43,6 +43,8 @@ export interface HealthCheck {
 export interface GracefulShutdownConfig {
     timeout?: number;
     onShutdown?: () => Promise<void>;
+    serverName?: string;
+    serverVersion?: string;
 }
 export interface SocketInstance {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naman_deep_singh/server-utils",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Extensible server utilities for Express.js microservices with TypeScript",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,10 +18,10 @@
   "license": "ISC",
   "packageManager": "pnpm@10.20.0",
   "dependencies": {
-    "express": "^4.21.1"
+    "express": "^5.1.0"
   },
   "devDependencies": {
-    "@types/express": "^4.17.21",
+    "@types/express": "^5.0.5",
     "typescript": "^5.9.3"
   }
 }

package/src/server.ts

@@ -101,7 +101,7 @@ export class ExpressServer implements ServerInstance {
         const corsOptions = typeof this.config.cors === 'object' ? this.config.cors : undefined;
         this.app.use(cors(corsOptions));
       } catch (error) {
-        console.warn('CORS middleware not available. Install cors package.');
+        console.warn(`${this.config.name}: CORS middleware not available. Install cors package.`);
       }
     }
 
@@ -111,7 +111,7 @@ export class ExpressServer implements ServerInstance {
         const helmet = require('helmet');
         this.app.use(helmet());
       } catch (error) {
-        console.warn('Helmet middleware not available. Install helmet package.');
+        console.warn(`${this.config.name}: Helmet middleware not available. Install helmet package.`);
       }
     }
 
@@ -236,11 +236,11 @@ export class ExpressServer implements ServerInstance {
           grpc.ServerCredentials.createInsecure(),
           () => {
             this.grpcServer!.start();
-            console.log(`🔗 gRPC server running on port ${port}`);
+            console.log(`🔗 ${this.config.name} gRPC server running on port ${port}`);
           }
         );
       } catch (error: unknown) {
-        console.warn('gRPC not available. Install @grpc/grpc-js to use gRPC features.');
+        console.warn(`${this.config.name}: gRPC not available. Install @grpc/grpc-js to use gRPC features.`);
       }
     }
   }
@@ -257,9 +257,9 @@ export class ExpressServer implements ServerInstance {
       };
       const rpcServer = jayson.server(this.rpcMethods);
       this.app.use(path, rpcServer.middleware());
-      console.log(`📡 JSON-RPC server mounted on ${path}`);
+      console.log(`📡 ${this.config.name} JSON-RPC server mounted on ${path}`);
     } catch (error: unknown) {
-      console.warn('JSON-RPC not available. Install jayson to use RPC features.');
+      console.warn(`${this.config.name}: JSON-RPC not available. Install jayson to use RPC features.`);
     }
   }
 
@@ -295,12 +295,12 @@ export class ExpressServer implements ServerInstance {
       }
     });
 
-    console.log(`🪝 Webhook registered at ${config.path}`);
+    console.log(`🪝 ${this.config.name} webhook registered at ${config.path}${config.secret ? ' (with signature verification)' : ''}`);
   }
 
   addSocketIO(config: SocketIOConfig = {}): unknown {
     if (!this.server) {
-      throw new Error('Server must be started before adding Socket.IO');
+      throw new Error(`${this.config.name}: Server must be started before adding Socket.IO`);
     }
 
     try {
@@ -336,7 +336,7 @@ export class ExpressServer implements ServerInstance {
       // Handle connections
       io.on('connection', (socket: unknown) => {
         const typedSocket = socket as SocketInstance;
-        console.log(`🔌 Socket connected: ${typedSocket.id}`);
+        console.log(`🔌 ${this.config.name}: Socket connected [${typedSocket.id}]`);
 
         // Call user-defined connection handler
         if (config.onConnection) {
@@ -345,7 +345,7 @@ export class ExpressServer implements ServerInstance {
 
         // Handle disconnection
         typedSocket.on('disconnect', (reason) => {
-          console.log(`🔌 Socket disconnected: ${typedSocket.id} - ${reason}`);
+          console.log(`🔌 ${this.config.name}: Socket disconnected [${typedSocket.id}] - ${reason}`);
 
           // Call user-defined disconnection handler
           if (config.onDisconnection) {
@@ -354,10 +354,10 @@ export class ExpressServer implements ServerInstance {
         });
       });
 
-      console.log(`🔌 Socket.IO server attached${config.path ? ` at ${config.path}` : ''}`);
+      console.log(`🔌 ${this.config.name} Socket.IO server attached${config.path ? ` at ${config.path}` : ''}${config.cors ? ' (CORS enabled)' : ''}`);
       return io;
     } catch (error: unknown) {
-      console.warn('Socket.IO not available. Install socket.io to use WebSocket features.');
+      console.warn(`${this.config.name}: Socket.IO not available. Install socket.io to use WebSocket features.`);
       return null;
     }
   }

package/src/shutdown.ts

@@ -2,13 +2,14 @@ import { Server } from 'http';
 import { GracefulShutdownConfig, ServerPlugin } from './types';
 
 export function createGracefulShutdown(server: Server, config: GracefulShutdownConfig = {}): void {
-  const { timeout = 10000, onShutdown } = config;
+  const { timeout = 10000, onShutdown, serverName, serverVersion } = config;
+  const nameVersion = serverName && serverVersion ? `${serverName} v${serverVersion}` : 'Server';
 
   const shutdown = async (signal: string) => {
-    console.log(`🛑 Received ${signal}, shutting down gracefully...`);
+    console.log(`🛑 ${nameVersion} received ${signal}, shutting down gracefully...`);
     
     const shutdownTimer = setTimeout(() => {
-      console.log('⏰ Shutdown timeout reached, forcing exit');
+      console.log(`⏰ ${nameVersion} shutdown timeout reached, forcing exit`);
       process.exit(1);
     }, timeout);
 
@@ -21,12 +22,12 @@ export function createGracefulShutdown(server: Server, config: GracefulShutdownC
       // Close server
       server.close(() => {
         clearTimeout(shutdownTimer);
-        console.log('👋 Server closed. Exiting now.');
+        console.log(`👋 ${nameVersion} closed. Exiting now.`);
         process.exit(0);
       });
     } catch (error) {
       clearTimeout(shutdownTimer);
-      console.error('❌ Error during shutdown:', error);
+      console.error(`❌ ${nameVersion} error during shutdown:`, error);
       process.exit(1);
     }
   };
@@ -46,15 +47,23 @@ export function withGracefulShutdown(config: GracefulShutdownConfig = {}): Serve
 export function startServerWithShutdown(
   app: any, 
   port: number, 
-  shutdownConfig: GracefulShutdownConfig = {}
+  shutdownConfig: GracefulShutdownConfig = {},
+  serverName?: string,
+  serverVersion?: string
 ): Server {
   const server = app.listen(port, () => {
-    console.log(`🚀 Server running on http://localhost:${port}`);
+    const nameVersion = serverName && serverVersion ? `${serverName} v${serverVersion}` : 'Server';
+    console.log(`🚀 ${nameVersion} running on http://localhost:${port}`);
   });
 
   // Apply graceful shutdown from stored config or provided config
   const config = app.__gracefulShutdownConfig || shutdownConfig;
-  createGracefulShutdown(server, config);
+  const enhancedConfig = {
+    ...config,
+    serverName,
+    serverVersion
+  };
+  createGracefulShutdown(server, enhancedConfig);
 
   return server;
 }

package/src/types.ts

@@ -49,6 +49,8 @@ export interface HealthCheck {
 export interface GracefulShutdownConfig {
   timeout?: number;
   onShutdown?: () => Promise<void>;
+  serverName?: string;
+  serverVersion?: string;
 }
 
 export interface SocketInstance {