webhoster 0.3.3 → 0.3.5

package/middleware/index.js

@@ -1,11 +0,0 @@
-export { default as CaseInsensitiveHeadersMiddleware } from './CaseInsensitiveHeadersMiddleware.js';
-export { default as ContentDecoderMiddleware } from './ContentDecoderMiddleware.js';
-export { default as ContentEncoderMiddleware } from './ContentEncoderMiddleware.js';
-export { default as ContentLengthMiddleware } from './ContentLengthMiddleware.js';
-export { default as ContentReaderMiddleware } from './ContentReaderMiddleware.js';
-export { default as ContentWriterMiddleware } from './ContentWriterMiddleware.js';
-export { default as CorsMiddleware } from './CORSMiddleware.js';
-export { default as HashMiddleware } from './HashMiddleware.js';
-export { default as MethodMiddleware } from './MethodMiddleware.js';
-export { default as PathMiddleware } from './PathMiddleware.js';
-export { default as SendHeadersMiddleware } from './SendHeadersMiddleware.js';

package/polyfill/FormData.js

@@ -1,164 +0,0 @@
-/* @see https://xhr.spec.whatwg.org/#dom-formdata */
-
-/** @implements {FormData} */
-export default class FormData {
-  /** @type {Map<string, (string|File)[]>} */
-  #list = new Map();
-
-  /** @param {HTMLFormElement} [form] */
-  constructor(form) {
-    if (form) {
-      throw new Error('InvalidStateError');
-    }
-  }
-
-  /**
-   * @param {string} s
-   * @return {string}
-   */
-  static #scalarValue = String;
-
-  /**
-   * @param {string} name
-   * @param {string|Blob} value
-   * @param {string} [filename]
-   * @return {{name:string, value:string|File}}
-   */
-  static #createEntry(name, value, filename) {
-    if (typeof value === 'string') {
-      return {
-        name: FormData.#scalarValue(name),
-        value: FormData.#scalarValue(value),
-      };
-    }
-
-    if (typeof File === 'undefined') {
-      if (!('name' in value) && !('lastModified' in value)) {
-        /** @type {File} */
-        // eslint-disable-next-line unicorn/prefer-spread
-        const file = Object.defineProperties(value.slice(), {
-          name: {
-            value: filename === undefined ? 'blob' : filename,
-          },
-          lastModified: {
-            value: Date.now(),
-          },
-          toString: { value: () => '[object File]' },
-        });
-        return {
-          name: FormData.#scalarValue(name),
-          value: file,
-        };
-      }
-      return {
-        name: FormData.#scalarValue(name),
-        value,
-      };
-    }
-    if (value instanceof File) {
-      return {
-        name: FormData.#scalarValue(name),
-        value,
-      };
-    }
-    return {
-      name: FormData.#scalarValue(name),
-      value: new File([value], filename === undefined ? 'blob' : filename, {}),
-    };
-  }
-
-  /**
-   * @param {string} name
-   * @param {string|Blob} value
-   * @param {string} [filename]
-   * @return {void}
-   */
-  append(name, value, filename) {
-    const entry = FormData.#createEntry(name, value, filename);
-    console.log(entry);
-    if (this.#list.has(entry.name)) {
-      this.#list.get(entry.name).push(entry.value);
-    } else {
-      this.#list.set(name, [entry.value]);
-    }
-  }
-
-  /**
-   * @param {string} name
-   * @return {void}
-   */
-  delete(name) {
-    this.#list.delete(name);
-  }
-
-  /**
-   * @param {string} name
-   * @return {null|File|string}
-   */
-  get(name) {
-    const entry = this.#list.get(name);
-    if (!entry) return null;
-    return entry[0];
-  }
-
-  /**
-   * @param {string} name
-   * @return {(File|string)[]}
-   */
-  getAll(name) {
-    return this.#list.get(name) ?? [];
-  }
-
-  /**
-   * @param {string} name
-   * @return {boolean}
-   */
-  has(name) {
-    return this.#list.has(name);
-  }
-
-  /**
-   * @param {string} name
-   * @param {string|Blob} value
-   * @param {string} [filename]
-   * @return {void}
-   */
-  set(name, value, filename) {
-    const entry = FormData.#createEntry(name, value, filename);
-    if (this.#list.has(entry.name)) {
-      const entries = this.#list.get(name);
-      entries.splice(0, entries.length, entry.value);
-    } else {
-      this.#list.set(name, [entry.value]);
-    }
-  }
-
-  /**
-   * @param {(value:(string|File), key:string, parent:this) => void} callback
-   * @return {void}
-   */
-  forEach(callback) {
-    for (const [key, value] of this) {
-      callback(value, key, this);
-    }
-  }
-
-  get keys() {
-    return this.#list.keys;
-  }
-
-  * values() {
-    for (const value of this.#list.values()) {
-      yield value[0];
-    }
-  }
-
-  * [Symbol.iterator]() {
-    for (const entry of this.#list.entries()) {
-      yield /** @type {[string, string|File]} */ ([entry[0], entry[1][0]]);
-    }
-  }
-}
-
-FormData.prototype.entries = FormData.prototype[Symbol.iterator];
-FormData.prototype.toString = () => '[Object FormData]';

package/rollup.config.js

@@ -1,8 +0,0 @@
-/** @typedef {import('rollup')} */
-export default {
-  input: 'index.js',
-  output: {
-    file: 'index.cjs',
-    format: 'cjs',
-  },
-};

package/scripts/check-teapot.mjs

@@ -1,40 +0,0 @@
-import http from 'node:http';
-import * as starter from '../templates/starter.js';
-
-async function run() {
-  const throwingMiddleware = [() => { throw new Error('brew failed'); }];
-  const teapotHandler = {
-    onError(transaction) {
-      transaction.response.status = 418;
-      return "I'm a teapot";
-    },
-  };
-
-  const listener = await starter.start({ middleware: throwingMiddleware, errorHandlers: [teapotHandler], host: '127.0.0.1', port: 0 });
-  try {
-    const addr = listener.httpServer.address();
-    const port = typeof addr === 'object' ? addr.port : addr;
-    const result = await new Promise((resolve, reject) => {
-      const req = http.get({ port, path: '/' }, (res) => {
-        let data = '';
-        res.setEncoding('utf8');
-        res.on('data', (c) => { data += c; });
-        res.on('end', () => resolve({ status: res.statusCode, body: data }));
-      });
-      req.on('error', reject);
-    });
-
-    // Print a concise confirmation
-    // (CI will show this output in the terminal)
-    // eslint-disable-next-line no-console
-    console.log('TEAPOT_CHECK_RESULT', JSON.stringify(result));
-  } finally {
-    await listener.stopHttpServer();
-  }
-}
-
-run().catch((err) => {
-  // eslint-disable-next-line no-console
-  console.error('check-teapot failed', err);
-  process.exit(1);
-});

package/scripts/test-all-sync.sh

@@ -1,6 +0,0 @@
-. ~/.nvm/nvm.sh; 
-nvm install 16.13; nvm use 16.13; npx c8 --clean false -r none ava;
-nvm install 16   ; nvm use 16   ; npx c8 --clean false -r none ava;
-nvm install 18   ; nvm use 18   ; npx c8 --clean false -r none ava;
-nvm install 20   ; nvm use 20   ; npx c8 --clean false -r none ava;
-nvm install 22   ; nvm use 22   ; npx c8 --clean false -r none ava;

package/scripts/test-all.sh

@@ -1,7 +0,0 @@
-echo . \
-  & sh -c ". ~/.nvm/nvm.sh; nvm install 16.13; nvm use 16.13; npx c8 --clean false -r none ava;" \
-  & sh -c ". ~/.nvm/nvm.sh; nvm install 16; nvm use 16; npx c8 --clean false -r none ava;" \
-  & sh -c ". ~/.nvm/nvm.sh; nvm install 18; nvm use 18; npx c8 --clean false -r none ava;" \
-  & sh -c ". ~/.nvm/nvm.sh; nvm install 20; nvm use 20; npx c8 --clean false -r none ava;" \
-  & sh -c ". ~/.nvm/nvm.sh; nvm install 22; nvm use 22; npx c8 --clean false -r none ava;" \
-  

package/test/fixtures/stream.js

@@ -1,68 +0,0 @@
-import { createHash } from 'node:crypto';
-import {
-  Readable, pipeline as legacyPipeline,
-} from 'node:stream';
-import { promisify } from 'node:util';
-
-/** @type {import('node:stream/promises').pipeline} */
-let pipeline;
-try {
-  ({ pipeline } = (await import('node:stream/promises')));
-} catch {
-  pipeline = promisify(legacyPipeline);
-}
-
-const BUFFER_SIZE = 1024 * 16;
-const CHUNK_SIZE = 256 / 8;
-const CHUNK_COUNT = BUFFER_SIZE / CHUNK_SIZE;
-
-const SEED = Math.floor(Math.random() * (2 ** 4));
-
-/** @yields {Buffer} */
-function* binaryGenerator() {
-  for (let index = 0; index < CHUNK_COUNT; index++) {
-    const number_ = (SEED + index);
-    /* eslint-disable no-bitwise */
-    yield createHash('sha256').update(Buffer.from([
-      (number_ >> 24) & 255,
-      (number_ >> 16) & 255,
-      (number_ >> 8) & 255,
-      number_ & 255,
-    ])).digest();
-    /* eslint-enable no-bitwise */
-  }
-}
-
-/** @yields {Buffer} */
-function* textGenerator() {
-  for (const chunk of binaryGenerator()) {
-    const hexString = chunk.toString('hex');
-    yield Buffer.from(hexString, 'utf-8');
-  }
-}
-
-/** @return {Readable} */
-export function getTestBinaryStream() {
-  return Readable.from(binaryGenerator());
-}
-
-/** @return {Readable} */
-export function getTestTextStream() {
-  return Readable.from(textGenerator());
-}
-
-/** @return {Promise<string>} */
-export async function getTestHash() {
-  const hash = createHash('sha256');
-  await pipeline(binaryGenerator(), hash);
-  return hash.digest().toString('hex');
-}
-
-/** @return {string} */
-export function getTestString() {
-  let data = '';
-  for (const chunk of textGenerator()) {
-    data += chunk;
-  }
-  return data;
-}

package/test/helpers/HttpListener/construct.js

@@ -1,18 +0,0 @@
-import test from 'ava';
-
-import HttpListener from '../../../helpers/HttpListener.js';
-
-test('HttpListener can be constructed with defaults', (t) => {
-  const listener = new HttpListener();
-  t.truthy(listener);
-  t.is(typeof listener.startHttpServer, 'function');
-  t.is(typeof listener.stopHttpServer, 'function');
-});
-
-test('HttpListener.defaultInstance returns a singleton', (t) => {
-  const inst1 = HttpListener.defaultInstance;
-  const inst2 = HttpListener.defaultInstance;
-  t.truthy(inst1);
-  t.is(inst1, inst2);
-  t.true(inst1 instanceof HttpListener);
-});

package/test/helpers/HttpListener/customOptions.js

@@ -1,22 +0,0 @@
-import test from 'ava';
-import HttpListener from '../../../helpers/HttpListener.js';
-
-// Test custom port/host and handler injection
-
-test('custom insecurePort and insecureHost are set', t => {
-  const listener = new HttpListener({ insecurePort: 1234, insecureHost: '127.0.0.1' });
-  t.is(listener.insecurePort, 1234);
-  t.is(listener.insecureHost, '127.0.0.1');
-});
-
-test('custom securePort and secureHost are set', t => {
-  const listener = new HttpListener({ securePort: 4321, secureHost: 'localhost' });
-  t.is(listener.securePort, 4321);
-  t.is(listener.secureHost, 'localhost');
-});
-
-test('custom httpHandler is set', t => {
-  const fakeHandler = { handleHttp1Request() {}, handleHttp2Stream() {} };
-  const listener = new HttpListener({ httpHandler: fakeHandler });
-  t.is(listener.httpHandler, fakeHandler);
-});

package/test/helpers/HttpListener/doubleCreate.js

@@ -1,40 +0,0 @@
-import test from 'ava';
-
-import HttpListener, { SERVER_ALREADY_CREATED } from '../../../helpers/HttpListener.js';
-
-// Test double server creation throws error
-test('createHttpServer throws if called twice with custom options', (t) => {
-  const listener = new HttpListener();
-  listener.createHttpServer();
-  t.notThrows(() => listener.createHttpServer());
-  t.notThrows(() => listener.createHttpServer({}));
-  const err = t.throws(() => listener.createHttpServer({ maxHeaderSize: 8192 }));
-  t.truthy(err);
-  t.is(err.message, SERVER_ALREADY_CREATED);
-});
-
-// Use environment variables for PEM string values
-const key = process.env.TEST_SSL_KEY;
-const cert = process.env.TEST_SSL_CERT;
-const haveCerts = key && cert;
-const testFn = (haveCerts ? test : test.skip);
-
-testFn('createHttpsServer throws if called twice with custom options', (t) => {
-  const listener = new HttpListener({ useHttps: true, tlsOptions: { key, cert } });
-  listener.createHttpsServer();
-  t.notThrows(() => listener.createHttpsServer());
-  t.notThrows(() => listener.createHttpsServer({}));
-  const err = t.throws(() => listener.createHttpsServer({ maxHeaderSize: 8192 }));
-  t.truthy(err);
-  t.is(err.message, SERVER_ALREADY_CREATED);
-});
-
-testFn('createHttp2Server throws if called twice with custom options', (t) => {
-  const listener = new HttpListener({ useHttp2: true, tlsOptions: { key, cert } });
-  listener.createHttp2Server();
-  t.notThrows(() => listener.createHttp2Server());
-  t.notThrows(() => listener.createHttp2Server({}));
-  const err = t.throws(() => listener.createHttp2Server({ settings: { maxConcurrentStreams: 100 } }));
-  t.truthy(err);
-  t.is(err.message, SERVER_ALREADY_CREATED);
-});

package/test/helpers/HttpListener/events.js

@@ -1,77 +0,0 @@
-import * as http from 'node:http';
-import { Socket } from 'node:net';
-
-import test from 'ava';
-
-import HttpListener from '../../../helpers/HttpListener.js';
-
-// Event listener coverage: simulate error/clientError/request events
-
-test('httpServer emits error and clientError', (t) => {
-  const listener = new HttpListener();
-  const server = listener.createHttpServer();
-  let errorCalled = false;
-  let clientErrorCalled = false;
-  server.on('error', () => { errorCalled = true; });
-  server.on('clientError', () => { clientErrorCalled = true; });
-  server.emit('error', new Error('test error'));
-  server.emit('clientError', new Error('test client error'), new EventTarget());
-  t.true(errorCalled);
-  t.true(clientErrorCalled);
-});
-
-// Cannot easily test request/stream/session events without real network, but can check listeners are attached
-
-test('listeners are attached for request and error events', async (t) => {
-  const listener = new HttpListener({ insecurePort: 0 });
-  await listener.startHttpServer();
-  const server = listener.httpServer;
-  t.true(server.listenerCount('request') > 0);
-  t.true(server.listenerCount('error') > 0);
-  t.true(server.listenerCount('clientError') > 0);
-  await listener.stopHttpServer();
-});
-
-// Test that 'clientError' event handler is called for bad request
-test('httpServer clientError event is called for bad request', async (t) => {
-  const listener = new HttpListener({ insecurePort: 0 });
-  await listener.startHttpServer();
-  const server = listener.httpServer;
-  let called = false;
-  server.on('clientError', () => { called = true; });
-  const address = server.address();
-  const port = typeof address === 'object' && address ? address.port : address;
-  const socket = new Socket();
-  socket.connect(Number(port), '127.0.0.1', () => {
-    socket.write('BAD REQUEST\r\n\r\n');
-    setTimeout(() => {
-      socket.destroy();
-    }, 50);
-  });
-  await new Promise((resolve) => setTimeout(resolve, 100));
-  t.true(called);
-  await listener.stopHttpServer();
-});
-
-// Test that 'error' event handler is called for server error
-test('httpServer error event is called', async (t) => {
-  const listener = new HttpListener({ insecurePort: 0 });
-  await listener.startHttpServer();
-  const server = listener.httpServer;
-  let called = false;
-  server.on('error', () => { called = true; });
-  server.emit('error', new Error('test error')); // Simulate error
-  t.true(called);
-  await listener.stopHttpServer();
-});
-
-// Test that listeners are removed after stop
-test('listeners are removed after stop', async (t) => {
-  const listener = new HttpListener({ insecurePort: 0 });
-  await listener.startHttpServer();
-  const server = listener.httpServer;
-  await listener.stopHttpServer();
-  t.is(server.listenerCount('request'), 0);
-  t.is(server.listenerCount('error'), 0);
-  t.is(server.listenerCount('clientError'), 0);
-});

package/test/helpers/HttpListener/http.js

@@ -1,31 +0,0 @@
-import { Socket } from 'node:net';
-
-import test from 'ava';
-
-import HttpListener from '../../../helpers/HttpListener.js';
-
-test('HttpListener.startHttpServer() and stopHttpServer() work', async (t) => {
-  const listener = new HttpListener({ insecurePort: 0 }); // Use ephemeral port
-  const server = await listener.startHttpServer();
-  t.truthy(server);
-  await listener.stopHttpServer();
-  t.pass();
-});
-
-test('HttpListener HTTP server closes idle socket after keepAliveTimeout', async (t) => {
-  const listener = new HttpListener({ insecurePort: 0 });
-  await listener.startHttpServer();
-  const server = listener.httpServer;
-  server.setTimeout(1000); // Set keepAliveTimeout to 1 seconds
-  const address = server.address();
-  const port = typeof address === 'object' && address ? address.port : address;
-  const socket = new Socket();
-  let destroyed = false;
-  socket.on('close', () => { destroyed = true; });
-  socket.connect(Number(port), '127.0.0.1', () => {
-    // Do not send any data, just keep connection open
-  });
-  await new Promise((resolve) => setTimeout(resolve, 2000));
-  t.true(destroyed, 'Socket should be destroyed after keepAliveTimeout');
-  await listener.stopHttpServer();
-});

package/test/helpers/HttpListener/http2.js

@@ -1,41 +0,0 @@
-import { connect } from 'node:http2';
-
-import test from 'ava';
-
-import HttpListener from '../../../helpers/HttpListener.js';
-
-const key = process.env.TEST_SSL_KEY;
-const cert = process.env.TEST_SSL_CERT;
-const haveCerts = key && cert;
-
-const testFn = haveCerts ? test : test.skip;
-
-testFn('HttpListener.startHttp2Server() and stopHttp2Server() work', async (t) => {
-  const tlsOptions = { key, cert };
-  const listener = new HttpListener({ securePort: 0, useHttp2: true, tlsOptions });
-  const server = await listener.startHttp2Server();
-  t.truthy(server);
-  await listener.stopHttp2Server();
-  t.pass();
-});
-
-testFn('HttpListener HTTP2 server closes idle socket after setTimeout', async (t) => {
-  const tlsOptions = { key, cert };
-  const listener = new HttpListener({ securePort: 0, useHttp2: true, tlsOptions });
-  await listener.startHttp2Server();
-  const server = listener.http2Server;
-  server.setTimeout(1000); // Set keepAliveTimeout to 1 seconds
-  const address = server.address();
-  const port = typeof address === 'object' && address ? address.port : address;
-  const client = connect(`https://127.0.0.1:${port}`, {
-    ca: cert,
-    rejectUnauthorized: false,
-  });
-  let closed = false;
-  client.on('close', () => { closed = true; });
-  // Do not send any requests, just keep connection open
-  await new Promise((resolve) => setTimeout(resolve, 2000));
-  t.true(closed, 'HTTP2 client should be closed after setTimeout');
-  client.destroy();
-  await listener.stopHttp2Server();
-});

package/test/helpers/HttpListener/https.js

@@ -1,38 +0,0 @@
-import { connect as tlsConnect } from 'node:tls';
-
-import test from 'ava';
-
-import HttpListener from '../../../helpers/HttpListener.js';
-
-const key = process.env.TEST_SSL_KEY;
-const cert = process.env.TEST_SSL_CERT;
-const haveCerts = key && cert;
-
-const testFn = haveCerts ? test : test.skip;
-
-testFn('HttpListener.startHttpsServer() and stopHttpsServer() work', async (t) => {
-  const tlsOptions = { key, cert };
-  const listener = new HttpListener({ securePort: 0, useHttps: true, tlsOptions });
-  const server = await listener.startHttpsServer();
-  t.truthy(server);
-  await listener.stopHttpsServer();
-  t.pass();
-});
-
-testFn('HttpListener HTTPS server closes idle socket after keepAliveTimeout', async (t) => {
-  const tlsOptions = { key, cert };
-  const listener = new HttpListener({ securePort: 0, useHttps: true, tlsOptions });
-  await listener.startHttpsServer();
-  const server = listener.httpsServer;
-  server.setTimeout(1000);
-  const address = server.address();
-  const port = typeof address === 'object' && address ? address.port : address;
-  let destroyed = false;
-  const socket = tlsConnect({ port: Number(port), host: '127.0.0.1', rejectUnauthorized: false }, () => {
-    // Do not send any data, just keep connection open
-  });
-  socket.on('close', () => { destroyed = true; });
-  await new Promise((resolve) => setTimeout(resolve, 2000));
-  t.true(destroyed, 'TLS socket should be destroyed after keepAliveTimeout');
-  await listener.stopHttpsServer();
-});

package/test/helpers/HttpListener/startAll.js

@@ -1,31 +0,0 @@
-import test from 'ava';
-
-import HttpListener from '../../../helpers/HttpListener.js';
-
-// Test startAll and stopAll with all modes enabled (HTTP, HTTPS, HTTP/2)
-
-const key = process.env.TEST_SSL_KEY;
-const cert = process.env.TEST_SSL_CERT;
-const haveCerts = !!key && !!cert;
-
-test('HttpListener.startAll() and stopAll() work (all modes)', async (t) => {
-  const listener = new HttpListener({
-    insecurePort: 0,
-    securePort: 0,
-    useHttp: true,
-    useHttps: haveCerts,
-    useHttp2: haveCerts,
-    tlsOptions: haveCerts ? { key, cert } : undefined,
-  });
-  const [http, https, http2] = await listener.startAll();
-  t.truthy(http);
-  if (haveCerts) {
-    t.truthy(https);
-    t.truthy(http2);
-  } else {
-    t.is(https, null);
-    t.is(http2, null);
-  }
-  await listener.stopAll();
-  t.pass();
-});

package/test/helpers/HttpListener/stopNotStarted.js

@@ -1,23 +0,0 @@
-import test from 'ava';
-import HttpListener from '../../../helpers/HttpListener.js';
-
-// Test stop methods when servers are not started (should resolve, not throw)
-test('stopHttpServer resolves if not started', async t => {
-  const listener = new HttpListener();
-  await t.notThrowsAsync(() => listener.stopHttpServer());
-});
-
-test('stopHttpsServer resolves if not started', async t => {
-  const listener = new HttpListener({ useHttps: true });
-  await t.notThrowsAsync(() => listener.stopHttpsServer());
-});
-
-test('stopHttp2Server resolves if not started', async t => {
-  const listener = new HttpListener({ useHttp2: true });
-  await t.notThrowsAsync(() => listener.stopHttp2Server());
-});
-
-test('stopAll resolves if nothing started', async t => {
-  const listener = new HttpListener({ useHttp: false, useHttps: false, useHttp2: false });
-  await t.notThrowsAsync(() => listener.stopAll());
-});

package/test/lib/HttpHandler/class.js

@@ -1,8 +0,0 @@
-import test from 'ava';
-
-import HttpHandler from '../../../lib/HttpHandler.js';
-
-test('new HttpHandler()', (t) => {
-  const instance = new HttpHandler({});
-  t.assert(instance instanceof HttpHandler);
-});

package/test/lib/HttpHandler/handleRequest.js

@@ -1,11 +0,0 @@
-import test from 'ava';
-import { PassThrough, Readable, Writable } from 'node:stream';
-
-import HttpHandler from '../../../lib/HttpHandler.js';
-import HttpRequest from '../../../lib/HttpRequest.js';
-import HttpResponse from '../../../lib/HttpResponse.js';
-
-test('HttpHandler.handleRequest()', async (t) => {
-
-  t.pass();
-});