initial commit

src/network/api_client.h

@@ -0,0 +1,137 @@
+#pragma once
+
+#include <cstdint>
+#include <string>
+#include <vector>
+
+namespace radiantwave::api {
+
+// Base URL of the RadiantWave content API.
+constexpr const char* API_BASE_URL = "https://portal.radiantwavetech.com/api/v2";
+
+// Paths relative to API_BASE_URL.
+constexpr const char* PATH_PROCLAMATIONS = "/proclamations";
+constexpr const char* PATH_CATEGORIES = "/categories";
+constexpr const char* PATH_FREQUENCIES = "/frequencies";
+constexpr const char* PATH_LICENSE = "/license";
+constexpr const char* PATH_CREATE_ACCOUNT = "/automations/create/account";
+constexpr const char* PATH_COLOR_PALETTES = "/color-palettes";
+
+// Result of a single HTTP request.
+struct HttpResponse {
+    long status = 0;         // HTTP status code; 0 if the request never completed
+    std::string body;        // raw response body (any status)
+    bool transportOk = false; // true when the request completed without a transport error
+};
+
+// Performs a GET/POST against `path` (relative to API_BASE_URL). When `apiKey` is
+// non-empty it is sent as `Authorization: Bearer <apiKey>`. When it is empty (or
+// omitted) the request falls back to the key baked in at build time via the
+// `API_KEY` compile definition (see CMakeLists.txt); with neither set, no auth
+// header is sent.
+HttpResponse httpGet(const std::string& path, const std::string& apiKey = "");
+HttpResponse httpPost(const std::string& path, const std::string& jsonBody,
+                      const std::string& apiKey = "");
+
+// ─── GET /frequencies ──────────────────────────────────────────────────
+
+struct Frequency {
+    int id = 0;
+    std::string name;
+    int value = 0; // frequency in Hz
+};
+
+// Parse the JSON payload returned by the frequencies endpoint.
+bool parseFrequenciesJson(const std::string& body, std::vector<Frequency>& out);
+
+// Fetch the solfeggio frequencies. Returns true only on HTTP 2xx + successful parse.
+bool fetchFrequencies(std::vector<Frequency>& out, const std::string& apiKey = "");
+
+// ─── GET /color-palettes ───────────────────────────────────────────────
+
+// A single color swatch (RGBA). Mirrors db::PaletteColor without coupling the
+// API layer to the database.
+struct PaletteColor {
+    uint8_t r = 0;
+    uint8_t g = 0;
+    uint8_t b = 0;
+    uint8_t a = 255;
+};
+
+// The ordered 7-color palette for one solfeggio frequency.
+struct ColorPalette {
+    int solfeggio_frequency_id = 0;
+    std::vector<PaletteColor> colors;
+};
+
+// Parse the JSON payload returned by the color-palettes endpoint. Each entry
+// is expected to look like {"solfeggioFrequencyId": 1, "colors": ["#RRGGBB", ...]}.
+// Returns false on malformed input.
+bool parseColorPalettesJson(const std::string& body, std::vector<ColorPalette>& out);
+
+// Fetch the color palettes for every solfeggio frequency. Returns true only on
+// HTTP 2xx + successful parse.
+//
+// NOTE: the portal does not expose this route yet. This is readiness code — it
+// is deliberately not called anywhere in the app until the route ships, so
+// palettes can be updated from the portal rather than code releases.
+bool fetchColorPalettes(std::vector<ColorPalette>& out, const std::string& apiKey = "");
+
+// ─── POST /license ─────────────────────────────────────────────────────
+
+// A subscription level as described by the portal's `SubscriptionLevel`
+// table. `name` is always populated; `id`/`description` may be 0/empty when
+// the API only reported the level name.
+struct SubscriptionLevel {
+    int id = 0;
+    std::string name;
+    std::string description;
+};
+
+struct LicenseInfo {
+    std::string key;
+    std::string email_address;
+    SubscriptionLevel subscription_level;
+};
+
+// Parse the 200 JSON payload returned by the license endpoint.
+bool parseLicenseJson(const std::string& body, LicenseInfo& out);
+
+struct LicenseResult {
+    int status = 0;
+    LicenseInfo info;
+    std::string error_message; // extracted from the error body on failure
+
+    bool ok() const { return status >= 200 && status < 300; }
+};
+
+// Validate a license key / email pair against the portal. Never throws; failures
+// (network, HTTP error status) are reported through the returned LicenseResult.
+LicenseResult validateLicense(const std::string& key, const std::string& email,
+                              const std::string& apiKey = "");
+
+// ─── POST /automations/create/account ──────────────────────────────────
+
+struct AccountBody {
+    bool success = false;
+    std::string message;
+    std::string user_id;
+};
+
+// Parse the 200 JSON payload returned by the create-account endpoint.
+bool parseCreateAccountJson(const std::string& body, AccountBody& out);
+
+struct AccountResult {
+    int status = 0;
+    AccountBody body;
+    std::string error_message;
+
+    bool ok() const { return status >= 200 && status < 300; }
+};
+
+// Creates (or reuses) a user account and issues a license key. The key is emailed
+// to the user and is NOT part of the response. `name` may be empty.
+AccountResult createAccount(const std::string& email, const std::string& subscription_level,
+                            const std::string& name = "", const std::string& apiKey = "");
+
+} // namespace radiantwave::api