Add `kind` field ("api" | "page" | "action" | "websocket") to EndpointInfo

[jorgeraad]

EndpointInfo today exposes the wire shape of a route (method, path, handler, file, params, auth) but not its categorical role. Consumers like apex currently derive that with hand-written file-path regex, which puts framework-specific knowledge in the wrong repo.

Add a required kind field to EndpointInfo in src/types.ts, plus an optional kind? parameter to the endpoint() factory in src/utils.ts (defaulting to "api" for migration ergonomics). Existing extractors get explicit kind: "api" calls — mechanical no-op since the factory default matches.

Four values:

• "api" — REST / GraphQL / RPC / generic JSON HTTP routes.
• "page" — server-rendered or client-routed page returning HTML/RSC.
• "action" — RPC-style call invoked from UI (Next.js Server Actions). Companion to `method: "ACTION"`.
• "websocket" — persistent bidirectional channel. Companion to `method: "WS"`.

The factoring is deliberate: method carries the HTTP verb (or wire-shape distinction for WS / ACTION today, until they migrate to kind), kind carries the protocol/role category. Two fields, orthogonal concepts.

Foundation for the Next.js page extraction work and future page detection in Rails / Django / FastAPI / Spring view-rendering routes.

[jorgeraad]

@cursor please take a look

[cursor]

Here's a summary of the implementation in PR #5:

• Added EndpointKind type ("api" | "page" | "action" | "websocket") to types.ts and a required kind field to EndpointInfo.
• Updated the endpoint() factory in utils.ts with an optional kind? parameter defaulting to "api", so all existing extractors work without changes.
• Set explicit kind values in the two extractors where method already signals non-API behavior: kind: "action" in server-actions.ts and kind: "websocket" for FastAPI websocket routes in fastapi.ts.
• Threaded kind through formatters — both format.ts and format-impact.ts now include kind in their JSON and NDJSON output.
• Exported EndpointKind from the public API in index.ts.

All checks pass: tsc --noEmit, eslint, prettier --check, and the smoke test all succeed. The build produces correct output with the new field (verified endpoints show kind: "api" by default).

  

[jorgeraad]

Addressed by #5