queen-mq 0.2.0 → 0.2.11

package/src/server.js

@@ -1,1633 +0,0 @@
-import uWS from 'uWebSockets.js';
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import config from './config.js';
-import { createPool, initDatabase } from './database/connection.js';
-import { createOptimizedQueueManager } from './managers/queueManagerOptimized.js';
-import { createResourceCache } from './managers/resourceCache.js';
-import { createEventManager } from './managers/eventManager.js';
-import { SystemEventManager, SYSTEM_QUEUE } from './managers/systemEventManager.js';
-import { syncSystemEvents } from './services/startupSync.js';
-//import { createQueenClient } from './client/queenClient.js';
-import { createPushRoute } from './routes/push.js';
-import { createPopRoute } from './routes/pop.js';
-import { createAckRoute } from './routes/ack.js';
-import { createConfigureRoute } from './routes/configure.js';
-import { createMessagesRoutes } from './routes/messages.js';
-import { createResourcesRoutes } from './routes/resources.js';
-import { createStatusRoutes } from './routes/status.js';
-import { createWebSocketServer } from './websocket/wsServer.js';
-import { initEncryption } from './services/encryptionService.js';
-import { startRetentionJob } from './services/retentionService.js';
-import { startEvictionJob } from './services/evictionService.js';
-import { log } from './utils/logger.js';
-import { streamJSON, sendJSON, sendError } from './utils/streaming.js';
-import { generateUUID } from './utils/uuid.js';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-/**
- * Start Queen MQ Server
- * @param {Object} options - Server configuration options
- * @param {number} options.port - Server port (default: from config)
- * @param {string} options.host - Server host (default: from config)
- * @param {string} options.workerId - Worker ID for clustering (default: from config)
- * @param {boolean} options.serveWebapp - Serve the built frontend from /webapp/dist (default: false)
- * @param {string} options.webappPath - Path to webapp dist folder (default: '../webapp/dist')
- * @returns {Promise<Object>} Server instance with shutdown method
- */
-export async function QueenServer(options = {}) {
-  const PORT = options.port || config.SERVER.PORT;
-  const HOST = options.host || config.SERVER.HOST;
-  const SERVE_WEBAPP = options.serveWebapp || false;
-  
-  // Default webapp path: try src/webapp-dist (npm package), fall back to ../webapp/dist (development)
-  let defaultWebappPath = path.join(__dirname, 'webapp-dist');
-  if (!fs.existsSync(defaultWebappPath)) {
-    defaultWebappPath = path.join(__dirname, '..', 'webapp', 'dist');
-  }
-  const WEBAPP_PATH = options.webappPath || defaultWebappPath;
-
-  // Use WORKER_ID from config as the server instance ID for consumer groups
-  // This ensures the same server (identified by WORKER_ID) maintains its position in the event stream
-  const SERVER_INSTANCE_ID = options.workerId || config.SERVER.WORKER_ID;
-
-  const SKIP_DATABASE_MIGRATION = (options.skipDatabaseMigration  || process.env.SKIP_DATABASE_MIGRATION) || false;
-
-  // Performance monitoring
-  let requestCount = 0;
-  let messageCount = 0;
-  const startTime = Date.now();
-
-  // Shutdown flag to prevent background jobs from running during shutdown
-  let isShuttingDown = false;
-
-  // Initialize components
-  const pool = createPool();
-  const resourceCache = createResourceCache();
-  const eventManager = createEventManager();
-
-  // Initialize system event manager
-  const systemEventManager = new SystemEventManager(pool, SERVER_INSTANCE_ID);
-
-  // Register cache event handlers
-  resourceCache.registerEventHandlers(systemEventManager);
-
-  // Always use optimized queue manager - it's better for all scenarios
-  const queueManager = createOptimizedQueueManager(pool, resourceCache, eventManager, systemEventManager);
-  const messagesRoutes = createMessagesRoutes(pool, queueManager);
-  const resourcesRoutes = createResourcesRoutes(pool, systemEventManager);
-  const statusRoutes = createStatusRoutes(pool);
-
-  // Initialize database with migrations
-  const initDatabaseWithMigrations = async () => {
-    // Run base schema
-    await initDatabase(pool);
-    
-    // Run extension migrations
-    const migrationPath = path.join(__dirname, '..', 'migrations', '001-extend-features.sql');
-    if (fs.existsSync(migrationPath)) {
-      const migration = fs.readFileSync(migrationPath, 'utf8');
-      try {
-        await pool.query(migration);
-        log('✅ Extension features migration applied');
-      } catch (error) {
-        if (!error.message.includes('already exists')) {
-          log('Migration error:', error);
-        }
-      }
-    }
-  };
-
-  if (!SKIP_DATABASE_MIGRATION) {
-    await initDatabaseWithMigrations();
-  }
-
-  // Initialize system queue
-  async function initializeSystemQueue() {
-    try {
-      // Direct database operation to create system queue
-      await pool.query(`
-        INSERT INTO queen.queues (name, ttl, priority, max_queue_size)
-        VALUES ($1, 300, 100, 10000)
-        ON CONFLICT (name) DO UPDATE SET
-          ttl = EXCLUDED.ttl,
-          priority = EXCLUDED.priority,
-          max_queue_size = EXCLUDED.max_queue_size
-      `, [SYSTEM_QUEUE]);
-      
-      await pool.query(`
-        INSERT INTO queen.partitions (queue_id, name)
-        SELECT id, 'Default' FROM queen.queues WHERE name = $1
-        ON CONFLICT (queue_id, name) DO NOTHING
-      `, [SYSTEM_QUEUE]);
-      
-      log('✅ System event queue initialized');
-    } catch (error) {
-      console.error('Failed to initialize system queue:', error);
-      throw error;
-    }
-  }
-
-  await initializeSystemQueue();
-
-  // Initialize extended features
-  log('🚀 Initializing Queen Services...');
-
-  // 1. Encryption service
-  const encryptionEnabled = initEncryption();
-
-  // 2. Retention service
-  const stopRetention = startRetentionJob(pool);
-
-  // 3. Eviction service
-  const stopEviction = startEvictionJob(pool, eventManager);
-
-  // Background job for lease reclamation
-  const leaseReclaimInterval = setInterval(async () => {
-    if (isShuttingDown) return;
-    try {
-      const reclaimed = await queueManager.reclaimExpiredLeases();
-      if (reclaimed > 0) {
-        log(`Reclaimed ${reclaimed} expired leases`);
-      }
-    } catch (error) {
-      if (!isShuttingDown) {
-        log('Error reclaiming leases:', error);
-      }
-    }
-  }, config.JOBS.LEASE_RECLAIM_INTERVAL);
-
-  // Create server
-  const app = uWS.App();
-
-  // Initialize WebSocket server
-  const wsServer = createWebSocketServer(app, eventManager);
-
-  // Background job for queue depth updates
-  const queueDepthInterval = setInterval(async () => {
-    if (isShuttingDown) return;
-    try {
-      await wsServer.updateQueueDepths(queueManager);
-    } catch (error) {
-      if (!isShuttingDown) {
-        log('Error updating queue depths:', error);
-      }
-    }
-  }, config.JOBS.QUEUE_DEPTH_UPDATE_INTERVAL);
-
-  // Background job for system stats
-  const systemStatsInterval = setInterval(async () => {
-    if (isShuttingDown) return;
-    try {
-      await wsServer.sendSystemStats(pool);
-    } catch (error) {
-      if (!isShuttingDown) {
-        log('Error sending system stats:', error);
-      }
-    }
-  }, config.JOBS.SYSTEM_STATS_UPDATE_INTERVAL);
-
-  // CORS headers helper
-  const setCorsHeaders = (res) => {
-    res.writeHeader('Access-Control-Allow-Origin', config.API.CORS_ALLOWED_ORIGINS);
-    res.writeHeader('Access-Control-Allow-Methods', config.API.CORS_ALLOWED_METHODS);
-    res.writeHeader('Access-Control-Allow-Headers', config.API.CORS_ALLOWED_HEADERS);
-    res.writeHeader('Access-Control-Max-Age', config.API.CORS_MAX_AGE.toString());
-  };
-
-  // Helper to read JSON body
-  const readJson = (res, cb, abortedRef) => {
-    let buffer;
-    const maxBodySize = config.API.MAX_BODY_SIZE; // 10MB max body size
-    
-    res.onData((ab, isLast) => {
-      const chunk = Buffer.from(ab);
-      
-      // Check size limit
-      const currentSize = (buffer ? buffer.length : 0) + chunk.length;
-      if (currentSize > maxBodySize) {
-        if (abortedRef && abortedRef.aborted) return;
-        res.writeStatus(config.HTTP_STATUS.BAD_REQUEST.toString()).end(JSON.stringify({ error: 'Request body too large' }));
-        return;
-      }
-      
-      if (isLast) {
-        let json;
-        try {
-          let fullData;
-          if (buffer) {
-            fullData = Buffer.concat([buffer, chunk]);
-          } else {
-            fullData = chunk;
-          }
-          
-          const jsonString = fullData.toString('utf8');
-          
-          // Debug large payloads
-          if (jsonString.length > 1000000) {
-            log(`Parsing large JSON: ${jsonString.length} bytes, starts with: ${jsonString.substring(0, 100)}`);
-          }
-          
-          json = JSON.parse(jsonString);
-        } catch (e) {
-          if (abortedRef && abortedRef.aborted) return;
-          // Log the actual error for debugging  
-          log(`JSON parse error: ${e.message}`);
-          
-          // Log what we're trying to parse for debugging
-          let sample = '';
-          if (buffer) {
-            const fullData = Buffer.concat([buffer, chunk]);
-            sample = fullData.toString('utf8').substring(0, 200);
-          } else {
-            sample = chunk.toString('utf8').substring(0, 200);
-          }
-          log(`Failed to parse data starting with: ${sample}`);
-          
-          res.writeStatus(config.HTTP_STATUS.BAD_REQUEST.toString()).end(JSON.stringify({ error: 'Invalid JSON' }));
-          return;
-        }
-        cb(json);
-      } else {
-        if (buffer) {
-          buffer = Buffer.concat([buffer, chunk]);
-        } else {
-          buffer = Buffer.from(chunk);  // Ensure it's a Buffer
-        }
-      }
-    });
-  };
-
-  // Handle OPTIONS requests for CORS preflight
-  app.options('/*', (res, req) => {
-    res.onAborted(() => {
-      log('OPTIONS request aborted');
-    });
-    
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.NO_CONTENT.toString()).end();
-    });
-  });
-
-  // Configure route
-  app.post('/api/v1/configure', (res, req) => {
-    const abortedRef = { aborted: false };
-    res.onAborted(() => {
-      abortedRef.aborted = true;
-      log('Configure request aborted');
-    });
-    
-    readJson(res, async (body) => {
-      if (abortedRef.aborted) return;
-      try {
-        const result = await createConfigureRoute(queueManager)(body);
-        if (abortedRef.aborted) return;
-        eventManager.emit('queue.created', result);
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus(config.HTTP_STATUS.CREATED.toString()).end(JSON.stringify(result));
-        });
-      } catch (error) {
-        if (abortedRef.aborted) return;
-        log('Configure error:', error);
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-        });
-      }
-    }, abortedRef);
-  });
-
-  // Push route
-  app.post('/api/v1/push', (res, req) => {
-    const abortedRef = { aborted: false };
-    res.onAborted(() => {
-      abortedRef.aborted = true;
-      log('Push request aborted');
-    });
-    
-    readJson(res, async (body) => {
-      if (abortedRef.aborted) return;
-      try {
-        const result = await createPushRoute(queueManager)(body);
-        messageCount += result.messages.length;
-        requestCount++;
-        if (abortedRef.aborted) return;
-        
-        // Emit events for pushed messages
-        for (const msg of result.messages) {
-          if (msg.status === 'queued') {
-            const item = body.items.find(i => 
-              i.transactionId === msg.transactionId || !i.transactionId
-            );
-            if (item) {
-              const partition = item.partition ?? 'Default';
-              const queuePath = `${item.queue}/${partition}`;
-              eventManager.emit('message.pushed', {
-                queue: item.queue,
-                partition: partition,
-                transactionId: msg.transactionId
-              });
-              eventManager.notifyMessageAvailable(queuePath);
-            }
-          }
-        }
-        
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus(config.HTTP_STATUS.CREATED.toString()).end(JSON.stringify(result));
-        });
-      } catch (error) {
-        if (abortedRef.aborted) return;
-        log('Push error:', error.message || error);
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-        });
-      }
-    }, abortedRef);
-  });
-
-  // Pop routes with new structure
-  app.get('/api/v1/pop/queue/:queue/partition/:partition', (res, req) => {
-    const queue = req.getParameter(0);
-    const partition = req.getParameter(1);
-    const query = new URLSearchParams(req.getQuery());
-    
-    let aborted = false;
-    res.onAborted(() => {
-      aborted = true;
-      log('Pop request aborted');
-    });
-    
-    createPopRoute(queueManager, eventManager)(
-      { 
-        queue, 
-        partition,
-        consumerGroup: query.get('consumerGroup') || query.get('consumer_group')
-      },
-      {
-        wait: query.get('wait') === 'true',
-        timeout: parseInt(query.get('timeout') || config.QUEUE.DEFAULT_TIMEOUT.toString()),
-        batch: parseInt(query.get('batch') || config.QUEUE.DEFAULT_BATCH_SIZE.toString()),
-        subscriptionMode: query.get('subscriptionMode'),
-        subscriptionFrom: query.get('subscriptionFrom')
-      }
-    ).then(result => {
-      if (aborted) return;
-      
-      // Emit events for processing messages
-      for (const msg of result.messages) {
-        eventManager.emit('message.processing', {
-          queue: msg.queue,
-          partition: msg.partition,
-          transactionId: msg.transactionId,
-          workerId: `worker-${process.pid}`
-        });
-      }
-      
-      // Use streaming with backpressure for large responses
-      if (result.messages.length === 0) {
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus(config.HTTP_STATUS.NO_CONTENT.toString()).end();
-        });
-      } else {
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus(config.HTTP_STATUS.OK.toString());
-        });
-        streamJSON(res, result, { aborted });
-      }
-    }).catch(error => {
-      if (aborted) return;
-      log('Pop error:', error);
-      res.cork(() => {
-        setCorsHeaders(res);
-      });
-      sendError(res, error, config.HTTP_STATUS.INTERNAL_SERVER_ERROR);
-    });
-  });
-
-    app.get('/api/v1/pop/queue/:queue', (res, req) => {
-    const queue = req.getParameter(0);
-    const query = new URLSearchParams(req.getQuery());
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Pop request aborted');
-  });
-  
-    createPopRoute(queueManager, eventManager)(
-    { 
-      queue,
-      consumerGroup: query.get('consumerGroup') || query.get('consumer_group')
-    },
-    {
-      wait: query.get('wait') === 'true',
-      timeout: parseInt(query.get('timeout') || config.QUEUE.DEFAULT_TIMEOUT.toString()),
-      batch: parseInt(query.get('batch') || config.QUEUE.DEFAULT_BATCH_SIZE.toString()),
-      subscriptionMode: query.get('subscriptionMode'),
-      subscriptionFrom: query.get('subscriptionFrom')
-    }
-  ).then(result => {
-    if (aborted) return;
-    
-    for (const msg of result.messages) {
-      eventManager.emit('message.processing', {
-        queue: msg.queue,
-        partition: msg.partition,
-        transactionId: msg.transactionId,
-        workerId: `worker-${process.pid}`
-      });
-    }
-    
-    // Use streaming with backpressure for large responses
-    if (result.messages.length === 0) {
-      res.cork(() => {
-        setCorsHeaders(res);
-        res.writeStatus(config.HTTP_STATUS.NO_CONTENT.toString()).end();
-      });
-    } else {
-      res.cork(() => {
-        setCorsHeaders(res);
-        res.writeStatus(config.HTTP_STATUS.OK.toString());
-      });
-      streamJSON(res, result, { aborted });
-    }
-  }).catch(error => {
-    if (aborted) return;
-    log('Pop error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-    });
-    sendError(res, error, config.HTTP_STATUS.INTERNAL_SERVER_ERROR);
-  });
-});
-
-// Pop with filters (namespace or task)
-    app.get('/api/v1/pop', (res, req) => {
-    const query = new URLSearchParams(req.getQuery());
-    const namespace = query.get('namespace');
-    const task = query.get('task');
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Pop request aborted');
-  });
-  
-    createPopRoute(queueManager, eventManager)(
-    { 
-      namespace, 
-      task,
-      consumerGroup: query.get('consumerGroup') || query.get('consumer_group')
-    },
-    {
-      wait: query.get('wait') === 'true',
-      timeout: parseInt(query.get('timeout') || config.QUEUE.DEFAULT_TIMEOUT.toString()),
-      batch: parseInt(query.get('batch') || config.QUEUE.DEFAULT_BATCH_SIZE.toString()),
-      subscriptionMode: query.get('subscriptionMode'),
-      subscriptionFrom: query.get('subscriptionFrom')
-    }
-  ).then(result => {
-    if (aborted) return;
-    
-    for (const msg of result.messages) {
-      eventManager.emit('message.processing', {
-        queue: msg.queue,
-        partition: msg.partition,
-        transactionId: msg.transactionId,
-        workerId: `worker-${process.pid}`
-      });
-    }
-    
-    // Use streaming with backpressure for large responses
-    if (result.messages.length === 0) {
-      res.cork(() => {
-        setCorsHeaders(res);
-        res.writeStatus(config.HTTP_STATUS.NO_CONTENT.toString()).end();
-      });
-    } else {
-      res.cork(() => {
-        setCorsHeaders(res);
-        res.writeStatus(config.HTTP_STATUS.OK.toString());
-      });
-      streamJSON(res, result, { aborted });
-    }
-  }).catch(error => {
-    if (aborted) return;
-    log('Pop error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-    });
-    sendError(res, error, config.HTTP_STATUS.INTERNAL_SERVER_ERROR);
-  });
-});
-
-// ACK route
-    app.post('/api/v1/ack', (res, req) => {
-    const abortedRef = { aborted: false };
-    res.onAborted(() => {
-    abortedRef.aborted = true;
-    log('ACK request aborted');
-  });
-  
-    readJson(res, async (body) => {
-    if (abortedRef.aborted) return;
-    try {
-      const result = await createAckRoute(queueManager)(body);
-      if (abortedRef.aborted) return;
-      
-      // Emit completion or failure event
-      if (body.status === 'completed') {
-        eventManager.emit('message.completed', {
-          transactionId: body.transactionId
-        });
-      } else {
-        eventManager.emit('message.failed', {
-          transactionId: body.transactionId,
-          error: body.error
-        });
-      }
-      
-      res.cork(() => {
-        setCorsHeaders(res);
-        res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-      });
-    } catch (error) {
-      if (abortedRef.aborted) return;
-      log('ACK error:', error.message || error);
-      res.cork(() => {
-        res.writeStatus('500');
-        setCorsHeaders(res);
-        res.end(JSON.stringify({ error: error.message || 'Unknown error' }));
-      });
-    }
-  }, abortedRef);
-});
-
-// Batch ACK route
-    app.post('/api/v1/ack/batch', (res, req) => {
-    const abortedRef = { aborted: false };
-    res.onAborted(() => {
-    abortedRef.aborted = true;
-    log('Batch ACK request aborted');
-  });
-  
-    readJson(res, async (body) => {
-    if (abortedRef.aborted) return;
-    try {
-      const results = await queueManager.acknowledgeMessages(body.acknowledgments, body.consumerGroup);
-      if (abortedRef.aborted) return;
-      
-      // Emit events for each acknowledgment
-      for (const ack of body.acknowledgments) {
-        if (ack.status === 'completed') {
-          eventManager.emit('message.completed', {
-            transactionId: ack.transactionId
-          });
-        } else {
-          eventManager.emit('message.failed', {
-            transactionId: ack.transactionId,
-            error: ack.error
-          });
-        }
-      }
-      
-      res.cork(() => {
-        setCorsHeaders(res);
-        res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify({
-          processed: results.length,
-          results
-        }));
-      });
-    } catch (error) {
-      if (abortedRef.aborted) return;
-      log('Batch ACK error:', error);
-      res.cork(() => {
-        setCorsHeaders(res);
-        res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-      });
-    }
-  }, abortedRef);
-});
-
-// Lease extension endpoint
-app.post('/api/v1/lease/:leaseId/extend', (res, req) => {
-  const abortedRef = { aborted: false };
-  res.onAborted(() => { 
-    abortedRef.aborted = true;
-    log('Lease extension request aborted');
-  });
-  
-  const leaseId = req.getParameter(0);  // In uWebSockets.js, parameters are accessed by index
-  
-  readJson(res, async (body) => {
-    if (abortedRef.aborted) return;
-    
-    const { seconds = 60 } = body || {};
-    
-    try {
-      const result = await pool.query(`
-        UPDATE queen.partition_consumers
-        SET lease_expires_at = GREATEST(lease_expires_at, NOW() + INTERVAL '1 second' * $1)
-        WHERE worker_id = $2 AND lease_expires_at > NOW()
-        RETURNING lease_expires_at, partition_id
-      `, [seconds, leaseId]);
-      
-      if (result.rows.length === 0) {
-        if (!abortedRef.aborted) {
-          res.cork(() => {
-            setCorsHeaders(res);
-            res.writeStatus('404').end(JSON.stringify({ error: 'Lease not found or expired' }));
-          });
-        }
-        return;
-      }
-      
-      if (!abortedRef.aborted) {
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus('200').end(JSON.stringify({ 
-            leaseId,
-            newExpiresAt: result.rows[0].lease_expires_at
-          }));
-        });
-      }
-    } catch (error) {
-      if (!abortedRef.aborted) {
-        log('Lease extension error:', error);
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus('500').end(JSON.stringify({ error: error.message }));
-        });
-      }
-    }
-  }, abortedRef);
-});
-
-// Transaction endpoint
-app.post('/api/v1/transaction', (res, req) => {
-  const abortedRef = { aborted: false };
-  res.onAborted(() => { 
-    abortedRef.aborted = true;
-    log('Transaction request aborted');
-  });
-  
-  readJson(res, async (body) => {
-    if (abortedRef.aborted) return;
-    
-    const { operations = [], requiredLeases = [] } = body;
-    
-    if (!Array.isArray(operations) || operations.length === 0) {
-      if (!abortedRef.aborted) {
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus('400').end(JSON.stringify({ error: 'Operations array required' }));
-        });
-      }
-      return;
-    }
-    
-    try {
-      const results = await queueManager.executeTransaction(operations, requiredLeases);
-      
-      if (!abortedRef.aborted) {
-        const transactionId = generateUUID();
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus('200').end(JSON.stringify({
-            success: true,
-            results,
-            transactionId
-          }));
-        });
-      }
-    } catch (error) {
-      if (!abortedRef.aborted) {
-        log('Transaction error:', error);
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeStatus('400').end(JSON.stringify({ error: error.message }));
-        });
-      }
-    }
-  }, abortedRef);
-});
-
-// Messages routes
-    app.get('/api/v1/messages', (res, req) => {
-    const query = new URLSearchParams(req.getQuery());
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Messages list request aborted');
-  });
-  
-    const filters = {
-    ns: query.get('ns'),
-    task: query.get('task'),
-    queue: query.get('queue'),
-    status: query.get('status'),
-    limit: parseInt(query.get('limit') || config.API.DEFAULT_LIMIT.toString()),
-    offset: parseInt(query.get('offset') || config.API.DEFAULT_OFFSET.toString())
-  };
-  
-    messagesRoutes.listMessages(filters).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify({ messages: result }));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('List messages error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.get('/api/v1/messages/:transactionId', (res, req) => {
-    const transactionId = req.getParameter(0);
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Get message request aborted');
-  });
-  
-    messagesRoutes.getMessage(transactionId).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Get message error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(error.message === 'Message not found' ? config.HTTP_STATUS.NOT_FOUND.toString() : config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString())
-        .end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.del('/api/v1/messages/:transactionId', (res, req) => {
-    const transactionId = req.getParameter(0);
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Delete message request aborted');
-  });
-  
-    messagesRoutes.deleteMessage(transactionId).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Delete message error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(error.message === 'Message not found' ? config.HTTP_STATUS.NOT_FOUND.toString() : config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString())
-        .end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.post('/api/v1/messages/:transactionId/retry', (res, req) => {
-    const transactionId = req.getParameter(0);
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Retry message request aborted');
-  });
-  
-    messagesRoutes.retryMessage(transactionId).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Retry message error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.post('/api/v1/messages/:transactionId/dlq', (res, req) => {
-    const transactionId = req.getParameter(0);
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Move to DLQ request aborted');
-  });
-  
-    messagesRoutes.moveToDLQ(transactionId).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Move to DLQ error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.get('/api/v1/messages/:transactionId/related', (res, req) => {
-    const transactionId = req.getParameter(0);
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Get related messages request aborted');
-  });
-  
-    messagesRoutes.getRelatedMessages(transactionId).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify({ messages: result }));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Get related messages error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.del('/api/v1/queues/:queue/clear', (res, req) => {
-    const queue = req.getParameter(0);
-    const query = new URLSearchParams(req.getQuery());
-    const partition = query.get('partition');
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Clear queue request aborted');
-  });
-  
-    messagesRoutes.clearQueue(queue, partition).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Clear queue error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-// Resources routes
-    app.get('/api/v1/resources/queues', (res, req) => {
-    const query = new URLSearchParams(req.getQuery());
-    const namespace = query.get('namespace');
-    const task = query.get('task');
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Get queues request aborted');
-  });
-  
-    resourcesRoutes.getQueues({ namespace, task }).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify({ queues: result }));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Get queues error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.get('/api/v1/resources/queues/:queue', (res, req) => {
-    const queue = req.getParameter(0);
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Get queue request aborted');
-  });
-  
-    resourcesRoutes.getQueue(queue).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Get queue error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(error.message === 'Queue not found' ? config.HTTP_STATUS.NOT_FOUND.toString() : config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString())
-        .end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.get('/api/v1/resources/partitions', (res, req) => {
-    const query = new URLSearchParams(req.getQuery());
-    const queue = query.get('queue');
-    const minDepth = query.get('minDepth');
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Get partitions request aborted');
-  });
-  
-    resourcesRoutes.getPartitions({ queue, minDepth: minDepth ? parseInt(minDepth) : null }).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify({ partitions: result }));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Get partitions error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.get('/api/v1/resources/namespaces', (res, req) => {
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Get namespaces request aborted');
-  });
-  
-    resourcesRoutes.getNamespaces().then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify({ namespaces: result }));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Get namespaces error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.get('/api/v1/resources/tasks', (res, req) => {
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Get tasks request aborted');
-  });
-  
-    resourcesRoutes.getTasks().then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify({ tasks: result }));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Get tasks error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-    app.get('/api/v1/resources/overview', (res, req) => {
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Get overview request aborted');
-  });
-  
-    resourcesRoutes.getSystemOverview().then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Get overview error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-// Delete queue
-    app.del('/api/v1/resources/queues/:queue', (res, req) => {
-    const queue = req.getParameter(0);
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Delete queue request aborted');
-  });
-  
-    resourcesRoutes.deleteQueue(queue).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Delete queue error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-// ============================================================================
-// Status/Dashboard Routes (New unified API)
-// ============================================================================
-
-// 1. Dashboard Status - GET /api/v1/status
-    app.get('/api/v1/status', (res, req) => {
-    const query = new URLSearchParams(req.getQuery());
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Status request aborted');
-  });
-  
-    const filters = {
-    from: query.get('from'),
-    to: query.get('to'),
-    queue: query.get('queue'),
-    namespace: query.get('namespace'),
-    task: query.get('task')
-  };
-  
-    statusRoutes.getStatus(filters).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Status error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-// 2. Queues List - GET /api/v1/status/queues
-    app.get('/api/v1/status/queues', (res, req) => {
-    const query = new URLSearchParams(req.getQuery());
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Status queues request aborted');
-  });
-  
-    const filters = {
-    from: query.get('from'),
-    to: query.get('to'),
-    namespace: query.get('namespace'),
-    task: query.get('task'),
-    limit: query.get('limit'),
-    offset: query.get('offset')
-  };
-  
-    statusRoutes.getQueues(filters).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Status queues error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-// 3. Queue Detail - GET /api/v1/status/queues/:queueName
-    app.get('/api/v1/status/queues/:queue', (res, req) => {
-    const queueName = req.getParameter(0);
-    const query = new URLSearchParams(req.getQuery());
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Status queue detail request aborted');
-  });
-  
-    const filters = {
-    from: query.get('from'),
-    to: query.get('to')
-  };
-  
-    statusRoutes.getQueueDetail(queueName, filters).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Status queue detail error:', error);
-    const statusCode = error.message === 'Queue not found' 
-      ? config.HTTP_STATUS.NOT_FOUND 
-      : config.HTTP_STATUS.INTERNAL_SERVER_ERROR;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(statusCode.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-// 4. Queue Messages - GET /api/v1/status/queues/:queueName/messages
-    app.get('/api/v1/status/queues/:queue/messages', (res, req) => {
-    const queueName = req.getParameter(0);
-    const query = new URLSearchParams(req.getQuery());
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Status queue messages request aborted');
-  });
-  
-    const filters = {
-    status: query.get('status'),
-    partition: query.get('partition'),
-    from: query.get('from'),
-    to: query.get('to'),
-    limit: query.get('limit'),
-    offset: query.get('offset')
-  };
-  
-    statusRoutes.getQueueMessages(queueName, filters).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Status queue messages error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-// 5. Analytics - GET /api/v1/status/analytics
-    app.get('/api/v1/status/analytics', (res, req) => {
-    const query = new URLSearchParams(req.getQuery());
-  
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Status analytics request aborted');
-  });
-  
-    const filters = {
-    from: query.get('from'),
-    to: query.get('to'),
-    queue: query.get('queue'),
-    namespace: query.get('namespace'),
-    task: query.get('task'),
-    interval: query.get('interval') || 'hour'
-  };
-  
-    statusRoutes.getAnalytics(filters).then(result => {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(result));
-    });
-  }).catch(error => {
-    if (aborted) return;
-    log('Status analytics error:', error);
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end(JSON.stringify({ error: error.message }));
-    });
-  });
-});
-
-// Health check with performance stats
-    app.get('/health', async (res, req) => {
-    let aborted = false;
-    res.onAborted(() => {
-    aborted = true;
-    log('Health check aborted');
-  });
-  
-    try {
-    await pool.query('SELECT 1');
-    if (aborted) return;
-    
-    const uptime = (Date.now() - startTime) / 1000;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify({ 
-        status: 'healthy',
-        uptime: `${Math.floor(uptime)}s`,
-        connections: wsServer.getConnectionCount(),
-        stats: {
-          requests: requestCount,
-          messages: messageCount,
-          requestsPerSecond: (requestCount / uptime).toFixed(2),
-          messagesPerSecond: (messageCount / uptime).toFixed(2),
-          pool: {
-            total: pool.totalCount,
-            idle: pool.idleCount,
-            waiting: pool.waitingCount
-          }
-        }
-      }));
-    });
-  } catch (error) {
-    if (aborted) return;
-    res.cork(() => {
-      setCorsHeaders(res);
-      res.writeStatus(config.HTTP_STATUS.SERVICE_UNAVAILABLE.toString()).end(JSON.stringify({ 
-        status: 'unhealthy',
-        error: error.message
-      }));
-    });
-  }
-});
-
-// Metrics endpoint for performance monitoring
-    app.get('/metrics', (res, req) => {
-    res.onAborted(() => {
-    log('Metrics request aborted');
-  });
-  
-    const uptime = (Date.now() - startTime) / 1000;
-    const metrics = {
-    uptime: uptime,
-    requests: {
-      total: requestCount,
-      rate: requestCount / uptime
-    },
-    messages: {
-      total: messageCount,
-      rate: messageCount / uptime
-    },
-    database: {
-      poolSize: pool.totalCount,
-      idleConnections: pool.idleCount,
-      waitingRequests: pool.waitingCount
-    },
-    memory: process.memoryUsage(),
-    cpu: process.cpuUsage()
-  };
-  
-    res.cork(() => {
-    setCorsHeaders(res);
-    res.writeStatus(config.HTTP_STATUS.OK.toString()).end(JSON.stringify(metrics));
-  });
-});
-
-  // ============================================================================
-  // Static File Serving (Optional - for serving built frontend)
-  // ============================================================================
-
-  if (SERVE_WEBAPP) {
-    // Check if webapp directory exists
-    if (!fs.existsSync(WEBAPP_PATH)) {
-      log(`❌ ERROR: Webapp directory not found at: ${WEBAPP_PATH}`);
-      log(`💡 To enable frontend serving:`);
-      log(`   1. Build the webapp: cd webapp && npm install && npm run build`);
-      log(`   2. Or specify a custom path: QueenServer({ webappPath: '/path/to/dist' })`);
-      log(`   3. Or disable frontend: QueenServer({ serveWebapp: false })`);
-      throw new Error(`Webapp directory not found: ${WEBAPP_PATH}`);
-    }
-
-    const indexPath = path.join(WEBAPP_PATH, 'index.html');
-    if (!fs.existsSync(indexPath)) {
-      log(`❌ ERROR: index.html not found in webapp directory: ${WEBAPP_PATH}`);
-      log(`💡 Make sure the webapp is built: cd webapp && npm run build`);
-      throw new Error(`index.html not found in: ${WEBAPP_PATH}`);
-    }
-
-    log(`📁 Enabling static file serving from: ${WEBAPP_PATH}`);
-
-    // MIME type mapping
-    const getMimeType = (filePath) => {
-      const ext = path.extname(filePath).toLowerCase();
-      const mimeTypes = {
-        '.html': 'text/html; charset=utf-8',
-        '.js': 'application/javascript; charset=utf-8',
-        '.css': 'text/css; charset=utf-8',
-        '.json': 'application/json; charset=utf-8',
-        '.png': 'image/png',
-        '.jpg': 'image/jpeg',
-        '.jpeg': 'image/jpeg',
-        '.gif': 'image/gif',
-        '.svg': 'image/svg+xml',
-        '.ico': 'image/x-icon',
-        '.woff': 'font/woff',
-        '.woff2': 'font/woff2',
-        '.ttf': 'font/ttf',
-        '.eot': 'application/vnd.ms-fontobject'
-      };
-      return mimeTypes[ext] || 'application/octet-stream';
-    };
-
-    // Helper to serve static files
-    const serveStaticFile = async (res, filePath) => {
-      try {
-        // Security check - prevent directory traversal
-        const normalizedPath = path.normalize(filePath);
-        if (!normalizedPath.startsWith(WEBAPP_PATH)) {
-          res.writeStatus('403').end('Forbidden');
-          return;
-        }
-
-        // Check if file exists
-        if (!fs.existsSync(filePath)) {
-          return false; // File not found, let caller handle it
-        }
-
-        const stat = fs.statSync(filePath);
-        if (!stat.isFile()) {
-          return false;
-        }
-
-        // Read file
-        const content = fs.readFileSync(filePath);
-        const mimeType = getMimeType(filePath);
-
-        // Set cache headers for assets (fingerprinted files can be cached forever)
-        const isFingerprintedAsset = /\.[a-f0-9]{8}\.(js|css)$/.test(filePath);
-        
-        res.cork(() => {
-          setCorsHeaders(res);
-          res.writeHeader('Content-Type', mimeType);
-          res.writeHeader('Content-Length', content.length.toString());
-          
-          if (isFingerprintedAsset) {
-            res.writeHeader('Cache-Control', 'public, max-age=31536000, immutable');
-          } else if (filePath.endsWith('index.html')) {
-            res.writeHeader('Cache-Control', 'no-cache, no-store, must-revalidate');
-          } else {
-            res.writeHeader('Cache-Control', 'public, max-age=3600');
-          }
-          
-          res.writeStatus(config.HTTP_STATUS.OK.toString()).end(content);
-        });
-        
-        return true;
-      } catch (error) {
-        log('Error serving static file:', error);
-        res.writeStatus(config.HTTP_STATUS.INTERNAL_SERVER_ERROR.toString()).end('Internal Server Error');
-        return true;
-      }
-    };
-
-    // Serve static assets (JS, CSS, images, fonts, etc.)
-    app.get('/assets/*', async (res, req) => {
-      let aborted = false;
-      res.onAborted(() => {
-        aborted = true;
-      });
-
-      if (aborted) return;
-
-      const url = req.getUrl();
-      const filePath = path.join(WEBAPP_PATH, url);
-      
-      const served = await serveStaticFile(res, filePath);
-      if (!served && !aborted) {
-        res.writeStatus('404').end('Not Found');
-      }
-    });
-
-    // Serve root index.html
-    app.get('/', async (res, req) => {
-      let aborted = false;
-      res.onAborted(() => {
-        aborted = true;
-      });
-
-      if (aborted) return;
-
-      const indexPath = path.join(WEBAPP_PATH, 'index.html');
-      await serveStaticFile(res, indexPath);
-    });
-
-    // SPA fallback - serve index.html for all non-API, non-asset routes
-    // This enables client-side routing to work
-    app.get('/*', async (res, req) => {
-      let aborted = false;
-      res.onAborted(() => {
-        aborted = true;
-      });
-
-      if (aborted) return;
-
-      const url = req.getUrl();
-      
-      // Don't serve index.html for API routes or special endpoints
-      if (url.startsWith('/api/') || 
-          url.startsWith('/health') || 
-          url.startsWith('/metrics') ||
-          url.startsWith('/ws/')) {
-        res.writeStatus('404').end('Not Found');
-        return;
-      }
-
-      // First try to serve as a direct file (e.g., favicon.ico)
-      const directPath = path.join(WEBAPP_PATH, url);
-      const served = await serveStaticFile(res, directPath);
-      
-      // If file doesn't exist, serve index.html for SPA routing
-      if (!served && !aborted) {
-        const indexPath = path.join(WEBAPP_PATH, 'index.html');
-        await serveStaticFile(res, indexPath);
-      }
-    });
-
-    log(`✅ Static file serving enabled at http://${HOST}:${PORT}/`);
-  }
-
-// Variable to hold system event consumer stop function
-let stopSystemEventConsumer = null;
-
-// Start server
-app.listen(HOST, PORT, async (token) => {
-  if (token) {
-    log(`✅ Queen Server running at http://${HOST}:${PORT}`);
-    log(`📊 Features enabled:`);
-    log(`   - Encryption: ${encryptionEnabled ? '✅' : '❌ (set QUEEN_ENCRYPTION_KEY)'}`);
-    log(`   - System Events: ${config.SYSTEM_EVENTS.ENABLED ? '✅' : '❌ (disabled via config)'}`);
-    log(`   - Retention: ✅`);
-    log(`   - Eviction: ✅`);
-    log(`   - WebSocket Dashboard: ws://${HOST}:${PORT}/ws/dashboard`);
-    log(`   - Server Instance ID: ${SERVER_INSTANCE_ID}`);
-    if (SERVE_WEBAPP) {
-      log(`   - Frontend Dashboard: http://${HOST}:${PORT}/ ✅`);
-    }
-    
-    // Start system event synchronization and consumption (only if enabled)
-    if (config.SYSTEM_EVENTS.ENABLED) {
-      /*try { // TODO: Uncomment this when we have a way to synchronize system events
-        // Create temporary client for synchronization
-        const syncClient = createQueenClient({ 
-          baseUrl: `http://localhost:${PORT}` 
-        });
-        
-        // Synchronize system events (catch up on missed events)
-        await syncSystemEvents(syncClient, systemEventManager, SERVER_INSTANCE_ID);
-        
-        // Start consuming system events
-        // Note: consume() returns the stop function directly
-        stopSystemEventConsumer = syncClient.consume({
-          queue: SYSTEM_QUEUE,
-          consumerGroup: SERVER_INSTANCE_ID,
-          handler: async (message) => {
-            await systemEventManager.processSystemEvent(message.data);
-          },
-          options: {
-            batch: 10,
-            wait: true
-          }
-        });
-        
-        log(`✅ System event consumer started`);
-      } catch (error) {
-        log(`⚠️ Failed to start system event consumer: ${error.message}`);
-      }*/
-    }
-    
-    log(`🎯 Ready to process messages with high performance!`);
-  } else {
-    log(`Failed to start server on port ${PORT}`);
-    process.exit(1);
-  }
-});
-
-  // Graceful shutdown
-  const shutdown = async (signal) => {
-    log(`\n🛑 Received ${signal}, shutting down gracefully...`);
-    
-    // Set shutdown flag immediately to prevent new operations
-    isShuttingDown = true;
-    
-    // Stop system event consumer
-    if (stopSystemEventConsumer) {
-      stopSystemEventConsumer();
-      log('✅ System event consumer stopped');
-    }
-    
-    // Stop background jobs
-    if (stopRetention) {
-      stopRetention();
-      log('✅ Retention job stopped');
-    }
-    if (stopEviction) {
-      stopEviction();
-      log('✅ Eviction job stopped');
-    }
-    
-    // Clear background intervals
-    if (leaseReclaimInterval) {
-      clearInterval(leaseReclaimInterval);
-      log('✅ Lease reclaim interval stopped');
-    }
-    if (queueDepthInterval) {
-      clearInterval(queueDepthInterval);
-      log('✅ Queue depth update interval stopped');
-    }
-    if (systemStatsInterval) {
-      clearInterval(systemStatsInterval);
-      log('✅ System stats interval stopped');
-    }
-    
-    // Wait a moment for any in-flight operations to complete
-    await new Promise(resolve => setTimeout(resolve, 100));
-    
-    const uptime = (Date.now() - startTime) / 1000;
-    if (messageCount > 0) {
-      log(`📊 Final stats: ${messageCount} messages processed in ${uptime.toFixed(1)}s`);
-      log(`   Average: ${(messageCount / uptime).toFixed(2)} messages/second`);
-    }
-    
-    // Close database pool last
-    await pool.end();
-    log('✅ Database pool closed');
-    
-    process.exit(0);
-  };
-
-  process.on('SIGTERM', () => shutdown('SIGTERM'));
-  process.on('SIGINT', () => shutdown('SIGINT'));
-
-  // Return server instance with shutdown method
-  return {
-    port: PORT,
-    host: HOST,
-    shutdown,
-    app
-  };
-}
-
-// Auto-start server if run directly (not imported)
-if (import.meta.url === `file://${process.argv[1]}`) {
-  QueenServer().catch(error => {
-    console.error('Failed to start Queen server:', error);
-    process.exit(1);
-  });
-}