adk-payments 0.5.0

Protocol-neutral agentic commerce and payment orchestration for ADK-Rust
Documentation 
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

use adk_core::{AdkError, ErrorCategory, ErrorComponent};
use thiserror::Error;

use crate::domain::{OrderState, ReceiptState};

/// Local kernel errors that map into the ADK structured error envelope.
#[derive(Debug, Error, PartialEq, Eq)]
pub enum PaymentsKernelError {
    #[error(
        "invalid transaction state transition from {from:?} to {to:?}. Move through the canonical checkout phases instead of skipping payment state."
    )]
    InvalidTransactionTransition { from: &'static str, to: &'static str },

    #[error(
        "invalid order state transition from {from:?} to {to:?}. Apply authorization and fulfillment updates in canonical order."
    )]
    InvalidOrderTransition { from: OrderState, to: OrderState },

    #[error(
        "invalid receipt state transition from {from:?} to {to:?}. Apply authorization, settlement, and refund updates in canonical order."
    )]
    InvalidReceiptTransition { from: ReceiptState, to: ReceiptState },

    #[error(
        "unsupported canonical action `{action}` for protocol `{protocol}`. Return an explicit unsupported response instead of approximating semantics."
    )]
    UnsupportedAction { action: String, protocol: String },

    #[error(
        "payment policy denied `{action}` for transaction `{transaction_id}`. Require explicit user approval or adjust policy before retrying."
    )]
    PolicyDenied { action: String, transaction_id: String },
}

impl From<PaymentsKernelError> for AdkError {
    fn from(value: PaymentsKernelError) -> Self {
        let message = value.to_string();

        match value {
            PaymentsKernelError::InvalidTransactionTransition { .. } => AdkError::new(
                ErrorComponent::Server,
                ErrorCategory::InvalidInput,
                "payments.transaction.invalid_transition",
                message,
            ),
            PaymentsKernelError::InvalidOrderTransition { .. } => AdkError::new(
                ErrorComponent::Server,
                ErrorCategory::InvalidInput,
                "payments.order.invalid_transition",
                message,
            ),
            PaymentsKernelError::InvalidReceiptTransition { .. } => AdkError::new(
                ErrorComponent::Server,
                ErrorCategory::InvalidInput,
                "payments.receipt.invalid_transition",
                message,
            ),
            PaymentsKernelError::UnsupportedAction { .. } => AdkError::new(
                ErrorComponent::Server,
                ErrorCategory::Unsupported,
                "payments.action.unsupported",
                message,
            ),
            PaymentsKernelError::PolicyDenied { .. } => AdkError::new(
                ErrorComponent::Guardrail,
                ErrorCategory::Forbidden,
                "payments.policy.denied",
                message,
            ),
        }
    }
}