ceres-server 0.4.0

REST API server for Ceres harvesting, embedding, and search workflows
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

use tokio_util::sync::CancellationToken;

use ceres_client::{EmbeddingProviderEnum, PortalClientFactoryEnum};
use ceres_core::{ExportService, HarvestPipeline, PortalsConfig, SearchService};
use ceres_db::{DatasetRepository, JobRepository};

/// Shared application state for all handlers.
///
/// This is wrapped in Arc internally by Axum when using `with_state()`,
/// so all fields must implement Clone (which they do via internal `Arc<Pool>`).
// TODO(design): consider pub(crate) fields to enforce service-layer boundary
#[derive(Clone)]
pub struct AppState {
    /// Search service for semantic search operations
    pub search_service: SearchService<DatasetRepository, EmbeddingProviderEnum>,

    /// Combined harvest + embed pipeline for portal synchronization
    pub harvest_pipeline:
        HarvestPipeline<DatasetRepository, EmbeddingProviderEnum, PortalClientFactoryEnum>,

    /// Export service for streaming data exports
    pub export_service: ExportService<DatasetRepository>,

    /// Dataset repository for direct database queries
    pub dataset_repo: DatasetRepository,

    /// Job repository for harvest job management
    pub job_repo: JobRepository,

    /// Portal configuration (loaded from portals.toml)
    pub portals_config: Option<PortalsConfig>,

    /// Cancellation token for graceful shutdown
    pub shutdown_token: CancellationToken,

    /// Admin API key for protecting write endpoints (None = admin endpoints disabled)
    pub admin_token: Option<String>,
}

impl AppState {
    /// Creates a new application state with all services initialized.
    pub fn new(
        pool: sqlx::PgPool,
        embedding_client: EmbeddingProviderEnum,
        portals_config: Option<PortalsConfig>,
        shutdown_token: CancellationToken,
        admin_token: Option<String>,
    ) -> Self {
        let dataset_repo = DatasetRepository::new(pool.clone());
        let job_repo = JobRepository::new(pool);
        let portal_factory = PortalClientFactoryEnum::new();

        Self {
            search_service: SearchService::new(dataset_repo.clone(), embedding_client.clone()),
            harvest_pipeline: HarvestPipeline::new(
                dataset_repo.clone(),
                embedding_client,
                portal_factory,
            ),
            export_service: ExportService::new(dataset_repo.clone()),
            dataset_repo,
            job_repo,
            portals_config,
            shutdown_token,
            admin_token,
        }
    }
}