@naman_deep_singh/server-utils 1.2.0 → 1.4.0

package/README.md

@@ -1,6 +1,6 @@
 # @naman_deep_singh/server-utils
 
-**Version:** 1.2.0 (with integrated cache & session support)
+**Version:** 1.4.0 (with integrated cache & session support)
 
 Extensible server utilities for Express.js microservices with multi-protocol support, integrated caching, session management, and TypeScript.
 
@@ -19,13 +19,13 @@ npm install @naman_deep_singh/server-utils
 - ✅ **Graceful shutdown** handling with cache/session cleanup
 - ✅ **Health checks** with custom checks and cache health integration
 - ✅ **TypeScript support** with full type safety
-- ✅ **Hybrid exports** - use named imports or namespace imports
-- ✅ **Plugin architecture** for extensibility
+
 - ✅ **Built-in middleware** - logging, validation, rate limiting, auth, caching, sessions
 
+
 ## Quick Start
 
-### Named Imports
+### Basic Usage
 ```typescript
 import { createServer } from '@naman_deep_singh/server-utils';
 
@@ -44,13 +44,6 @@ server.app.get('/users', (req, res) => {
 await server.start();
 ```
 
-### Namespace Import
-```typescript
-import ServerUtils from '@naman_deep_singh/server-utils';
-
-const server = ServerUtils.createServer('My API', '1.0.0');
-```
-
 ## Multi-Protocol Support
 
 ### HTTP + Express Routes
@@ -131,17 +124,13 @@ server.addWebhook({
 
 ## Built-in Middleware
 
+
 ### Logging Middleware
 ```typescript
-import { createLoggingMiddleware, withLogging } from '@naman_deep_singh/server-utils';
+import { createLoggingMiddleware } from '@naman_deep_singh/server-utils';
 
 // Direct usage
 server.app.use(createLoggingMiddleware('detailed'));
-
-// Plugin usage
-const server = createServerWithPlugins('My API', '1.0.0', [
-  withLogging('detailed')
-]);
 ```
 
 ### Validation Middleware
@@ -169,67 +158,45 @@ server.app.use('/api', rateLimit({
 }));
 ```
 
+
 ### Authentication Middleware
 ```typescript
 import { requireAuth } from '@naman_deep_singh/server-utils';
 
 server.app.use('/protected', requireAuth({
-  tokenExtractor: (req) => req.headers.authorization?.substring(7),
-  tokenValidator: async (token) => {
-    // Verify JWT token
-    return jwt.verify(token, process.env.JWT_SECRET);
+  secret: process.env.JWT_SECRET!,
+  unauthorizedMessage: 'Invalid or expired token'
+}));
+```
+
+**Advanced Configuration:**
+```typescript
+import { createAuthMiddleware } from '@naman_deep_singh/server-utils';
+
+server.app.use('/api', createAuthMiddleware({
+  secret: process.env.JWT_SECRET!,
+  unauthorizedMessage: 'Access denied',
+  tokenExtractor: (req) => {
+    // Custom token extraction logic
+    // By default, uses sophisticated extractToken from @naman_deep_singh/security
+    // that checks Authorization headers, cookies, query params, and body
+    return req.headers.authorization?.substring(7);
   }
 }));
 ```
 
 ## Health Checks
 
+
 ### Basic Health Check
 ```typescript
-import { addHealthCheck, createHealthCheck, withHealthCheck } from '@naman_deep_singh/server-utils';
+import { createHealthCheck } from '@naman_deep_singh/server-utils';
 
-// Method 1: Direct addition
-addHealthCheck(server.app, '/health');
+// The health check is automatically enabled when healthCheck is not false
+// Health endpoint is available at /health by default
 
-// Method 2: As middleware
+// If you need to customize or disable it:
 server.app.get('/health', createHealthCheck());
-
-// Method 3: As plugin
-const server = createServerWithPlugins('My API', '1.0.0', [
-  withHealthCheck('/health')
-]);
-```
-
-### Advanced Health Checks
-```typescript
-addHealthCheck(server.app, '/health', {
-  customChecks: [
-    {
-      name: 'database',
-      check: async () => {
-        // Check database connection
-        return await db.ping();
-      }
-    },
-    {
-      name: 'redis',
-      check: async () => {
-        return await redis.ping() === 'PONG';
-      }
-    }
-  ]
-});
-
-// Response format:
-// {
-//   "status": "healthy",
-//   "checks": {
-//     "server": true,
-//     "timestamp": 1640995200000,
-//     "database": true,
-//     "redis": false
-//   }
-// }
 ```
 
 ## Server Management
@@ -332,6 +299,12 @@ import { Request, Response, NextFunction, Router, Application } from '@naman_dee
 import type { RequestHandler, ErrorRequestHandler } from '@naman_deep_singh/server-utils';
 
 // No need to install Express separately in your services
+
+## TypeScript Notes
+
+- This package includes TypeScript augmentations for Express `Request` and `Application` that expose runtime helpers used by the middleware (for example `req.cache`, `req.sessionStore`, `req.getSession`, and `req.createSession`). Installing and importing `@naman_deep_singh/server-utils` in your project will surface these types automatically.
+- Middleware that attaches runtime props uses `unknown` internally and runtime guards — prefer the provided helpers rather than casting `req` to `any`.
+
 ```
 
 ## API Reference

package/dist/cjs/core/health.d.ts

@@ -0,0 +1,5 @@
+import { Application, RequestHandler } from 'express';
+import { HealthCheckConfig, ServerPlugin } from '../types';
+export declare function createHealthCheck(config?: HealthCheckConfig): RequestHandler;
+export declare function withHealthCheck(path?: string, config?: HealthCheckConfig): ServerPlugin;
+export declare function addHealthCheck(app: Application, path?: string, config?: HealthCheckConfig): void;

package/dist/cjs/{periodic-health.d.ts → core/periodic-health.d.ts}

@@ -1,4 +1,4 @@
-import { PeriodicHealthCheckConfig } from './types';
+import { PeriodicHealthCheckConfig } from '../types';
 export declare class PeriodicHealthMonitor {
     private intervals;
     private config;

package/dist/{types → cjs/core}/server.d.ts

@@ -1,6 +1,6 @@
-import express from 'express';
 import { Server } from 'http';
-import { ServerConfig, SocketIOConfig } from './types';
+import { Application } from 'express';
+import { ServerConfig, SocketIOConfig } from '../types';
 export interface GrpcService {
     service: Record<string, unknown>;
     implementation: Record<string, (...args: unknown[]) => unknown>;
@@ -26,7 +26,7 @@ export interface ServerInstanceConfig extends Required<Omit<ServerConfig, 'socke
     socketIO?: SocketIOConfig;
 }
 export interface ServerInstance {
-    app: express.Application;
+    app: Application;
     server?: Server;
     config: ServerInstanceConfig;
     start(): Promise<ServerInstance>;
@@ -46,9 +46,11 @@ export interface ServerInfo {
     startTime: Date;
 }
 export declare class ExpressServer implements ServerInstance {
-    app: express.Application;
+    app: Application;
     server?: Server;
     config: ServerInstanceConfig;
+    cache?: import('@naman_deep_singh/cache').ICache<unknown>;
+    sessionStore?: import('@naman_deep_singh/cache').SessionStore | undefined;
     private status;
     private grpcServices;
     private grpcServer?;

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

@@ -1,15 +1,48 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExpressServer = void 0;
 exports.createServer = createServer;
-const express_1 = __importDefault(require("express"));
-const shutdown_1 = require("./shutdown");
-const periodic_health_1 = require("./periodic-health");
-const crypto_1 = __importDefault(require("crypto"));
+const express_1 = __importStar(require("express"));
 const cache_1 = require("@naman_deep_singh/cache");
+const crypto_1 = __importDefault(require("crypto"));
+const periodic_health_1 = require("./periodic-health");
+const shutdown_1 = require("./shutdown");
 class ExpressServer {
     constructor(name = 'Express Server', version = '1.0.0', config = {}) {
         this.status = 'stopped';
@@ -66,7 +99,7 @@ class ExpressServer {
         }
         // Apply JSON parser if enabled
         if (this.config.json) {
-            this.app.use(express_1.default.json());
+            this.app.use((0, express_1.json)());
         }
         // Apply cookie parser if enabled
         if (this.config.cookieParser) {
@@ -114,17 +147,15 @@ class ExpressServer {
             // Initialize cache if enabled
             if (config.cache && config.cache.enabled) {
                 try {
-                    const provided = config.cache.options;
+                    const provided = config.cache?.options;
                     let cacheConfig = provided && typeof provided === 'object' ? provided : undefined;
                     if (!cacheConfig) {
                         cacheConfig = { adapter: config.cache.adapter || 'memory' };
                     }
                     console.log(`🔄 [${serverName}] Initializing cache adapter: ${config.cache.adapter || 'memory'}...`);
                     // Use createWithFallback to prefer primary and fall back to memory when configured
-                    const cache = await cache_1.CacheFactory.createWithFallback({
-                        ...(cacheConfig || {}),
-                        ttl: cacheConfig?.ttl ?? config.cache?.defaultTTL
-                    });
+                    const cfg = { ...(cacheConfig || {}), ttl: cacheConfig?.ttl ?? config.cache?.defaultTTL };
+                    const cache = await cache_1.CacheFactory.createWithFallback(cfg);
                     this.app.locals.cache = cache;
                     this.cache = cache;
                     this.app.locals.cacheDefaultTTL = config.cache?.defaultTTL;
@@ -171,7 +202,7 @@ class ExpressServer {
                     // attach session middleware globally so req.sessionStore is available
                     try {
                         // eslint-disable-next-line @typescript-eslint/no-var-requires
-                        const { useSession } = require('./middleware');
+                        const { useSession } = require('../middleware/middleware');
                         this.app.use(useSession(cookieName));
                         console.log(`✅ [${serverName}] Session middleware enabled (cookie: ${cookieName}, TTL: ${ttl}s)`);
                     }
@@ -315,7 +346,7 @@ class ExpressServer {
         }
     }
     addWebhook(config) {
-        this.app.post(config.path, express_1.default.raw({ type: 'application/json' }), async (req, res) => {
+        this.app.post(config.path, (0, express_1.raw)({ type: 'application/json' }), async (req, res) => {
             try {
                 // Verify signature if secret provided
                 if (config.secret) {

package/dist/cjs/core/shutdown.d.ts

@@ -0,0 +1,5 @@
+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: import('express').Application, port: number, shutdownConfig?: GracefulShutdownConfig, serverName?: string, serverVersion?: string): Server;

package/dist/cjs/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 { 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';
-export { PeriodicHealthMonitor } from './periodic-health';
+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 { ExpressServer, createServer } from './server';
-import { createHealthCheck, withHealthCheck, addHealthCheck } from './health';
-import { createGracefulShutdown, withGracefulShutdown, startServerWithShutdown } from './shutdown';
+import { ExpressServer, createServer } from './core/server';
+import { createHealthCheck, withHealthCheck, addHealthCheck } from './core/health';
+import { createGracefulShutdown, withGracefulShutdown, startServerWithShutdown } from './core/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 { getEnv, getEnvNumber, getEnvBoolean } from './utils/utils';
+import { PeriodicHealthMonitor } from './core/periodic-health';
 declare const ServerUtils: {
     createServer: typeof createServer;
     ExpressServer: typeof ExpressServer;

package/dist/cjs/index.js

@@ -2,19 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PeriodicHealthMonitor = exports.getEnvBoolean = exports.getEnvNumber = exports.getEnv = exports.useSession = exports.cacheResponse = exports.requireAuth = exports.rateLimit = exports.validateFields = exports.withAuth = exports.withRateLimit = exports.withValidation = exports.withRequestId = exports.withErrorHandler = exports.withLogging = exports.createAuthMiddleware = exports.createRateLimitMiddleware = exports.createValidationMiddleware = exports.createRequestIdMiddleware = exports.createErrorHandler = exports.createLoggingMiddleware = exports.startServerWithShutdown = exports.withGracefulShutdown = exports.createGracefulShutdown = exports.addHealthCheck = exports.withHealthCheck = exports.createHealthCheck = exports.Router = exports.createServer = exports.ExpressServer = void 0;
 // Core server utilities
-var server_1 = require("./server");
+var server_1 = require("./core/server");
 Object.defineProperty(exports, "ExpressServer", { enumerable: true, get: function () { return server_1.ExpressServer; } });
 Object.defineProperty(exports, "createServer", { enumerable: true, get: function () { return server_1.createServer; } });
 // Express re-exports (to avoid direct Express dependency in services)
 var express_1 = require("express");
 Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return express_1.Router; } });
 // Health check utilities
-var health_1 = require("./health");
+var health_1 = require("./core/health");
 Object.defineProperty(exports, "createHealthCheck", { enumerable: true, get: function () { return health_1.createHealthCheck; } });
 Object.defineProperty(exports, "withHealthCheck", { enumerable: true, get: function () { return health_1.withHealthCheck; } });
 Object.defineProperty(exports, "addHealthCheck", { enumerable: true, get: function () { return health_1.addHealthCheck; } });
 // Graceful shutdown utilities
-var shutdown_1 = require("./shutdown");
+var shutdown_1 = require("./core/shutdown");
 Object.defineProperty(exports, "createGracefulShutdown", { enumerable: true, get: function () { return shutdown_1.createGracefulShutdown; } });
 Object.defineProperty(exports, "withGracefulShutdown", { enumerable: true, get: function () { return shutdown_1.withGracefulShutdown; } });
 Object.defineProperty(exports, "startServerWithShutdown", { enumerable: true, get: function () { return shutdown_1.startServerWithShutdown; } });
@@ -38,20 +38,20 @@ Object.defineProperty(exports, "requireAuth", { enumerable: true, get: function
 Object.defineProperty(exports, "cacheResponse", { enumerable: true, get: function () { return middleware_1.cacheResponse; } });
 Object.defineProperty(exports, "useSession", { enumerable: true, get: function () { return middleware_1.useSession; } });
 // Utility functions
-var utils_1 = require("./utils");
+var utils_1 = require("./utils/utils");
 Object.defineProperty(exports, "getEnv", { enumerable: true, get: function () { return utils_1.getEnv; } });
 Object.defineProperty(exports, "getEnvNumber", { enumerable: true, get: function () { return utils_1.getEnvNumber; } });
 Object.defineProperty(exports, "getEnvBoolean", { enumerable: true, get: function () { return utils_1.getEnvBoolean; } });
 // Periodic health monitoring
-var periodic_health_1 = require("./periodic-health");
+var periodic_health_1 = require("./core/periodic-health");
 Object.defineProperty(exports, "PeriodicHealthMonitor", { enumerable: true, get: function () { return periodic_health_1.PeriodicHealthMonitor; } });
 // Import all exports for default export
-const server_2 = require("./server");
-const health_2 = require("./health");
-const shutdown_2 = require("./shutdown");
+const server_2 = require("./core/server");
+const health_2 = require("./core/health");
+const shutdown_2 = require("./core/shutdown");
 const middleware_2 = require("./middleware");
-const utils_2 = require("./utils");
-const periodic_health_2 = require("./periodic-health");
+const utils_2 = require("./utils/utils");
+const periodic_health_2 = require("./core/periodic-health");
 // Default export for namespace usage
 const ServerUtils = {
     // Server creation

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

@@ -0,0 +1,7 @@
+import { 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/cjs/middleware/auth.middleware.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuthMiddleware = createAuthMiddleware;
+const security_1 = require("@naman_deep_singh/security");
+const errors_utils_1 = require("@naman_deep_singh/errors-utils");
+function createAuthMiddleware(config) {
+    const { secret, unauthorizedMessage = 'Unauthorized access', tokenExtractor = (req) => (0, security_1.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 errors_utils_1.UnauthorizedError(unauthorizedMessage, {
+                    reason: 'No token provided'
+                });
+                return next(error);
+            }
+            // Use safe verify token from security package
+            const result = (0, security_1.safeVerifyToken)(token, secret);
+            if (!result.valid) {
+                const error = new errors_utils_1.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 errors_utils_1.UnauthorizedError(unauthorizedMessage, error instanceof Error ? { originalError: error.message } : error);
+            return next(unauthorizedError);
+        }
+    };
+}

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

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

package/dist/cjs/middleware/cache.middleware.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheResponse = cacheResponse;
+// Cache response middleware (per-route opt-in)
+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/cjs/middleware/errorHandler.middleware.d.ts

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

package/dist/cjs/middleware/errorHandler.middleware.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createErrorHandler = createErrorHandler;
+// Error handling middleware
+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/cjs/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/cjs/middleware/index.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireAuth = exports.rateLimit = exports.validateFields = exports.withAuth = exports.withRateLimit = exports.withValidation = exports.withRequestId = exports.withErrorHandler = exports.withLogging = exports.createValidationMiddleware = exports.useSession = exports.createRequestIdMiddleware = exports.createRateLimitMiddleware = exports.createLoggingMiddleware = exports.createErrorHandler = exports.cacheResponse = exports.createAuthMiddleware = void 0;
+// Authentication Middleware
+var auth_middleware_1 = require("./auth.middleware");
+Object.defineProperty(exports, "createAuthMiddleware", { enumerable: true, get: function () { return auth_middleware_1.createAuthMiddleware; } });
+// Cache Middleware
+var cache_middleware_1 = require("./cache.middleware");
+Object.defineProperty(exports, "cacheResponse", { enumerable: true, get: function () { return cache_middleware_1.cacheResponse; } });
+// Error Handler Middleware
+var errorHandler_middleware_1 = require("./errorHandler.middleware");
+Object.defineProperty(exports, "createErrorHandler", { enumerable: true, get: function () { return errorHandler_middleware_1.createErrorHandler; } });
+// Logging Middleware
+var logging_middleware_1 = require("./logging.middleware");
+Object.defineProperty(exports, "createLoggingMiddleware", { enumerable: true, get: function () { return logging_middleware_1.createLoggingMiddleware; } });
+// Rate Limiter Middleware
+var rateLimiter_middleware_1 = require("./rateLimiter.middleware");
+Object.defineProperty(exports, "createRateLimitMiddleware", { enumerable: true, get: function () { return rateLimiter_middleware_1.createRateLimitMiddleware; } });
+// Request ID Middleware
+var requestId_middleware_1 = require("./requestId.middleware");
+Object.defineProperty(exports, "createRequestIdMiddleware", { enumerable: true, get: function () { return requestId_middleware_1.createRequestIdMiddleware; } });
+// Session Middleware
+var session_middleware_1 = require("./session.middleware");
+Object.defineProperty(exports, "useSession", { enumerable: true, get: function () { return session_middleware_1.useSession; } });
+// Validation Middleware
+var validation_middleware_1 = require("./validation.middleware");
+Object.defineProperty(exports, "createValidationMiddleware", { enumerable: true, get: function () { return validation_middleware_1.createValidationMiddleware; } });
+// Plugin middleware functions (for application-level middleware)
+var plugins_middleware_1 = require("./plugins.middleware");
+Object.defineProperty(exports, "withLogging", { enumerable: true, get: function () { return plugins_middleware_1.withLogging; } });
+Object.defineProperty(exports, "withErrorHandler", { enumerable: true, get: function () { return plugins_middleware_1.withErrorHandler; } });
+Object.defineProperty(exports, "withRequestId", { enumerable: true, get: function () { return plugins_middleware_1.withRequestId; } });
+Object.defineProperty(exports, "withValidation", { enumerable: true, get: function () { return plugins_middleware_1.withValidation; } });
+Object.defineProperty(exports, "withRateLimit", { enumerable: true, get: function () { return plugins_middleware_1.withRateLimit; } });
+Object.defineProperty(exports, "withAuth", { enumerable: true, get: function () { return plugins_middleware_1.withAuth; } });
+// Convenience middleware functions (for route-level middleware)
+var plugins_middleware_2 = require("./plugins.middleware");
+Object.defineProperty(exports, "validateFields", { enumerable: true, get: function () { return plugins_middleware_2.validateFields; } });
+Object.defineProperty(exports, "rateLimit", { enumerable: true, get: function () { return plugins_middleware_2.rateLimit; } });
+Object.defineProperty(exports, "requireAuth", { enumerable: true, get: function () { return plugins_middleware_2.requireAuth; } });

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

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

package/dist/cjs/middleware/logging.middleware.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLoggingMiddleware = createLoggingMiddleware;
+// Logging middleware
+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/cjs/middleware/plugins.middleware.d.ts

@@ -0,0 +1,14 @@
+import { RequestHandler } from 'express';
+import { ServerPlugin } from '../types';
+import { ValidationRule } from './validation.middleware';
+import { RateLimitConfig } from './rateLimiter.middleware';
+import { AuthConfig } from './auth.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;