@naman_deep_singh/server-utils 1.3.0 → 1.4.1

package/dist/esm/{server.js → core/server.js}

@@ -1,8 +1,9 @@
-import express from 'express';
-import { createGracefulShutdown } from './shutdown';
-import { PeriodicHealthMonitor } from './periodic-health';
 import crypto from 'crypto';
 import { CacheFactory, SessionStore } from '@naman_deep_singh/cache';
+import express, { json, raw } from 'express';
+import { PeriodicHealthMonitor } from './periodic-health';
+import { createGracefulShutdown } from './shutdown';
+import { useSession } from '../middleware';
 export class ExpressServer {
     constructor(name = 'Express Server', version = '1.0.0', config = {}) {
         this.status = 'stopped';
@@ -24,7 +25,7 @@ export class ExpressServer {
             socketIO: config.socketIO,
             periodicHealthCheck: config.periodicHealthCheck || { enabled: false },
             cache: config.cache || { enabled: false },
-            session: config.session || { enabled: false }
+            session: config.session || { enabled: false },
         };
         // Initialize locals for cache/session
         this.app.locals.cache = undefined;
@@ -59,7 +60,7 @@ export class ExpressServer {
         }
         // Apply JSON parser if enabled
         if (this.config.json) {
-            this.app.use(express.json());
+            this.app.use(json());
         }
         // Apply cookie parser if enabled
         if (this.config.cookieParser) {
@@ -72,21 +73,24 @@ export class ExpressServer {
             }
         }
         // Apply custom middleware
-        if (this.config.customMiddleware && this.config.customMiddleware.length > 0) {
-            this.config.customMiddleware.forEach(middleware => {
+        if (this.config.customMiddleware &&
+            this.config.customMiddleware.length > 0) {
+            this.config.customMiddleware.forEach((middleware) => {
                 this.app.use(middleware);
             });
         }
         // Add health check if enabled
         if (this.config.healthCheck) {
-            const healthPath = typeof this.config.healthCheck === 'string' ? this.config.healthCheck : '/health';
+            const healthPath = typeof this.config.healthCheck === 'string'
+                ? this.config.healthCheck
+                : '/health';
             this.app.get(healthPath, async (req, res) => {
                 const base = {
                     status: 'healthy',
                     service: this.config.name,
                     version: this.config.version,
                     uptime: Date.now() - this.config.startTime.getTime(),
-                    timestamp: new Date().toISOString()
+                    timestamp: new Date().toISOString(),
                 };
                 // If cache is enabled, include its health
                 const cache = req.app.locals.cache;
@@ -95,7 +99,12 @@ export class ExpressServer {
                         base.cache = await cache.isAlive();
                     }
                     catch (e) {
-                        base.cache = { isAlive: false, adapter: 'unknown', timestamp: new Date(), error: e.message };
+                        base.cache = {
+                            isAlive: false,
+                            adapter: 'unknown',
+                            timestamp: new Date(),
+                            error: e.message,
+                        };
                     }
                 }
                 res.status(200).json(base);
@@ -114,7 +123,11 @@ export class ExpressServer {
                     }
                     console.log(`🔄 [${serverName}] Initializing cache adapter: ${config.cache.adapter || 'memory'}...`);
                     // Use createWithFallback to prefer primary and fall back to memory when configured
-                    const cfg = { ...(cacheConfig || {}), ttl: cacheConfig?.ttl ?? config.cache?.defaultTTL };
+                    const cfg = {
+                        ...(cacheConfig || {}),
+                        ttl: cacheConfig?.ttl ??
+                            config.cache?.defaultTTL,
+                    };
                     const cache = await CacheFactory.createWithFallback(cfg);
                     this.app.locals.cache = cache;
                     this.cache = cache;
@@ -124,7 +137,7 @@ export class ExpressServer {
                         req.cache = cache;
                         next();
                     });
-                    console.log(`✅ [${serverName}] Cache initialized successfully (adapter: ${(cacheConfig.adapter || 'memory')})`);
+                    console.log(`✅ [${serverName}] Cache initialized successfully (adapter: ${cacheConfig.adapter || 'memory'})`);
                 }
                 catch (err) {
                     console.error(`❌ [${serverName}] Failed to initialize cache (fallback to memory if enabled):`, err instanceof Error ? err.message : err);
@@ -133,7 +146,8 @@ export class ExpressServer {
             }
             // Initialize session if enabled
             if (config.session && config.session.enabled) {
-                const cookieName = config.session.cookieName || `${serverName.replace(/\s+/g, '_').toLowerCase()}.sid`;
+                const cookieName = config.session.cookieName ||
+                    `${serverName.replace(/\s+/g, '_').toLowerCase()}.sid`;
                 const ttl = config.session.ttl ?? 3600;
                 let cache = this.app.locals.cache;
                 if (!cache) {
@@ -161,8 +175,6 @@ export class ExpressServer {
                     this.sessionStore = store;
                     // attach session middleware globally so req.sessionStore is available
                     try {
-                        // eslint-disable-next-line @typescript-eslint/no-var-requires
-                        const { useSession } = require('./middleware');
                         this.app.use(useSession(cookieName));
                         console.log(`✅ [${serverName}] Session middleware enabled (cookie: ${cookieName}, TTL: ${ttl}s)`);
                     }
@@ -217,7 +229,7 @@ export class ExpressServer {
                                 catch (e) {
                                     // SessionStore may not have close; ignore
                                 }
-                            }
+                            },
                         });
                     }
                     // Start periodic health monitoring after server is running
@@ -267,7 +279,7 @@ export class ExpressServer {
             port: this.config.port,
             uptime: Date.now() - this.config.startTime.getTime(),
             status: this.status,
-            startTime: this.config.startTime
+            startTime: this.config.startTime,
         };
     }
     addGrpcService(service, implementation, port = 50051) {
@@ -275,7 +287,6 @@ export class ExpressServer {
         // Lazy load gRPC to avoid dependency issues
         if (!this.grpcServer) {
             try {
-                // eslint-disable-next-line @typescript-eslint/no-var-requires
                 const grpc = require('@grpc/grpc-js');
                 this.grpcServer = new grpc.Server();
                 // Add all services
@@ -295,7 +306,6 @@ export class ExpressServer {
     addRpcMethods(methods, path = '/rpc') {
         Object.assign(this.rpcMethods, methods);
         try {
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
             const jayson = require('jayson');
             const rpcServer = jayson.server(this.rpcMethods);
             this.app.use(path, rpcServer.middleware());
@@ -306,17 +316,20 @@ export class ExpressServer {
         }
     }
     addWebhook(config) {
-        this.app.post(config.path, express.raw({ type: 'application/json' }), async (req, res) => {
+        this.app.post(config.path, raw({ type: 'application/json' }), async (req, res) => {
             try {
                 // Verify signature if secret provided
                 if (config.secret) {
-                    const signature = req.headers['x-hub-signature-256'] || req.headers['x-signature-256'];
+                    const signature = req.headers['x-hub-signature-256'] ||
+                        req.headers['x-signature-256'];
                     if (signature) {
                         const expectedSignature = crypto
                             .createHmac('sha256', config.secret)
                             .update(req.body)
                             .digest('hex');
-                        const providedSignature = Array.isArray(signature) ? signature[0] : signature;
+                        const providedSignature = Array.isArray(signature)
+                            ? signature[0]
+                            : signature;
                         if (!providedSignature.includes(expectedSignature)) {
                             return res.status(401).json({ error: 'Invalid signature' });
                         }
@@ -340,7 +353,6 @@ export class ExpressServer {
             throw new Error(`${this.config.name}: Server must be started before adding Socket.IO`);
         }
         try {
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
             const { Server } = require('socket.io');
             // Configure CORS
             const corsConfig = config.cors === true
@@ -349,7 +361,7 @@ export class ExpressServer {
             // Create Socket.IO server
             const io = new Server(this.server, {
                 cors: config.cors ? corsConfig : undefined,
-                path: config.path || '/socket.io'
+                path: config.path || '/socket.io',
             });
             // Store reference for cleanup
             this.socketIO = io;

package/dist/esm/{shutdown.d.ts → core/shutdown.d.ts}

@@ -1,5 +1,5 @@
-import { Server } from 'http';
-import { GracefulShutdownConfig, ServerPlugin } from './types';
+import type { Server } from 'http';
+import type { 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: import('express').Application, port: number, shutdownConfig?: GracefulShutdownConfig, serverName?: string, serverVersion?: string): Server;

package/dist/esm/{shutdown.js → core/shutdown.js}

@@ -32,6 +32,7 @@ export function withGracefulShutdown(config = {}) {
     return (app, serverConfig) => {
         // This plugin needs to be applied after server.listen()
         // Store config for later use
+        ;
         app.__gracefulShutdownConfig = config;
     };
 }
@@ -45,7 +46,7 @@ export function startServerWithShutdown(app, port, shutdownConfig = {}, serverNa
     const enhancedConfig = {
         ...config,
         serverName,
-        serverVersion
+        serverVersion,
     };
     createGracefulShutdown(server, enhancedConfig);
     return server;

package/dist/esm/index.d.ts

@@ -1,19 +1,19 @@
-export { ExpressServer, createServer } from './server';
-export type { ServerInstance, ServerInfo, GrpcService, RpcMethod, WebhookConfig } from './server';
+export { ExpressServer, createServer } from './core/server';
+export type { ServerInstance, ServerInfo, GrpcService, RpcMethod, WebhookConfig, } from './core/server';
 export { Request, Response, NextFunction, Router, Application } from 'express';
 export type { RequestHandler, ErrorRequestHandler } from 'express';
-export { createHealthCheck, withHealthCheck, addHealthCheck } from './health';
-export { createGracefulShutdown, withGracefulShutdown, startServerWithShutdown } from './shutdown';
-export { createLoggingMiddleware, createErrorHandler, createRequestIdMiddleware, createValidationMiddleware, createRateLimitMiddleware, createAuthMiddleware, withLogging, withErrorHandler, withRequestId, withValidation, withRateLimit, withAuth, validateFields, rateLimit, requireAuth, cacheResponse, useSession, type ValidationRule, type RateLimitConfig, type AuthConfig } from './middleware';
-export { getEnv, getEnvNumber, getEnvBoolean } from './utils';
-export { PeriodicHealthMonitor } from './periodic-health';
-export type { ServerConfig, HealthCheckConfig, HealthCheck, GracefulShutdownConfig, ServerPlugin, SocketIOConfig, SocketInstance, PeriodicHealthCheckConfig, HealthCheckService } from './types';
-import { ExpressServer, createServer } from './server';
-import { createHealthCheck, withHealthCheck, addHealthCheck } from './health';
-import { createGracefulShutdown, withGracefulShutdown, startServerWithShutdown } from './shutdown';
-import { createLoggingMiddleware, createErrorHandler, createRequestIdMiddleware, createValidationMiddleware, createRateLimitMiddleware, createAuthMiddleware, withLogging, withErrorHandler, withRequestId, withValidation, withRateLimit, withAuth, validateFields, rateLimit, requireAuth } from './middleware';
-import { getEnv, getEnvNumber, getEnvBoolean } from './utils';
-import { PeriodicHealthMonitor } from './periodic-health';
+export { createHealthCheck, withHealthCheck, addHealthCheck, } from './core/health';
+export { createGracefulShutdown, withGracefulShutdown, startServerWithShutdown, } from './core/shutdown';
+export { createLoggingMiddleware, createErrorHandler, createRequestIdMiddleware, createValidationMiddleware, createRateLimitMiddleware, createAuthMiddleware, withLogging, withErrorHandler, withRequestId, withValidation, withRateLimit, withAuth, validateFields, rateLimit, requireAuth, cacheResponse, useSession, type ValidationRule, type RateLimitConfig, type AuthConfig, } from './middleware';
+export { getEnv, getEnvNumber, getEnvBoolean, } from './utils/utils';
+export { PeriodicHealthMonitor } from './core/periodic-health';
+export type { ServerConfig, HealthCheckConfig, HealthCheck, GracefulShutdownConfig, ServerPlugin, SocketIOConfig, SocketInstance, PeriodicHealthCheckConfig, HealthCheckService, } from './types';
+import { addHealthCheck, createHealthCheck, withHealthCheck } from './core/health';
+import { PeriodicHealthMonitor } from './core/periodic-health';
+import { ExpressServer, createServer } from './core/server';
+import { createGracefulShutdown, startServerWithShutdown, withGracefulShutdown } from './core/shutdown';
+import { createAuthMiddleware, createErrorHandler, createLoggingMiddleware, createRateLimitMiddleware, createRequestIdMiddleware, createValidationMiddleware, rateLimit, requireAuth, validateFields, withAuth, withErrorHandler, withLogging, withRateLimit, withRequestId, withValidation } from './middleware';
+import { getEnv, getEnvBoolean, getEnvNumber } from './utils/utils';
 declare const ServerUtils: {
     createServer: typeof createServer;
     ExpressServer: typeof ExpressServer;

package/dist/esm/index.js

@@ -1,24 +1,24 @@
 // Core server utilities
-export { ExpressServer, createServer } from './server';
+export { ExpressServer, createServer } from './core/server';
 // Express re-exports (to avoid direct Express dependency in services)
 export { Router } from 'express';
 // Health check utilities
-export { createHealthCheck, withHealthCheck, addHealthCheck } from './health';
+export { createHealthCheck, withHealthCheck, addHealthCheck, } from './core/health';
 // Graceful shutdown utilities
-export { createGracefulShutdown, withGracefulShutdown, startServerWithShutdown } from './shutdown';
+export { createGracefulShutdown, withGracefulShutdown, startServerWithShutdown, } from './core/shutdown';
 // Middleware utilities
-export { createLoggingMiddleware, createErrorHandler, createRequestIdMiddleware, createValidationMiddleware, createRateLimitMiddleware, createAuthMiddleware, withLogging, withErrorHandler, withRequestId, withValidation, withRateLimit, withAuth, validateFields, rateLimit, requireAuth, cacheResponse, useSession } from './middleware';
+export { createLoggingMiddleware, createErrorHandler, createRequestIdMiddleware, createValidationMiddleware, createRateLimitMiddleware, createAuthMiddleware, withLogging, withErrorHandler, withRequestId, withValidation, withRateLimit, withAuth, validateFields, rateLimit, requireAuth, cacheResponse, useSession, } from './middleware';
 // Utility functions
-export { getEnv, getEnvNumber, getEnvBoolean } from './utils';
+export { getEnv, getEnvNumber, getEnvBoolean, } from './utils/utils';
 // Periodic health monitoring
-export { PeriodicHealthMonitor } from './periodic-health';
+export { PeriodicHealthMonitor } from './core/periodic-health';
+import { addHealthCheck, createHealthCheck, withHealthCheck, } from './core/health';
+import { PeriodicHealthMonitor } from './core/periodic-health';
 // Import all exports for default export
-import { ExpressServer, createServer } from './server';
-import { createHealthCheck, withHealthCheck, addHealthCheck } from './health';
-import { createGracefulShutdown, withGracefulShutdown, startServerWithShutdown } from './shutdown';
-import { createLoggingMiddleware, createErrorHandler, createRequestIdMiddleware, createValidationMiddleware, createRateLimitMiddleware, createAuthMiddleware, withLogging, withErrorHandler, withRequestId, withValidation, withRateLimit, withAuth, validateFields, rateLimit, requireAuth } from './middleware';
-import { getEnv, getEnvNumber, getEnvBoolean } from './utils';
-import { PeriodicHealthMonitor } from './periodic-health';
+import { ExpressServer, createServer } from './core/server';
+import { createGracefulShutdown, startServerWithShutdown, withGracefulShutdown, } from './core/shutdown';
+import { createAuthMiddleware, createErrorHandler, createLoggingMiddleware, createRateLimitMiddleware, createRequestIdMiddleware, createValidationMiddleware, rateLimit, requireAuth, validateFields, withAuth, withErrorHandler, withLogging, withRateLimit, withRequestId, withValidation, } from './middleware';
+import { getEnv, getEnvBoolean, getEnvNumber } from './utils/utils';
 // Default export for namespace usage
 const ServerUtils = {
     // Server creation

package/dist/esm/middleware/auth.middleware.d.ts

@@ -0,0 +1,7 @@
+import type { Request, RequestHandler } from 'node_modules/@types/express';
+export interface AuthConfig {
+    secret: string;
+    unauthorizedMessage?: string;
+    tokenExtractor?: (req: Request) => string | null;
+}
+export declare function createAuthMiddleware(config: AuthConfig): RequestHandler;

package/dist/esm/middleware/auth.middleware.js

@@ -0,0 +1,38 @@
+import { UnauthorizedError } from '@naman_deep_singh/errors-utils';
+import { extractToken, safeVerifyToken } from '@naman_deep_singh/security';
+export function createAuthMiddleware(config) {
+    const { secret, unauthorizedMessage = 'Unauthorized access', tokenExtractor = (req) => extractToken({
+        header: req.headers.authorization || undefined,
+        cookies: req.cookies,
+        query: req.query,
+        body: req.body,
+    }), } = config;
+    return async (req, res, next) => {
+        try {
+            // Extract token from request
+            const token = tokenExtractor(req);
+            if (!token) {
+                const error = new UnauthorizedError(unauthorizedMessage, {
+                    reason: 'No token provided',
+                });
+                return next(error);
+            }
+            // Use safe verify token from security package
+            const result = safeVerifyToken(token, secret);
+            if (!result.valid) {
+                const error = new UnauthorizedError(unauthorizedMessage, {
+                    reason: 'Invalid or expired token',
+                    originalError: result.error?.message,
+                });
+                return next(error);
+            }
+            // Attach the verified payload as user
+            req.user = result.payload;
+            next();
+        }
+        catch (error) {
+            const unauthorizedError = new UnauthorizedError(unauthorizedMessage, error instanceof Error ? { originalError: error.message } : error);
+            return next(unauthorizedError);
+        }
+    };
+}

package/dist/esm/middleware/cache.middleware.d.ts

@@ -0,0 +1,2 @@
+import type { RequestHandler } from 'node_modules/@types/express';
+export declare function cacheResponse(ttl?: number): RequestHandler;

package/dist/esm/middleware/cache.middleware.js

@@ -0,0 +1,55 @@
+// Cache response middleware (per-route opt-in)
+export function cacheResponse(ttl) {
+    return async (req, res, next) => {
+        try {
+            if (req.method !== 'GET')
+                return next();
+            const cache = (req.cache ?? req.app.locals.cache);
+            const defaultTTL = req.app.locals.cacheDefaultTTL;
+            if (!cache || typeof cache.get !== 'function')
+                return next();
+            const key = `${req.originalUrl}`;
+            try {
+                const cached = await cache.get(key);
+                if (cached !== null && cached !== undefined) {
+                    res.setHeader('X-Cache', 'HIT');
+                    return res.json(cached);
+                }
+            }
+            catch (cacheErr) {
+                console.error(`[Cache] Failed to retrieve key "${key}":`, cacheErr);
+                // Continue without cache hit
+            }
+            const originalJson = res.json.bind(res);
+            res.json = (body) => {
+                try {
+                    const expiry = ttl ?? defaultTTL;
+                    if (expiry && cache && typeof cache.set === 'function') {
+                        ;
+                        cache.set(key, body, expiry).catch((err) => {
+                            console.error(`[Cache] Failed to set key "${key}" with TTL ${expiry}:`, err);
+                        });
+                    }
+                    else if (cache) {
+                        if (typeof cache.set === 'function') {
+                            ;
+                            cache.set(key, body).catch((err) => {
+                                console.error(`[Cache] Failed to set key "${key}":`, err);
+                            });
+                        }
+                    }
+                }
+                catch (e) {
+                    console.error(`[Cache] Error during cache.set operation:`, e);
+                }
+                res.setHeader('X-Cache', 'MISS');
+                return originalJson(body);
+            };
+            next();
+        }
+        catch (err) {
+            console.error('[Cache] Unexpected error in cacheResponse middleware:', err);
+            next();
+        }
+    };
+}

package/dist/esm/middleware/errorHandler.middleware.d.ts

@@ -0,0 +1,2 @@
+import type { ErrorRequestHandler } from 'node_modules/@types/express';
+export declare function createErrorHandler(): ErrorRequestHandler;

package/dist/esm/middleware/errorHandler.middleware.js

@@ -0,0 +1,27 @@
+// Error handling middleware
+export function createErrorHandler() {
+    return (err, req, res, next) => {
+        console.error('Error:', err);
+        if (res.headersSent) {
+            return next(err);
+        }
+        // Type guard for error objects
+        const errorObj = err;
+        const status = errorObj.status || errorObj.statusCode || 500;
+        const message = process.env.NODE_ENV === 'production'
+            ? 'Internal Server Error'
+            : errorObj.message || 'Unknown error';
+        res.status(status).json({
+            success: false,
+            message,
+            data: undefined,
+            error: {
+                message,
+                ...(process.env.NODE_ENV !== 'production' && {
+                    details: { stack: errorObj.stack },
+                }),
+            },
+            meta: null,
+        });
+    };
+}

package/dist/esm/middleware/index.d.ts

@@ -0,0 +1,10 @@
+export { AuthConfig, createAuthMiddleware } from './auth.middleware';
+export { cacheResponse } from './cache.middleware';
+export { createErrorHandler } from './errorHandler.middleware';
+export { createLoggingMiddleware } from './logging.middleware';
+export { RateLimitConfig, createRateLimitMiddleware, } from './rateLimiter.middleware';
+export { createRequestIdMiddleware } from './requestId.middleware';
+export { useSession } from './session.middleware';
+export { ValidationRule, createValidationMiddleware, } from './validation.middleware';
+export { withLogging, withErrorHandler, withRequestId, withValidation, withRateLimit, withAuth, } from './plugins.middleware';
+export { validateFields, rateLimit, requireAuth, } from './plugins.middleware';

package/dist/esm/middleware/index.js

@@ -0,0 +1,20 @@
+// Authentication Middleware
+export { createAuthMiddleware } from './auth.middleware';
+// Cache Middleware
+export { cacheResponse } from './cache.middleware';
+// Error Handler Middleware
+export { createErrorHandler } from './errorHandler.middleware';
+// Logging Middleware
+export { createLoggingMiddleware } from './logging.middleware';
+// Rate Limiter Middleware
+export { createRateLimitMiddleware, } from './rateLimiter.middleware';
+// Request ID Middleware
+export { createRequestIdMiddleware } from './requestId.middleware';
+// Session Middleware
+export { useSession } from './session.middleware';
+// Validation Middleware
+export { createValidationMiddleware, } from './validation.middleware';
+// Plugin middleware functions (for application-level middleware)
+export { withLogging, withErrorHandler, withRequestId, withValidation, withRateLimit, withAuth, } from './plugins.middleware';
+// Convenience middleware functions (for route-level middleware)
+export { validateFields, rateLimit, requireAuth, } from './plugins.middleware';

package/dist/esm/middleware/logging.middleware.d.ts

@@ -0,0 +1,2 @@
+import type { RequestHandler } from 'node_modules/@types/express';
+export declare function createLoggingMiddleware(format?: 'simple' | 'detailed'): RequestHandler;

package/dist/esm/middleware/logging.middleware.js

@@ -0,0 +1,16 @@
+// Logging middleware
+export function createLoggingMiddleware(format = 'simple') {
+    return (req, res, next) => {
+        const start = Date.now();
+        res.on('finish', () => {
+            const duration = Date.now() - start;
+            if (format === 'detailed') {
+                console.log(`${req.method} ${req.url} - ${res.statusCode} - ${duration}ms - ${req.ip}`);
+            }
+            else {
+                console.log(`${req.method} ${req.url} - ${res.statusCode}`);
+            }
+        });
+        next();
+    };
+}

package/dist/esm/middleware/plugins.middleware.d.ts

@@ -0,0 +1,14 @@
+import type { RequestHandler } from 'express';
+import type { ServerPlugin } from '../types';
+import type { AuthConfig } from './auth.middleware';
+import type { RateLimitConfig } from './rateLimiter.middleware';
+import type { ValidationRule } from './validation.middleware';
+export declare function withLogging(format?: 'simple' | 'detailed'): ServerPlugin;
+export declare function withErrorHandler(): ServerPlugin;
+export declare function withRequestId(): ServerPlugin;
+export declare function withValidation(rules: ValidationRule[]): ServerPlugin;
+export declare function withRateLimit(config?: RateLimitConfig): ServerPlugin;
+export declare function withAuth(config: AuthConfig): ServerPlugin;
+export declare function validateFields(rules: ValidationRule[]): RequestHandler;
+export declare function rateLimit(config?: RateLimitConfig): RequestHandler;
+export declare function requireAuth(config: AuthConfig): RequestHandler;

package/dist/esm/middleware/plugins.middleware.js

@@ -0,0 +1,47 @@
+import { createAuthMiddleware } from './auth.middleware';
+import { createErrorHandler } from './errorHandler.middleware';
+import { createLoggingMiddleware } from './logging.middleware';
+import { createRateLimitMiddleware } from './rateLimiter.middleware';
+import { createRequestIdMiddleware } from './requestId.middleware';
+import { createValidationMiddleware } from './validation.middleware';
+// Plugin versions
+export function withLogging(format = 'simple') {
+    return (app) => {
+        app.use(createLoggingMiddleware(format));
+    };
+}
+export function withErrorHandler() {
+    return (app) => {
+        app.use(createErrorHandler());
+    };
+}
+export function withRequestId() {
+    return (app) => {
+        app.use(createRequestIdMiddleware());
+    };
+}
+export function withValidation(rules) {
+    return (app) => {
+        app.use(createValidationMiddleware(rules));
+    };
+}
+export function withRateLimit(config = {}) {
+    return (app) => {
+        app.use(createRateLimitMiddleware(config));
+    };
+}
+export function withAuth(config) {
+    return (app) => {
+        app.use(createAuthMiddleware(config));
+    };
+}
+// Convenience functions for route-specific middleware
+export function validateFields(rules) {
+    return createValidationMiddleware(rules);
+}
+export function rateLimit(config = {}) {
+    return createRateLimitMiddleware(config);
+}
+export function requireAuth(config) {
+    return createAuthMiddleware(config);
+}

package/dist/esm/middleware/rateLimiter.middleware.d.ts

@@ -0,0 +1,8 @@
+import type { Request, RequestHandler } from 'node_modules/@types/express';
+export interface RateLimitConfig {
+    windowMs?: number;
+    maxRequests?: number;
+    message?: string;
+    keyGenerator?: (req: Request) => string;
+}
+export declare function createRateLimitMiddleware(config?: RateLimitConfig): RequestHandler;

package/dist/esm/middleware/rateLimiter.middleware.js

@@ -0,0 +1,32 @@
+const rateLimitStore = new Map();
+export function createRateLimitMiddleware(config = {}) {
+    const { windowMs = 15 * 60 * 1000, maxRequests = 100, message = 'Too many requests, please try again later', keyGenerator = (req) => req.ip || 'unknown', } = config;
+    return (req, res, next) => {
+        const key = keyGenerator(req);
+        const now = Date.now();
+        const record = rateLimitStore.get(key);
+        if (!record || now > record.resetTime) {
+            rateLimitStore.set(key, {
+                count: 1,
+                resetTime: now + windowMs,
+            });
+            return next();
+        }
+        if (record.count >= maxRequests) {
+            return res.status(429).json({
+                success: false,
+                message,
+                data: undefined,
+                error: {
+                    message,
+                    details: {
+                        retryAfter: Math.ceil((record.resetTime - now) / 1000),
+                    },
+                },
+                meta: null,
+            });
+        }
+        record.count++;
+        next();
+    };
+}

package/dist/esm/middleware/requestId.middleware.d.ts

@@ -0,0 +1,2 @@
+import type { RequestHandler } from 'node_modules/@types/express';
+export declare function createRequestIdMiddleware(): RequestHandler;

package/dist/esm/middleware/requestId.middleware.js

@@ -0,0 +1,9 @@
+// Request ID middleware
+export function createRequestIdMiddleware() {
+    return (req, res, next) => {
+        const requestId = Math.random().toString(36).substring(2, 15);
+        req.requestId = requestId;
+        res.setHeader('X-Request-ID', requestId);
+        next();
+    };
+}

package/dist/esm/middleware/session.middleware.d.ts

@@ -0,0 +1,2 @@
+import type { RequestHandler } from 'node_modules/@types/express';
+export declare function useSession(cookieName?: string): RequestHandler;