@hono/node-server 2.1.0: RequestError

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify @hono/node-server.RequestError in pkg:npm/%40hono/node-server@2.1.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/%40hono/node-server@2.1.0
Demonstrate these symbols/APIs:
  - @hono/node-server.RequestError

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:a8abdee092d1ac45458ae99f957a6cc94d0abcf940e49910dda82ab4a50e8c21","contract":["@hono/node-server exports RequestError class extending Error","RequestError supports options.cause for error chaining","getRequestListener passes RequestError to errorHandler on missing host header","getRequestListener passes RequestError to errorHandler on invalid host header","serve returns HTTP 400 Bad Request when incoming request triggers RequestError"],"goal":"verify @hono/node-server.RequestError in pkg:npm/%40hono/node-server@2.1.0","kind":"HOW","packages":["pkg:npm/%40hono/node-server@2.1.0"],"schemaVersion":1,"symbols":["@hono/node-server.RequestError"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"esm","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/%40hono/node-server@2.1.0"],"schemaVersion":1,"subject":"pkg:npm/%40hono/node-server@2.1.0","symbols":["@hono/node-server.RequestError"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-hono-node-server-requesterror",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-hono-node-server-requesterror",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "@hono/node-server": "2.1.0"
      }
    },
    "node_modules/@hono/node-server": {
      "version": "2.1.0",
      "resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-2.1.0.tgz",
      "integrity": "sha512-XovyyCCnBzW+zKu+z/zq8hwNs4KOR5rEMAOxo2f40Q5xoOI37IMm6MIg2COOUtUApo0i6850MTBKH2u4QLGIqg==",
      "license": "MIT",
      "engines": {
        "node": ">=20"
      },
      "peerDependencies": {
        "hono": "^4"
      }
    },
    "node_modules/hono": {
      "version": "4.13.5",
      "resolved": "https://registry.npmjs.org/hono/-/hono-4.13.5.tgz",
      "integrity": "sha512-O6+/eCYRkzzzy0rPWwKLiGBR1nFuUPZynnwjxN1MBA62NNqbT0wQEzQyK2gSO5yDIDB336sXQleAhOHrzlYyKw==",
      "license": "MIT",
      "peer": true,
      "engines": {
        "node": ">=16.9.0"
      }
    }
  }
}

{
  "name": "sample-hono-node-server-requesterror",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "license": "MIT-0",
  "dependencies": {
    "@hono/node-server": "2.1.0"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify @hono/node-server.RequestError in pkg:npm/%40hono/node-server@2.1.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/%40hono/node-server@2.1.0"
  ],
  "symbols": [
    "@hono/node-server.RequestError"
  ]
}

import assert from 'node:assert/strict';
import http from 'node:http';
import net from 'node:net';
import { RequestError, getRequestListener, serve } from '@hono/node-server';

// Contract 1: @hono/node-server exports RequestError class extending Error
{
  assert.strictEqual(typeof RequestError, 'function');
  const err = new RequestError('test error');
  assert.ok(err instanceof Error);
  assert.ok(err instanceof RequestError);
  assert.strictEqual(err.name, 'RequestError');
  assert.strictEqual(err.message, 'test error');
}

// Contract 2: RequestError supports options.cause for error chaining
{
  const cause = new Error('underlying reason');
  const err = new RequestError('wrapper error', { cause });
  assert.ok(err instanceof RequestError);
  assert.strictEqual(err.message, 'wrapper error');
  assert.strictEqual(err.cause, cause);
}

// Contract 3: getRequestListener passes RequestError to errorHandler on missing host header
{
  let capturedError = null;
  const listener = getRequestListener(
    () => new Response('ok'),
    {
      errorHandler: (err) => {
        capturedError = err;
        return new Response(JSON.stringify({ error: err.name, message: err.message }), {
          status: 400,
          headers: { 'content-type': 'application/json' },
        });
      },
    }
  );

  const server = http.createServer(listener);
  await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
  const { port } = server.address();

  await new Promise((resolve, reject) => {
    const socket = net.connect({ port, host: '127.0.0.1' }, () => {
      socket.write('GET / HTTP/1.0\r\nConnection: close\r\n\r\n');
    });
    let res = '';
    socket.on('data', (chunk) => { res += chunk.toString(); });
    socket.on('end', () => {
      try {
        assert.ok(capturedError instanceof RequestError);
        assert.strictEqual(capturedError.name, 'RequestError');
        assert.strictEqual(capturedError.message, 'Missing host header');
        assert.ok(res.includes('400 Bad Request') || res.includes('400'));
        assert.ok(res.includes('RequestError'));
        resolve();
      } catch (e) {
        reject(e);
      }
    });
    socket.on('error', reject);
  });

  await new Promise((resolve, reject) => {
    server.close((err) => (err ? reject(err) : resolve()));
  });
}

// Contract 4: getRequestListener passes RequestError to errorHandler on invalid host header
{
  let capturedError = null;
  const listener = getRequestListener(
    () => new Response('ok'),
    {
      errorHandler: (err) => {
        capturedError = err;
        return new Response(JSON.stringify({ error: err.name, message: err.message }), {
          status: 400,
          headers: { 'content-type': 'application/json' },
        });
      },
    }
  );

  const server = http.createServer(listener);
  await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
  const { port } = server.address();

  await new Promise((resolve, reject) => {
    const socket = net.connect({ port, host: '127.0.0.1' }, () => {
      socket.write('GET / HTTP/1.1\r\nHost: foo#bar\r\nConnection: close\r\n\r\n');
    });
    let res = '';
    socket.on('data', (chunk) => { res += chunk.toString(); });
    socket.on('end', () => {
      try {
        assert.ok(capturedError instanceof RequestError);
        assert.strictEqual(capturedError.name, 'RequestError');
        assert.strictEqual(capturedError.message, 'Invalid host header');
        assert.ok(res.includes('400'));
        resolve();
      } catch (e) {
        reject(e);
      }
    });
    socket.on('error', reject);
  });

  await new Promise((resolve, reject) => {
    server.close((err) => (err ? reject(err) : resolve()));
  });
}

// Contract 5: serve returns HTTP 400 Bad Request when incoming request triggers RequestError
{
  const server = serve({
    fetch: () => new Response('ok'),
    port: 0,
  });

  await new Promise((resolve) => {
    if (server.listening) resolve();
    else server.once('listening', resolve);
  });

  const { port } = server.address();

  await new Promise((resolve, reject) => {
    const socket = net.connect({ port, host: '127.0.0.1' }, () => {
      socket.write('GET / HTTP/1.0\r\nConnection: close\r\n\r\n');
    });
    let res = '';
    socket.on('data', (chunk) => { res += chunk.toString(); });
    socket.on('end', () => {
      try {
        assert.ok(res.includes('400 Bad Request'));
        resolve();
      } catch (e) {
        reject(e);
      }
    });
    socket.on('error', reject);
  });

  await new Promise((resolve, reject) => {
    server.close((err) => (err ? reject(err) : resolve()));
  });
}

console.log('All @hono/node-server RequestError contract tests passed.');