// file: kb_lib/src/db/queries/db_metadata.rs //! Queries for `k_sol_db_metadata`. /// Inserts or updates one metadata row. pub async fn query_db_metadatas_upsert( database: &crate::Database, dto: &crate::DbMetadataDto, ) -> Result<(), crate::Error> { let entity = crate::DbMetadataEntity::from(dto.clone()); match database.connection() { crate::DatabaseConnection::Sqlite(pool) => { let query_result = sqlx::query( r#" INSERT INTO k_sol_db_metadata ( key, value, updated_at ) VALUES (?, ?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at "#, ) .bind(entity.key) .bind(entity.value) .bind(entity.updated_at) .execute(pool) .await; match query_result { Ok(_) => return Ok(()), Err(error) => { return Err(crate::Error::Db(format!( "cannot upsert k_sol_db_metadata on sqlite: {}", error ))); }, } }, } } /// Reads one metadata row by key. pub async fn query_db_metadatas_get( database: &crate::Database, key: &str, ) -> Result, crate::Error> { match database.connection() { crate::DatabaseConnection::Sqlite(pool) => { let query_result = sqlx::query_as::( r#" SELECT key, value, updated_at FROM k_sol_db_metadata WHERE key = ? LIMIT 1 "#, ) .bind(key) .fetch_optional(pool) .await; let entity_option = match query_result { Ok(entity_option) => entity_option, Err(error) => { return Err(crate::Error::Db(format!( "cannot read k_sol_db_metadata '{}' on sqlite: {}", key, error ))); }, }; match entity_option { Some(entity) => { let dto_result = crate::DbMetadataDto::try_from(entity); match dto_result { Ok(dto) => return Ok(Some(dto)), Err(error) => return Err(error), } }, None => return Ok(None), } }, } } /// Lists all metadata rows. pub async fn query_db_metadatas_list( database: &crate::Database, ) -> Result, crate::Error> { match database.connection() { crate::DatabaseConnection::Sqlite(pool) => { let query_result = sqlx::query_as::( r#" SELECT key, value, updated_at FROM k_sol_db_metadata ORDER BY key ASC "#, ) .fetch_all(pool) .await; let entities = match query_result { Ok(entities) => entities, Err(error) => { return Err(crate::Error::Db(format!( "cannot list k_sol_db_metadata on sqlite: {}", error ))); }, }; let mut dtos = std::vec::Vec::new(); for entity in entities { let dto_result = crate::DbMetadataDto::try_from(entity); let dto = match dto_result { Ok(dto) => dto, Err(error) => return Err(error), }; dtos.push(dto); } return Ok(dtos); }, } } #[cfg(test)] mod tests { #[tokio::test] async fn db_metadata_roundtrip_works() { let tempdir = tempfile::tempdir().expect("tempdir must succeed"); let database_path = tempdir.path().join("roundtrip.sqlite3"); let config = crate::DatabaseConfig { enabled: true, backend: crate::DatabaseBackend::Sqlite, sqlite: crate::SqliteDatabaseConfig { path: database_path.to_string_lossy().to_string(), create_if_missing: true, busy_timeout_ms: 5000, max_connections: 1, auto_initialize_schema: true, use_wal: true, }, }; let database = crate::Database::connect_and_initialize(&config) .await .expect("database init must succeed"); let dto = crate::DbMetadataDto::new("schema_version".to_string(), "0.5.0".to_string()); crate::query_db_metadatas_upsert(&database, &dto) .await .expect("upsert must succeed"); let fetched = crate::query_db_metadatas_get(&database, "schema_version") .await .expect("fetch must succeed"); assert!(fetched.is_some()); let fetched = fetched.expect("metadata must exist"); assert_eq!(fetched.key, "schema_version"); assert_eq!(fetched.value, "0.5.0"); let listed = crate::query_db_metadatas_list(&database).await.expect("list must succeed"); assert!(!listed.is_empty()); } }