Struct CommandContext 

pub struct CommandContext {
    pub actor: Option<String>,
    pub correlation_id: Option<String>,
    pub metadata: Option<Value>,
    pub source_device: Option<String>,
}

Cross-cutting metadata passed alongside a command.

Carries audit trail, correlation, and tracing information without polluting the Command or DomainEvent types. Fields are mapped onto eventfold::Event metadata when events are appended.

Examples

use eventfold_es::CommandContext;
use serde_json::json;

let ctx = CommandContext::default()
    .with_actor("user-42")
    .with_correlation_id("req-abc-123")
    .with_metadata(json!({"source": "api"}));

assert_eq!(ctx.actor.as_deref(), Some("user-42"));
assert_eq!(ctx.correlation_id.as_deref(), Some("req-abc-123"));
assert!(ctx.metadata.is_some());

Fields

actor: Option<String>

Identity of the actor issuing the command (e.g. a user ID).

correlation_id: Option<String>

Correlation ID for tracing a request across aggregates.

metadata: Option<Value>

Arbitrary metadata forwarded to eventfold::Event::meta.

source_device: Option<String>

The device ID of the client that issued the command.

Stamped into event.meta["source_device"] by to_eventfold_event. Skipped during serialization when None to maintain backward compatibility with existing JSONL records.

Implementations

impl CommandContext

pub fn with_actor(self, actor: impl Into<String>) -> Self

Set the actor identity.

Arguments

• actor - Any value convertible to String identifying who issued the command (e.g. a user ID or service name).

Returns

The updated CommandContext with the actor set.

pub fn with_correlation_id(self, id: impl Into<String>) -> Self

Set the correlation ID.

Arguments

• id - Any value convertible to String used to correlate this command with other operations across aggregates or services.

Returns

The updated CommandContext with the correlation ID set.

pub fn with_metadata(self, meta: Value) -> Self

Set arbitrary metadata.

Arguments

• meta - A serde_json::Value carrying any additional key-value pairs to forward into eventfold::Event::meta.

Returns

The updated CommandContext with the metadata set.

pub fn with_source_device(self, device_id: impl Into<String>) -> Self

Set the source device ID.

The device ID identifies which client device originated this command. It is stamped into event.meta["source_device"] by to_eventfold_event, making it available to projections, process managers, and downstream sync consumers.

Arguments

• device_id - Any value convertible to String identifying the originating device (e.g. a UUID or hostname).

Returns

The updated CommandContext with the source device set.

Trait Implementations

impl Clone for CommandContext

fn clone(&self) -> CommandContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CommandContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CommandContext

fn default() -> CommandContext

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CommandContext

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CommandContext

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.