fix(routing): unify route based architecture

ts/proxies/smart-proxy/route-manager.ts

@@ -58,36 +58,88 @@ export class RouteManager extends plugins.EventEmitter {
   
   /**
    * Rebuild the port mapping for fast lookups
+   * Also logs information about the ports being listened on
    */
   private rebuildPortMap(): void {
     this.portMap.clear();
-    
+    this.portRangeCache.clear(); // Clear cache when rebuilding
+
+    // Track ports for logging
+    const portToRoutesMap = new Map<number, string[]>();
+
     for (const route of this.routes) {
       const ports = this.expandPortRange(route.match.ports);
-      
+
+      // Skip if no ports were found
+      if (ports.length === 0) {
+        console.warn(`Route ${route.name || 'unnamed'} has no valid ports to listen on`);
+        continue;
+      }
+
       for (const port of ports) {
+        // Add to portMap for routing
         if (!this.portMap.has(port)) {
           this.portMap.set(port, []);
         }
         this.portMap.get(port)!.push(route);
+
+        // Add to tracking for logging
+        if (!portToRoutesMap.has(port)) {
+          portToRoutesMap.set(port, []);
+        }
+        portToRoutesMap.get(port)!.push(route.name || 'unnamed');
+      }
+    }
+
+    // Log summary of ports and routes
+    const totalPorts = this.portMap.size;
+    const totalRoutes = this.routes.length;
+    console.log(`Route manager configured with ${totalRoutes} routes across ${totalPorts} ports`);
+
+    // Log port details if detailed logging is enabled
+    const enableDetailedLogging = this.options.enableDetailedLogging;
+    if (enableDetailedLogging) {
+      for (const [port, routes] of this.portMap.entries()) {
+        console.log(`Port ${port}: ${routes.length} routes (${portToRoutesMap.get(port)!.join(', ')})`);
       }
     }
   }
   
   /**
    * Expand a port range specification into an array of individual ports
+   * Uses caching to improve performance for frequently used port ranges
+   *
+   * @public - Made public to allow external code to interpret port ranges
    */
-  private expandPortRange(portRange: TPortRange): number[] {
+  public expandPortRange(portRange: TPortRange): number[] {
+    // For simple number, return immediately
     if (typeof portRange === 'number') {
       return [portRange];
     }
-    
+
+    // Create a cache key for this port range
+    const cacheKey = JSON.stringify(portRange);
+
+    // Check if we have a cached result
+    if (this.portRangeCache.has(cacheKey)) {
+      return this.portRangeCache.get(cacheKey)!;
+    }
+
+    // Process the port range
+    let result: number[] = [];
+
     if (Array.isArray(portRange)) {
       // Handle array of port objects or numbers
-      return portRange.flatMap(item => {
+      result = portRange.flatMap(item => {
         if (typeof item === 'number') {
           return [item];
         } else if (typeof item === 'object' && 'from' in item && 'to' in item) {
+          // Handle port range object - check valid range
+          if (item.from > item.to) {
+            console.warn(`Invalid port range: from (${item.from}) > to (${item.to})`);
+            return [];
+          }
+
           // Handle port range object
           const ports: number[] = [];
           for (let p = item.from; p <= item.to; p++) {
@@ -98,14 +150,24 @@ export class RouteManager extends plugins.EventEmitter {
         return [];
       });
     }
-    
-    return [];
+
+    // Cache the result
+    this.portRangeCache.set(cacheKey, result);
+
+    return result;
   }
   
+  /**
+   * Memoization cache for expanded port ranges
+   */
+  private portRangeCache: Map<string, number[]> = new Map();
+
   /**
    * Get all ports that should be listened on
+   * This method automatically infers all required ports from route configurations
    */
   public getListeningPorts(): number[] {
+    // Return the unique set of ports from all routes
     return Array.from(this.portMap.keys());
   }