Struct RecordSpendArgs 

#[non_exhaustive]
pub struct RecordSpendArgs {
    pub budget_id: BudgetId,
    pub execution_id: ExecutionId,
    pub deltas: BTreeMap<String, u64>,
    pub idempotency_key: String,
}

Args for crate::engine_backend::EngineBackend::record_spend.

Carries an open-set BTreeMap<String, u64> of dimension deltas per cairn’s ground-truth shape at cairn-fabric/src/engine/control_plane_types.rs. Cairn budgets are per-tenant open-schema (tenant A tracks "tokens" + "cost_cents", tenant B tracks "egress_bytes"), distinct from FF’s fixed-shape [UsageDimensions] which encodes the internal usage-report surface.

BTreeMap (not HashMap) gives stable iteration order — consistent with UsageDimensions::custom, and critical for the PG body which updates multiple dimension rows per call (deterministic ordering prevents deadlocks under concurrent spend).

Return shape reuses ReportUsageResult — same four variants (Ok / SoftBreach / HardBreach / AlreadyApplied) cairn’s UI branches on. Not a new enum.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

budget_id: BudgetId

execution_id: ExecutionId

deltas: BTreeMap<String, u64>

Per-dimension positive deltas. Tenant-defined keys; stable iteration order.

idempotency_key: String

Caller-computed idempotency key (cairn uses SHA-256 hex of budget_id || execution_id || sorted(deltas)). FF does not interpret the bytes — dedup is a simple equality check against the prior stamped key.

Implementations

impl RecordSpendArgs

pub fn new( budget_id: BudgetId, execution_id: ExecutionId, deltas: BTreeMap<String, u64>, idempotency_key: impl Into<String>, ) -> Self

Trait Implementations

impl Clone for RecordSpendArgs

fn clone(&self) -> RecordSpendArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecordSpendArgs

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RecordSpendArgs

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RecordSpendArgs

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

where __S: Serializer,

Serialize this value into the given Serde serializer.