CodeVetter · Repo Unpack · Behavior traces
honojs/hono
Source reads followed registration and first-request routing, validated requests, cache persistence, Lambda translation and static generation. These traces describe function order and branches rather than executed observations. The default router becomes fixed after its first match. SSG executes application handlers as part of both route discovery and output production.
- Startup registration: new Hono() calls HonoBase's constructor, initializes registration functions, selects SmartRouter, and app.get()/use() call #addRoute() to append metadata and router entries.
- First request: fetch() → #dispatch() → getPath() → SmartRouter.match(); SmartRouter replays stored routes into candidates, skips UnsupportedPathError, and replaces match with the selected router's bound implementation.
- Single-handler GET: #dispatch() invokes the handler directly; a returned Response is delivered and Promise rejection reaches #handleError(). For a Promise resolving without a response, a finalized Context returns c.res; otherwise notFound is used. A synchronous nullish return falls back to notFound.
- Validated POST: compose.dispatch() invokes validator('json') → req.json() → cached text → JSON.parse() → validationFunc(); transformed output enters addValidatedData(), next() reaches the handler, and c.json() serializes its response.
- Malformed JSON: validator catches body parsing failure and throws HTTPException(400); compose catches Error instances and passes them to onError, while the default handler uses getResponse().
- Cache hit: cache middleware checks method and Authorization, computes a QUERY digest when needed, generates the key, opens caches, matches it and returns a new Response without calling downstream handlers.
- Cache miss and persistence: cache.match() misses → await next() → status/Vary/Cache-Control/Set-Cookie checks → response.clone() → awaited cache.put() or executionCtx.waitUntil(cache.put()).
- Lambda request: handle(app) chooses getProcessor(), calls createRequest(), passes event/requestContext/lambdaContext to app.fetch(), then calls createResult(); request-construction TypeErrors become 400 results.
- Static generation: toSSG() combines hooks → fetchRoutesContent() filters routes and calls app.fetch() for metadata → parameter expansion calls app.request() → response hooks transform/filter content → saveContentToFile() creates directories and writes files.
- SSE output: streamSSE() constructs TransformStream/SSEStreamingApi, sets protocol headers and starts run(); callback writeSSE() escapes line structure and writes framed events, and run() closes the stream in finally.