[yangshun]

Summary

With routing.typedRoutes on, the url argument of connectEventStream() (void/sse/client) and connectLiveStream() (void/live/client) is now checked against the app's routes, like Link, router methods and c.rewrite().

Both clients accept:

• one of the app's route URLs, including template literals for dynamic routes and a query/hash suffix (`/api/users/${id}`),
• an absolute http:// or https:// URL, for a stream on another origin,
• a URL object.

They reject unknown paths, ws:///wss://, mailto:, tel:, same-page ?/# URLs and unchecked string values. A string TypeScript can't check is cast with as RouteUrl, which turns the check off for that URL.

connectEventStream('/api/logs'); // ok
connectEventStream(`/api/users/${id}`); // ok
connectEventStream('https://example.com/events'); // ok
connectEventStream(path as RouteUrl); // ok, unchecked
connectEventStream('/api/lgos'); // type error
connectLiveStream('wss://example.com/live'); // type error

With the flag off, the parameter stays string | URL.

Neither client has a base-URL option: a path always resolves against the page's origin, so route checking applies to every relative string. The accepted string type (RequestUrl in route-url.ts) stays internal rather than being exported from void/routes; Href was not reused because it also allows mailto:, tel: and same-page URLs.

Docs

• docs/guide/sse.md, docs/guide/live.md: what typedRoutes checks for the client URL and how to cast.
• docs/guide/type-safety.md: "Checked URL strings" list, a paragraph on stream URLs, and the "What Gets Checked" table.
• docs/reference/config.md: routing.typedRoutes.

Tests

• packages/void/test/integration/route-url-builder.test.ts: the typed fixture (generated and package declarations) accepts a known route, a dynamic template literal, a RouteUrl, http(s) URLs, a URL and a RouteUrl cast; it rejects an unknown path, ws:///wss://, #details and an unchecked string. Reverting the SSE client's parameter to string | URL in dist makes the four SSE @ts-expect-error lines fail.
• packages/void/test/unit/typed-navigation.typecheck.ts: with the flag off, both parameters are exactly string | URL.

🤖 Generated with Claude Code

[cpojer]

So safe now.