kempo-server 1.7.3 → 1.7.5

package/dist/utils/cli.js

@@ -0,0 +1 @@
+import{spawn}from"child_process";import readline from"readline";export const getArgs=(mapping={})=>{const args={};let name="",values=[];const save=()=>{name&&(0===values.length?args[name]=!0:1===values.length?"false"===values[0]?args[name]=!1:args[name]=values[0]:args[name]=values)};for(let i=2;i<process.argv.length;i++){const arg=process.argv[i];arg.startsWith("-")?(save(),arg.startsWith("--")?name=arg.slice(2):(name=arg.slice(1),mapping[name]&&(name=mapping[name])),values=[]):values.push(arg)}return save(),args};export const runChildProcess=command=>new Promise((resolve,reject)=>{const[cmd,...args]=command.split(" "),child=spawn(cmd,args,{stdio:"inherit",shell:!0});child.on("close",code=>{0===code?resolve(`child process exited with code ${code}`):reject(new Error(`child process exited with code ${code}`))}),child.on("error",reject)});export const runChildNodeProcess=(scriptPath,argsObj={})=>{const command=`node ${scriptPath} ${Object.entries(argsObj).flatMap(([key,value])=>!0===value?[`--${key}`]:[`--${key}`,value]).join(" ")}`;return runChildProcess(command)};export const runChildNodeProcessScript=scriptPath=>{const child=spawn("node",[scriptPath],{stdio:"inherit",shell:!0});return new Promise((resolve,reject)=>{child.on("close",code=>{0===code?resolve():reject(new Error(`Process exited with code ${code}`))}),child.on("error",reject)})};export const promptUser=query=>{const rl=readline.createInterface({input:process.stdin,output:process.stdout});return new Promise(resolve=>{rl.question(`${query}: `,answer=>{rl.close(),resolve(answer)})})};export const promptYN=(query,defaultValue="y")=>promptUser(`${query} (${"y"===defaultValue?"Y/n":"y/N"}): `).then(answer=>{const normalizedAnswer=answer.trim().toLowerCase();return""===normalizedAnswer?"y"===defaultValue:"y"===normalizedAnswer});

package/dist/utils/fs-utils.js

@@ -0,0 +1 @@
+import fs from"fs/promises";import path from"path";export const ensureDir=async dirPath=>{try{await fs.mkdir(dirPath,{recursive:!0})}catch(error){if("EEXIST"!==error.code)throw error}};export const copyDir=async(src,dest)=>{await ensureDir(dest);const entries=await fs.readdir(src,{withFileTypes:!0});for(const entry of entries){const srcPath=path.join(src,entry.name),destPath=path.join(dest,entry.name);entry.isDirectory()?await copyDir(srcPath,destPath):await fs.copyFile(srcPath,destPath)}};export const emptyDir=async dirPath=>{try{const entries=await fs.readdir(dirPath);await Promise.all(entries.map(entry=>fs.rm(path.join(dirPath,entry),{recursive:!0,force:!0})))}catch(error){if("ENOENT"!==error.code)throw error}};

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "kempo-server",
   "type": "module",
-  "version": "1.7.3",
+  "version": "1.7.5",
   "description": "A lightweight, zero-dependency, file based routing server.",
   "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./utils/cli": "./dist/utils/cli.js",
+    "./utils/fs-utils": "./dist/utils/fs-utils.js"
+  },
   "bin": {
     "kempo-server": "./dist/index.js"
   },
   "scripts": {
     "build": "node scripts/build.js",
-    "start": "node dist/index.js -r ./docs",
+    "docs": "node dist/index.js -r ./docs",
     "tests": "npx kempo-test",
     "tests:gui": "npx kempo-test --gui",
     "tests:browser": "npx kempo-test -b",

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/tests/router-wildcard-double-asterisk.node-test.js

@@ -169,5 +169,71 @@ export default {
     } catch(e){ 
       fail(e.message); 
     }
+  },
+
+  'wildcard routes serve nested files from server root': async ({pass, fail, log}) => {
+    try {
+      await withTempDir(async (dir) => {
+        // Create nested file structure in src directory
+        const importFile = await write(dir, 'src/components/Import.js', 'export default ImportComponent');
+        const utilsFile = await write(dir, 'src/utils/helpers.js', 'export const helpers = {}');
+        const deepFile = await write(dir, 'src/deep/nested/file.js', 'export const nested = true');
+        
+        // Create index.html in server root
+        await write(dir, 'index.html', '<h1>Home</h1>');
+        
+        const prev = process.cwd();
+        process.chdir(dir);
+        
+        // Server root is the current directory (dir)
+        const flags = {root: '.', logging: 0, scan: false};
+        const logFn = () => {};
+        
+        // Configure wildcard route to serve from ./src/**
+        const config = {
+          customRoutes: {
+            '/src/**': './src/**'
+          }
+        };
+        
+        await write(dir, '.config.json', JSON.stringify(config));
+        const handler = await router(flags, logFn);
+        const server = http.createServer(handler);
+        const port = randomPort();
+        
+        await new Promise(r => server.listen(port, r));
+        await new Promise(r => setTimeout(r, 50));
+        
+        try {
+          // Test that /src/components/Import.js is served correctly
+          const r1 = await httpGet(`http://localhost:${port}/src/components/Import.js`);
+          log('Import.js status: ' + r1.res.statusCode);
+          if(r1.res.statusCode !== 200) throw new Error(`Expected 200, got ${r1.res.statusCode}`);
+          if(r1.body.toString() !== 'export default ImportComponent') throw new Error('Import.js content mismatch');
+          
+          // Test deeper nested file
+          const r2 = await httpGet(`http://localhost:${port}/src/utils/helpers.js`);
+          log('helpers.js status: ' + r2.res.statusCode);
+          if(r2.res.statusCode !== 200) throw new Error(`Expected 200 for helpers.js, got ${r2.res.statusCode}`);
+          
+          // Test very deeply nested file
+          const r3 = await httpGet(`http://localhost:${port}/src/deep/nested/file.js`);
+          log('deep nested file status: ' + r3.res.statusCode);
+          if(r3.res.statusCode !== 200) throw new Error(`Expected 200 for deep nested file, got ${r3.res.statusCode}`);
+          
+          // Test that index.html still works (non-wildcard route)
+          const r4 = await httpGet(`http://localhost:${port}/index.html`);
+          log('index.html status: ' + r4.res.statusCode);
+          if(r4.res.statusCode !== 200) throw new Error(`Expected 200 for index.html, got ${r4.res.statusCode}`);
+          
+        } finally { 
+          server.close(); 
+          process.chdir(prev); 
+        }
+      });
+      pass('wildcard routes serve nested files from server root');
+    } catch(e){ 
+      fail(e.message); 
+    }
   }
 };

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);
-}