koa-classic-server 3.0.1 ā 3.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +44 -120
- package/index.cjs +200 -21
- package/package.json +10 -5
- package/.github/workflows/npm-publish.yml +0 -98
- package/CLAUDE.md +0 -101
- package/__tests__/benchmark-results-baseline-v1.2.0.txt +0 -354
- package/__tests__/benchmark-results-optimized-v2.0.0.txt +0 -354
- package/__tests__/benchmark-results-v3.0.0.txt +0 -372
- package/__tests__/benchmark.js +0 -239
- package/__tests__/caching-headers.test.js +0 -556
- package/__tests__/compression-fixtures/data.json +0 -1
- package/__tests__/compression-fixtures/large.txt +0 -1
- package/__tests__/compression-fixtures/small.txt +0 -1
- package/__tests__/compression.test.js +0 -284
- package/__tests__/customTest/README.md +0 -6
- package/__tests__/customTest/loadConfig.util.js +0 -41
- package/__tests__/customTest/serversToLoad.util.js +0 -93
- package/__tests__/demo-regex-index.js +0 -140
- package/__tests__/deprecation-warnings.test.js +0 -105
- package/__tests__/directory-sorting-links.test.js +0 -135
- package/__tests__/dt-unknown.test.js +0 -635
- package/__tests__/ejs.test.js +0 -299
- package/__tests__/head-method.test.js +0 -160
- package/__tests__/hidden-fixtures/.dot-dir/inside.txt +0 -1
- package/__tests__/hidden-fixtures/.env +0 -2
- package/__tests__/hidden-fixtures/.well-known/acme-challenge.txt +0 -1
- package/__tests__/hidden-fixtures/config/secrets/password.txt +0 -1
- package/__tests__/hidden-fixtures/data.key +0 -1
- package/__tests__/hidden-fixtures/file.secret +0 -1
- package/__tests__/hidden-fixtures/index.html +0 -1
- package/__tests__/hidden-fixtures/normal.txt +0 -1
- package/__tests__/hidden-fixtures/subdir/.env +0 -1
- package/__tests__/hidden-fixtures/subdir/regular.txt +0 -1
- package/__tests__/hidden-option.test.js +0 -407
- package/__tests__/hideExtension.test.js +0 -607
- package/__tests__/index-option.test.js +0 -449
- package/__tests__/index.test.js +0 -345
- package/__tests__/listing.test.js +0 -437
- package/__tests__/logger.test.js +0 -232
- package/__tests__/performance.test.js +0 -370
- package/__tests__/publicWwwTest/cartella/sottocartella/ciao.html +0 -11
- package/__tests__/publicWwwTest/cartella/sottocartella/provaEjs/testEjs.ejs +0 -11
- package/__tests__/publicWwwTest/cartella vuota con spazi nel nome/file con spazio nel nome .txt +0 -1
- package/__tests__/publicWwwTest/cartella vuota con spazi nel nome /file con spazio nel nome .txt +0 -1
- package/__tests__/publicWwwTest/ejs-templates/complex.ejs +0 -56
- package/__tests__/publicWwwTest/ejs-templates/index.ejs +0 -30
- package/__tests__/publicWwwTest/ejs-templates/simple.ejs +0 -13
- package/__tests__/publicWwwTest/ejs-templates/with-conditional.ejs +0 -28
- package/__tests__/publicWwwTest/ejs-templates/with-escaping.ejs +0 -26
- package/__tests__/publicWwwTest/ejs-templates/with-loop.ejs +0 -16
- package/__tests__/publicWwwTest/hideext-test/about/index.html +0 -1
- package/__tests__/publicWwwTest/hideext-test/about.EJS +0 -1
- package/__tests__/publicWwwTest/hideext-test/about.ejs +0 -2
- package/__tests__/publicWwwTest/hideext-test/blog/articolo.ejs +0 -2
- package/__tests__/publicWwwTest/hideext-test/conflict-test/pagina +0 -1
- package/__tests__/publicWwwTest/hideext-test/conflict-test/pagina.ejs +0 -1
- package/__tests__/publicWwwTest/hideext-test/file.ejs.bak +0 -1
- package/__tests__/publicWwwTest/hideext-test/index.ejs +0 -2
- package/__tests__/publicWwwTest/hideext-test/photo.txt +0 -1
- package/__tests__/publicWwwTest/hideext-test/sezione/index.ejs +0 -1
- package/__tests__/publicWwwTest/hideext-test/style.css +0 -1
- package/__tests__/publicWwwTest/ile_vuoto.txt +0 -0
- package/__tests__/publicWwwTest/index.html +0 -11
- package/__tests__/publicWwwTest/prova file .txt +0 -2
- package/__tests__/publicWwwTest/semplicetxt.txt +0 -1
- package/__tests__/publicWwwTest/test-page.html +0 -1
- package/__tests__/publicWwwTest/test.txt +0 -1
- package/__tests__/range-fixtures/sample.txt +0 -1
- package/__tests__/range.test.js +0 -223
- package/__tests__/security-headers.test.js +0 -165
- package/__tests__/security.test.js +0 -322
- package/__tests__/server-cache-fixtures/large.txt +0 -1
- package/__tests__/server-cache-fixtures/small.txt +0 -1
- package/__tests__/server-cache.test.js +0 -594
- package/__tests__/setup-benchmark.js +0 -178
- package/__tests__/symlink.test.js +0 -441
- package/__tests__/template-timeout.test.js +0 -321
- package/__tests__/test-regex-quick.js +0 -158
- package/__tests__/useOriginalUrl.test.js +0 -213
- package/docs/ACTION_PLAN.md +0 -293
- package/docs/BENCHMARKS.md +0 -317
- package/docs/CHANGELOG.md +0 -906
- package/docs/CODE_REVIEW.md +0 -300
- package/docs/DEBUG_REPORT.md +0 -593
- package/docs/DOCUMENTATION.md +0 -1864
- package/docs/EXAMPLES_INDEX_OPTION.md +0 -395
- package/docs/FLOW_DIAGRAM.md +0 -954
- package/docs/INDEX_OPTION_PRIORITY.md +0 -527
- package/docs/OPTIMIZATION_HTTP_CACHING.md +0 -689
- package/docs/OPTIMIZATION_ROADMAP_for_V3.md +0 -864
- package/docs/PERFORMANCE_ANALYSIS.md +0 -839
- package/docs/PERFORMANCE_COMPARISON.md +0 -388
- package/docs/noteExports.md +0 -148
- package/docs/security_improvement_for_V3.md +0 -421
- package/docs/template-engine/TEMPLATE_ENGINE_GUIDE.md +0 -1734
- package/docs/template-engine/esempi-incrementali.js +0 -192
- package/docs/template-engine/examples/esempio1-nessun-dato.ejs +0 -12
- package/docs/template-engine/examples/esempio2-una-variabile.ejs +0 -11
- package/docs/template-engine/examples/esempio3-piu-variabili.ejs +0 -15
- package/docs/template-engine/examples/esempio4-condizionale.ejs +0 -18
- package/docs/template-engine/examples/esempio5-loop.ejs +0 -18
- package/docs/template-engine/examples/index-esempi.html +0 -181
- package/docs/template-engine/examples/index.html +0 -40
- package/docs/template-engine/examples/test.ejs +0 -64
- package/eslint.config.mjs +0 -17
- package/jest.config.js +0 -18
package/__tests__/benchmark.js
DELETED
|
@@ -1,239 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* HTTP Load Testing Benchmark using autocannon
|
|
5
|
-
*
|
|
6
|
-
* This script performs realistic load testing to measure:
|
|
7
|
-
* - Requests per second
|
|
8
|
-
* - Latency (avg, p50, p99)
|
|
9
|
-
* - Throughput
|
|
10
|
-
*
|
|
11
|
-
* Usage:
|
|
12
|
-
* node benchmark.js
|
|
13
|
-
* node benchmark.js --save baseline.json
|
|
14
|
-
*
|
|
15
|
-
* Compare before/after:
|
|
16
|
-
* node benchmark.js --save before.json
|
|
17
|
-
* # ... apply optimizations ...
|
|
18
|
-
* node benchmark.js --save after.json --compare before.json
|
|
19
|
-
*/
|
|
20
|
-
|
|
21
|
-
const autocannon = require('autocannon');
|
|
22
|
-
const Koa = require('koa');
|
|
23
|
-
const koaClassicServer = require('../index.cjs');
|
|
24
|
-
const path = require('path');
|
|
25
|
-
const fs = require('fs');
|
|
26
|
-
|
|
27
|
-
const BENCHMARK_DIR = path.join(__dirname, 'benchmark-data');
|
|
28
|
-
|
|
29
|
-
// Check if benchmark data exists
|
|
30
|
-
if (!fs.existsSync(BENCHMARK_DIR)) {
|
|
31
|
-
console.error('\nā Benchmark data not found!');
|
|
32
|
-
console.error('Please run: node scripts/setup-benchmark.js\n');
|
|
33
|
-
process.exit(1);
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
// Parse command line arguments
|
|
37
|
-
const args = process.argv.slice(2);
|
|
38
|
-
const saveFile = args.includes('--save') ? args[args.indexOf('--save') + 1] : null;
|
|
39
|
-
const compareFile = args.includes('--compare') ? args[args.indexOf('--compare') + 1] : null;
|
|
40
|
-
|
|
41
|
-
console.log('š Starting koa-classic-server benchmark...\n');
|
|
42
|
-
|
|
43
|
-
// Start server
|
|
44
|
-
const app = new Koa();
|
|
45
|
-
app.use(koaClassicServer(BENCHMARK_DIR));
|
|
46
|
-
const server = app.listen(0); // Random available port
|
|
47
|
-
|
|
48
|
-
const port = server.address().port;
|
|
49
|
-
console.log(`Server running on http://localhost:${port}\n`);
|
|
50
|
-
|
|
51
|
-
// Define benchmark scenarios
|
|
52
|
-
const scenarios = [
|
|
53
|
-
{
|
|
54
|
-
name: 'Small file (1KB)',
|
|
55
|
-
url: `http://localhost:${port}/small-files/file-1.txt`,
|
|
56
|
-
duration: 10,
|
|
57
|
-
connections: 10
|
|
58
|
-
},
|
|
59
|
-
{
|
|
60
|
-
name: 'Medium file (100KB)',
|
|
61
|
-
url: `http://localhost:${port}/medium-files/file-1.txt`,
|
|
62
|
-
duration: 10,
|
|
63
|
-
connections: 10
|
|
64
|
-
},
|
|
65
|
-
{
|
|
66
|
-
name: 'Large file (1MB)',
|
|
67
|
-
url: `http://localhost:${port}/large-files/file-1.txt`,
|
|
68
|
-
duration: 10,
|
|
69
|
-
connections: 10
|
|
70
|
-
},
|
|
71
|
-
{
|
|
72
|
-
name: 'Directory listing (100 files)',
|
|
73
|
-
url: `http://localhost:${port}/small-files/`,
|
|
74
|
-
duration: 10,
|
|
75
|
-
connections: 10
|
|
76
|
-
},
|
|
77
|
-
{
|
|
78
|
-
name: 'Directory listing (1,000 files)',
|
|
79
|
-
url: `http://localhost:${port}/large-directory/`,
|
|
80
|
-
duration: 10,
|
|
81
|
-
connections: 5
|
|
82
|
-
},
|
|
83
|
-
{
|
|
84
|
-
name: 'HTML file',
|
|
85
|
-
url: `http://localhost:${port}/test.html`,
|
|
86
|
-
duration: 10,
|
|
87
|
-
connections: 10
|
|
88
|
-
},
|
|
89
|
-
{
|
|
90
|
-
name: '404 Not Found',
|
|
91
|
-
url: `http://localhost:${port}/does-not-exist.txt`,
|
|
92
|
-
duration: 10,
|
|
93
|
-
connections: 10
|
|
94
|
-
}
|
|
95
|
-
];
|
|
96
|
-
|
|
97
|
-
// Run benchmarks sequentially
|
|
98
|
-
async function runBenchmarks() {
|
|
99
|
-
const results = {};
|
|
100
|
-
|
|
101
|
-
for (const scenario of scenarios) {
|
|
102
|
-
console.log('ā'.repeat(70));
|
|
103
|
-
console.log(`š Benchmarking: ${scenario.name}`);
|
|
104
|
-
console.log('ā'.repeat(70));
|
|
105
|
-
|
|
106
|
-
const result = await runBenchmark(scenario);
|
|
107
|
-
results[scenario.name] = result;
|
|
108
|
-
|
|
109
|
-
// Wait a bit between tests
|
|
110
|
-
await sleep(2000);
|
|
111
|
-
}
|
|
112
|
-
|
|
113
|
-
return results;
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
function runBenchmark(scenario) {
|
|
117
|
-
return new Promise((resolve, reject) => {
|
|
118
|
-
const instance = autocannon({
|
|
119
|
-
url: scenario.url,
|
|
120
|
-
connections: scenario.connections,
|
|
121
|
-
duration: scenario.duration,
|
|
122
|
-
pipelining: 1,
|
|
123
|
-
}, (err, result) => {
|
|
124
|
-
if (err) {
|
|
125
|
-
reject(err);
|
|
126
|
-
} else {
|
|
127
|
-
printResults(result, scenario.name);
|
|
128
|
-
resolve(formatResults(result, scenario.name));
|
|
129
|
-
}
|
|
130
|
-
});
|
|
131
|
-
|
|
132
|
-
autocannon.track(instance, { renderProgressBar: true });
|
|
133
|
-
});
|
|
134
|
-
}
|
|
135
|
-
|
|
136
|
-
function printResults(result, name) {
|
|
137
|
-
console.log(`\nā ${name} - Results:`);
|
|
138
|
-
console.log(` Requests/sec: ${result.requests.average.toFixed(2)}`);
|
|
139
|
-
console.log(` Latency (avg): ${result.latency.mean.toFixed(2)}ms`);
|
|
140
|
-
console.log(` Latency (p50): ${result.latency.p50.toFixed(2)}ms`);
|
|
141
|
-
console.log(` Latency (p99): ${result.latency.p99.toFixed(2)}ms`);
|
|
142
|
-
console.log(` Throughput: ${(result.throughput.average / 1024 / 1024).toFixed(2)} MB/sec`);
|
|
143
|
-
console.log(` Total requests: ${result.requests.total}`);
|
|
144
|
-
console.log('');
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
function formatResults(result, name) {
|
|
148
|
-
return {
|
|
149
|
-
name,
|
|
150
|
-
requestsPerSecond: result.requests.average,
|
|
151
|
-
latency: {
|
|
152
|
-
mean: result.latency.mean,
|
|
153
|
-
p50: result.latency.p50,
|
|
154
|
-
p75: result.latency.p75,
|
|
155
|
-
p90: result.latency.p90,
|
|
156
|
-
p99: result.latency.p99,
|
|
157
|
-
p999: result.latency.p999
|
|
158
|
-
},
|
|
159
|
-
throughput: result.throughput.average,
|
|
160
|
-
totalRequests: result.requests.total,
|
|
161
|
-
errors: result.errors
|
|
162
|
-
};
|
|
163
|
-
}
|
|
164
|
-
|
|
165
|
-
function sleep(ms) {
|
|
166
|
-
return new Promise(resolve => setTimeout(resolve, ms));
|
|
167
|
-
}
|
|
168
|
-
|
|
169
|
-
// Main execution
|
|
170
|
-
runBenchmarks()
|
|
171
|
-
.then(results => {
|
|
172
|
-
console.log('='.repeat(70));
|
|
173
|
-
console.log('š BENCHMARK SUMMARY');
|
|
174
|
-
console.log('='.repeat(70));
|
|
175
|
-
console.log('');
|
|
176
|
-
|
|
177
|
-
// Summary table
|
|
178
|
-
console.log('Scenario | Req/sec | Latency (avg) | Throughput');
|
|
179
|
-
console.log('----------------------------------|---------|---------------|-------------');
|
|
180
|
-
|
|
181
|
-
Object.values(results).forEach(result => {
|
|
182
|
-
const name = result.name.padEnd(33);
|
|
183
|
-
const reqSec = result.requestsPerSecond.toFixed(0).padStart(7);
|
|
184
|
-
const latency = `${result.latency.mean.toFixed(2)}ms`.padStart(13);
|
|
185
|
-
const throughput = `${(result.throughput / 1024 / 1024).toFixed(2)} MB/s`.padStart(11);
|
|
186
|
-
console.log(`${name} | ${reqSec} | ${latency} | ${throughput}`);
|
|
187
|
-
});
|
|
188
|
-
|
|
189
|
-
console.log('');
|
|
190
|
-
console.log('='.repeat(70));
|
|
191
|
-
|
|
192
|
-
// Save results if requested
|
|
193
|
-
if (saveFile) {
|
|
194
|
-
const data = {
|
|
195
|
-
timestamp: new Date().toISOString(),
|
|
196
|
-
version: require('./package.json').version,
|
|
197
|
-
results
|
|
198
|
-
};
|
|
199
|
-
fs.writeFileSync(saveFile, JSON.stringify(data, null, 2));
|
|
200
|
-
console.log(`\nā Results saved to: ${saveFile}`);
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
// Compare with previous results if requested
|
|
204
|
-
if (compareFile && fs.existsSync(compareFile)) {
|
|
205
|
-
const previous = JSON.parse(fs.readFileSync(compareFile, 'utf8'));
|
|
206
|
-
console.log('\nš COMPARISON WITH PREVIOUS RESULTS');
|
|
207
|
-
console.log('='.repeat(70));
|
|
208
|
-
|
|
209
|
-
Object.keys(results).forEach(key => {
|
|
210
|
-
const current = results[key];
|
|
211
|
-
const prev = previous.results[key];
|
|
212
|
-
|
|
213
|
-
if (prev) {
|
|
214
|
-
const reqDiff = ((current.requestsPerSecond - prev.requestsPerSecond) / prev.requestsPerSecond * 100);
|
|
215
|
-
const latDiff = ((current.latency.mean - prev.latency.mean) / prev.latency.mean * 100);
|
|
216
|
-
|
|
217
|
-
console.log(`\n${key}:`);
|
|
218
|
-
console.log(` Requests/sec: ${prev.requestsPerSecond.toFixed(2)} ā ${current.requestsPerSecond.toFixed(2)} (${reqDiff > 0 ? '+' : ''}${reqDiff.toFixed(1)}%)`);
|
|
219
|
-
console.log(` Latency: ${prev.latency.mean.toFixed(2)}ms ā ${current.latency.mean.toFixed(2)}ms (${latDiff > 0 ? '+' : ''}${latDiff.toFixed(1)}%)`);
|
|
220
|
-
|
|
221
|
-
if (reqDiff > 10) {
|
|
222
|
-
console.log(` ā
Significant improvement!`);
|
|
223
|
-
} else if (reqDiff < -10) {
|
|
224
|
-
console.log(` ā ļø Performance regression!`);
|
|
225
|
-
}
|
|
226
|
-
}
|
|
227
|
-
});
|
|
228
|
-
|
|
229
|
-
console.log('\n' + '='.repeat(70));
|
|
230
|
-
}
|
|
231
|
-
|
|
232
|
-
server.close();
|
|
233
|
-
console.log('\nā Benchmark complete!\n');
|
|
234
|
-
})
|
|
235
|
-
.catch(err => {
|
|
236
|
-
console.error('ā Benchmark failed:', err);
|
|
237
|
-
server.close();
|
|
238
|
-
process.exit(1);
|
|
239
|
-
});
|