Add HTTP QUERY method (RFC 10008)

[EyJunge1]

Summary

• Parse and expose HTTP_QUERY (1u << 24) per RFC 10008: safe, idempotent, request body allowed.
• stringToMethod / methodToString and T_QUERY so QUERY is no longer treated as HTTP_INVALID (which aborted the connection).
• AsyncCallbackJsonWebHandler default mask is unchanged (GET/POST/PUT/PATCH). Enable QUERY with setMethod(HTTP_QUERY) — see examples/arduino/Json/Json.ino.
• Accept-Query literal for responses.

No platform http_method mapping in this PR (waits on an IDF detection criterion).

Feature issue: #475

Related:

• http_parser: add HTTP QUERY method (RFC 10008) (IDFGH-18267) espressif/esp-idf#19072
• feat(http_parser): add HTTP QUERY method (RFC 10008) (IDFGH-18266) espressif/esp-idf#19071
• WebServer: read request body for HTTP QUERY (RFC 10008) espressif/arduino-esp32#12895

Test plan

• curl -X QUERY -H 'Content-Type: application/json' -d '{"q":1}' http://<device>/json-query reaches the Json example handler
• AsyncCallbackJsonWebHandler without setMethod(HTTP_QUERY) does not accept QUERY
• Unknown methods still abort

[EyJunge1]

Implements / tracks feature request: #475

Related IDF issue: espressif/esp-idf#19072
Related IDF PR: espressif/esp-idf#19071

[willmmiles]

Seems like a simple and low cost extension to me. The documentation was a bit bungled, though.

[EyJunge1]

Addressed the review on e7cbb2f:

• Reverted the JsonHandlerMethods constructor cleanup (AsyncJson.cpp matches main).
• Dropped the HTTP_PARSER_HAS_QUERY platform mapping until IDF settles on a detection criterion. The library parser still recognizes QUERY.
• Removed the extra docs block under Request Variables. HTTP_QUERY stays in the method() enum list; examples/arduino/Json/Json.ino shows setMethod(HTTP_QUERY).

[Copilot]

🟡 Changes recommended

Accept-Query is incorrectly treated as a singleton header despite being list-valued.

Get a fresh assessment by requesting another Copilot review.

Pull request overview

Adds RFC 10008 HTTP QUERY method support, including parsing, serialization, documentation, and JSON-handler usage.

Changes:

• Defines and converts HTTP_QUERY.
• Adds QUERY and Accept-Query literals.
• Demonstrates opt-in JSON QUERY handling.

File summaries

File	Description
src/WebRequest.cpp	Parses and serializes QUERY methods.
src/literals.h	Adds QUERY-related literals.
src/ESPAsyncWebServer.h	Defines the HTTP_QUERY method bit.
examples/arduino/Json/Json.ino	Demonstrates a JSON QUERY endpoint.
docs/requests.md	Documents HTTP_QUERY.

Review details

• Files reviewed: 5/5 changed files
• Comments generated: 1
• Review effort level: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[mathieucarbou]

@EyJunge1 : could you please rebase ? I have pushed a commit on main to fix the build with Libretiny... Thanks!

[Copilot]

🟢 Approval recommended

The implementation consistently adds opt-in QUERY support without changing existing handler defaults.

Review details

• Files reviewed: 7/7 changed files
• Comments generated: 0 new
• Review effort level: Balanced

[mathieucarbou]

@willmmiles we can merge once you approve 👍

[willmmiles]

LGTM. I would recommend squashing.

[EyJunge1]

@willmmiles Done