/**
 * @file src/update.h
 * @brief Declarations for update checking and notification.
 */
#pragma once

// standard includes
#include <atomic>
#include <chrono>
#include <cstdint>
#include <string>
#include <vector>

namespace update {
  struct asset_info_t {
    std::string name;  ///< Asset filename
    std::string download_url;  ///< Direct download URL
    std::string sha256;  ///< SHA256 hash of the asset
    std::int64_t size;  ///< Size in bytes
    std::string content_type;  ///< MIME type
  };

  struct release_info_t {
    std::string version;  ///< Version tag (e.g., "v1.2.3")
    std::string url;  ///< Release page URL
    std::string name;  ///< Release name/title
    std::string body;  ///< Release body/changelog
    std::string published_at;  ///< Publish date
    bool is_prerelease;  ///< Whether this is a prerelease
    std::vector<asset_info_t> assets;  ///< Available binary assets
  };

  struct state_t {
    std::string last_notified_version;  ///< Version string last notified to user
    std::string last_notified_url;  ///< Release page URL last notified to user
    bool last_notified_is_prerelease {false};  ///< Whether last notification was for a prerelease
    release_info_t latest_release;  ///< Latest stable release info
    release_info_t latest_prerelease;  ///< Latest prerelease info (if enabled)
    std::chrono::steady_clock::time_point last_check_time;  ///< Last time we checked
    std::atomic<bool> check_in_progress {false};  ///< True while a check is running
  };

  extern state_t state;

  /**
   * @brief Trigger an asynchronous update check.
   * Initiates a check for updates if not already running. If force is true, bypasses interval throttling.
   * @param force If true, forces the check regardless of throttling.
   */
  void trigger_check(bool force);

  /**
   * @brief Handle stream start event for update notification.
   * Called when a stream transitions from 0 to 1 clients to schedule a delayed update notification.
   */
  void on_stream_started();

  /**
   * @brief Periodic tick to evaluate update check timing.
   * Called from a task pool or timer to determine if the next update check is due.
   */
  void periodic();

  /**
   * @brief Download GitHub release data for a repository.
   * Fetches release data in JSON format for the specified repository.
   * @param owner The GitHub repository owner.
   * @param repo The GitHub repository name.
   * @param out_json Output parameter for the fetched JSON data.
   * @return true on success, false otherwise.
   */
  bool download_github_release_data(const std::string &owner, const std::string &repo, std::string &out_json);

  /**
   * @brief Open the last-notified release page.
   * Callback used by tray notifications to open the release page last notified to the user.
   */
  void open_last_notified_release_page();
}  // namespace update