Function buildSchemas

scripts/build-schemas.js:56–181

(
  externalHTTPRoutes = [],
  externalWebSocketRoutes = [],
)

 * @param {string[]} externalWebSocketRoutes Additional WS routes to parse
 */
const buildSchemas = async (
  externalHTTPRoutes = [],
  externalWebSocketRoutes = [],
) => {
  const { getRouteFiles, tsExtension } = await import('../build/utils.js');

  const schemas = ['BodySchema', 'QuerySchema', 'ResponseSchema'];
  const settings = {
    ignoreErrors: true,
    noExtraProps: true,
    required: true,
  };

  const { compilerOptions } = JSON.parse(
    await fs.readFile('tsconfig.json', 'utf-8'),
  );

  const { Config } = await import('../build/config.js');
  const [httpRoutes, wsRoutes] = await getRouteFiles(new Config());

  // Depending on if we're parsing an external projects routes,
  // skip the prebuilt ones. This makes it much faster to build
  const routesToParse = (
    moduleMain
      ? [...httpRoutes, ...wsRoutes]
      : [...externalHTTPRoutes, ...externalWebSocketRoutes]
  ).filter((r) => r.endsWith(tsExtension));

  if (routesToParse.length === 0) {
    return;
  }

  // Build a SINGLE TypeScript program for every route up front. Previously a
  // fresh program was created per route, which re-parsed the entire standard
  // lib and the large transitive `.d.ts` graph (puppeteer-core, playwright,
  // @types/node) once per file — the dominant cost of this script. One shared
  // program does that work a single time.
  //
  // Schema generation must be deterministic and independent of the consumer's
  // runtime module settings. Under moduleResolution "nodenext"/"node16", types
  // pulled from dual CJS/ESM packages (e.g. puppeteer-core) serialize as
  // absolute-path `import("...",{with:{"resolution-mode":"import"}}).Type`
  // $ref names that the ajv-backed validator cannot resolve at request time.
  // Forcing the canonical es2022/bundler resolution yields stable, named $refs
  // for every consumer regardless of how their own tsconfig is configured.
  const program = TJS.getProgramFromFiles(
    routesToParse,
    { ...compilerOptions, module: 'es2022', moduleResolution: 'bundler' },
    './',
  );

  // `uniqueNames` lets identically-named interfaces (e.g. every route's
  // `BodySchema`) coexist in one program by suffixing each definition with a
  // hash. We use it only to address the specific symbol a given route exports;
  // the suffixes are stripped from the emitted files (see stripHashSuffixes).
  const generator = TJS.buildGenerator(program, {
    ...settings,
    uniqueNames: true,