#pragma once #include #include #include #include #include #include #include #include using HttpGetHandler = std::function; using HttpPostHandler = std::function; using HttpRawHandler = std::function; using WsFrameHandler = std::function; using WsOpenHandler = std::function; using WsCloseHandler = std::function; struct HttpRoute { std::string uri; httpd_method_t method; HttpGetHandler getHandler; HttpPostHandler postHandler; HttpRawHandler rawHandler; // For proto handlers that don't need JSON parsing bool isWebsocket; }; class WebServer { public: WebServer(); ~WebServer(); void config(size_t maxUriHandlers, size_t stackSize); esp_err_t listen(uint16_t port); void stop(); void on(const char* uri, httpd_method_t method, HttpGetHandler handler); void on(const char* uri, httpd_method_t method, HttpPostHandler handler); void onRaw(const char* uri, httpd_method_t method, HttpRawHandler handler); void onWsFrame(WsFrameHandler handler); void onWsOpen(WsOpenHandler handler); void onWsClose(WsCloseHandler handler); void registerWebsocket(const char* uri); esp_err_t wsSend(int sockfd, const uint8_t* data, size_t len); esp_err_t wsSendAll(const uint8_t* data, size_t len); void addWsClient(int sockfd); void removeWsClient(int sockfd); std::vector getWsClients(); void addDefaultHeader(const char* key, const char* value); httpd_handle_t getHandle() { return server_; } static esp_err_t sendJson(httpd_req_t* req, int status, const char* json); static esp_err_t sendJson(httpd_req_t* req, int status, JsonDocument& doc); static esp_err_t sendError(httpd_req_t* req, int status, const char* message); static esp_err_t sendOk(httpd_req_t* req); static esp_err_t sendProto(httpd_req_t* req, int status, const uint8_t* data, size_t len); template static esp_err_t sendProto(httpd_req_t* req, int status, const T& msg, const pb_msgdesc_t* fields) { uint8_t buffer[1024]; pb_ostream_t stream = pb_ostream_from_buffer(buffer, sizeof(buffer)); if (!pb_encode(&stream, fields, &msg)) { return sendError(req, 500, "Failed to encode proto"); } return sendProto(req, status, buffer, stream.bytes_written); } template static bool receiveProto(httpd_req_t* req, T& msg, const pb_msgdesc_t* fields) { size_t contentLen = req->content_len; if (contentLen == 0 || contentLen > 4096) { return false; } uint8_t* buffer = (uint8_t*)malloc(contentLen); if (!buffer) { return false; } int received = 0; int remaining = contentLen; while (remaining > 0) { int ret = httpd_req_recv(req, (char*)buffer + received, remaining); if (ret <= 0) { free(buffer); return false; } received += ret; remaining -= ret; } pb_istream_t stream = pb_istream_from_buffer(buffer, contentLen); bool success = pb_decode(&stream, fields, &msg); free(buffer); return success; } private: httpd_handle_t server_ = nullptr; httpd_config_t config_; std::vector routes_; std::map defaultHeaders_; std::vector wsClients_; SemaphoreHandle_t wsMutex_; WsFrameHandler wsFrameHandler_; WsOpenHandler wsOpenHandler_; WsCloseHandler wsCloseHandler_; static esp_err_t httpHandler(httpd_req_t* req); static esp_err_t wsHandler(httpd_req_t* req); void applyDefaultHeaders(httpd_req_t* req); esp_err_t registerRoute(const HttpRoute& route); }; extern WebServer server;