#ifndef NAK_FFI_H
#define NAK_FFI_H

#include <stddef.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

/* ========================================================================
 * Tier 1: Game Detection
 * ======================================================================== */

/** A detected game installation */
typedef struct {
    char *name;
    char *app_id;
    char *install_path;
    char *prefix_path;             /* NULL if no prefix */
    char *launcher;                /* display name string */
    char *my_games_folder;         /* NULL if not applicable */
    char *appdata_local_folder;    /* NULL if not applicable */
    char *appdata_roaming_folder;  /* NULL if not applicable */
    char *registry_path;           /* NULL if not applicable */
    char *registry_value;          /* NULL if not applicable */
} NakGame;

/** List of detected games */
typedef struct {
    NakGame *games;
    size_t count;
    size_t steam_count;
    size_t heroic_count;
    size_t bottles_count;
} NakGameList;

/** Detect all installed games across all launchers */
NakGameList nak_detect_all_games(void);

/** Free a NakGameList returned by nak_detect_all_games */
void nak_game_list_free(NakGameList list);

/** A known game definition (static data, do NOT free) */
typedef struct {
    const char *name;
    const char *steam_app_id;
    const char *gog_app_id;              /* NULL if none */
    const char *my_games_folder;         /* NULL if not applicable */
    const char *appdata_local_folder;    /* NULL if not applicable */
    const char *appdata_roaming_folder;  /* NULL if not applicable */
    const char *registry_path;
    const char *registry_value;
    const char *steam_folder;
} NakKnownGame;

/** Get the list of all known games (static data, do NOT free).
 *  Returns pointer to array; writes count to *out_count. */
const NakKnownGame *nak_get_known_games(size_t *out_count);

/* ========================================================================
 * Tier 2: Proton Detection
 * ======================================================================== */

/** An installed Proton version */
typedef struct {
    char *name;
    char *config_name;
    char *path;
    int is_steam_proton;
    int is_experimental;
} NakSteamProton;

/** List of detected Proton installations */
typedef struct {
    NakSteamProton *protons;
    size_t count;
} NakProtonList;

/** Find all installed Proton versions */
NakProtonList nak_find_steam_protons(void);

/** Free a NakProtonList */
void nak_proton_list_free(NakProtonList list);

/* ========================================================================
 * Tier 3: Steam Shortcuts
 * ======================================================================== */

/** Result from adding a Steam shortcut */
typedef struct {
    uint32_t app_id;
    char *prefix_path;  /* NULL on error */
    char *error;        /* NULL on success */
} NakShortcutResult;

/** Add a mod manager as a non-Steam game shortcut.
 *  Check result.error: NULL = success. */
NakShortcutResult nak_add_mod_manager_shortcut(
    const char *name,
    const char *exe_path,
    const char *start_dir,
    const char *proton_name
);

/** Remove a non-Steam game shortcut by AppID.
 *  Returns NULL on success, or error message (free with nak_string_free). */
char *nak_remove_steam_shortcut(uint32_t app_id);

/** Free a NakShortcutResult */
void nak_shortcut_result_free(NakShortcutResult result);

/* ========================================================================
 * Tier 4: Steam Paths
 * ======================================================================== */

/** Find the Steam installation path.
 *  Returns newly allocated string (free with nak_string_free), or NULL. */
char *nak_find_steam_path(void);

/* ========================================================================
 * Tier 5: Managed Prefixes
 * ======================================================================== */

/** A managed Wine prefix */
typedef struct {
    uint32_t app_id;
    char *name;
    char *prefix_path;
    char *install_path;
    char *manager_type;
    char *library_path;
    char *created;              /* ISO 8601 timestamp */
    char *proton_config_name;   /* NULL if not set */
} NakManagedPrefix;

/** List of managed prefixes */
typedef struct {
    NakManagedPrefix *prefixes;
    size_t count;
} NakManagedPrefixList;

/** Load all managed prefixes */
NakManagedPrefixList nak_managed_prefixes_load(void);

/** Register a new managed prefix (proton_config_name may be NULL) */
void nak_managed_prefixes_register(
    uint32_t app_id,
    const char *name,
    const char *prefix_path,
    const char *install_path,
    const char *library_path,
    const char *proton_config_name
);

/** Unregister a managed prefix by AppID */
void nak_managed_prefixes_unregister(uint32_t app_id);

/** Free a NakManagedPrefixList */
void nak_managed_prefix_list_free(NakManagedPrefixList list);

/* ========================================================================
 * Tier 6: Dependency Installation (callback-based)
 * ======================================================================== */

/** Callback for status/log messages */
typedef void (*NakStatusCallback)(const char *message);
typedef void (*NakLogCallback)(const char *message);

/** Callback for progress updates (0.0 to 1.0) */
typedef void (*NakProgressCallback)(float progress);

/** Install all Wine prefix dependencies (blocking call).
 *  cancel_flag: pointer to int, set non-zero to cancel.
 *  Returns NULL on success, or error message (free with nak_string_free). */
char *nak_install_all_dependencies(
    const char *prefix_path,
    const char *proton_name,
    const char *proton_path,
    NakStatusCallback status_cb,
    NakLogCallback log_cb,
    NakProgressCallback progress_cb,
    const int *cancel_flag,
    uint32_t app_id
);

/** Apply Wine registry settings to a prefix.
 *  Returns NULL on success, or error message (free with nak_string_free). */
char *nak_apply_wine_registry_settings(
    const char *prefix_path,
    const char *proton_name,
    const char *proton_path,
    NakLogCallback log_cb,
    uint32_t app_id
);

/** Apply a game's registry entry with a custom install path.
 *  Looks up game_name in KNOWN_GAMES and writes registry pointing to install_path.
 *  Returns NULL on success, or an error message (free with nak_string_free). */
char *nak_apply_registry_for_game_path(
    const char *prefix_path,
    const char *proton_name,
    const char *proton_path,
    const char *game_name,
    const char *install_path,
    NakLogCallback log_cb
);

/* ========================================================================
 * Tier 7: Prefix Symlinks
 * ======================================================================== */

/** Ensure AppData/Local/Temp exists in the Wine prefix.
 *  Call during prefix creation. */
void nak_ensure_temp_directory(const char *prefix_path);

/** Detect games and create symlinks from the prefix to game prefixes.
 *  Call during prefix creation. */
void nak_create_game_symlinks_auto(const char *prefix_path);

/* ========================================================================
 * General
 * ======================================================================== */

/** Free a string returned by any nak_* function */
void nak_string_free(char *s);

#ifdef __cplusplus
}
#endif

#endif /* NAK_FFI_H */