Files
Ferrous-Solitaire/solitaire_data/src/achievements.rs
T
funman300 6e407a3ea7
Build and Deploy / build-and-push (push) Successful in 3m54s
fix(engine,server): safe area clamp, analytics batch, achievement save order, daily rollover, replay validation, leaderboard opt-in (#56, #60, #61, #62, #66, #68)
- #66: Clamp safe-area insets to 25% of window height with warn!() on excess
- #68: Move fire_flush outside per-event loop in analytics (batch flush once)
- #56: Persist progress before marking reward_granted to prevent XP loss on crash
- #60: Add DateRolloverTimer + check_date_rollover system for midnight seed refresh
- #62: Add validate_header() in replay upload with mode/draw_mode allowlists
- #61: Restore two-query leaderboard opt-in check (SELECT then UPDATE); original
       queries already in .sqlx cache; EXISTS variant would require sqlx prepare

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-05-28 13:07:22 -07:00

109 lines
3.2 KiB
Rust

//! Persistence for per-player achievement unlock records.
//!
//! The [`AchievementRecord`] struct is defined in `solitaire_sync` so the
//! server can use the same type. This module re-exports it and provides
//! file I/O helpers.
use std::fs;
use std::io;
use std::path::{Path, PathBuf};
pub use solitaire_sync::AchievementRecord;
const FILE_NAME: &str = "achievements.json";
/// Platform-specific default path for `achievements.json`.
pub fn achievements_file_path() -> Option<PathBuf> {
crate::data_dir().map(|d| d.join(crate::APP_DIR_NAME).join(FILE_NAME))
}
/// Load achievements from an explicit path. Returns `Vec::new()` if the file
/// is missing or unreadable.
pub fn load_achievements_from(path: &Path) -> Vec<AchievementRecord> {
let Ok(data) = fs::read(path) else {
return Vec::new();
};
serde_json::from_slice(&data).unwrap_or_default()
}
/// Save achievements to an explicit path using an atomic write.
pub fn save_achievements_to(path: &Path, records: &[AchievementRecord]) -> io::Result<()> {
if let Some(parent) = path.parent() {
fs::create_dir_all(parent)?;
}
let json = serde_json::to_string_pretty(records).map_err(io::Error::other)?;
let tmp = path.with_extension("json.tmp");
fs::write(&tmp, json.as_bytes())?;
fs::rename(&tmp, path)?;
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
use chrono::Utc;
use std::env;
fn tmp_path(name: &str) -> PathBuf {
env::temp_dir().join(format!("solitaire_ach_test_{name}.json"))
}
#[test]
fn unlock_sets_flag_and_date() {
let mut r = AchievementRecord::locked("x");
let at = Utc::now();
r.unlock(at);
assert!(r.unlocked);
assert_eq!(r.unlock_date, Some(at));
}
#[test]
fn unlock_is_idempotent_on_date() {
let mut r = AchievementRecord::locked("x");
let first = Utc::now();
r.unlock(first);
let later = first + chrono::Duration::hours(1);
r.unlock(later);
assert_eq!(r.unlock_date, Some(first), "earliest date preserved");
}
#[test]
fn round_trip_save_and_load() {
let path = tmp_path("round_trip");
let _ = fs::remove_file(&path);
let records = vec![AchievementRecord::locked("first_win"), {
let mut r = AchievementRecord::locked("century");
r.unlock(Utc::now());
r
}];
save_achievements_to(&path, &records).expect("save");
let loaded = load_achievements_from(&path);
assert_eq!(loaded.len(), 2);
assert_eq!(loaded[1].id, "century");
assert!(loaded[1].unlocked);
}
#[test]
fn load_from_missing_file_returns_empty() {
let path = tmp_path("missing_abc");
let _ = fs::remove_file(&path);
assert!(load_achievements_from(&path).is_empty());
}
#[test]
fn load_from_corrupt_file_returns_empty() {
let path = tmp_path("corrupt");
fs::write(&path, b"not json").expect("write");
assert!(load_achievements_from(&path).is_empty());
}
#[test]
fn save_cleans_up_tmp_file() {
let path = tmp_path("atomic");
save_achievements_to(&path, &[]).expect("save");
let tmp = path.with_extension("json.tmp");
assert!(!tmp.exists());
}
}