[thetutlage]

Summary

Adds a CodeGen class that performs the codegen the dev-server performs, without the server and without the file watcher.

Pairs with adonisjs/application#48 and the node ace codegen command in core.

Why

The dev-server, the bundler and the test runner all generate code as a side effect of doing something else, so there is no way to refresh .adonisjs on its own. That matters in CI, where you want the generated types to be current before typechecking or building, without starting a long running process.

Worth noting: only the dev-server loads the routes hooks today. The bundler loads ['init', 'buildStarting', 'buildFinished'] and the test runner ['init', 'testsStarting', 'testsFinished']. So anything hanging off routesCommitted / routesScanned — a Tuyau registry, for instance — is only regenerated while npm run dev is running.

The two stages, and why the order is forced

Static stage — run the init hooks against an IndexGenerator and write the index files. Only the file-system is needed.

Runtime stage — run the routes hooks. This needs state only a booted application knows about.

Assembler never boots an application, so the caller supplies that state. It cannot simply be passed in, because the stages are ordered: an application imports the generated barrel files from its preload files (start/routes.ts does import { controllers } from '#generated/controllers'), so it cannot be booted until the index files exist. The dev-server generates them before spawning the app for exactly this reason.

Hence the callback:

const codegen = new CodeGen(cwd, { hooks: rcFile.hooks })

await codegen.run(async () => {
  await app.boot()
  await app.warmUp()
  router.commit()
  return { routes: router.toJSON() }
})

Ordering is structural rather than documented, and there is a test pinning it. Skip the callback to generate the index files alone.

The snapshot is a keyed bag rather than a positional argument, so a second runtime producer later does not change the signature.

Shared with the dev-server

The sequence for sharing and scanning routes was identical in both, so it now lives in processRoutes / hasRoutesHooks in utils.ts. Each caller keeps its own edges: the dev-server keeps the throttle, the file read, the unlinks and the try/catch that logs and continues; CodeGen takes the routes in memory and lets errors throw, so a command can exit non-zero.

Breaking

The hook parent unions widen — CommonHooks.init to DevServer | TestRunner | Bundler | CodeGen, and the three RouterHooks to DevServer | CodeGen. A hook reading DevServer-only members without narrowing will no longer compile.

Tests

9 new tests in tests/codegen.spec.ts, including one that asserts the index files exist by the time the snapshot callback runs.