// Sharing a save (save_share.c): the menu's Export writes the save the game would load next into one zip, for a bug
// report or another player, and its Import checks such a zip and leaves its save for the game's next start
// (fs_host.c import_pending). The launcher writes and reads the same zip (launcher/saves.py export_save, import_zip).
#pragma once
#include <stddef.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef enum {
    SAVE_SHARE_OK,
    SAVE_SHARE_NO_SAVE,        // export: the game has not saved yet
    SAVE_SHARE_READ_FAILED,    // export: a save file could not be read; import: the zip could not be read
    SAVE_SHARE_WRITE_FAILED,   // export: the zip could not be written; import: its save could not be put in place
    SAVE_SHARE_NOT_A_SAVE,     // import: not a zip of an NX2navi save (no manifest, another format, no save files)
    SAVE_SHARE_OTHER_GAME,     // import: the manifest names another game
    SAVE_SHARE_NEWER,          // import: a newer NX2navi made it, in a format this one does not know
    SAVE_SHARE_DAMAGED,        // import: a member's data or CRC is wrong
    SAVE_SHARE_UNSAFE,         // import: a path outside the save, a link, or far more than a save
} SaveShareResult;

// Writes NX2navi-save-<local date>_<time>[-bug-report].zip into dir (made when missing); bug_report adds this run's
// log and nx2navi.ini. path gets the zip's path. Never a key file.
SaveShareResult save_share_export(const char *dir, int bug_report, char *path, size_t cap);
// Checks the zip at zip_path (manifest, game, paths, sizes, CRCs) and stages its save for the next start. detail gets
// "<NX2navi version>, <export date>" from its manifest ("?" for what it lacks).
SaveShareResult save_share_import(const char *zip_path, char *detail, size_t cap);
int save_share_pending(void);   // 1 while an import waits for the next start
int save_share_cancel(void);    // drops the waiting import; 0 on success
// Where Export writes and Import's file dialog opens: the player's Downloads folder, else the game folder. 0 when
// neither is known.
int save_share_default_dir(char *out, size_t cap);
// A new folder name <game folder>/saves/backup <local date> <time> (with " (2)" and up when taken), the saves folder
// made; the folder itself is not. Where the launcher keeps the backups of its imports. 0 when it cannot be named.
int save_share_backup_dir(char *out, size_t cap);

#ifdef __cplusplus
}
#endif