//! [`FsProfileStore`] — JSON file implementation of the [`ProfileStore`] port. //! //! Persists the configured [`AgentProfile`]s in the global IDE store //! (ARCHITECTURE §9.2): //! //! ```text //! / //! └── profiles.json # { version, profiles: [AgentProfile, ...] } //! ``` //! //! Each profile item is exactly the declarative profile of CONTEXT §9 //! (`id, name, command, args, contextInjection{strategy,…}, detect, cwd`). The //! existence of `profiles.json` is what marks the first run as *done* (see //! [`ProfileStore::is_configured`]). //! //! Like [`super::FsProjectStore`], the store is Tauri-agnostic: the app-data //! directory is resolved by the composition root and injected as a plain path, //! and all I/O goes through the [`FileSystem`] port. use std::sync::Arc; use async_trait::async_trait; use serde::{Deserialize, Serialize}; use domain::ids::ProfileId; use domain::ports::{FileSystem, ProfileStore, RemotePath, StoreError}; use domain::profile::AgentProfile; /// File name of the profiles store inside the app-data dir. const PROFILES_FILE: &str = "profiles.json"; /// Current schema version of the profiles file. const PROFILES_VERSION: u32 = 1; /// On-disk shape of `profiles.json`. #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] struct ProfilesDoc { /// Schema version. version: u32, /// All configured profiles. profiles: Vec, } impl Default for ProfilesDoc { fn default() -> Self { Self { version: PROFILES_VERSION, profiles: Vec::new(), } } } /// JSON-file implementation of the [`ProfileStore`] port. /// /// Cheap to clone (everything is behind `Arc`); built once at the composition /// root and shared across use cases. #[derive(Clone)] pub struct FsProfileStore { fs: Arc, app_data_dir: String, } impl FsProfileStore { /// Builds the store from an injected [`FileSystem`] and the app-data /// directory path (resolved by the composition root). The directory is /// created lazily on first write. #[must_use] pub fn new(fs: Arc, app_data_dir: impl Into) -> Self { Self { fs, app_data_dir: app_data_dir.into(), } } /// Joins the app-data dir with the profiles file name (POSIX separator, valid /// on every target — `tokio::fs` accepts `/` on Windows too). fn path(&self) -> RemotePath { let base = self.app_data_dir.trim_end_matches(['/', '\\']); RemotePath::new(format!("{base}/{PROFILES_FILE}")) } /// Reads and parses the doc, returning an empty default if the file is absent. async fn read_doc(&self) -> Result { match self.fs.read(&self.path()).await { Ok(bytes) => { serde_json::from_slice(&bytes).map_err(|e| StoreError::Serialization(e.to_string())) } Err(domain::ports::FsError::NotFound(_)) => Ok(ProfilesDoc::default()), Err(e) => Err(StoreError::Io(e.to_string())), } } /// Writes the doc, ensuring the app-data dir exists first. async fn write_doc(&self, doc: &ProfilesDoc) -> Result<(), StoreError> { let dir = RemotePath::new(self.app_data_dir.trim_end_matches(['/', '\\']).to_owned()); self.fs .create_dir_all(&dir) .await .map_err(|e| StoreError::Io(e.to_string()))?; let bytes = serde_json::to_vec_pretty(doc).map_err(|e| StoreError::Serialization(e.to_string()))?; self.fs .write(&self.path(), &bytes) .await .map_err(|e| StoreError::Io(e.to_string())) } } #[async_trait] impl ProfileStore for FsProfileStore { async fn list(&self) -> Result, StoreError> { Ok(self.read_doc().await?.profiles) } async fn save(&self, profile: &AgentProfile) -> Result<(), StoreError> { let mut doc = self.read_doc().await?; if let Some(slot) = doc.profiles.iter_mut().find(|p| p.id == profile.id) { *slot = profile.clone(); } else { doc.profiles.push(profile.clone()); } self.write_doc(&doc).await } async fn delete(&self, id: ProfileId) -> Result<(), StoreError> { let mut doc = self.read_doc().await?; let before = doc.profiles.len(); doc.profiles.retain(|p| p.id != id); if doc.profiles.len() == before { return Err(StoreError::NotFound); } self.write_doc(&doc).await } async fn is_configured(&self) -> Result { self.fs .exists(&self.path()) .await .map_err(|e| StoreError::Io(e.to_string())) } async fn mark_configured(&self) -> Result<(), StoreError> { // Write the current doc back (an empty default when nothing exists), // which materialises `profiles.json` and records first-run completion. let doc = self.read_doc().await?; self.write_doc(&doc).await } }