diff options
Diffstat (limited to 'libs/nak_ffi/include/nak_ffi.h')
| -rw-r--r-- | libs/nak_ffi/include/nak_ffi.h | 220 |
1 files changed, 220 insertions, 0 deletions
diff --git a/libs/nak_ffi/include/nak_ffi.h b/libs/nak_ffi/include/nak_ffi.h new file mode 100644 index 0000000..c6010d4 --- /dev/null +++ b/libs/nak_ffi/include/nak_ffi.h @@ -0,0 +1,220 @@ +#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
+);
+
+/* ========================================================================
+ * 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 */
|