webhoster 0.3.4 → 0.3.6

package/.vscode/settings.json

@@ -1,5 +0,0 @@
-{
-  "javascript.preferences.importModuleSpecifier": "relative",
-  "javascript.preferences.importModuleSpecifierEnding": "js",
-  "javascript.preferences.quoteStyle": "single"
-}

package/CHANGELOG.md

@@ -1,10 +0,0 @@
-## v0.0.5
-  * Fix SocketIO errata
-
-## v0.0.4
-  * Add CommonJS support
-  * Add `HttpListener` helper
-  * Add SocketIO errata
-
-## v0.0.3
-  * Rename RequestHandler to HttpHandler

package/CODE_OF_CONDUCT.md

@@ -1,76 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, sex characteristics, gender identity and expression,
-level of experience, education, socio-economic status, nationality, personal
-appearance, race, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
- advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
- address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
- professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at clshortfuse@gmail.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see
-https://www.contributor-covenant.org/faq

package/data/middleware.d.ts

@@ -1,14 +0,0 @@
-import {
-  IMiddleware,
-  MiddlewareContent,
-  MiddlewareFunction,
-  MiddlewareFunctionResultType,
-} from './custom-types.js';
-
-export type Middleware =
-  | IMiddleware
-  | MiddlewareFunction
-  | Middleware[]
-  | MiddlewareContent
-  | Set<Middleware>
-  | MiddlewareFunctionResultType

package/examples/starter.js

@@ -1,11 +0,0 @@
-import * as starter from '../templates/starter.js';
-
-const middleware = [
-  () => 'Hello world!',
-];
-
-// Start the singleton HTTP server using the starter convenience API.
-await starter.start({ middleware });
-
-// Export nothing — this example file is intended as a tiny runnable demo.
-export {};

package/jsconfig.json

@@ -1,12 +0,0 @@
-{
-  "compilerOptions": {
-    "checkJs": true,
-    "noImplicitAny": true,
-    "target": "es2022",
-    "module": "esnext",
-    "moduleResolution": "node"
-  },
-  "exclude": [
-    "**/node_modules/*"
-  ]
-}

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