Skip to content

Commit f692458

Browse files
kriszypclaude
andcommitted
docs: fastifyRoutes host mount fails to load, not just a warning
harper#1964's handleApplication throws when a host-mounted application declares fastifyRoutes, and componentLoader.ts catches it and marks the component failed — it doesn't continue running with a warning logged. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
1 parent f013ba2 commit f692458

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

reference/http/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ Handlers see the request with the mount already removed from the pathname, so ap
7171
A mount is a routing prefix, not an isolation boundary:
7272

7373
- **It does not namespace resources.** Exported tables live in one instance-wide registry, so a table exported by one application is reachable through any mounted REST route, not only its own.
74-
- **It does not constrain legacy Fastify routes by host.** `fastifyRoutes` registers as a global fallback outside the routed middleware chain, so those routes answer on every hostname. A `urlPath` mount does apply (it becomes the Fastify route prefix); a `host` mount does not, and Harper logs a warning when a host-mounted application declares `fastifyRoutes`. Port them to `server.http()` for host routing.
74+
- **It does not constrain legacy Fastify routes by host.** `fastifyRoutes` registers as a global fallback outside the routed middleware chain, so those routes answer on every hostname. A `urlPath` mount does apply (it becomes the Fastify route prefix); a `host` mount does not, and Harper refuses to load a host-mounted application that declares `fastifyRoutes` rather than silently serving it unconstrained. Port them to `server.http()` for host routing.
7575

7676
Host matching ignores the port and is case-insensitive. IPv6 hosts are configured as a bare literal (`::1`), not bracketed.
7777

0 commit comments

Comments
 (0)