@superdangerous/app-framework 4.9.0

package/dist/middleware/fileUpload.js

@@ -0,0 +1,175 @@
+/**
+ * File Upload Middleware
+ * Simple file upload handling for Express
+ */
+import multer from "multer";
+import path from "path";
+import { getStorageService } from "../core/storageService.js";
+import { createLogger } from "../core/index.js";
+let logger; // Will be initialized when needed
+function ensureLogger() {
+    if (!logger) {
+        logger = createLogger("FileUpload");
+    }
+    return logger;
+}
+/**
+ * Create file upload middleware
+ */
+export function createFileUpload(config = {}) {
+    const { destination = "uploads", maxSize = 10 * 1024 * 1024, // 10MB default
+    allowedTypes = [], fieldName = "file", multiple = false, maxCount = 10, } = config;
+    // Configure multer storage
+    const storage = multer.memoryStorage();
+    // Configure multer
+    const upload = multer({
+        storage,
+        limits: {
+            fileSize: maxSize,
+            files: maxCount,
+        },
+        fileFilter: (_req, file, cb) => {
+            // Check file type if restrictions are set
+            if (allowedTypes.length > 0) {
+                const ext = path.extname(file.originalname).toLowerCase();
+                if (!allowedTypes.includes(ext)) {
+                    return cb(new Error(`File type ${ext} not allowed`));
+                }
+            }
+            cb(null, true);
+        },
+    });
+    // Return appropriate middleware
+    const multerMiddleware = multiple
+        ? upload.array(fieldName, maxCount)
+        : upload.single(fieldName);
+    return async (req, res, next) => {
+        multerMiddleware(req, res, async (err) => {
+            if (err) {
+                ensureLogger().error("Upload error:", err);
+                if (err instanceof multer.MulterError) {
+                    if (err.code === "LIMIT_FILE_SIZE") {
+                        res.status(400).json({
+                            success: false,
+                            error: "File too large",
+                            message: `File size exceeds maximum of ${maxSize} bytes`,
+                        });
+                        return;
+                    }
+                    if (err.code === "LIMIT_FILE_COUNT") {
+                        res.status(400).json({
+                            success: false,
+                            error: "Too many files",
+                            message: `Maximum ${maxCount} files allowed`,
+                        });
+                        return;
+                    }
+                }
+                res.status(400).json({
+                    success: false,
+                    error: "Upload failed",
+                    message: err.message,
+                });
+                return;
+            }
+            // Process uploaded files via StorageService to keep a single path for uploads
+            try {
+                const storage = getStorageService();
+                if (multiple && req.files && Array.isArray(req.files)) {
+                    // Multiple files
+                    const uploadedFiles = [];
+                    for (const file of req.files) {
+                        const uploaded = await storage.saveUserUpload(file.buffer, file.originalname, {
+                            allowedTypes,
+                            maxSize,
+                            destination,
+                        });
+                        uploadedFiles.push({
+                            ...uploaded,
+                            mimetype: file.mimetype,
+                        });
+                    }
+                    req.uploadedFiles = uploadedFiles;
+                    ensureLogger().info(`Uploaded ${uploadedFiles.length} files`);
+                }
+                else if (req.file) {
+                    // Single file
+                    const uploaded = await storage.saveUserUpload(req.file.buffer, req.file.originalname, {
+                        allowedTypes,
+                        maxSize,
+                        destination,
+                    });
+                    req.uploadedFile = {
+                        ...uploaded,
+                        mimetype: req.file.mimetype,
+                    };
+                    ensureLogger().info(`Uploaded file: ${uploaded.filename}`);
+                }
+                next();
+            }
+            catch (_error) {
+                ensureLogger().error("File processing error:", _error);
+                res.status(500).json({
+                    success: false,
+                    error: "File processing failed",
+                    message: _error.message,
+                });
+            }
+        });
+    };
+}
+/**
+ * Parse form data middleware (for mixed file/data uploads)
+ */
+export function parseFormData(fields = []) {
+    const upload = multer();
+    return upload.fields(fields.map((field) => ({ name: field })));
+}
+/**
+ * Download file helper
+ */
+export function sendFile(filePath, filename) {
+    return (_req, res) => {
+        const resolvedPath = path.resolve(filePath);
+        const downloadName = filename || path.basename(filePath);
+        res.download(resolvedPath, downloadName, (err) => {
+            if (err) {
+                ensureLogger().error("Download error:", err);
+                if (!res.headersSent) {
+                    res.status(404).json({
+                        success: false,
+                        error: "File not found",
+                    });
+                }
+            }
+        });
+    };
+}
+/**
+ * Express middleware to clean old temp files periodically
+ */
+export function createTempCleaner(tempDir = "./temp", maxAge = 24 * 60 * 60 * 1000, // 24 hours
+interval = 60 * 60 * 1000) {
+    const storage = getStorageService();
+    // Start periodic cleaning
+    setInterval(async () => {
+        try {
+            const deleted = await storage.cleanTempFiles(maxAge, tempDir);
+            if (deleted > 0) {
+                ensureLogger().info(`Cleaned ${deleted} old temporary files`);
+            }
+        }
+        catch (_error) {
+            ensureLogger().error("Temp file cleanup error:", _error);
+        }
+    }, interval);
+    // Return middleware that does nothing (just starts the cleaner)
+    return (_req, _res, next) => next();
+}
+export default {
+    createFileUpload,
+    parseFormData,
+    sendFile,
+    createTempCleaner,
+};
+//# sourceMappingURL=fileUpload.js.map

package/dist/middleware/fileUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUpload.js","sourceRoot":"","sources":["../../src/middleware/fileUpload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,IAAI,MAAW,CAAC,CAAC,kCAAkC;AAEnD,SAAS,YAAY;IACnB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAWD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAA2B,EAAE;IAC5D,MAAM,EACJ,WAAW,GAAG,SAAS,EACvB,OAAO,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,eAAe;IAC3C,YAAY,GAAG,EAAE,EACjB,SAAS,GAAG,MAAM,EAClB,QAAQ,GAAG,KAAK,EAChB,QAAQ,GAAG,EAAE,GACd,GAAG,MAAM,CAAC;IAEX,2BAA2B;IAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;IAEvC,mBAAmB;IACnB,MAAM,MAAM,GAAG,MAAM,CAAC;QACpB,OAAO;QACP,MAAM,EAAE;YACN,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,QAAQ;SAChB;QACD,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;YAC7B,0CAA0C;YAC1C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC1D,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChC,OAAO,EAAE,CAAC,IAAI,KAAK,CAAC,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;YACD,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;IAEH,gCAAgC;IAChC,MAAM,gBAAgB,GAAG,QAAQ;QAC/B,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC;QACnC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE7B,OAAO,KAAK,EACV,GAAY,EACZ,GAAa,EACb,IAAkB,EACH,EAAE;QACjB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACvC,IAAI,GAAG,EAAE,CAAC;gBACR,YAAY,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;gBAE3C,IAAI,GAAG,YAAY,MAAM,CAAC,WAAW,EAAE,CAAC;oBACtC,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;wBACnC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;4BACnB,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,gBAAgB;4BACvB,OAAO,EAAE,gCAAgC,OAAO,QAAQ;yBACzD,CAAC,CAAC;wBACH,OAAO;oBACT,CAAC;oBACD,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;wBACpC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;4BACnB,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,gBAAgB;4BACvB,OAAO,EAAE,WAAW,QAAQ,gBAAgB;yBAC7C,CAAC,CAAC;wBACH,OAAO;oBACT,CAAC;gBACH,CAAC;gBAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,eAAe;oBACtB,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,8EAA8E;YAC9E,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;gBAEpC,IAAI,QAAQ,IAAI,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACtD,iBAAiB;oBACjB,MAAM,aAAa,GAAG,EAAE,CAAC;oBAEzB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;wBAC7B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,CAC3C,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,EACjB;4BACE,YAAY;4BACZ,OAAO;4BACP,WAAW;yBACZ,CACF,CAAC;wBACF,aAAa,CAAC,IAAI,CAAC;4BACjB,GAAG,QAAQ;4BACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;yBACxB,CAAC,CAAC;oBACL,CAAC;oBAED,GAAG,CAAC,aAAa,GAAG,aAAa,CAAC;oBAClC,YAAY,EAAE,CAAC,IAAI,CAAC,YAAY,aAAa,CAAC,MAAM,QAAQ,CAAC,CAAC;gBAChE,CAAC;qBAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;oBACpB,cAAc;oBACd,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,CAC3C,GAAG,CAAC,IAAI,CAAC,MAAM,EACf,GAAG,CAAC,IAAI,CAAC,YAAY,EACrB;wBACE,YAAY;wBACZ,OAAO;wBACP,WAAW;qBACZ,CACF,CAAC;oBAEF,GAAG,CAAC,YAAY,GAAG;wBACjB,GAAG,QAAQ;wBACX,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ;qBAC5B,CAAC;oBACF,YAAY,EAAE,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC7D,CAAC;gBAED,IAAI,EAAE,CAAC;YACT,CAAC;YAAC,OAAO,MAAW,EAAE,CAAC;gBACrB,YAAY,EAAE,CAAC,KAAK,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;gBACvD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,wBAAwB;oBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAmB,EAAE;IACjD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,QAAiB;IAC1D,OAAO,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEzD,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;YAC/C,IAAI,GAAG,EAAE,CAAC;gBACR,YAAY,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;gBAC7C,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;oBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,gBAAgB;qBACxB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,QAAQ,EAC1B,SAAiB,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;AACjD,WAAmB,EAAE,GAAG,EAAE,GAAG,IAAI;IAEjC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,0BAA0B;IAC1B,WAAW,CAAC,KAAK,IAAI,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC9D,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC,IAAI,CAAC,WAAW,OAAO,sBAAsB,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAAC,OAAO,MAAW,EAAE,CAAC;YACrB,YAAY,EAAE,CAAC,KAAK,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEb,gEAAgE;IAChE,OAAO,CAAC,IAAa,EAAE,IAAc,EAAE,IAAkB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;AACvE,CAAC;AA6BD,eAAe;IACb,gBAAgB;IAChB,aAAa;IACb,QAAQ;IACR,iBAAiB;CAClB,CAAC"}

package/dist/middleware/health.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Standardized Health Check Middleware
+ * Provides consistent health monitoring across all applications
+ */
+import { Request, Response, Router } from "express";
+export interface HealthCheckOptions {
+    includeDetails?: boolean;
+    checkComponents?: () => Promise<ComponentHealth>;
+    version?: string;
+    serviceName?: string;
+}
+export interface ComponentHealth {
+    [key: string]: {
+        status: "healthy" | "degraded" | "unhealthy";
+        message?: string;
+        latency?: number;
+    };
+}
+export interface HealthResponse {
+    status: "healthy" | "degraded" | "unhealthy";
+    timestamp: string;
+    version: string;
+    uptime: number;
+    service?: string;
+    components?: ComponentHealth;
+    resources?: {
+        memory: {
+            used: number;
+            total: number;
+            percentage: number;
+        };
+        cpu: {
+            usage: number;
+            cores: number;
+        };
+    };
+}
+/**
+ * Create standardized health check endpoint
+ * @param {HealthCheckOptions} options - Health check configuration
+ * @returns {Router} Express router with health endpoint
+ */
+export declare function createHealthCheck(options?: HealthCheckOptions): Router;
+/**
+ * Simple health check middleware for basic use
+ */
+export declare function healthCheck(_req: Request, res: Response): void;
+//# sourceMappingURL=health.d.ts.map

package/dist/middleware/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/middleware/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGpD,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;QAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,SAAS,CAAC,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,GAAG,EAAE;YACH,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH;AA4DD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAqF1E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,QASvD"}

package/dist/middleware/health.js

@@ -0,0 +1,143 @@
+/**
+ * Standardized Health Check Middleware
+ * Provides consistent health monitoring across all applications
+ */
+import { Router } from "express";
+import os from "os";
+/**
+ * Get system resource usage
+ */
+function getSystemResources() {
+    const totalMem = os.totalmem();
+    const freeMem = os.freemem();
+    const usedMem = totalMem - freeMem;
+    // Simplified CPU usage calculation
+    const cpus = os.cpus();
+    let totalIdle = 0;
+    let totalTick = 0;
+    cpus.forEach((cpu) => {
+        for (const type in cpu.times) {
+            totalTick += cpu.times[type];
+        }
+        totalIdle += cpu.times.idle;
+    });
+    const idle = totalIdle / cpus.length;
+    const total = totalTick / cpus.length;
+    const usage = Math.round(100 - (100 * idle) / total);
+    return {
+        memory: {
+            used: usedMem,
+            total: totalMem,
+            percentage: Math.round((usedMem / totalMem) * 100),
+        },
+        cpu: {
+            usage,
+            cores: cpus.length,
+        },
+    };
+}
+/**
+ * Determine overall health status based on components
+ */
+function determineOverallHealth(components) {
+    if (!components)
+        return "healthy";
+    const statuses = Object.values(components).map((c) => c.status);
+    if (statuses.some((s) => s === "unhealthy")) {
+        return "unhealthy";
+    }
+    if (statuses.some((s) => s === "degraded")) {
+        return "degraded";
+    }
+    return "healthy";
+}
+/**
+ * Create standardized health check endpoint
+ * @param {HealthCheckOptions} options - Health check configuration
+ * @returns {Router} Express router with health endpoint
+ */
+export function createHealthCheck(options = {}) {
+    const router = Router();
+    const { includeDetails = true, checkComponents, version = process.env.npm_package_version || "1.0.0", serviceName, } = options;
+    /**
+     * GET /health
+     * Standard health check endpoint
+     */
+    router.get("/health", async (_req, res) => {
+        try {
+            // Check component health if provided
+            const components = checkComponents ? await checkComponents() : undefined;
+            // Build health response
+            const health = {
+                status: determineOverallHealth(components),
+                timestamp: new Date().toISOString(),
+                version,
+                uptime: process.uptime(),
+            };
+            if (serviceName) {
+                health.service = serviceName;
+            }
+            if (includeDetails) {
+                health.resources = getSystemResources();
+            }
+            if (components) {
+                health.components = components;
+            }
+            // Set appropriate status code
+            const statusCode = health.status === "healthy"
+                ? 200
+                : health.status === "degraded"
+                    ? 200
+                    : 503;
+            res.status(statusCode).json(health);
+        }
+        catch (_error) {
+            res.status(503).json({
+                status: "unhealthy",
+                timestamp: new Date().toISOString(),
+                version,
+                error: _error.message,
+            });
+        }
+    });
+    /**
+     * GET /health/ready
+     * Readiness check (for k8s)
+     */
+    router.get("/health/ready", async (_req, res) => {
+        try {
+            const components = checkComponents ? await checkComponents() : undefined;
+            const status = determineOverallHealth(components);
+            if (status === "healthy") {
+                res.status(200).json({ ready: true });
+            }
+            else {
+                res.status(503).json({ ready: false, status });
+            }
+        }
+        catch (_error) {
+            res.status(503).json({ ready: false });
+        }
+    });
+    /**
+     * GET /health/live
+     * Liveness check (for k8s)
+     */
+    router.get("/health/live", (_req, res) => {
+        res.status(200).json({ alive: true });
+    });
+    return router;
+}
+/**
+ * Simple health check middleware for basic use
+ */
+export function healthCheck(_req, res) {
+    const health = {
+        status: "healthy",
+        timestamp: new Date().toISOString(),
+        version: process.env.npm_package_version || "1.0.0",
+        uptime: process.uptime(),
+    };
+    res.json(health);
+}
+//# sourceMappingURL=health.js.map

package/dist/middleware/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/middleware/health.ts"],"names":[],"mappings":"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"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Middleware Module Exports
+ */
+export { schemas, validate, validateParams, validateQuery, validateAsync, validateRequest, validateIf, compose, z, zod, } from "./validation.js";
+export { aiErrorHandler } from "./aiErrorHandler.js";
+export { errorHandler, notFoundHandler, asyncHandler, AppError, } from "./errorHandler.js";
+export { createFileUpload, parseFormData, sendFile, createTempCleaner, } from "./fileUpload.js";
+export type { FileUploadConfig } from "./fileUpload.js";
+export { createHealthCheck, healthCheck } from "./health.js";
+export type { HealthCheckOptions, ComponentHealth, HealthResponse, } from "./health.js";
+export { setupOpenAPIDocumentation, generateOpenAPISpec, ApiOperation, } from "./openapi.js";
+export type { OpenAPIConfig } from "./openapi.js";
+export { createAuthMiddleware, createLoginHandler, createLogoutHandler, createAuthCheckHandler, SimpleAuthService, } from "./auth.js";
+export type { AuthConfig } from "./auth.js";
+export { configureSession } from "./session.js";
+export type { SessionConfig as SessionMiddlewareConfig } from "./session.js";
+export { createDynamicCors, createProductionCors, createDevCors, } from "./cors.js";
+export type { DynamicCorsOptions } from "./cors.js";
+export { createRequestLoggingMiddleware, type RequestLoggingOptions, } from "./requestLogging.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,OAAO,EACP,QAAQ,EACR,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,UAAU,EACV,OAAO,EACP,CAAC,EACD,GAAG,GACJ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,aAAa,IAAI,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG7E,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EACL,8BAA8B,EAC9B,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,18 @@
+/**
+ * Middleware Module Exports
+ */
+export { schemas, validate, validateParams, validateQuery, validateAsync, validateRequest, validateIf, compose, z, zod, } from "./validation.js";
+export { aiErrorHandler } from "./aiErrorHandler.js";
+export { errorHandler, notFoundHandler, asyncHandler, AppError, } from "./errorHandler.js";
+export { createFileUpload, parseFormData, sendFile, createTempCleaner, } from "./fileUpload.js";
+export { createHealthCheck, healthCheck } from "./health.js";
+export { setupOpenAPIDocumentation, generateOpenAPISpec, ApiOperation, } from "./openapi.js";
+// Auth middleware exports
+export { createAuthMiddleware, createLoginHandler, createLogoutHandler, createAuthCheckHandler, SimpleAuthService, } from "./auth.js";
+// Session middleware exports
+export { configureSession } from "./session.js";
+// CORS middleware exports
+export { createDynamicCors, createProductionCors, createDevCors, } from "./cors.js";
+// Request logging / context
+export { createRequestLoggingMiddleware, } from "./requestLogging.js";
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,OAAO,EACP,QAAQ,EACR,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,UAAU,EACV,OAAO,EACP,CAAC,EACD,GAAG,GACJ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM7D,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,0BAA0B;AAC1B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,4BAA4B;AAC5B,OAAO,EACL,8BAA8B,GAE/B,MAAM,qBAAqB,CAAC"}

package/dist/middleware/openapi.d.ts

@@ -0,0 +1,64 @@
+/**
+ * OpenAPI Documentation Middleware
+ * Provides automatic API documentation generation
+ */
+import { Express } from "express";
+export interface OpenAPIConfig {
+    title: string;
+    version: string;
+    description?: string;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    contact?: {
+        name?: string;
+        email?: string;
+        url?: string;
+    };
+    license?: {
+        name: string;
+        url?: string;
+    };
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+/**
+ * Generate OpenAPI specification
+ * @param config OpenAPI configuration
+ * @param apis Array of file patterns for API routes
+ */
+export declare function generateOpenAPISpec(config: OpenAPIConfig, apis: string[]): object;
+/**
+ * Setup OpenAPI documentation UI
+ * @param app Express application
+ * @param config OpenAPI configuration
+ * @param apis Array of file patterns for API routes
+ * @param path Path to serve documentation (default: /api-docs)
+ */
+export declare function setupOpenAPIDocumentation(app: Express, config: OpenAPIConfig, apis: string[], path?: string): void;
+/**
+ * Example JSDoc annotation for OpenAPI
+ *
+ * @swagger
+ * /api/resource:
+ *   get:
+ *     summary: Get all resources
+ *     tags: [Resources]
+ *     responses:
+ *       200:
+ *         description: Successful response
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ApiResponse'
+ *       500:
+ *         $ref: '#/components/responses/InternalError'
+ */
+/**
+ * OpenAPI operation decorator (for future TypeScript decorator support)
+ */
+export declare function ApiOperation(operation: any): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/middleware/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/middleware/openapi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,IAAI,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EAAE,GACb,MAAM,CAsLR;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,MAAoB,GACzB,IAAI,CA+BN;AAED;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,GAAG,IAEvC,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,kBAAkB,wBASjC"}