feat: enhance fetch commands to support custom headers for GET, POST, and PATCH requests

Author: io-eric

docs/api/fetch.md

@@ -16,24 +16,33 @@ Initiates a GET request to the specified URL. Returns a handle that identifies t
 
 ```cpp
 webcc::FetchRequest get(webcc::string_view url);
+webcc::FetchRequest get(webcc::string_view url, webcc::string_view headers_json);
 ```
 
+The `headers_json` argument is a JSON string of HTTP headers, e.g. `{"apikey":"...","Authorization":"Bearer ..."}`. If omitted, no custom headers are sent.
+
 ### `post`
 
 Initiates a POST request to the specified URL with the given body. Returns a handle that identifies the request.
 
 ```cpp
 webcc::FetchRequest post(webcc::string_view url, webcc::string_view body);
+webcc::FetchRequest post(webcc::string_view url, webcc::string_view body, webcc::string_view headers_json);
 ```
 
+The `headers_json` argument is a JSON string of HTTP headers, e.g. `{"apikey":"...","Authorization":"Bearer ..."}`. If omitted, no custom headers are sent.
+
 ### `patch`
 
 Initiates a PATCH request to the specified URL with the given body. Returns a handle that identifies the request.
 
 ```cpp
 webcc::FetchRequest patch(webcc::string_view url, webcc::string_view body);
+webcc::FetchRequest patch(webcc::string_view url, webcc::string_view body, webcc::string_view headers_json);
 ```
 
+The `headers_json` argument is a JSON string of HTTP headers, e.g. `{"apikey":"...","Authorization":"Bearer ..."}`. If omitted, no custom headers are sent.
+
 ## Events
 
 Fetch operations are asynchronous. You must poll for events to receive the results.

schema.def

@@ -173,9 +173,9 @@ websocket|command|CLOSE|close|handle(WebSocket):handle|{ const ws = websockets[h
 # ------------------------------------------------------------------------------
 fetch|event|SUCCESS|handle(FetchRequest):id string:data
 fetch|event|ERROR|handle(FetchRequest):id string:error
-fetch|command|GET|get|string:url RET:handle(FetchRequest)|{ const id = (window.webcc_next_id = (window.webcc_next_id || 0) + 1); fetch(url).then(r => r.text().then(d => ({ ok: r.ok, status: r.status, statusText: r.statusText, data: d }))).then(res => { if(res.ok) push_event_fetch_SUCCESS(id, res.data); else push_event_fetch_ERROR(id, res.data && res.data.length ? res.data : (res.status + ' ' + res.statusText)); }).catch(e => push_event_fetch_ERROR(id, e.toString())); return id; }
-fetch|command|POST|post|string:url string:body RET:handle(FetchRequest)|{ const id = (window.webcc_next_id = (window.webcc_next_id || 0) + 1); fetch(url, { method: 'POST', body: body }).then(r => r.text().then(d => ({ ok: r.ok, status: r.status, statusText: r.statusText, data: d }))).then(res => { if(res.ok) push_event_fetch_SUCCESS(id, res.data); else push_event_fetch_ERROR(id, res.data && res.data.length ? res.data : (res.status + ' ' + res.statusText)); }).catch(e => push_event_fetch_ERROR(id, e.toString())); return id; }
-fetch|command|PATCH|patch|string:url string:body RET:handle(FetchRequest)|{ const id = (window.webcc_next_id = (window.webcc_next_id || 0) + 1); fetch(url, { method: 'PATCH', body: body }).then(r => r.text().then(d => ({ ok: r.ok, status: r.status, statusText: r.statusText, data: d }))).then(res => { if(res.ok) push_event_fetch_SUCCESS(id, res.data); else push_event_fetch_ERROR(id, res.data && res.data.length ? res.data : (res.status + ' ' + res.statusText)); }).catch(e => push_event_fetch_ERROR(id, e.toString())); return id; }
+fetch|command|GET|get|string:url string:headers RET:handle(FetchRequest)|{ const id = (window.webcc_next_id = (window.webcc_next_id || 0) + 1); let h = {}; try { h = JSON.parse(headers); } catch(e) {} fetch(url, { headers: h }).then(r => r.text().then(d => ({ ok: r.ok, status: r.status, statusText: r.statusText, data: d }))).then(res => { if(res.ok) push_event_fetch_SUCCESS(id, res.data); else push_event_fetch_ERROR(id, res.data && res.data.length ? res.data : (res.status + ' ' + res.statusText)); }).catch(e => push_event_fetch_ERROR(id, e.toString())); return id; }
+fetch|command|POST|post|string:url string:body string:headers RET:handle(FetchRequest)|{ const id = (window.webcc_next_id = (window.webcc_next_id || 0) + 1); let h = {}; try { h = JSON.parse(headers); } catch(e) {} fetch(url, { method: 'POST', body: body, headers: h }).then(r => r.text().then(d => ({ ok: r.ok, status: r.status, statusText: r.statusText, data: d }))).then(res => { if(res.ok) push_event_fetch_SUCCESS(id, res.data); else push_event_fetch_ERROR(id, res.data && res.data.length ? res.data : (res.status + ' ' + res.statusText)); }).catch(e => push_event_fetch_ERROR(id, e.toString())); return id; }
+fetch|command|PATCH|patch|string:url string:body string:headers RET:handle(FetchRequest)|{ const id = (window.webcc_next_id = (window.webcc_next_id || 0) + 1); let h = {}; try { h = JSON.parse(headers); } catch(e) {} fetch(url, { method: 'PATCH', body: body, headers: h }).then(r => r.text().then(d => ({ ok: r.ok, status: r.status, statusText: r.statusText, data: d }))).then(res => { if(res.ok) push_event_fetch_SUCCESS(id, res.data); else push_event_fetch_ERROR(id, res.data && res.data.length ? res.data : (res.status + ' ' + res.statusText)); }).catch(e => push_event_fetch_ERROR(id, e.toString())); return id; }
 
 # ------------------------------------------------------------------------------
 # IMAGES