feat(wfe-core): add models, traits, and error types

Core domain models: WorkflowInstance, ExecutionPointer, WorkflowDefinition,
WorkflowStep, Event, EventSubscription, ScheduledCommand, ExecutionError,
LifecycleEvent, PollEndpointConfig. All serde-serializable.

Provider traits: PersistenceProvider (composite of WorkflowRepository,
EventRepository, SubscriptionRepository, ScheduledCommandRepository),
DistributedLockProvider, QueueProvider, SearchIndex, LifecyclePublisher,
WorkflowMiddleware, StepMiddleware, WorkflowRegistry.

StepBody trait with StepExecutionContext for workflow step implementations.
WorkflowData marker trait (blanket impl for Serialize + DeserializeOwned).
This commit is contained in:
2026-03-25 20:07:50 +00:00
parent 098564db51
commit d87d888787
25 changed files with 1627 additions and 0 deletions

View File

@@ -0,0 +1,95 @@
use async_trait::async_trait;
use chrono::{DateTime, Utc};
use crate::models::{
Event, EventSubscription, ExecutionError, ScheduledCommand, WorkflowInstance,
};
/// Persistence for workflow instances.
#[async_trait]
pub trait WorkflowRepository: Send + Sync {
async fn create_new_workflow(&self, instance: &WorkflowInstance) -> crate::Result<String>;
async fn persist_workflow(&self, instance: &WorkflowInstance) -> crate::Result<()>;
async fn persist_workflow_with_subscriptions(
&self,
instance: &WorkflowInstance,
subscriptions: &[EventSubscription],
) -> crate::Result<()>;
async fn get_runnable_instances(&self, as_at: DateTime<Utc>) -> crate::Result<Vec<String>>;
async fn get_workflow_instance(&self, id: &str) -> crate::Result<WorkflowInstance>;
async fn get_workflow_instances(&self, ids: &[String]) -> crate::Result<Vec<WorkflowInstance>>;
}
/// Persistence for event subscriptions.
#[async_trait]
pub trait SubscriptionRepository: Send + Sync {
async fn create_event_subscription(
&self,
subscription: &EventSubscription,
) -> crate::Result<String>;
async fn get_subscriptions(
&self,
event_name: &str,
event_key: &str,
as_of: DateTime<Utc>,
) -> crate::Result<Vec<EventSubscription>>;
async fn terminate_subscription(&self, subscription_id: &str) -> crate::Result<()>;
async fn get_subscription(&self, subscription_id: &str) -> crate::Result<EventSubscription>;
async fn get_first_open_subscription(
&self,
event_name: &str,
event_key: &str,
as_of: DateTime<Utc>,
) -> crate::Result<Option<EventSubscription>>;
async fn set_subscription_token(
&self,
subscription_id: &str,
token: &str,
worker_id: &str,
expiry: DateTime<Utc>,
) -> crate::Result<bool>;
async fn clear_subscription_token(
&self,
subscription_id: &str,
token: &str,
) -> crate::Result<()>;
}
/// Persistence for events.
#[async_trait]
pub trait EventRepository: Send + Sync {
async fn create_event(&self, event: &Event) -> crate::Result<String>;
async fn get_event(&self, id: &str) -> crate::Result<Event>;
async fn get_runnable_events(&self, as_at: DateTime<Utc>) -> crate::Result<Vec<String>>;
async fn get_events(
&self,
event_name: &str,
event_key: &str,
as_of: DateTime<Utc>,
) -> crate::Result<Vec<String>>;
async fn mark_event_processed(&self, id: &str) -> crate::Result<()>;
async fn mark_event_unprocessed(&self, id: &str) -> crate::Result<()>;
}
/// Persistence for scheduled commands.
#[async_trait]
pub trait ScheduledCommandRepository: Send + Sync {
fn supports_scheduled_commands(&self) -> bool;
async fn schedule_command(&self, command: &ScheduledCommand) -> crate::Result<()>;
async fn process_commands(
&self,
as_of: DateTime<Utc>,
handler: &(dyn Fn(ScheduledCommand) -> std::pin::Pin<Box<dyn std::future::Future<Output = crate::Result<()>> + Send>>
+ Send
+ Sync),
) -> crate::Result<()>;
}
/// Composite persistence provider combining all repository traits.
#[async_trait]
pub trait PersistenceProvider:
WorkflowRepository + EventRepository + SubscriptionRepository + ScheduledCommandRepository
{
async fn persist_errors(&self, errors: &[ExecutionError]) -> crate::Result<()>;
async fn ensure_store_exists(&self) -> crate::Result<()>;
}