camel-core 0.6.3

Core engine for rust-camel
Documentation
//! # Camel Core
//!
//! This crate provides the core functionality for the Apache Camel implementation in Rust.
//!
//! ## Tracer EIP
//!
//! The Tracer Enterprise Integration Pattern (EIP) provides automatic message flow tracing
//! throughout your Camel routes. It captures detailed information about each step as messages
//! flow through the integration routes, helping with debugging, monitoring, and observability.
//!
//! ### Configuration
//!
//! You can configure the tracer in your `Camel.toml` file:
//!
//! ```toml
//! [observability.tracer]
//! enabled = true
//! detail_level = "minimal"  # minimal | medium | full
//!
//! [observability.tracer.outputs.stdout]
//! enabled = true
//! format = "json"
//! ```
//!
//! Or enable it programmatically:
//!
//! ```ignore
//! use camel_core::CamelContext;
//! let mut ctx = CamelContext::builder().build().await.unwrap();
//! ctx.set_tracing(true).await;
//! ```
//!
//! ### Span Fields
//!
//! Each trace span includes the following fields:
//!
//! - `correlation_id`: Unique identifier that links all spans in a single message flow
//! - `route_id`: Identifier for the route being traced
//! - `step_id`: Unique identifier for this specific step in the route
//! - `step_index`: Sequential index of this step within the route
//! - `timestamp`: When the step was executed (Unix timestamp)
//! - `duration_ms`: How long the step took to execute in milliseconds
//! - `status`: The status of the step execution (e.g., "success", "error")
//!
//! ### Detail Levels
//!
//! The tracer supports three levels of detail:
//!
//! - **Minimal**: Includes only the base fields listed above
//! - **Medium**: Includes the base fields plus:
//!   - `headers_count`: Number of message headers
//!   - `body_type`: Type of the message body
//!   - `has_error`: Whether the message contains an error
//!   - `output_body_type`: Type of the output body after processing
//! - **Full**: Includes all fields from Minimal and Medium plus:
//!   - Up to 3 message headers (`header_0`, `header_1`, `header_2`)
//!
//! //! Configuration types for the Tracer EIP live in `camel-core` rather than `camel-config`
//! //! to avoid a circular dependency — `camel-config` depends on `camel-core`.
//!
pub mod context;
pub(crate) mod hot_reload;
pub mod lifecycle;
pub(crate) mod shared;

pub mod route {
    pub use crate::lifecycle::adapters::route_compiler::{
        compose_pipeline, compose_pipeline_with_contracts, compose_traced_pipeline,
    };
    pub use crate::lifecycle::adapters::route_types::Route;
    pub use crate::lifecycle::application::route_definition::*;
    pub use crate::lifecycle::domain::route::RouteSpec;
}

pub mod route_controller {
    pub use crate::lifecycle::adapters::route_controller::*;
}

pub mod supervising_route_controller {
    pub use crate::lifecycle::adapters::controller_actor::spawn_supervision_task;
}

pub mod reload_watcher {
    pub use crate::hot_reload::adapters::reload_watcher::*;
}

pub use crate::hot_reload::adapters::ReloadWatcher;
pub use crate::lifecycle::adapters::controller_actor::RouteControllerHandle;
pub use crate::lifecycle::adapters::controller_actor::spawn_controller_actor;
pub use crate::lifecycle::adapters::controller_actor::spawn_supervision_task;
pub use crate::lifecycle::adapters::exchange_uow::ExchangeUoWLayer;
pub use crate::lifecycle::adapters::redb_journal::{
    JournalDurability, JournalEntry, JournalInspectFilter, RedbJournalOptions,
    RedbRuntimeEventJournal,
};
pub use crate::lifecycle::adapters::route_controller::DefaultRouteController;
pub use crate::lifecycle::adapters::route_types::Route;
pub use crate::lifecycle::adapters::{
    InMemoryCommandDedup, InMemoryEventPublisher, InMemoryProjectionStore, InMemoryRouteRepository,
    InMemoryRuntimeStore, RuntimeExecutionAdapter,
};
pub use crate::lifecycle::application::runtime_bus::RuntimeBus;
pub use crate::lifecycle::application::{BuilderStep, RouteDefinition};
pub use crate::lifecycle::domain::{
    LanguageRegistryError, RouteLifecycleCommand, RouteRuntimeAggregate, RouteRuntimeState,
    RuntimeEvent,
};
pub use crate::lifecycle::ports::{
    CommandDedupPort, EventPublisherPort, ProjectionStorePort, RouteRepositoryPort,
    RouteStatusProjection, RuntimeEventJournalPort, RuntimeExecutionPort, RuntimeUnitOfWorkPort,
};
pub use crate::shared::components::domain::Registry;
pub use crate::shared::observability::adapters::TracingProcessor;
pub use crate::shared::observability::domain::{
    DetailLevel, FileOutput, OutputFormat, StdoutOutput, TracerConfig, TracerOutputs,
};
pub use context::CamelContext;

// Re-export route controller types from camel-api (they live there to avoid cyclic dependencies).
pub use camel_api::CamelError;
pub use camel_api::{RouteAction, RouteController, RouteStatus};