kempo-server 1.7.6 → 1.7.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kempo-server",
   "type": "module",
-  "version": "1.7.6",
+  "version": "1.7.7",
   "description": "A lightweight, zero-dependency, file based routing server.",
   "main": "dist/index.js",
   "exports": {

package/tests/router-wildcard-double-asterisk.node-test.js

@@ -13,8 +13,8 @@ export default {
         const fileC = await write(dir, 'src/deep/nested/folder/file.js', 'export const deep = true');
         
         // Create files in docs directory that should be ignored when custom routes match
-        await write(dir, 'docs/src/components/Button.js', 'WRONG FILE');
-        await write(dir, 'docs/src/utils/helpers/format.js', 'WRONG FILE');
+        await write(dir, 'docs/src/components/Button.js', '// WRONG FILE');
+        await write(dir, 'docs/src/utils/helpers/format.js', '// WRONG FILE');
         
         const prev = process.cwd();
         process.chdir(dir);
@@ -70,12 +70,12 @@ export default {
   'single asterisk only matches single path segments': async ({pass, fail, log}) => {
     try {
       await withTempDir(async (dir) => {
-        // Create nested file structure
-        await write(dir, 'src/file.js', 'single level');
-        await write(dir, 'src/nested/file.js', 'nested level');
+        // Create files at different nesting levels
+        await write(dir, 'src/file.js', '// single level');
+        await write(dir, 'src/nested/file.js', '// nested level');
         
-        // Create fallback file in docs
-        await write(dir, 'docs/src/nested/file.js', 'fallback file');
+        // Create docs directory with fallback file
+        await write(dir, 'docs/src/nested/file.js', '// fallback file');
         
         const prev = process.cwd();
         process.chdir(dir);
@@ -103,13 +103,13 @@ export default {
           const r1 = await httpGet(`http://localhost:${port}/src/file.js`);
           log('single level status: ' + r1.res.statusCode);
           if(r1.res.statusCode !== 200) throw new Error('single level 200');
-          if(r1.body.toString() !== 'single level') throw new Error('single level content');
+          if(r1.body.toString() !== '// single level') throw new Error('single level content');
           
           // Nested level should NOT work with single asterisk, should fall back to docs
           const r2 = await httpGet(`http://localhost:${port}/src/nested/file.js`);
           log('nested level status: ' + r2.res.statusCode);
           if(r2.res.statusCode !== 200) throw new Error('nested level 200');
-          if(r2.body.toString() !== 'fallback file') throw new Error('nested level should use fallback');
+          if(r2.body.toString() !== '// fallback file') throw new Error('nested level should use fallback');
           
         } finally { 
           server.close(); 
@@ -125,12 +125,12 @@ export default {
   'wildcard routes take precedence over static files': async ({pass, fail, log}) => {
     try {
       await withTempDir(async (dir) => {
-        // Create source files
-        await write(dir, 'custom/data.json', '{"source": "custom"}');
-        
-        // Create static files in docs that should be overridden
+        // Create static file in docs
         await write(dir, 'docs/api/data.json', '{"source": "static"}');
         
+        // Create custom file outside docs
+        await write(dir, 'custom/data.json', '{"source": "custom"}');
+        
         const prev = process.cwd();
         process.chdir(dir);
         
@@ -174,13 +174,11 @@ export default {
   '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>');
+        // Create additional test files needed for this specific test
+        await write(dir, 'src/components/Import.js', 'export default ImportComponent');
+        await write(dir, 'src/utils/helpers.js', 'export const helpers = {}');
+        await write(dir, 'src/deep/nested/file.js', 'export const deep = true');
+        await write(dir, 'index.html', '<html><body>Test Index</body></html>');
         
         const prev = process.cwd();
         process.chdir(dir);
@@ -220,6 +218,7 @@ export default {
           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}`);
+          if(r3.body.toString() !== 'export const deep = true') throw new Error('Deep nested file content mismatch');
           
           // Test that index.html still works (non-wildcard route)
           const r4 = await httpGet(`http://localhost:${port}/index.html`);

package/tests/router-wildcard.node-test.js

@@ -13,8 +13,8 @@ export default {
         const fileC = await write(dir, 'src/deep/nested/folder/file.js', 'export const deep = true');
         
         // Create files in docs directory that should be ignored when custom routes match
-        await write(dir, 'docs/src/components/Button.js', 'WRONG FILE');
-        await write(dir, 'docs/src/utils/helpers/format.js', 'WRONG FILE');
+        await write(dir, 'docs/src/components/Button.js', '// WRONG FILE');
+        await write(dir, 'docs/src/utils/helpers/format.js', '// WRONG FILE');
         
         const prev = process.cwd();
         process.chdir(dir);
@@ -70,12 +70,12 @@ export default {
   'single asterisk only matches single path segments': async ({pass, fail, log}) => {
     try {
       await withTempDir(async (dir) => {
-        // Create nested file structure
-        await write(dir, 'src/file.js', 'single level');
-        await write(dir, 'src/nested/file.js', 'nested level');
+        // Create files at different nesting levels
+        await write(dir, 'src/file.js', '// single level');
+        await write(dir, 'src/nested/file.js', '// nested level');
         
-        // Create fallback file in docs
-        await write(dir, 'docs/src/nested/file.js', 'fallback file');
+        // Create docs directory with fallback file
+        await write(dir, 'docs/src/nested/file.js', '// fallback file');
         
         const prev = process.cwd();
         process.chdir(dir);
@@ -103,13 +103,13 @@ export default {
           const r1 = await httpGet(`http://localhost:${port}/src/file.js`);
           log('single level status: ' + r1.res.statusCode);
           if(r1.res.statusCode !== 200) throw new Error('single level 200');
-          if(r1.body.toString() !== 'single level') throw new Error('single level content');
+          if(r1.body.toString() !== '// single level') throw new Error('single level content');
           
           // Nested level should NOT work with single asterisk, should fall back to docs
           const r2 = await httpGet(`http://localhost:${port}/src/nested/file.js`);
           log('nested level status: ' + r2.res.statusCode);
           if(r2.res.statusCode !== 200) throw new Error('nested level 200');
-          if(r2.body.toString() !== 'fallback file') throw new Error('nested level should use fallback');
+          if(r2.body.toString() !== '// fallback file') throw new Error('nested level should use fallback');
           
         } finally { 
           server.close(); 
@@ -125,12 +125,12 @@ export default {
   'wildcard routes take precedence over static files': async ({pass, fail, log}) => {
     try {
       await withTempDir(async (dir) => {
-        // Create source files
-        await write(dir, 'custom/data.json', '{"source": "custom"}');
-        
-        // Create static files in docs that should be overridden
+        // Create static file in docs
         await write(dir, 'docs/api/data.json', '{"source": "static"}');
         
+        // Create custom file outside docs
+        await write(dir, 'custom/data.json', '{"source": "custom"}');
+        
         const prev = process.cwd();
         process.chdir(dir);
         

package/tests/test-server-root/docs/.config.json

@@ -1,6 +1,5 @@
 {
   "customRoutes": {
-    "/src/*": "../src/$1"
-  },
-  "routePreference": "customRoute"
+    "/src/**": "../src/**"
+  }
 }

package/tests/test-server-root/docs/src/components/Button.js

@@ -1 +1 @@
-WRONG FILE
+// WRONG FILE

package/tests/test-server-root/docs/src/nested/file.js

@@ -1 +1 @@
-fallback file
+// fallback file

package/tests/test-server-root/docs/src/utils/helpers/format.js

@@ -1 +1 @@
-WRONG FILE
+// WRONG FILE

package/tests/test-server-root/src/components/Import.js

@@ -0,0 +1 @@
+export const Import = () => 'imported';

package/tests/test-server-root/src/deep/nested/file.js

@@ -0,0 +1 @@
+export const nested = true

package/tests/test-server-root/src/file.js

@@ -1 +1 @@
-single level
+// single level

package/tests/test-server-root/src/nested/file.js

@@ -1 +1 @@
-nested level
+// nested level

package/tests/test-server-root/src/utils/helpers.js

@@ -0,0 +1 @@
+export const helpers = {}

package/tests/test-server-root/README.md

@@ -1,118 +0,0 @@
-# Test Server Root
-
-This directory contains the persistent test server structure used by unit tests instead of creating temporary files for each test run. Tests use `withTestDir()` to get a temporary copy of this structure, maintaining isolation while providing consistent base files.
-
-## Directory Structure
-
-```
-test-server-root/
-├── README.md                              # This file
-├── .config.json                           # Basic config with middleware settings
-├── index.html                             # Basic home page: "<h1>Home</h1>"
-├── late.html                              # For rescan tests: "later"
-├── hello.html                             # For CLI tests: "hello world"
-├── a.txt                                  # Test file: "A"
-├── b/
-│   └── 1.txt                              # Test file: "B1"
-├── api/
-│   ├── GET.js                             # Route handler returning {ok:true, params}
-│   └── no-default.js                      # Route file without default export
-├── src/
-│   ├── file.js                            # Content: "single level"
-│   ├── file.txt                           # Content: "custom"
-│   ├── nested/
-│   │   └── file.js                        # Content: "nested level"
-│   ├── components/
-│   │   └── Button.js                      # Content: "export default Button"
-│   ├── utils/
-│   │   └── helpers/
-│   │       └── format.js                  # Content: "export const format = () => {}"
-│   └── deep/
-│       └── nested/
-│           └── folder/
-│               └── file.js                # Content: "export const deep = true"
-├── docs/
-│   ├── .config.json                       # Config with custom routes to ../src/**
-│   ├── api/
-│   │   └── data.json                      # Content: {"source": "static"}
-│   └── src/
-│       ├── nested/
-│       │   └── file.js                    # Content: "fallback file"
-│       ├── components/
-│       │   └── Button.js                  # Content: "WRONG FILE"
-│       └── utils/
-│           └── helpers/
-│               └── format.js              # Content: "WRONG FILE"
-├── custom/
-│   └── data.json                          # Content: {"source": "custom"}
-└── public/
-    └── src/
-        └── file.txt                       # Content: "static"
-```
-
-## Configuration Files
-
-### Root .config.json
-Basic configuration for middleware testing:
-```json
-{
-  "middleware": {
-    "cors": {}
-  }
-}
-```
-
-### docs/.config.json
-Configuration for wildcard routing tests:
-```json
-{
-  "customRoutes": {
-    "/src/*": "../src/$1"
-  },
-  "routePreference": "customRoute"
-}
-```
-
-## Usage in Tests
-
-### Simple Tests
-Use `withTestDir()` for tests that can leverage the existing structure:
-
-```javascript
-await withTestDir(async (dir) => {
-  // dir contains a copy of all the above files
-  // Use existing files or create additional ones as needed
-  const handler = await router({root: dir}, log);
-  // ... test the handler
-});
-```
-
-### Subdirectory Tests
-Use the `subdir` option to work within a specific folder:
-
-```javascript
-await withTestDir(async (dir) => {
-  // dir points to test-server-root/docs/
-  process.chdir(dir);
-  const handler = await router({root: '.'}, log);
-  // ... test from docs folder perspective
-}, {subdir: 'docs'});
-```
-
-### Complex Tests
-For tests requiring very specific or complex structures, continue using `withTempDir()`:
-
-```javascript
-await withTempDir(async (dir) => {
-  await write(dir, 'very/specific/structure.js', 'content');
-  // ... custom test setup
-});
-```
-
-## Benefits
-
-1. **Consistency** - All tests start with the same base structure
-2. **Speed** - No need to recreate common files for each test
-3. **Maintainability** - Centralized test file management  
-4. **Documentation** - Clear visibility of what test files exist
-5. **Isolation** - Each test still gets its own temporary copy