Skip to main content

hyprstream_service/
lib.rs

1//! Pluggable service orchestration for hyprstream.
2//!
3//! This crate provides service lifecycle management:
4//! - **Spawner**: `Spawnable` trait, `ServiceSpawner`, process backends
5//! - **Factory**: `ServiceFactory`, `ServiceContext`, inventory-based registration
6//! - **Manager**: `ServiceManager` trait, systemd/standalone implementations
7//! - **Metadata**: `MethodMeta`, `ParamMeta` for schema introspection
8//!
9//! # Architecture
10//!
11//! ```text
12//! hyprstream-rpc       (transport: RequestService, RequestLoop, Resolver)
13//!     ↑
14//! hyprstream-service   (orchestration: spawner, factory, manager)
15//!     ↑
16//! hyprstream           (application: factory functions, CLI)
17//! ```
18
19pub mod notify;
20pub mod service;
21
22// Top-level re-exports for convenience
23pub use service::spawner::{
24    DualSpawnable, InprocManager, ProcessBackend, ProcessConfig, ProcessKind, ProcessReadiness,
25    ProcessSpawner, ServiceKind, ServiceMode, ServiceSpawner, Spawnable, SpawnedProcess,
26    SpawnedService, SpawnerBackend, StandaloneBackend, SystemdBackend, UnifiedServiceConfig,
27};
28
29pub use service::factory::{
30    deployment_data_dir, get_factory, list_factories, NativeAnnouncementPublisher,
31    NativeAnnouncementReach, NativeAnnouncementRequest, NativeServiceAnnouncement,
32    QuicSharedConfig, ServiceContext, ServiceFactory, ServiceFactoryFn,
33};
34
35pub use service::trust_store::{global_trust_store, Attestation, TrustStore};
36
37pub use service::manager::{
38    detect as detect_service_manager, detect_with_mode as detect_service_manager_with_mode,
39    ServiceManager, ServiceTarget, StandaloneManager,
40};
41
42#[cfg(feature = "systemd")]
43pub use service::manager::{SystemdManager, SystemdSystemManager};
44
45#[cfg(feature = "systemd")]
46pub use service::manager::systemd::encrypt_credentials_if_available;
47
48pub use service::metadata::{
49    MethodMeta, ParamMeta, SchemaMetadataFn, ScopedClientTreeNode, ScopedSchemaMetadataFn,
50};
51
52pub use service::ordering::{startup_stages, startup_stages_for_profile};