Function fetchLocalOpenApi

docs/scripts/extract-openapi.mjs:95–136

Local dev: Node http so Host is honored (undici fetch may override Host for http URLs).

(port, hostHeader)

/** Local dev: Node http so Host is honored (undici fetch may override Host for http URLs). */
function fetchLocalOpenApi(port, hostHeader) {
  return new Promise((resolve, reject) => {
    const req = http.request(
      {
        hostname: '127.0.0.1',
        port: Number(port),
        path: '/2/openapi.json',
        method: 'GET',
        timeout: 30_000,
        headers: {
          'Host': hostHeader,
          'User-Agent': 'FxEmbed-Docs-Builder/1.0'
        }
      },
      res => {
        let data = '';
        res.setEncoding('utf8');
        res.on('data', chunk => {
          data += chunk;
        });
        res.on('end', () => {
          if (res.statusCode !== undefined && res.statusCode >= 200 && res.statusCode < 300) {
            try {
              resolve(JSON.parse(data));
            } catch (e) {
              const msg = e instanceof Error ? e.message : String(e);
              reject(new Error(`Invalid JSON: ${msg}`));
            }
          } else {
            reject(new Error(`HTTP ${res.statusCode}: ${data.slice(0, 200)}`));
          }
        });
      }
    );
    req.on('timeout', () => {
      req.destroy();
      reject(new Error('Request timed out'));
    });
    req.on('error', reject);
    req.end();
  });
}

async function fetchSpec(endpoint, localPort) {
  if (localPort) {