mmex_lib 0.1.2-beta.1

Library for interacting with Money Manager EX data and logic
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

use crate::api::MmexContext;
use crate::domain::categories::{Category, CategoryError, CategoryId, CategoryUpdate};
use crate::MmexError;
use std::sync::{Arc, Mutex};

/// Gestor especializado en la administración de categorías y subcategorías.
#[derive(uniffi::Object)]
pub struct CategoryManager {
    pub(crate) context: Arc<Mutex<MmexContext>>,
}

#[uniffi::export]
impl CategoryManager {
    /// Obtiene la lista completa de categorías registradas.
    pub fn get_all(&self) -> Result<Vec<Category>, CategoryError> {
        let ctx = self
            .context
            .lock()
            .map_err(|e| CategoryError::Common(MmexError::Internal(e.to_string())))?;
        Ok(ctx.categories().get_all_categories()?)
    }

    /// Busca una categoría específica por su identificador único.
    pub fn get_by_id(&self, id: i64) -> Result<Option<Category>, CategoryError> {
        let ctx = self
            .context
            .lock()
            .map_err(|e| CategoryError::Common(MmexError::Internal(e.to_string())))?;
        Ok(ctx.categories().get_category_by_id(CategoryId { v1: id })?)
    }

    /// Obtiene las subcategorías asociadas a una categoría padre.
    pub fn get_subcategories(&self, parent_id: i64) -> Result<Vec<Category>, CategoryError> {
        let ctx = self
            .context
            .lock()
            .map_err(|e| CategoryError::Common(MmexError::Internal(e.to_string())))?;
        Ok(ctx
            .categories()
            .get_subcategories(CategoryId { v1: parent_id })?)
    }

    /// Crea una nueva categoría con el nombre y padre opcional proporcionados.
    pub fn create(&self, name: String, parent_id: Option<i64>) -> Result<Category, CategoryError> {
        let ctx = self
            .context
            .lock()
            .map_err(|e| CategoryError::Common(MmexError::Internal(e.to_string())))?;
        Ok(ctx
            .categories()
            .create_category(&name, parent_id.map(|v| CategoryId { v1: v }))?)
    }

    /// Actualiza la información de una categoría existente.
    pub fn update(&self, category: Category) -> Result<(), CategoryError> {
        let ctx = self
            .context
            .lock()
            .map_err(|e| CategoryError::Common(MmexError::Internal(e.to_string())))?;
        ctx.categories().update_category(&category)?;
        Ok(())
    }

    /// Actualiza parcialmente la información de una categoría.
    pub fn update_partial(&self, id: i64, update: CategoryUpdate) -> Result<(), CategoryError> {
        let ctx = self
            .context
            .lock()
            .map_err(|e| CategoryError::Common(MmexError::Internal(e.to_string())))?;
        ctx.categories()
            .update_category_partial(CategoryId { v1: id }, update)?;
        Ok(())
    }

    /// Elimina una categoría de la base de datos.
    pub fn delete(&self, id: i64) -> Result<(), CategoryError> {
        let ctx = self
            .context
            .lock()
            .map_err(|e| CategoryError::Common(MmexError::Internal(e.to_string())))?;
        ctx.categories().delete_category(CategoryId { v1: id })?;
        Ok(())
    }

    /// Obtiene todas las categorías en formato JSON.
    pub fn get_all_json(&self) -> Result<String, CategoryError> {
        let categories = self.get_all()?;
        serde_json::to_string(&categories)
            .map_err(|e| CategoryError::Common(MmexError::Internal(e.to_string())))
    }
}