webhoster 0.1.0 → 0.3.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/.eslintrc.json +74 -58
- package/.github/copilot-instructions.md +100 -0
- package/.github/workflows/test-matrix.yml +37 -0
- package/.test/benchmark.js +28 -0
- package/.test/constants.js +4 -0
- package/{test → .test}/http2server.js +1 -1
- package/{test → .test}/httpserver.js +1 -1
- package/{test → .test}/index.js +178 -192
- package/.test/multipromise.js +32 -0
- package/{test → .test}/tls.js +3 -3
- package/{test → .test}/urlencoded.js +3 -0
- package/.vscode/launch.json +24 -3
- package/README.md +116 -90
- package/data/CookieObject.js +14 -14
- package/errata/socketio.js +6 -11
- package/examples/starter.js +11 -0
- package/helpers/HeadersParser.js +7 -8
- package/helpers/HttpListener.js +387 -42
- package/helpers/RequestHeaders.js +43 -36
- package/helpers/RequestReader.js +27 -26
- package/helpers/ResponseHeaders.js +47 -36
- package/jsconfig.json +1 -1
- package/lib/HttpHandler.js +447 -277
- package/lib/HttpRequest.js +383 -39
- package/lib/HttpResponse.js +316 -52
- package/lib/HttpTransaction.js +146 -0
- package/middleware/AutoHeadersMiddleware.js +73 -0
- package/middleware/CORSMiddleware.js +45 -47
- package/middleware/CaseInsensitiveHeadersMiddleware.js +5 -11
- package/middleware/ContentDecoderMiddleware.js +81 -35
- package/middleware/ContentEncoderMiddleware.js +179 -132
- package/middleware/ContentLengthMiddleware.js +66 -43
- package/middleware/ContentWriterMiddleware.js +5 -11
- package/middleware/HashMiddleware.js +68 -40
- package/middleware/HeadMethodMiddleware.js +24 -22
- package/middleware/MethodMiddleware.js +29 -36
- package/middleware/PathMiddleware.js +49 -66
- package/middleware/ReadFormData.js +99 -0
- package/middleware/SendHeadersMiddleware.js +0 -2
- package/middleware/SendJsonMiddleware.js +131 -0
- package/middleware/SendStringMiddleware.js +87 -0
- package/package.json +38 -29
- package/polyfill/FormData.js +164 -0
- package/rollup.config.js +0 -1
- package/scripts/test-all-sync.sh +6 -0
- package/scripts/test-all.sh +7 -0
- package/templates/starter.js +53 -0
- package/test/fixtures/stream.js +68 -0
- package/test/helpers/HttpListener/construct.js +18 -0
- package/test/helpers/HttpListener/customOptions.js +22 -0
- package/test/helpers/HttpListener/doubleCreate.js +40 -0
- package/test/helpers/HttpListener/events.js +77 -0
- package/test/helpers/HttpListener/http.js +31 -0
- package/test/helpers/HttpListener/http2.js +41 -0
- package/test/helpers/HttpListener/https.js +38 -0
- package/test/helpers/HttpListener/startAll.js +31 -0
- package/test/helpers/HttpListener/stopNotStarted.js +23 -0
- package/test/lib/HttpHandler/class.js +8 -0
- package/test/lib/HttpHandler/handleRequest.js +11 -0
- package/test/lib/HttpHandler/middleware.js +941 -0
- package/test/lib/HttpHandler/parse.js +41 -0
- package/test/lib/HttpRequest/class.js +8 -0
- package/test/lib/HttpRequest/downstream.js +171 -0
- package/test/lib/HttpRequest/properties.js +101 -0
- package/test/lib/HttpRequest/read.js +518 -0
- package/test/lib/HttpResponse/class.js +8 -0
- package/test/lib/HttpResponse/properties.js +59 -0
- package/test/lib/HttpResponse/send.js +275 -0
- package/test/lib/HttpTransaction/class.js +8 -0
- package/test/lib/HttpTransaction/ping.js +50 -0
- package/test/lib/HttpTransaction/push.js +89 -0
- package/test/middleware/SendJsonMiddleware.js +222 -0
- package/test/sanity.js +10 -0
- package/test/templates/starter.js +93 -0
- package/tsconfig.json +12 -0
- package/types/index.js +61 -34
- package/types/typings.d.ts +8 -9
- package/utils/AsyncObject.js +6 -3
- package/utils/CaseInsensitiveObject.js +2 -3
- package/utils/function.js +1 -7
- package/utils/headers.js +42 -0
- package/utils/qualityValues.js +1 -1
- package/utils/stream.js +4 -20
- package/index.cjs +0 -3200
- package/test/constants.js +0 -4
- /package/{test → .test}/cookietester.js +0 -0
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import * as http from 'node:http';
|
|
2
|
+
import { Socket } from 'node:net';
|
|
3
|
+
|
|
4
|
+
import test from 'ava';
|
|
5
|
+
|
|
6
|
+
import HttpListener from '../../../helpers/HttpListener.js';
|
|
7
|
+
|
|
8
|
+
// Event listener coverage: simulate error/clientError/request events
|
|
9
|
+
|
|
10
|
+
test('httpServer emits error and clientError', (t) => {
|
|
11
|
+
const listener = new HttpListener();
|
|
12
|
+
const server = listener.createHttpServer();
|
|
13
|
+
let errorCalled = false;
|
|
14
|
+
let clientErrorCalled = false;
|
|
15
|
+
server.on('error', () => { errorCalled = true; });
|
|
16
|
+
server.on('clientError', () => { clientErrorCalled = true; });
|
|
17
|
+
server.emit('error', new Error('test error'));
|
|
18
|
+
server.emit('clientError', new Error('test client error'), new EventTarget());
|
|
19
|
+
t.true(errorCalled);
|
|
20
|
+
t.true(clientErrorCalled);
|
|
21
|
+
});
|
|
22
|
+
|
|
23
|
+
// Cannot easily test request/stream/session events without real network, but can check listeners are attached
|
|
24
|
+
|
|
25
|
+
test('listeners are attached for request and error events', async (t) => {
|
|
26
|
+
const listener = new HttpListener({ insecurePort: 0 });
|
|
27
|
+
await listener.startHttpServer();
|
|
28
|
+
const server = listener.httpServer;
|
|
29
|
+
t.true(server.listenerCount('request') > 0);
|
|
30
|
+
t.true(server.listenerCount('error') > 0);
|
|
31
|
+
t.true(server.listenerCount('clientError') > 0);
|
|
32
|
+
await listener.stopHttpServer();
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
// Test that 'clientError' event handler is called for bad request
|
|
36
|
+
test('httpServer clientError event is called for bad request', async (t) => {
|
|
37
|
+
const listener = new HttpListener({ insecurePort: 0 });
|
|
38
|
+
await listener.startHttpServer();
|
|
39
|
+
const server = listener.httpServer;
|
|
40
|
+
let called = false;
|
|
41
|
+
server.on('clientError', () => { called = true; });
|
|
42
|
+
const address = server.address();
|
|
43
|
+
const port = typeof address === 'object' && address ? address.port : address;
|
|
44
|
+
const socket = new Socket();
|
|
45
|
+
socket.connect(Number(port), '127.0.0.1', () => {
|
|
46
|
+
socket.write('BAD REQUEST\r\n\r\n');
|
|
47
|
+
setTimeout(() => {
|
|
48
|
+
socket.destroy();
|
|
49
|
+
}, 50);
|
|
50
|
+
});
|
|
51
|
+
await new Promise((resolve) => setTimeout(resolve, 100));
|
|
52
|
+
t.true(called);
|
|
53
|
+
await listener.stopHttpServer();
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
// Test that 'error' event handler is called for server error
|
|
57
|
+
test('httpServer error event is called', async (t) => {
|
|
58
|
+
const listener = new HttpListener({ insecurePort: 0 });
|
|
59
|
+
await listener.startHttpServer();
|
|
60
|
+
const server = listener.httpServer;
|
|
61
|
+
let called = false;
|
|
62
|
+
server.on('error', () => { called = true; });
|
|
63
|
+
server.emit('error', new Error('test error')); // Simulate error
|
|
64
|
+
t.true(called);
|
|
65
|
+
await listener.stopHttpServer();
|
|
66
|
+
});
|
|
67
|
+
|
|
68
|
+
// Test that listeners are removed after stop
|
|
69
|
+
test('listeners are removed after stop', async (t) => {
|
|
70
|
+
const listener = new HttpListener({ insecurePort: 0 });
|
|
71
|
+
await listener.startHttpServer();
|
|
72
|
+
const server = listener.httpServer;
|
|
73
|
+
await listener.stopHttpServer();
|
|
74
|
+
t.is(server.listenerCount('request'), 0);
|
|
75
|
+
t.is(server.listenerCount('error'), 0);
|
|
76
|
+
t.is(server.listenerCount('clientError'), 0);
|
|
77
|
+
});
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { Socket } from 'node:net';
|
|
2
|
+
|
|
3
|
+
import test from 'ava';
|
|
4
|
+
|
|
5
|
+
import HttpListener from '../../../helpers/HttpListener.js';
|
|
6
|
+
|
|
7
|
+
test('HttpListener.startHttpServer() and stopHttpServer() work', async (t) => {
|
|
8
|
+
const listener = new HttpListener({ insecurePort: 0 }); // Use ephemeral port
|
|
9
|
+
const server = await listener.startHttpServer();
|
|
10
|
+
t.truthy(server);
|
|
11
|
+
await listener.stopHttpServer();
|
|
12
|
+
t.pass();
|
|
13
|
+
});
|
|
14
|
+
|
|
15
|
+
test('HttpListener HTTP server closes idle socket after keepAliveTimeout', async (t) => {
|
|
16
|
+
const listener = new HttpListener({ insecurePort: 0 });
|
|
17
|
+
await listener.startHttpServer();
|
|
18
|
+
const server = listener.httpServer;
|
|
19
|
+
server.setTimeout(1000); // Set keepAliveTimeout to 1 seconds
|
|
20
|
+
const address = server.address();
|
|
21
|
+
const port = typeof address === 'object' && address ? address.port : address;
|
|
22
|
+
const socket = new Socket();
|
|
23
|
+
let destroyed = false;
|
|
24
|
+
socket.on('close', () => { destroyed = true; });
|
|
25
|
+
socket.connect(Number(port), '127.0.0.1', () => {
|
|
26
|
+
// Do not send any data, just keep connection open
|
|
27
|
+
});
|
|
28
|
+
await new Promise((resolve) => setTimeout(resolve, 2000));
|
|
29
|
+
t.true(destroyed, 'Socket should be destroyed after keepAliveTimeout');
|
|
30
|
+
await listener.stopHttpServer();
|
|
31
|
+
});
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { connect } from 'node:http2';
|
|
2
|
+
|
|
3
|
+
import test from 'ava';
|
|
4
|
+
|
|
5
|
+
import HttpListener from '../../../helpers/HttpListener.js';
|
|
6
|
+
|
|
7
|
+
const key = process.env.TEST_SSL_KEY;
|
|
8
|
+
const cert = process.env.TEST_SSL_CERT;
|
|
9
|
+
const haveCerts = key && cert;
|
|
10
|
+
|
|
11
|
+
const testFn = haveCerts ? test : test.skip;
|
|
12
|
+
|
|
13
|
+
testFn('HttpListener.startHttp2Server() and stopHttp2Server() work', async (t) => {
|
|
14
|
+
const tlsOptions = { key, cert };
|
|
15
|
+
const listener = new HttpListener({ securePort: 0, useHttp2: true, tlsOptions });
|
|
16
|
+
const server = await listener.startHttp2Server();
|
|
17
|
+
t.truthy(server);
|
|
18
|
+
await listener.stopHttp2Server();
|
|
19
|
+
t.pass();
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
testFn('HttpListener HTTP2 server closes idle socket after setTimeout', async (t) => {
|
|
23
|
+
const tlsOptions = { key, cert };
|
|
24
|
+
const listener = new HttpListener({ securePort: 0, useHttp2: true, tlsOptions });
|
|
25
|
+
await listener.startHttp2Server();
|
|
26
|
+
const server = listener.http2Server;
|
|
27
|
+
server.setTimeout(1000); // Set keepAliveTimeout to 1 seconds
|
|
28
|
+
const address = server.address();
|
|
29
|
+
const port = typeof address === 'object' && address ? address.port : address;
|
|
30
|
+
const client = connect(`https://127.0.0.1:${port}`, {
|
|
31
|
+
ca: cert,
|
|
32
|
+
rejectUnauthorized: false,
|
|
33
|
+
});
|
|
34
|
+
let closed = false;
|
|
35
|
+
client.on('close', () => { closed = true; });
|
|
36
|
+
// Do not send any requests, just keep connection open
|
|
37
|
+
await new Promise((resolve) => setTimeout(resolve, 2000));
|
|
38
|
+
t.true(closed, 'HTTP2 client should be closed after setTimeout');
|
|
39
|
+
client.destroy();
|
|
40
|
+
await listener.stopHttp2Server();
|
|
41
|
+
});
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { connect as tlsConnect } from 'node:tls';
|
|
2
|
+
|
|
3
|
+
import test from 'ava';
|
|
4
|
+
|
|
5
|
+
import HttpListener from '../../../helpers/HttpListener.js';
|
|
6
|
+
|
|
7
|
+
const key = process.env.TEST_SSL_KEY;
|
|
8
|
+
const cert = process.env.TEST_SSL_CERT;
|
|
9
|
+
const haveCerts = key && cert;
|
|
10
|
+
|
|
11
|
+
const testFn = haveCerts ? test : test.skip;
|
|
12
|
+
|
|
13
|
+
testFn('HttpListener.startHttpsServer() and stopHttpsServer() work', async (t) => {
|
|
14
|
+
const tlsOptions = { key, cert };
|
|
15
|
+
const listener = new HttpListener({ securePort: 0, useHttps: true, tlsOptions });
|
|
16
|
+
const server = await listener.startHttpsServer();
|
|
17
|
+
t.truthy(server);
|
|
18
|
+
await listener.stopHttpsServer();
|
|
19
|
+
t.pass();
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
testFn('HttpListener HTTPS server closes idle socket after keepAliveTimeout', async (t) => {
|
|
23
|
+
const tlsOptions = { key, cert };
|
|
24
|
+
const listener = new HttpListener({ securePort: 0, useHttps: true, tlsOptions });
|
|
25
|
+
await listener.startHttpsServer();
|
|
26
|
+
const server = listener.httpsServer;
|
|
27
|
+
server.setTimeout(1000);
|
|
28
|
+
const address = server.address();
|
|
29
|
+
const port = typeof address === 'object' && address ? address.port : address;
|
|
30
|
+
let destroyed = false;
|
|
31
|
+
const socket = tlsConnect({ port: Number(port), host: '127.0.0.1', rejectUnauthorized: false }, () => {
|
|
32
|
+
// Do not send any data, just keep connection open
|
|
33
|
+
});
|
|
34
|
+
socket.on('close', () => { destroyed = true; });
|
|
35
|
+
await new Promise((resolve) => setTimeout(resolve, 2000));
|
|
36
|
+
t.true(destroyed, 'TLS socket should be destroyed after keepAliveTimeout');
|
|
37
|
+
await listener.stopHttpsServer();
|
|
38
|
+
});
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import test from 'ava';
|
|
2
|
+
|
|
3
|
+
import HttpListener from '../../../helpers/HttpListener.js';
|
|
4
|
+
|
|
5
|
+
// Test startAll and stopAll with all modes enabled (HTTP, HTTPS, HTTP/2)
|
|
6
|
+
|
|
7
|
+
const key = process.env.TEST_SSL_KEY;
|
|
8
|
+
const cert = process.env.TEST_SSL_CERT;
|
|
9
|
+
const haveCerts = !!key && !!cert;
|
|
10
|
+
|
|
11
|
+
test('HttpListener.startAll() and stopAll() work (all modes)', async (t) => {
|
|
12
|
+
const listener = new HttpListener({
|
|
13
|
+
insecurePort: 0,
|
|
14
|
+
securePort: 0,
|
|
15
|
+
useHttp: true,
|
|
16
|
+
useHttps: haveCerts,
|
|
17
|
+
useHttp2: haveCerts,
|
|
18
|
+
tlsOptions: haveCerts ? { key, cert } : undefined,
|
|
19
|
+
});
|
|
20
|
+
const [http, https, http2] = await listener.startAll();
|
|
21
|
+
t.truthy(http);
|
|
22
|
+
if (haveCerts) {
|
|
23
|
+
t.truthy(https);
|
|
24
|
+
t.truthy(http2);
|
|
25
|
+
} else {
|
|
26
|
+
t.is(https, null);
|
|
27
|
+
t.is(http2, null);
|
|
28
|
+
}
|
|
29
|
+
await listener.stopAll();
|
|
30
|
+
t.pass();
|
|
31
|
+
});
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import test from 'ava';
|
|
2
|
+
import HttpListener from '../../../helpers/HttpListener.js';
|
|
3
|
+
|
|
4
|
+
// Test stop methods when servers are not started (should resolve, not throw)
|
|
5
|
+
test('stopHttpServer resolves if not started', async t => {
|
|
6
|
+
const listener = new HttpListener();
|
|
7
|
+
await t.notThrowsAsync(() => listener.stopHttpServer());
|
|
8
|
+
});
|
|
9
|
+
|
|
10
|
+
test('stopHttpsServer resolves if not started', async t => {
|
|
11
|
+
const listener = new HttpListener({ useHttps: true });
|
|
12
|
+
await t.notThrowsAsync(() => listener.stopHttpsServer());
|
|
13
|
+
});
|
|
14
|
+
|
|
15
|
+
test('stopHttp2Server resolves if not started', async t => {
|
|
16
|
+
const listener = new HttpListener({ useHttp2: true });
|
|
17
|
+
await t.notThrowsAsync(() => listener.stopHttp2Server());
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
test('stopAll resolves if nothing started', async t => {
|
|
21
|
+
const listener = new HttpListener({ useHttp: false, useHttps: false, useHttp2: false });
|
|
22
|
+
await t.notThrowsAsync(() => listener.stopAll());
|
|
23
|
+
});
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import test from 'ava';
|
|
2
|
+
import { PassThrough, Readable, Writable } from 'node:stream';
|
|
3
|
+
|
|
4
|
+
import HttpHandler from '../../../lib/HttpHandler.js';
|
|
5
|
+
import HttpRequest from '../../../lib/HttpRequest.js';
|
|
6
|
+
import HttpResponse from '../../../lib/HttpResponse.js';
|
|
7
|
+
|
|
8
|
+
test('HttpHandler.handleRequest()', async (t) => {
|
|
9
|
+
|
|
10
|
+
t.pass();
|
|
11
|
+
});
|