server/src/lutris_integration.h

Rama main · réplica de lectura del repositorio original.

/** @file src/lutris_integration.h
 * Local Lutris catalog discovery and launch helpers.
 */
#pragma once

#include <cstdint>
#include <filesystem>
#include <string>
#include <vector>

namespace platf::lutris {
  struct game_t {
    std::int64_t id = 0;
    // Opaque local-art revision supplied by the session-user scanner.
    std::string session_artwork_revision;
    std::string stable_id;  // lutris:<id>, or steam:<appid> for Steam-backed records
    std::string name;
    std::string slug;
    std::string runner;
    std::string platform;
    std::filesystem::path directory;
    std::string config_path;
    std::string service;
    std::string service_id;
    // Lutris' portrait cover and square launcher icon are kept separately.
    // image_path is populated later with a client-compatible managed PNG.
    std::filesystem::path artwork_path;
    std::filesystem::path icon_path;
    std::filesystem::path image_path;
    std::int64_t last_played = 0;
    double playtime_seconds = 0.0;

    [[nodiscard]] bool steam_backed() const;
  };

  std::filesystem::path default_database_path();
  // On the Linux machine host this is resolved by the dropped-UID scanner;
  // the user's database path itself is never returned to the host.
  bool database_available();
  // Distinguishes a valid empty/missing user catalog from a broker or scanner
  // failure. Non-machine discovery is always ready.
  bool discovery_ready();
  std::vector<game_t> discover(const std::filesystem::path &database = {});
  std::uint64_t source_fingerprint(const std::vector<game_t> &games);

  std::string launch_uri(std::int64_t id);
  bool launch(std::int64_t id);
  bool executable_available();
}  // namespace platf::lutris