kempo-server 1.7.4 → 1.7.5

package/scripts/build.js

@@ -6,9 +6,52 @@ import { fileURLToPath } from 'url';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const rootDir = join(__dirname, '..');
 const srcDir = join(rootDir, 'src');
+const utilsDir = join(rootDir, 'utils');
 const distDir = join(rootDir, 'dist');
 const docsDir = join(rootDir, 'docs');
 
+/*
+  File Processing Helper
+*/
+const processJsFile = async (srcPath, distPath) => {
+  const fileName = distPath.split(/[/\\]/).pop();
+  console.log(`Minifying ${fileName}...`);
+  
+  // Read source file
+  let sourceCode = await readFile(srcPath, 'utf8');
+  
+  // Check for and preserve shebang
+  let shebang = '';
+  if (sourceCode.startsWith('#!')) {
+    const firstNewline = sourceCode.indexOf('\n');
+    shebang = sourceCode.substring(0, firstNewline + 1);
+    sourceCode = sourceCode.substring(firstNewline + 1);
+  }
+  
+  // Minify with Terser
+  const result = await minify(sourceCode, {
+    module: true, // Enable ES module support
+    format: {
+      comments: false,
+    },
+    compress: {
+      dead_code: true,
+      drop_console: false,
+      drop_debugger: true,
+    },
+    mangle: false, // Keep function names for better debugging
+  });
+  
+  if (result.error) {
+    throw new Error(`Minification failed for ${fileName}: ${result.error}`);
+  }
+  
+  // Write minified file to dist with shebang if it existed
+  const finalCode = shebang + result.code;
+  await writeFile(distPath, finalCode);
+  console.log(`✓ Built ${fileName}`);
+};
+
 /*
   Build Process
 */
@@ -16,53 +59,24 @@ const build = async () => {
   try {
     // Ensure dist directory exists
     await mkdir(distDir, { recursive: true });
+    await mkdir(join(distDir, 'utils'), { recursive: true });
     
     console.log('Building JavaScript files...');
     
-    // Get all JS files in src directory
-    const files = await readdir(srcDir);
-    const jsFiles = files.filter(file => file.endsWith('.js'));
+    // Process src directory
+    const srcFiles = await readdir(srcDir);
+    const srcJsFiles = srcFiles.filter(file => file.endsWith('.js'));
+    
+    for (const file of srcJsFiles) {
+      await processJsFile(join(srcDir, file), join(distDir, file));
+    }
+    
+    // Process utils directory
+    const utilsFiles = await readdir(utilsDir);
+    const utilsJsFiles = utilsFiles.filter(file => file.endsWith('.js'));
     
-    // Process each JS file
-    for (const file of jsFiles) {
-      const srcPath = join(srcDir, file);
-      const distPath = join(distDir, file);
-      
-      console.log(`Minifying ${file}...`);
-      
-      // Read source file
-      let sourceCode = await readFile(srcPath, 'utf8');
-      
-      // Check for and preserve shebang
-      let shebang = '';
-      if (sourceCode.startsWith('#!')) {
-        const firstNewline = sourceCode.indexOf('\n');
-        shebang = sourceCode.substring(0, firstNewline + 1);
-        sourceCode = sourceCode.substring(firstNewline + 1);
-      }
-      
-      // Minify with Terser
-      const result = await minify(sourceCode, {
-        module: true, // Enable ES module support
-        format: {
-          comments: false,
-        },
-        compress: {
-          dead_code: true,
-          drop_console: false,
-          drop_debugger: true,
-        },
-        mangle: false, // Keep function names for better debugging
-      });
-      
-      if (result.error) {
-        throw new Error(`Minification failed for ${file}: ${result.error}`);
-      }
-      
-      // Write minified file to dist with shebang if it existed
-      const finalCode = shebang + result.code;
-      await writeFile(distPath, finalCode);
-      console.log(`✓ Built ${file}`);
+    for (const file of utilsJsFiles) {
+      await processJsFile(join(utilsDir, file), join(distDir, 'utils', file));
     }
     
     console.log('Copying kempo.min.css to docs...');

package/config-examples/development.config.json

@@ -1,24 +0,0 @@
-{
-  "_comment": "Development configuration with aggressive file watching and conservative memory usage",
-  "cache": {
-    "enabled": true,
-    "maxSize": 50,
-    "maxMemoryMB": 25,
-    "ttlMs": 300000,
-    "maxHeapUsagePercent": 65,
-    "memoryCheckInterval": 15000,
-    "watchFiles": true,
-    "enableMemoryMonitoring": true
-  },
-  "middleware": {
-    "cors": {
-      "enabled": true,
-      "origin": "*"
-    },
-    "logging": {
-      "enabled": true,
-      "includeUserAgent": true,
-      "includeResponseTime": true
-    }
-  }
-}

package/config-examples/low-memory.config.json

@@ -1,23 +0,0 @@
-{
-  "_comment": "Low-memory configuration for resource-constrained environments",
-  "cache": {
-    "enabled": true,
-    "maxSize": 20,
-    "maxMemoryMB": 5,
-    "ttlMs": 120000,
-    "maxHeapUsagePercent": 60,
-    "memoryCheckInterval": 10000,
-    "watchFiles": true,
-    "enableMemoryMonitoring": true
-  },
-  "middleware": {
-    "compression": {
-      "enabled": true,
-      "threshold": 512
-    },
-    "logging": {
-      "enabled": true,
-      "includeResponseTime": false
-    }
-  }
-}

package/config-examples/no-cache.config.json

@@ -1,13 +0,0 @@
-{
-  "_comment": "Cache disabled configuration for debugging or special environments",
-  "cache": {
-    "enabled": false
-  },
-  "middleware": {
-    "logging": {
-      "enabled": true,
-      "includeUserAgent": true,
-      "includeResponseTime": true
-    }
-  }
-}

package/config-examples/production.config.json

@@ -1,38 +0,0 @@
-{
-  "_comment": "Production configuration with large cache and disabled file watching",
-  "cache": {
-    "enabled": true,
-    "maxSize": 1000,
-    "maxMemoryMB": 200,
-    "ttlMs": 3600000,
-    "maxHeapUsagePercent": 85,
-    "memoryCheckInterval": 60000,
-    "watchFiles": false,
-    "enableMemoryMonitoring": true
-  },
-  "middleware": {
-    "cors": {
-      "enabled": true,
-      "origin": ["https://myapp.com", "https://www.myapp.com"],
-      "credentials": true
-    },
-    "compression": {
-      "enabled": true,
-      "threshold": 1024
-    },
-    "security": {
-      "enabled": true,
-      "headers": {
-        "X-Content-Type-Options": "nosniff",
-        "X-Frame-Options": "DENY",
-        "X-XSS-Protection": "1; mode=block",
-        "Strict-Transport-Security": "max-age=31536000; includeSubDomains"
-      }
-    },
-    "logging": {
-      "enabled": true,
-      "includeUserAgent": false,
-      "includeResponseTime": true
-    }
-  }
-}

package/example-cache.config.json

@@ -1,45 +0,0 @@
-{
-  "cache": {
-    "enabled": true,
-    "maxSize": 200,
-    "maxMemoryMB": 75,
-    "ttlMs": 600000,
-    "maxHeapUsagePercent": 75,
-    "memoryCheckInterval": 15000,
-    "watchFiles": true,
-    "enableMemoryMonitoring": true,
-    "production": {
-      "maxSize": 1000,
-      "maxMemoryMB": 200,
-      "ttlMs": 3600000,
-      "maxHeapUsagePercent": 85,
-      "memoryCheckInterval": 60000,
-      "watchFiles": false
-    }
-  },
-  "middleware": {
-    "cors": {
-      "enabled": true,
-      "origin": "*",
-      "methods": ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
-      "headers": ["Content-Type", "Authorization"]
-    },
-    "compression": {
-      "enabled": true,
-      "threshold": 1024
-    },
-    "security": {
-      "enabled": true,
-      "headers": {
-        "X-Content-Type-Options": "nosniff",
-        "X-Frame-Options": "DENY",
-        "X-XSS-Protection": "1; mode=block"
-      }
-    },
-    "logging": {
-      "enabled": true,
-      "includeUserAgent": false,
-      "includeResponseTime": true
-    }
-  }
-}

package/example.config.json

@@ -1,50 +0,0 @@
-{
-  "allowedMimes": {
-    "html": "text/html",
-    "css": "text/css",
-    "js": "application/javascript",
-    "json": "application/json",
-    "png": "image/png",
-    "jpg": "image/jpeg"
-  },
-  "middleware": {
-    "cors": {
-      "enabled": true,
-      "origin": ["http://localhost:3000", "https://mydomain.com"],
-      "methods": ["GET", "POST", "PUT", "DELETE"],
-      "headers": ["Content-Type", "Authorization", "X-API-Key"]
-    },
-    "compression": {
-      "enabled": true,
-      "threshold": 512
-    },
-    "rateLimit": {
-      "enabled": true,
-      "maxRequests": 50,
-      "windowMs": 60000,
-      "message": "Rate limit exceeded. Please try again later."
-    },
-    "security": {
-      "enabled": true,
-      "headers": {
-        "X-Content-Type-Options": "nosniff",
-        "X-Frame-Options": "SAMEORIGIN",
-        "X-XSS-Protection": "1; mode=block",
-        "Strict-Transport-Security": "max-age=31536000; includeSubDomains"
-      }
-    },
-    "logging": {
-      "enabled": true,
-      "includeUserAgent": true,
-      "includeResponseTime": true
-    },
-    "custom": [
-      "./middleware/auth.js",
-      "./middleware/analytics.js"
-    ]
-  },
-  "customRoutes": {
-    "api/*": "./api-handlers/*",
-    "/vendor/bootstrap.css": "./node_modules/bootstrap/dist/css/bootstrap.min.css"
-  }
-}

package/utils/cache-demo.js

@@ -1,145 +0,0 @@
-#!/usr/bin/env node
-
-/*
-  Cache Demo Script
-  Demonstrates the module cache functionality with real-time monitoring
-*/
-
-import path from 'path';
-import { writeFile, unlink, mkdir, rm } from 'fs/promises';
-import ModuleCache from '../src/moduleCache.js';
-
-const createDemoFiles = async (demoDir) => {
-  await mkdir(demoDir, { recursive: true });
-  
-  // Create some demo route files
-  await writeFile(path.join(demoDir, 'users.js'), 
-    'export default async (req, res) => res.json({ users: ["alice", "bob"] });'
-  );
-  
-  await writeFile(path.join(demoDir, 'posts.js'), 
-    'export default async (req, res) => res.json({ posts: ["post1", "post2"] });'
-  );
-  
-  await writeFile(path.join(demoDir, 'auth.js'), 
-    'export default async (req, res) => res.json({ authenticated: true });'
-  );
-  
-  return [
-    path.join(demoDir, 'users.js'),
-    path.join(demoDir, 'posts.js'), 
-    path.join(demoDir, 'auth.js')
-  ];
-};
-
-const simulateFileAccess = async (cache, filePaths) => {
-  const { stat } = await import('fs/promises');
-  
-  for(const filePath of filePaths) {
-    const stats = await stat(filePath);
-    
-    // Try to get from cache first
-    let module = cache.get(filePath, stats);
-    
-    if(!module) {
-      // Simulate loading module
-      const fileUrl = `file://${filePath}?t=${Date.now()}`;
-      module = await import(fileUrl);
-      cache.set(filePath, module, stats, stats.size / 1024);
-    }
-    
-    console.log(`📁 ${path.basename(filePath)}: ${module ? '✅ cached' : '❌ loaded fresh'}`);
-  }
-};
-
-const displayCacheStats = (cache) => {
-  console.log('\n📊 Cache Statistics:');
-  console.log('─'.repeat(40));
-  
-  const stats = cache.getStats();
-  console.log(`Entries: ${stats.cache.size}/${stats.cache.maxSize}`);
-  console.log(`Memory: ${stats.cache.memoryUsageMB}/${stats.cache.maxMemoryMB}MB`);
-  console.log(`Hit Rate: ${cache.getHitRate()}%`);
-  console.log(`Hits: ${stats.stats.hits}, Misses: ${stats.stats.misses}`);
-  console.log(`File Changes: ${stats.stats.fileChanges}`);
-  console.log(`Heap Usage: ${stats.memory.heapUsedMB}MB (${stats.memory.heapUsagePercent}%)`);
-  
-  if(stats.cache.size > 0) {
-    console.log('\n📋 Cached Files:');
-    const cachedFiles = cache.getCachedFiles();
-    cachedFiles.forEach(file => {
-      const ageSeconds = Math.round(file.age / 1000);
-      console.log(`  • ${file.relativePath} (${file.sizeKB.toFixed(1)}KB, ${ageSeconds}s old)`);
-    });
-  }
-  console.log();
-};
-
-const main = async () => {
-  console.log('🚀 Kempo Server Module Cache Demo\n');
-  
-  // Create demo directory and files
-  const demoDir = path.join(process.cwd(), 'demo-cache-test');
-  console.log('📝 Creating demo files...');
-  const filePaths = await createDemoFiles(demoDir);
-  
-  // Initialize cache with small limits for demo
-  const cache = new ModuleCache({
-    maxSize: 2,
-    maxMemoryMB: 1,
-    ttlMs: 5000, // 5 seconds
-    watchFiles: true,
-    enableMemoryMonitoring: true
-  });
-  
-  console.log('✅ Cache initialized\n');
-  
-  try {
-    // Round 1: Initial loads (cache misses)
-    console.log('🔄 Round 1: Initial file access (expect cache misses)');
-    await simulateFileAccess(cache, filePaths);
-    displayCacheStats(cache);
-    
-    // Round 2: Immediate re-access (cache hits)
-    console.log('🔄 Round 2: Immediate re-access (expect cache hits)');
-    await simulateFileAccess(cache, [filePaths[0], filePaths[1]]);
-    displayCacheStats(cache);
-    
-    // Round 3: Add third file (should evict oldest due to maxSize=2)
-    console.log('🔄 Round 3: Access third file (expect LRU eviction)');
-    await simulateFileAccess(cache, [filePaths[2]]);
-    displayCacheStats(cache);
-    
-    // Round 4: Wait for TTL expiration
-    console.log('⏱️  Waiting 6 seconds for TTL expiration...');
-    await new Promise(resolve => setTimeout(resolve, 6000));
-    
-    console.log('🔄 Round 4: Access after TTL expiration (expect cache misses)');
-    await simulateFileAccess(cache, [filePaths[1]]);
-    displayCacheStats(cache);
-    
-    // Round 5: Demonstrate file watching
-    console.log('📝 Round 5: Modifying file to test file watching...');
-    await writeFile(filePaths[1], 
-      'export default async (req, res) => res.json({ posts: ["updated post"] });'
-    );
-    
-    // Wait for file watcher to detect change
-    await new Promise(resolve => setTimeout(resolve, 200));
-    
-    console.log('🔄 Accessing modified file (expect cache invalidation)');
-    await simulateFileAccess(cache, [filePaths[1]]);
-    displayCacheStats(cache);
-    
-  } finally {
-    // Cleanup
-    console.log('🧹 Cleaning up...');
-    cache.destroy();
-    await rm(demoDir, { recursive: true });
-    console.log('✅ Demo completed successfully!');
-  }
-};
-
-if(import.meta.url === `file://${process.argv[1]}`) {
-  main().catch(console.error);
-}

package/utils/cache-monitor.js

@@ -1,132 +0,0 @@
-#!/usr/bin/env node
-
-/*
-  Cache Monitor Utility
-  Displays real-time cache statistics and memory usage
-*/
-
-import { spawn } from 'child_process';
-import { pathToFileURL } from 'url';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const formatBytes = (bytes) => {
-  const mb = bytes / 1024 / 1024;
-  return `${mb.toFixed(2)}MB`;
-};
-
-const formatPercent = (value) => `${value.toFixed(1)}%`;
-
-const clearScreen = () => process.stdout.write('\x1b[2J\x1b[0f');
-
-const displayStats = (stats) => {
-  clearScreen();
-  console.log('='.repeat(60));
-  console.log('📦 KEMPO SERVER - MODULE CACHE MONITOR');
-  console.log('='.repeat(60));
-  console.log();
-  
-  if (!stats) {
-    console.log('❌ Cache not available or disabled');
-    return;
-  }
-  
-  const { cache, stats: cacheStats, memory, config } = stats;
-  
-  // Cache Status
-  console.log('📊 CACHE STATUS');
-  console.log('-'.repeat(30));
-  console.log(`Entries:     ${cache.size}/${cache.maxSize} (${((cache.size/cache.maxSize)*100).toFixed(1)}%)`);
-  console.log(`Memory:      ${cache.memoryUsageMB}/${cache.maxMemoryMB}MB (${((cache.memoryUsageMB/cache.maxMemoryMB)*100).toFixed(1)}%)`);
-  console.log(`Watchers:    ${cache.watchersActive} active`);
-  console.log();
-  
-  // Performance Stats
-  console.log('⚡ PERFORMANCE');
-  console.log('-'.repeat(30));
-  const total = cacheStats.hits + cacheStats.misses;
-  const hitRate = total === 0 ? 0 : (cacheStats.hits / total * 100);
-  console.log(`Hit Rate:    ${hitRate.toFixed(1)}% (${cacheStats.hits} hits, ${cacheStats.misses} misses)`);
-  console.log(`Evictions:   ${cacheStats.evictions}`);
-  console.log(`File Changes: ${cacheStats.fileChanges}`);
-  console.log();
-  
-  // Memory Info
-  console.log('🧠 NODE.JS MEMORY');
-  console.log('-'.repeat(30));
-  console.log(`Heap Used:   ${memory.heapUsedMB}MB (${memory.heapUsagePercent}%)`);
-  console.log(`Heap Total:  ${memory.heapTotalMB}MB`);
-  console.log(`RSS:         ${memory.rssMB}MB`);
-  console.log();
-  
-  // Configuration
-  console.log('⚙️  CONFIGURATION');
-  console.log('-'.repeat(30));
-  console.log(`TTL:         ${Math.round(config.ttlMs / 1000)}s`);
-  console.log(`Max Heap:    ${config.maxHeapUsagePercent}%`);
-  console.log(`File Watch:  ${config.watchFiles ? '✅' : '❌'}`);
-  console.log();
-  
-  console.log(`Last updated: ${new Date().toLocaleTimeString()}`);
-  console.log('Press Ctrl+C to exit');
-};
-
-// Simulate getting stats from a running server
-// In a real implementation, you'd expose an endpoint or use IPC
-const getStatsFromServer = async () => {
-  // This is a placeholder - in practice you'd either:
-  // 1. Add an admin endpoint to your server that returns cache stats
-  // 2. Use process communication to get stats from the running server
-  // 3. Log stats to a file that this script reads
-  
-  // For demonstration, return mock stats
-  return {
-    cache: {
-      size: Math.floor(Math.random() * 100),
-      maxSize: 100,
-      memoryUsageMB: Math.random() * 50,
-      maxMemoryMB: 50,
-      watchersActive: Math.floor(Math.random() * 50)
-    },
-    stats: {
-      hits: Math.floor(Math.random() * 1000),
-      misses: Math.floor(Math.random() * 200),
-      evictions: Math.floor(Math.random() * 50),
-      fileChanges: Math.floor(Math.random() * 10)
-    },
-    memory: {
-      heapUsedMB: 45 + Math.random() * 20,
-      heapTotalMB: 70 + Math.random() * 30,
-      heapUsagePercent: 60 + Math.random() * 20,
-      rssMB: 80 + Math.random() * 40
-    },
-    config: {
-      ttlMs: 300000,
-      maxHeapUsagePercent: 70,
-      watchFiles: true
-    }
-  };
-};
-
-const main = async () => {
-  console.log('Starting cache monitor...');
-  
-  setInterval(async () => {
-    try {
-      const stats = await getStatsFromServer();
-      displayStats(stats);
-    } catch (error) {
-      console.error('Error getting stats:', error.message);
-    }
-  }, 2000); // Update every 2 seconds
-};
-
-// Handle Ctrl+C gracefully
-process.on('SIGINT', () => {
-  console.log('\n\n👋 Cache monitor stopped');
-  process.exit(0);
-});
-
-if (import.meta.url === pathToFileURL(process.argv[1]).href) {
-  main();
-}