@superdangerous/app-framework 4.9.0

package/dist/core/apiResponse.js.map

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

package/dist/core/healthCheck.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Health Check Service
+ * Provides real-time system health monitoring without intervention
+ * Data is informational only - no automatic service stops based on metrics
+ */
+import { Router } from "express";
+export interface SystemHealth {
+    status: "healthy" | "degraded" | "unhealthy";
+    timestamp: string;
+    uptime: number;
+    environment: string;
+    version: string;
+    pid: number;
+    platform: string;
+    nodeVersion: string;
+}
+export interface SystemMetrics {
+    cpu: {
+        usage: number;
+        count: number;
+        model: string;
+        speed: number;
+        loadAverage: number[];
+    };
+    memory: {
+        total: number;
+        used: number;
+        free: number;
+        percentage: number;
+    };
+    disk: {
+        total: number;
+        used: number;
+        free: number;
+        percentage: number;
+        path: string;
+    };
+    network: {
+        interfaces: NetworkInterface[];
+    };
+    process: {
+        pid: number;
+        memory: NodeJS.MemoryUsage;
+        cpuUsage: NodeJS.CpuUsage;
+        uptime: number;
+    };
+}
+export interface NetworkInterface {
+    name: string;
+    address: string;
+    family: string;
+    internal: boolean;
+}
+export interface HealthCheckOptions {
+    includeCpu?: boolean;
+    includeMemory?: boolean;
+    includeDisk?: boolean;
+    includeNetwork?: boolean;
+    includeProcess?: boolean;
+    diskPath?: string;
+    customChecks?: CustomHealthCheck[];
+}
+export interface CustomHealthCheck {
+    name: string;
+    check: () => Promise<HealthCheckResult>;
+}
+export interface HealthCheckResult {
+    name: string;
+    status: "healthy" | "degraded" | "unhealthy";
+    message?: string;
+    data?: any;
+}
+export interface DependencyHealth {
+    name: string;
+    status: "connected" | "disconnected" | "error";
+    responseTime?: number;
+    error?: string;
+}
+declare class HealthCheckService {
+    private static instance;
+    private cpuUsageHistory;
+    private memoryUsageHistory;
+    private lastCpuInfo;
+    private metricsInterval?;
+    private historySize;
+    private constructor();
+    static getInstance(): HealthCheckService;
+    /**
+     * Get basic system health status
+     */
+    getHealth(appVersion?: string): Promise<SystemHealth>;
+    /**
+     * Get detailed system metrics
+     */
+    getMetrics(options?: HealthCheckOptions): Promise<SystemMetrics>;
+    /**
+     * Get CPU metrics with real usage calculation
+     */
+    private getCpuMetrics;
+    /**
+     * Calculate real CPU usage percentage
+     */
+    private calculateCpuUsage;
+    /**
+     * Get memory metrics
+     */
+    private getMemoryMetrics;
+    /**
+     * Get disk metrics for specified path
+     */
+    private getDiskMetrics;
+    /**
+     * Get network interface information
+     */
+    private getNetworkMetrics;
+    /**
+     * Get current process metrics
+     */
+    private getProcessMetrics;
+    /**
+     * Check dependency health (database, Redis, external APIs, etc.)
+     */
+    checkDependencies(dependencies: {
+        name: string;
+        check: () => Promise<boolean>;
+    }[]): Promise<DependencyHealth[]>;
+    /**
+     * Run custom health checks
+     */
+    runCustomChecks(checks: CustomHealthCheck[]): Promise<HealthCheckResult[]>;
+    /**
+     * Get metrics history for graphs
+     */
+    getMetricsHistory(): {
+        cpu: number[];
+        memory: number[];
+    };
+    /**
+     * Start collecting metrics periodically for history
+     */
+    private startMetricsCollection;
+    /**
+     * Stop metrics collection (for cleanup)
+     */
+    stopMetricsCollection(): void;
+}
+/**
+ * Create health check router for Express apps
+ */
+export declare function createHealthCheckRouter(options?: {
+    version?: string;
+    customChecks?: CustomHealthCheck[];
+    dependencies?: Array<{
+        name: string;
+        check: () => Promise<boolean>;
+    }>;
+}): Router;
+export declare function getHealthCheckService(): HealthCheckService;
+export type { HealthCheckService };
+//# sourceMappingURL=healthCheck.d.ts.map

package/dist/core/healthCheck.d.ts.map

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

package/dist/core/healthCheck.js

@@ -0,0 +1,398 @@
+/**
+ * Health Check Service
+ * Provides real-time system health monitoring without intervention
+ * Data is informational only - no automatic service stops based on metrics
+ */
+import os from "os";
+import { exec } from "child_process";
+import { promisify } from "util";
+import { Router } from "express";
+const execAsync = promisify(exec);
+class HealthCheckService {
+    static instance;
+    cpuUsageHistory = [];
+    memoryUsageHistory = [];
+    lastCpuInfo;
+    metricsInterval;
+    historySize = 60; // Keep last 60 data points
+    constructor() {
+        this.startMetricsCollection();
+    }
+    static getInstance() {
+        if (!HealthCheckService.instance) {
+            HealthCheckService.instance = new HealthCheckService();
+        }
+        return HealthCheckService.instance;
+    }
+    /**
+     * Get basic system health status
+     */
+    async getHealth(appVersion) {
+        // Health status is 'healthy' by default - system metrics are informational only
+        // Actual health is determined by custom checks (database, websocket, etc.)
+        const status = "healthy";
+        return {
+            status,
+            timestamp: new Date().toISOString(),
+            uptime: process.uptime(),
+            environment: process.env.NODE_ENV || "development",
+            version: appVersion || process.env.npm_package_version || "unknown",
+            pid: process.pid,
+            platform: process.platform,
+            nodeVersion: process.version,
+        };
+    }
+    /**
+     * Get detailed system metrics
+     */
+    async getMetrics(options = {}) {
+        const { includeCpu = true, includeMemory = true, includeDisk = true, includeNetwork = true, includeProcess = true, diskPath = process.cwd(), } = options;
+        const metrics = {};
+        if (includeCpu) {
+            metrics.cpu = await this.getCpuMetrics();
+        }
+        if (includeMemory) {
+            metrics.memory = this.getMemoryMetrics();
+        }
+        if (includeDisk) {
+            metrics.disk = await this.getDiskMetrics(diskPath);
+        }
+        if (includeNetwork) {
+            metrics.network = this.getNetworkMetrics();
+        }
+        if (includeProcess) {
+            metrics.process = this.getProcessMetrics();
+        }
+        return metrics;
+    }
+    /**
+     * Get CPU metrics with real usage calculation
+     */
+    async getCpuMetrics() {
+        const cpus = os.cpus();
+        const cpuModel = cpus[0]?.model || "Unknown";
+        const cpuSpeed = cpus[0]?.speed || 0;
+        const cpuCount = cpus.length;
+        const loadAverage = os.loadavg();
+        // Calculate CPU usage percentage
+        const cpuUsage = await this.calculateCpuUsage();
+        return {
+            usage: cpuUsage,
+            count: cpuCount,
+            model: cpuModel,
+            speed: cpuSpeed,
+            loadAverage,
+        };
+    }
+    /**
+     * Calculate real CPU usage percentage
+     */
+    async calculateCpuUsage() {
+        const cpus = os.cpus();
+        // Calculate total and idle times
+        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;
+        // If we have previous measurements, calculate the difference
+        if (this.lastCpuInfo) {
+            const idleDiff = idle - this.lastCpuInfo.idle;
+            const totalDiff = total - this.lastCpuInfo.total;
+            const usage = 100 - (100 * idleDiff) / totalDiff;
+            this.lastCpuInfo = { idle, total };
+            return Math.min(100, Math.max(0, usage));
+        }
+        // First measurement - store for next time
+        this.lastCpuInfo = { idle, total };
+        // Fallback: use load average as approximation
+        const loadAvg = os.loadavg()[0]; // 1-minute load average
+        const approximateUsage = (loadAvg / cpus.length) * 100;
+        return Math.min(100, Math.max(0, approximateUsage));
+    }
+    /**
+     * Get memory metrics
+     */
+    getMemoryMetrics() {
+        const totalMemory = os.totalmem();
+        const freeMemory = os.freemem();
+        const usedMemory = totalMemory - freeMemory;
+        const memoryPercentage = (usedMemory / totalMemory) * 100;
+        return {
+            total: totalMemory,
+            used: usedMemory,
+            free: freeMemory,
+            percentage: parseFloat(memoryPercentage.toFixed(2)),
+        };
+    }
+    /**
+     * Get disk metrics for specified path
+     */
+    async getDiskMetrics(diskPath) {
+        try {
+            // Platform-specific disk usage check
+            if (process.platform === "win32") {
+                // Windows: use wmic command
+                const { stdout } = await execAsync("wmic logicaldisk get size,freespace,caption");
+                const lines = stdout.split("\n").filter((line) => line.trim());
+                // Parse the output (this is simplified - may need adjustment)
+                const total = parseInt(lines[1]?.split(/\s+/)[2] || "0");
+                const free = parseInt(lines[1]?.split(/\s+/)[1] || "0");
+                const used = total - free;
+                return {
+                    total,
+                    used,
+                    free,
+                    percentage: total > 0 ? parseFloat(((used / total) * 100).toFixed(2)) : 0,
+                    path: diskPath,
+                };
+            }
+            else {
+                // Unix-like systems: use df command
+                const { stdout } = await execAsync(`df -k "${diskPath}" | tail -1`);
+                const parts = stdout.trim().split(/\s+/);
+                // df output: filesystem 1K-blocks used available use% mounted
+                const total = parseInt(parts[1] || "0") * 1024;
+                const used = parseInt(parts[2] || "0") * 1024;
+                const available = parseInt(parts[3] || "0") * 1024;
+                const percentage = parseInt(parts[4]?.replace("%", "") || "0");
+                return {
+                    total,
+                    used,
+                    free: available,
+                    percentage,
+                    path: diskPath,
+                };
+            }
+        }
+        catch (_error) {
+            console.error("Failed to get disk metrics:", _error);
+            // Return zeros if we can't get disk stats
+            return {
+                total: 0,
+                used: 0,
+                free: 0,
+                percentage: 0,
+                path: diskPath,
+            };
+        }
+    }
+    /**
+     * Get network interface information
+     */
+    getNetworkMetrics() {
+        const networkInterfaces = os.networkInterfaces();
+        const interfaces = [];
+        for (const [name, nets] of Object.entries(networkInterfaces)) {
+            if (nets) {
+                for (const net of nets) {
+                    interfaces.push({
+                        name,
+                        address: net.address,
+                        family: net.family,
+                        internal: net.internal,
+                    });
+                }
+            }
+        }
+        return { interfaces };
+    }
+    /**
+     * Get current process metrics
+     */
+    getProcessMetrics() {
+        return {
+            pid: process.pid,
+            memory: process.memoryUsage(),
+            cpuUsage: process.cpuUsage(),
+            uptime: process.uptime(),
+        };
+    }
+    /**
+     * Check dependency health (database, Redis, external APIs, etc.)
+     */
+    async checkDependencies(dependencies) {
+        const results = [];
+        for (const dep of dependencies) {
+            const startTime = Date.now();
+            try {
+                const isHealthy = await dep.check();
+                results.push({
+                    name: dep.name,
+                    status: isHealthy ? "connected" : "disconnected",
+                    responseTime: Date.now() - startTime,
+                });
+            }
+            catch (_error) {
+                results.push({
+                    name: dep.name,
+                    status: "error",
+                    responseTime: Date.now() - startTime,
+                    error: _error instanceof Error ? _error.message : "Unknown error",
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Run custom health checks
+     */
+    async runCustomChecks(checks) {
+        const results = [];
+        for (const check of checks) {
+            try {
+                const result = await check.check();
+                results.push(result);
+            }
+            catch (_error) {
+                results.push({
+                    name: check.name,
+                    status: "unhealthy",
+                    message: _error instanceof Error ? _error.message : "Check failed",
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Get metrics history for graphs
+     */
+    getMetricsHistory() {
+        return {
+            cpu: [...this.cpuUsageHistory],
+            memory: [...this.memoryUsageHistory],
+        };
+    }
+    /**
+     * Start collecting metrics periodically for history
+     */
+    startMetricsCollection() {
+        // Collect metrics every 5 seconds
+        this.metricsInterval = setInterval(async () => {
+            try {
+                const metrics = await this.getMetrics();
+                // Add to history
+                this.cpuUsageHistory.push(metrics.cpu.usage);
+                this.memoryUsageHistory.push(metrics.memory.percentage);
+                // Keep only last N data points
+                if (this.cpuUsageHistory.length > this.historySize) {
+                    this.cpuUsageHistory.shift();
+                }
+                if (this.memoryUsageHistory.length > this.historySize) {
+                    this.memoryUsageHistory.shift();
+                }
+            }
+            catch (_error) {
+                console.error("Failed to collect metrics:", _error);
+            }
+        }, 5000);
+    }
+    /**
+     * Stop metrics collection (for cleanup)
+     */
+    stopMetricsCollection() {
+        if (this.metricsInterval) {
+            clearInterval(this.metricsInterval);
+            this.metricsInterval = undefined;
+        }
+    }
+}
+/**
+ * Create health check router for Express apps
+ */
+export function createHealthCheckRouter(options) {
+    const router = Router();
+    const healthService = HealthCheckService.getInstance();
+    // Basic health endpoint
+    router.get("/health", async (_req, res) => {
+        try {
+            const health = await healthService.getHealth(options?.version);
+            // Run custom checks if provided
+            if (options?.customChecks && options.customChecks.length > 0) {
+                const customResults = await Promise.all(options.customChecks.map((check) => check.check()));
+                // Add custom check results to health object
+                health.checks = customResults;
+                // Update overall status based ONLY on custom checks
+                const hasUnhealthy = customResults.some((r) => r.status === "unhealthy");
+                const hasDegraded = customResults.some((r) => r.status === "degraded");
+                if (hasUnhealthy) {
+                    health.status = "unhealthy";
+                }
+                else if (hasDegraded) {
+                    health.status = "degraded";
+                }
+                // Otherwise keep default 'healthy' status
+            }
+            const statusCode = health.status === "healthy"
+                ? 200
+                : health.status === "degraded"
+                    ? 200
+                    : 503;
+            res.status(statusCode).json(health);
+        }
+        catch (_error) {
+            res.status(503).json({
+                status: "unhealthy",
+                error: "Failed to get health status",
+            });
+        }
+    });
+    // Detailed metrics endpoint
+    router.get("/metrics", async (_req, res) => {
+        try {
+            const metrics = await healthService.getMetrics();
+            res.json(metrics);
+        }
+        catch (_error) {
+            res.status(500).json({
+                error: "Failed to get metrics",
+            });
+        }
+    });
+    // Metrics history for graphs
+    router.get("/metrics/history", (_req, res) => {
+        const history = healthService.getMetricsHistory();
+        res.json(history);
+    });
+    // Dependency health checks
+    if (options?.dependencies) {
+        router.get("/health/dependencies", async (_req, res) => {
+            try {
+                const results = await healthService.checkDependencies(options.dependencies);
+                const allHealthy = results.every((r) => r.status === "connected");
+                res.status(allHealthy ? 200 : 503).json(results);
+            }
+            catch (_error) {
+                res.status(500).json({
+                    error: "Failed to check dependencies",
+                });
+            }
+        });
+    }
+    // Custom health checks
+    if (options?.customChecks) {
+        router.get("/health/custom", async (_req, res) => {
+            try {
+                const results = await healthService.runCustomChecks(options.customChecks);
+                const allHealthy = results.every((r) => r.status === "healthy");
+                res.status(allHealthy ? 200 : 503).json(results);
+            }
+            catch (_error) {
+                res.status(500).json({
+                    error: "Failed to run custom checks",
+                });
+            }
+        });
+    }
+    return router;
+}
+// Export singleton instance getter
+export function getHealthCheckService() {
+    return HealthCheckService.getInstance();
+}
+//# sourceMappingURL=healthCheck.js.map

package/dist/core/healthCheck.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Core Framework Components
+ *
+ * These are generic, reusable components that could be extracted
+ * into a separate npm package for use in other applications.
+ */
+export declare const FRAMEWORK_VERSION = "4.4.0";
+export { StandardServer, createStandardServer } from "./StandardServer.js";
+export type { StandardServerConfig } from "./StandardServer.js";
+export { clearPort, isPortAvailable, getPortInfo, getProcessOnPort, findAvailablePort, checkRequiredPorts, formatPortStatus, waitForPort, getPortsInUse, type ProcessInfo, type PortStatus, type PortClearResult, type PortStatusResult, } from "./portUtils.js";
+export { getLogger, default as Logger, createLogger as createLoggerBase, } from "./logger.js";
+/**
+ * Create a logger instance with automatic file output
+ * @param name - The name/category for this logger
+ * @returns A logger instance that writes to console and files
+ */
+export declare function createLogger(name: string): any;
+export interface Logger {
+    info: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+}
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export { getStorageService, StorageService, getSecureFileHandler, SecureFileHandler, } from "./storageService.js";
+/**
+ * Usage Example:
+ *
+ * import { StandardServer, createLogger } from '@/core';
+ *
+ * const logger = createLogger('MyApp');
+ * const server = new StandardServer({
+ *   appName: 'MyApp',
+ *   appVersion: '1.0.0',
+ *   port: 8080
+ * });
+ * await server.initialize();
+ * await server.start();
+ */
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,SAAS,EACT,OAAO,IAAI,MAAM,EACjB,YAAY,IAAI,gBAAgB,GACjC,MAAM,aAAa,CAAC;AAIrB;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,OAGxC;AAGD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAG3D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;GAaG"}

package/dist/core/index.js

@@ -0,0 +1,40 @@
+/**
+ * Core Framework Components
+ *
+ * These are generic, reusable components that could be extracted
+ * into a separate npm package for use in other applications.
+ */
+// Framework version
+export const FRAMEWORK_VERSION = "4.4.0";
+// Process Management
+export { StandardServer, createStandardServer } from "./StandardServer.js";
+export { clearPort, isPortAvailable, getPortInfo, getProcessOnPort, findAvailablePort, checkRequiredPorts, formatPortStatus, waitForPort, getPortsInUse, } from "./portUtils.js";
+// Logging - Consolidated logger implementation
+export { getLogger, default as Logger, createLogger as createLoggerBase, } from "./logger.js";
+import { createLogger as createLoggerImport } from "./logger.js";
+/**
+ * Create a logger instance with automatic file output
+ * @param name - The name/category for this logger
+ * @returns A logger instance that writes to console and files
+ */
+export function createLogger(name) {
+    // Use the createLogger function from logger
+    return createLoggerImport(name);
+}
+// Security
+export { getStorageService, StorageService, getSecureFileHandler, SecureFileHandler, } from "./storageService.js";
+/**
+ * Usage Example:
+ *
+ * import { StandardServer, createLogger } from '@/core';
+ *
+ * const logger = createLogger('MyApp');
+ * const server = new StandardServer({
+ *   appName: 'MyApp',
+ *   appVersion: '1.0.0',
+ *   port: 8080
+ * });
+ * await server.initialize();
+ * await server.start();
+ */
+//# sourceMappingURL=index.js.map