EventHandlerAPIPlugin (enterprise) docs

[masenf]

No description provided.

[greptile-apps]

Greptile Summary

This PR adds documentation for the rxe.EventHandlerAPIPlugin enterprise feature, which exposes Reflex event handlers as HTTP POST endpoints with auto-generated OpenAPI 3 specs. It also registers the new page in the enterprise sidebar under "Configuration".

Confidence Score: 5/5

Safe to merge — all findings are P2 style/consistency suggestions that don't block correctness.

Both findings are P2: a port inconsistency in the LLM example prompts (3000 vs 8000 used elsewhere) and a missing EOF newline. Neither affects the accuracy of the core documentation or any code logic.

No files require special attention.

Important Files Changed

Filename	Overview
docs/enterprise/event-handler-api.md	New documentation page for EventHandlerAPIPlugin — comprehensive coverage of endpoints, auth, OpenAPI spec, and LLM-driven usage; minor port inconsistency (3000 vs 8000) in LLM prompt examples and missing EOF newline.
docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/enterprise.py	Adds 'Event Handler API' sidebar entry under the Configuration section, consistent with existing sidebar item pattern.

Sequence Diagram

sequenceDiagram
    participant Client as API Client / LLM Agent
    participant Backend as Reflex Backend (8000)
    participant State as Reflex State

    Client->>Backend: GET /.well-known/api-catalog
    Backend-->>Client: RFC 9264 Linkset (points to openapi.yaml)

    Client->>Backend: GET /_reflex/events/openapi.yaml
    Backend-->>Client: OpenAPI 3 spec

    Client->>Backend: POST /_reflex/event/<state>/<handler> + Bearer token
    Backend->>State: Acquire state lock, run handler
    State-->>Backend: Yield state deltas
    Backend-->>Client: NDJSON stream of state deltas

    Client->>Backend: POST /_reflex/retrieve_state + Bearer token
    Backend->>State: Read full root state dict
    State-->>Backend: State dict
    Backend-->>Client: Full state JSON

Loading

_{Reviews (1): Last reviewed commit: "EventHandlerAPIPlugin (enterprise) docs" | Re-trigger Greptile}

[greptile-apps]

Port inconsistency in LLM example prompts

The curl examples throughout the document consistently use port 8000 (the backend), but the LLM prompt examples switch to port 3000 (the frontend/single-port port) without explanation. A reader who copies these prompts in a default dev setup (without single-port mode enabled) will get connection errors because 3000 only works in single-port mode. Either align all examples to port 8000, or add a short note explaining these prompts assume single-port mode is active.

[greptile-apps]

Missing newline at end of file

The file is missing a trailing newline. Most editors and linters expect files to end with a newline character.

[codspeed-hq]

Merging this PR will not alter performance

✅ 9 untouched benchmarks

---

_{Comparing masenf/event-handler-api-plugin-docs (4c431ff) with main (2fe1a44)}