CodeVetter · Repo Unpack · Data flow
honojs/hono
Incoming Requests pass through path extraction and router matching into a per-request Context. Middleware and validators progressively attach state before response construction. Clients and adapters serialize or translate data at the outer boundaries. Cache writes and SSG files are separate optional output paths with different ownership and lifetime.
- fetch(request, env, executionCtx) forwards the method and supplied runtime values into #dispatch(), which extracts the path, matches routes and constructs Context.
- Router results carry handler tuples and either parameter indexes with a stash or direct parameter maps; HonoRequest resolves the active route's parameters and decodes their values.
- compose dispatch assigns req.routeIndex before each handler, calls the next handler recursively and places returned responses into Context.
- HonoRequest caches consumed body representations and rebuilds alternate representations through Response while retaining the original media type except for FormData.
- Validation parses the selected boundary, awaits validationFunc(), returns Response results immediately, and stores other results through addValidatedData() for valid().
- Context JSON responses stringify objects and supply application/json; #newResponse combines existing/prepared headers, explicit headers and status.
- ClientRequestImpl serializes forms or JSON, substitutes path parameters, appends query parameters and invokes supplied fetch or global fetch; GET and HEAD omit request bodies.
- Lambda EventProcessor builds an HTTPS Request from event path/domain/query/headers, decodes base64 bodies, then serializes the Response to text or base64 with platform cookie handling.
- Cache keys encode the logical key, method and configured header variants; QUERY additionally hashes representation metadata and body bytes within a configured size ceiling.
- SSG routes become application Responses, then text or ArrayBuffer content, MIME-derived file paths and filesystem writes after output-containment validation.