bpm-engine 0.1.0

Lightweight embeddable BPM runtime for long-running, stateful workflows with tokens, timers, Saga compensation, and crash recovery
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

//! BPM Engine (design: overview §3).
//! TokenScheduler, NodeExecutor, GatewayEvaluator, EventBus / event pump.

pub mod el;
mod events;
mod executor;
mod gateway;
mod handler;
mod log_handler;
mod process_completed_handler;
mod process_start_handler;
mod pump;
mod scheduler;
mod saga;
mod timer_handler;
mod token_arrived_handler;
mod transition;
mod user_task_completed_handler;

pub use events::{payloads, EngineEvent};
pub use gateway::GatewayEvaluator;
pub use handler::{EngineContext, EventHandler};
pub use pump::EventPump;
pub use scheduler::TokenScheduler;
pub use executor::NodeExecutor;
pub use log_handler::LogEventHandler;
pub use process_completed_handler::ProcessCompletedHandler;
pub use process_start_handler::ProcessStartHandler;
pub use token_arrived_handler::TokenArrivedHandler;
pub use saga::{CompensationRecord, CompensationStatus, SagaCoordinator};
pub use timer_handler::{Timer, TimerFiredHandler, TimerType};
pub use user_task_completed_handler::UserTaskCompletedHandler;

/// BpmEngine aggregates scheduler, executor, gateway, event pump (design: overview §3).
pub struct BpmEngine {
    pub handlers: Vec<Box<dyn EventHandler>>,
}

impl BpmEngine {
    pub fn new(handlers: Vec<Box<dyn EventHandler>>) -> Self {
        BpmEngine { handlers }
    }

    /// Run event pump with initial event (design: handler.md §9).
    pub fn run(&self, initial: EngineEvent, ctx: &mut EngineContext) {
        EventPump::run(&self.handlers, initial, ctx);
    }
}