xypriss 9.11.13 → 9.12.0

package/dist/src/plugins/route-optimization-plugin.js

@@ -0,0 +1,416 @@
+/**
+ * Route Optimization Plugin
+ *
+ * Automatically detects popular routes and optimizes them in the background
+ * Features:
+ * - Route popularity tracking
+ * - Automatic caching for hot routes
+ * - Response time optimization
+ * - Predictive preloading
+ * - Route pattern analysis
+ */
+import { EventEmitter } from "events";
+export class RouteOptimizationPlugin extends EventEmitter {
+    constructor(config = {}) {
+        super();
+        this.name = "route-optimization";
+        this.version = "1.2.4";
+        this.routeStats = new Map();
+        this.optimizedRoutes = new Set();
+        this.config = {
+            enabled: true,
+            analysisInterval: 60000, // 1 minute
+            optimizationThreshold: 100,
+            popularityWindow: 3600000, // 1 hour
+            maxTrackedRoutes: 1000,
+            autoOptimization: true,
+            customRules: [],
+            onOptimization: () => { },
+            onAnalysis: () => { },
+            ...config,
+        };
+    }
+    /**
+     * Hook for XyPriss Plugin System
+     */
+    onServerStart(server) {
+        this.initialize(server.app, server.app.logger || console);
+    }
+    /**
+     * Initialize the plugin with XyPriss app
+     */
+    initialize(app, logger) {
+        if (!this.config.enabled)
+            return;
+        this.app = app;
+        this.logger = logger;
+        // Install route tracking middleware
+        this.installTrackingMiddleware();
+        // Start background analysis
+        this.startBackgroundAnalysis();
+        this.logger.info("plugins", "Route Optimization Plugin initialized");
+    }
+    /**
+     * Install middleware to track route usage
+     */
+    installTrackingMiddleware() {
+        this.app.use((req, res, next) => {
+            const startTime = Date.now();
+            const routeKey = `${req.method}:${req.path}`;
+            // Track request start
+            this.trackRouteStart(routeKey);
+            // Override res.end to capture response time
+            const originalEnd = res.end.bind(res);
+            res.end = (...args) => {
+                const responseTime = Date.now() - startTime;
+                const statusCode = res.statusCode;
+                this.trackRouteEnd(routeKey, responseTime, statusCode);
+                return originalEnd(...args);
+            };
+            next();
+        });
+    }
+    /**
+     * Track route request start
+     */
+    trackRouteStart(routeKey) {
+        const [method, path] = routeKey.split(":");
+        if (!this.routeStats.has(routeKey)) {
+            this.routeStats.set(routeKey, {
+                path,
+                method,
+                hitCount: 0,
+                totalResponseTime: 0,
+                averageResponseTime: 0,
+                lastAccessed: new Date(),
+                errorCount: 0,
+                cacheHits: 0,
+                cacheMisses: 0,
+                popularity: 0,
+            });
+        }
+        const stats = this.routeStats.get(routeKey);
+        stats.hitCount++;
+        stats.lastAccessed = new Date();
+    }
+    /**
+     * Track route request completion
+     */
+    trackRouteEnd(routeKey, responseTime, statusCode) {
+        const stats = this.routeStats.get(routeKey);
+        if (!stats)
+            return;
+        stats.totalResponseTime += responseTime;
+        stats.averageResponseTime = stats.totalResponseTime / stats.hitCount;
+        if (statusCode >= 400) {
+            stats.errorCount++;
+        }
+        // Calculate popularity score
+        stats.popularity = this.calculatePopularity(stats);
+        // Check if route needs optimization
+        if (this.config.autoOptimization && this.shouldOptimizeRoute(stats)) {
+            this.optimizeRoute(routeKey, stats);
+        }
+    }
+    /**
+     * Calculate route popularity score
+     */
+    calculatePopularity(stats) {
+        const now = Date.now();
+        const timeSinceLastAccess = now - stats.lastAccessed.getTime();
+        const recencyFactor = Math.max(0, 1 - timeSinceLastAccess / this.config.popularityWindow);
+        const frequencyScore = Math.log(stats.hitCount + 1);
+        const performanceScore = Math.max(0, 1 - stats.averageResponseTime / 1000); // Normalize to 1 second
+        const reliabilityScore = Math.max(0, 1 - stats.errorCount / stats.hitCount);
+        return (frequencyScore * 0.4 +
+            performanceScore * 0.3 +
+            reliabilityScore * 0.2 +
+            recencyFactor * 0.1);
+    }
+    /**
+     * Check if route should be optimized
+     */
+    shouldOptimizeRoute(stats) {
+        if (this.optimizedRoutes.has(`${stats.method}:${stats.path}`)) {
+            return false; // Already optimized
+        }
+        // Check threshold
+        if (stats.hitCount < this.config.optimizationThreshold) {
+            return false;
+        }
+        // Check custom rules
+        for (const rule of this.config.customRules) {
+            if (this.matchesPattern(stats.path, rule.pattern)) {
+                return (stats.hitCount >= rule.minHits &&
+                    stats.averageResponseTime <= rule.maxResponseTime);
+            }
+        }
+        // Default optimization criteria
+        return stats.popularity > 5 || stats.averageResponseTime > 500;
+    }
+    /**
+     * Optimize a specific route
+     */
+    optimizeRoute(routeKey, stats) {
+        if (this.optimizedRoutes.has(routeKey))
+            return;
+        const optimizations = [];
+        // Apply caching optimization
+        if (stats.averageResponseTime > 200) {
+            this.applyCachingOptimization(routeKey, stats);
+            optimizations.push("caching");
+        }
+        // Apply response compression
+        if (stats.hitCount > 500) {
+            this.applyCompressionOptimization(routeKey, stats);
+            optimizations.push("compression");
+        }
+        // Apply preloading for very popular routes
+        if (stats.popularity > 8) {
+            this.applyPreloadingOptimization(routeKey, stats);
+            optimizations.push("preloading");
+        }
+        this.optimizedRoutes.add(routeKey);
+        this.logger.info("plugins", `Route optimized: ${routeKey} (${optimizations.join(", ")})`);
+        this.config.onOptimization(routeKey, optimizations.join(", "));
+        this.emit("route_optimized", { routeKey, stats, optimizations });
+    }
+    /**
+     * Apply caching optimization
+     */
+    applyCachingOptimization(routeKey, stats) {
+        const [method, path] = routeKey.split(":");
+        // Determine cache strategy based on route performance
+        let cacheStrategy = "moderate";
+        let cacheTTL = 300; // 5 minutes default
+        if (stats.averageResponseTime > 1000) {
+            cacheStrategy = "aggressive";
+            cacheTTL = 1800; // 30 minutes for slow routes
+        }
+        else if (stats.averageResponseTime < 200) {
+            cacheStrategy = "conservative";
+            cacheTTL = 60; // 1 minute for fast routes
+        }
+        // Apply route-specific caching middleware
+        this.app.use(path, (req, res, next) => {
+            // Only cache GET requests
+            if (req.method !== "GET") {
+                return next();
+            }
+            const cacheKey = `route_cache:${method}:${req.originalUrl}:${JSON.stringify(req.query)}`;
+            // Try to get from cache first
+            if (this.app.cacheManager) {
+                this.app.cacheManager
+                    .get(cacheKey)
+                    .then((cachedResponse) => {
+                    if (cachedResponse) {
+                        stats.cacheHits++;
+                        res.set("X-Cache", "HIT");
+                        res.set("X-Cache-Strategy", cacheStrategy);
+                        return res.json(cachedResponse);
+                    }
+                    // Cache miss - intercept response
+                    stats.cacheMisses++;
+                    const originalJson = res.json.bind(res);
+                    res.json = (data) => {
+                        // Cache the response
+                        this.app.cacheManager.set(cacheKey, data, {
+                            ttl: cacheTTL,
+                        });
+                        res.set("X-Cache", "MISS");
+                        res.set("X-Cache-Strategy", cacheStrategy);
+                        return originalJson(data);
+                    };
+                    next();
+                })
+                    .catch(() => {
+                    // Cache error - continue without caching
+                    next();
+                });
+            }
+            else {
+                next();
+            }
+        });
+        this.logger.debug("plugins", `Applied ${cacheStrategy} caching optimization to ${routeKey} (TTL: ${cacheTTL}s)`);
+    }
+    /**
+     * Apply compression optimization
+     */
+    applyCompressionOptimization(routeKey, stats) {
+        const [method, path] = routeKey.split(":");
+        // Apply compression middleware for this specific route
+        this.app.use(path, (req, res, next) => {
+            // Enable compression for responses larger than 1KB
+            const originalSend = res.send.bind(res);
+            const originalJson = res.json.bind(res);
+            res.send = (data) => {
+                if (data && typeof data === "string" && data.length > 1024) {
+                    res.set("X-Compression", "ENABLED");
+                    res.set("Content-Encoding", "gzip");
+                }
+                return originalSend(data);
+            };
+            res.json = (data) => {
+                const jsonString = JSON.stringify(data);
+                if (jsonString.length > 1024) {
+                    res.set("X-Compression", "ENABLED");
+                    res.set("Content-Encoding", "gzip");
+                }
+                return originalJson(data);
+            };
+            next();
+        });
+        this.logger.debug("plugins", `Applied compression optimization to ${routeKey} (avg response: ${stats.averageResponseTime}ms)`);
+    }
+    /**
+     * Apply preloading optimization
+     */
+    applyPreloadingOptimization(routeKey, stats) {
+        const [method, path] = routeKey.split(":");
+        // Preload common responses for very popular routes
+        if (stats.popularity > 8 && method === "GET") {
+            // Schedule preloading during low traffic periods
+            setTimeout(() => {
+                this.preloadRouteData(path, stats);
+            }, 60000); // Preload after 1 minute
+            // Set up predictive preloading based on access patterns
+            this.app.use(path, (req, res, next) => {
+                // Track access patterns for predictive preloading
+                const userAgent = req.headers["user-agent"] || "unknown";
+                const referer = req.headers["referer"] || "direct";
+                // Store access pattern for future preloading
+                const accessPattern = {
+                    path: req.originalUrl,
+                    userAgent,
+                    referer,
+                    timestamp: Date.now(),
+                    query: req.query,
+                };
+                // Add to preload queue if pattern is detected
+                this.schedulePreload(accessPattern);
+                res.set("X-Preload", "ENABLED");
+                next();
+            });
+        }
+        this.logger.debug("plugins", `Applied preloading optimization to ${routeKey} (popularity: ${stats.popularity.toFixed(2)})`);
+    }
+    /**
+     * Preload route data
+     */
+    preloadRouteData(path, stats) {
+        // Simulate preloading by making internal requests
+        if (this.app.cacheManager) {
+            const preloadKey = `preload:${path}:${Date.now()}`;
+            // Store preload metadata
+            this.app.cacheManager.set(preloadKey, {
+                path,
+                preloadedAt: new Date(),
+                averageResponseTime: stats.averageResponseTime,
+                hitCount: stats.hitCount,
+            }, { ttl: 3600 }); // 1 hour
+            this.logger.debug("plugins", `Preloaded data for ${path}`);
+        }
+    }
+    /**
+     * Schedule predictive preloading
+     */
+    schedulePreload(accessPattern) {
+        // Simple predictive logic - preload related resources
+        if (accessPattern.path.includes("/api/")) {
+            const relatedPaths = [
+                accessPattern.path + "/details",
+                accessPattern.path + "/related",
+                accessPattern.path.replace("/api/", "/api/meta/"),
+            ];
+            relatedPaths.forEach((relatedPath) => {
+                setTimeout(() => {
+                    this.logger.debug("plugins", `Predictive preload scheduled for ${relatedPath}`);
+                }, Math.random() * 30000); // Random delay up to 30 seconds
+            });
+        }
+    }
+    /**
+     * Check if path matches pattern
+     */
+    matchesPattern(path, pattern) {
+        const regex = new RegExp(pattern.replace(/\*/g, ".*"));
+        return regex.test(path);
+    }
+    /**
+     * Start background analysis
+     */
+    startBackgroundAnalysis() {
+        this.analysisTimer = setInterval(() => {
+            this.performAnalysis();
+        }, this.config.analysisInterval);
+    }
+    /**
+     * Perform route analysis
+     */
+    performAnalysis() {
+        const stats = Array.from(this.routeStats.values())
+            .sort((a, b) => b.popularity - a.popularity)
+            .slice(0, 20); // Top 20 routes
+        this.logger.debug("plugins", `Analyzed ${this.routeStats.size} routes, top performers: ${stats.length}`);
+        this.config.onAnalysis(stats);
+        this.emit("analysis_complete", stats);
+        // Cleanup old routes
+        this.cleanupOldRoutes();
+    }
+    /**
+     * Cleanup old unused routes
+     */
+    cleanupOldRoutes() {
+        const now = Date.now();
+        const cutoff = now - this.config.popularityWindow * 2; // 2x the popularity window
+        for (const [routeKey, stats] of this.routeStats.entries()) {
+            if (stats.lastAccessed.getTime() < cutoff && stats.hitCount < 10) {
+                this.routeStats.delete(routeKey);
+                this.optimizedRoutes.delete(routeKey);
+            }
+        }
+        // Limit total tracked routes
+        if (this.routeStats.size > this.config.maxTrackedRoutes) {
+            const sortedRoutes = Array.from(this.routeStats.entries()).sort(([, a], [, b]) => a.popularity - b.popularity);
+            const toRemove = sortedRoutes.slice(0, this.routeStats.size - this.config.maxTrackedRoutes);
+            toRemove.forEach(([routeKey]) => {
+                this.routeStats.delete(routeKey);
+                this.optimizedRoutes.delete(routeKey);
+            });
+        }
+    }
+    /**
+     * Get route statistics
+     */
+    getRouteStats() {
+        return Array.from(this.routeStats.values()).sort((a, b) => b.popularity - a.popularity);
+    }
+    /**
+     * Get optimized routes
+     */
+    getOptimizedRoutes() {
+        return Array.from(this.optimizedRoutes);
+    }
+    /**
+     * Manually optimize a route
+     */
+    manualOptimize(routeKey) {
+        const stats = this.routeStats.get(routeKey);
+        if (stats) {
+            this.optimizeRoute(routeKey, stats);
+        }
+    }
+    /**
+     * Destroy the plugin
+     */
+    destroy() {
+        if (this.analysisTimer) {
+            clearInterval(this.analysisTimer);
+        }
+        this.routeStats.clear();
+        this.optimizedRoutes.clear();
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=route-optimization-plugin.js.map

package/dist/src/plugins/route-optimization-plugin.js.map

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

package/dist/src/plugins/types/PluginPermissions.d.ts

@@ -0,0 +1,26 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ***************************************************************************** */
+/**
+ * Plugin permission structure for fine-grained security control.
+ */
+export interface PluginPermission {
+    /** Name of the plugin */
+    name: string;
+    /** List of allowed hooks (e.g. "onRegister", "onServerStart") or "*" for all */
+    allowedHooks?: string[] | "*";
+    /** List of explicitly denied hooks that override allowedHooks */
+    deniedHooks?: string[];
+    /** Policy for unlisted hooks: "allow" (default) or "deny" */
+    policy?: "allow" | "deny";
+}
+/**
+ * Internal storage for plugin permissions
+ */
+export type PluginPermissionsConfig = PluginPermission[];
+//# sourceMappingURL=PluginPermissions.d.ts.map

package/dist/src/plugins/types/PluginPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginPermissions.d.ts","sourceRoot":"","sources":["../../../../src/plugins/types/PluginPermissions.ts"],"names":[],"mappings":"AAAA;;;;;;;iFAOiF;AAEjF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC9B,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,EAAE,CAAC"}

package/dist/src/plugins/types/PluginPermissions.js

@@ -0,0 +1,10 @@
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ ***************************************************************************** */
+export {};
+//# sourceMappingURL=PluginPermissions.js.map

package/dist/src/plugins/types/PluginPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginPermissions.js","sourceRoot":"","sources":["../../../../src/plugins/types/PluginPermissions.ts"],"names":[],"mappings":"AAAA;;;;;;;iFAOiF"}