feat(assa): Add support for Advanced Commerce

Author: tikhop

Cargo.toml

@@ -14,7 +14,7 @@ edition = "2021"
 [dependencies]
 
 # Cryptography
-x509-parser = { version = "0.17.0", features = ["verify", "validate"] }
+x509-parser = { version = "0.18.0", features = ["verify", "validate"] }
 jsonwebtoken = { version = "9.3.1" }
 ring = "0.17.14"
 pem-rfc7468 = "1.0.0-rc.3"
@@ -27,7 +27,7 @@ serde = { version = "1.0.219", features = ["derive"] }
 serde_json = { version = "1.0.143" }
 serde_with = { version = "3.14.0", features = ["chrono"] }
 serde_repr = "0.1.20"
-uuid = { version = "1.18.0", features = ["serde", "v4"] }
+uuid = { version = "1.18.1", features = ["serde", "v4"] }
 chrono = { version = "0.4.41", features = ["serde"] }
 base64 = "0.22.1"
 

src/primitives/advanced_commerce/mod.rs

@@ -47,4 +47,5 @@ pub mod subscription_migrate_response;
 pub mod in_app_request_operation;
 pub mod in_app_request_version;
 pub mod in_app_request;
-mod base_response;
+pub mod base_response;
+pub mod refund;

src/primitives/advanced_commerce/refund.rs

@@ -0,0 +1,18 @@
+use chrono::{DateTime, Utc};
+use serde::{Deserialize, Serialize};
+use crate::primitives::advanced_commerce::refund_reason::RefundReason;
+use crate::primitives::advanced_commerce::refund_type::RefundType;
+
+#[derive(Debug, Clone, Deserialize, Serialize, PartialEq, Eq, Hash)]
+#[serde_with::serde_as]
+#[serde(rename_all = "camelCase")]
+pub struct Refund {
+    pub refund_amount: i64,
+
+    #[serde_as(as = "TimestampMilliSeconds<String, Flexible>")]
+    pub refund_date: DateTime<Utc>,
+
+    pub refund_reason: RefundReason,
+
+    pub refund_type: RefundType,
+}

src/primitives/advanced_commerce_renewal_info.rs

@@ -0,0 +1,26 @@
+use serde::{Deserialize, Serialize};
+use crate::primitives::advanced_commerce::descriptors::Descriptors;
+use crate::primitives::advanced_commerce::period::Period;
+use crate::primitives::advanced_commerce_renewal_item::AdvancedCommerceRenewalItem;
+
+#[derive(Debug, Clone, Deserialize, Serialize, PartialEq, Eq, Hash)]
+#[serde(rename_all = "camelCase")]
+pub struct AdvancedCommerceRenewalInfo {
+    /// advancedCommerceConsistencyToken
+    pub consistency_token: String,
+
+    /// advancedCommerceDescriptors
+    pub descriptors: Descriptors,
+
+    /// advancedCommerceRenewalItems
+    pub items: Vec<AdvancedCommerceRenewalItem>,
+
+    /// advancedCommercePeriod
+    pub period: Period,
+
+    /// advancedCommerceRequestReferenceId
+    pub request_reference_id: String,
+
+    /// advancedCommerceTaxCode
+    pub tax_code: String,
+}

src/primitives/advanced_commerce_renewal_item.rs

@@ -0,0 +1,17 @@
+use serde::{Deserialize, Serialize};
+use crate::primitives::advanced_commerce::offer::Offer;
+
+#[derive(Debug, Clone, Deserialize, Serialize, PartialEq, Eq, Hash)]
+#[serde(rename_all = "camelCase")]
+pub struct AdvancedCommerceRenewalItem {
+    #[serde(rename = "SKU")]
+    pub sku: String,
+
+    pub description: String,
+
+    pub display_name: String,
+
+    pub offer: Offer,
+
+    pub price: i64,
+}

src/primitives/advanced_commerce_transaction_info.rs

@@ -0,0 +1,34 @@
+use serde::{Deserialize, Serialize};
+use crate::primitives::advanced_commerce::descriptors::Descriptors;
+use crate::primitives::advanced_commerce::period::Period;
+use crate::primitives::advanced_commerce_transaction_item::AdvancedCommerceTransactionItem;
+
+#[derive(Debug, Clone, Deserialize, Serialize, PartialEq, Eq, Hash)]
+#[serde(rename_all = "camelCase")]
+/// [AdvancedCommerceTransactionInfo](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercetransactioninfo)
+pub struct AdvancedCommerceTransactionInfo {
+
+    /// [descriptors](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercedescriptors)
+    pub descriptors: Descriptors,
+
+    /// [estimatedTax](https://developer.apple.com/documentation/appstoreserverapi/advancedcommerceestimatedtax)
+    pub estimated_tax: i64,
+
+    /// [items](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercetransactionitems)
+    pub items: Vec<AdvancedCommerceTransactionItem>,
+
+    /// [period](https://developer.apple.com/documentation/appstoreserverapi/advancedcommerceperiod)
+    pub period: Period,
+
+    /// [requestReferenceId](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercerequestreferenceid)
+    pub request_reference_id: String,
+
+    /// [taxCode](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercetaxcode)
+    pub tax_code: String,
+
+    /// [taxExclusivePrice](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercetaxexclusiveprice)
+    pub tax_exclusive_price: i64,
+
+    /// [taxRate](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercetaxrate)
+    pub tax_rate: String,
+}

src/primitives/advanced_commerce_transaction_item.rs

@@ -0,0 +1,41 @@
+use chrono::{DateTime, Utc};
+use serde::{Deserialize, Serialize};
+use crate::primitives::advanced_commerce::offer::Offer;
+use crate::primitives::advanced_commerce::refund::Refund;
+
+#[derive(Debug, Clone, Deserialize, Serialize, PartialEq, Eq, Hash)]
+#[serde_with::serde_as]
+#[serde(rename_all = "camelCase")]
+/// [AdvancedCommerceTransactionItem](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercetransactionitem)
+pub struct AdvancedCommerceTransactionItem {
+    /// The SKU of the item.
+    ///
+    /// [SKU](https://developer.apple.com/documentation/advancedcommerceapi/sku)
+    #[serde(rename = "SKU")]
+    pub sku: String,
+
+    /// The new description for the item.
+    ///
+    /// [Description](https://developer.apple.com/documentation/advancedcommerceapi/description)
+    pub description: String,
+
+    /// The display name for the item.
+    ///
+    /// [Display Name](https://developer.apple.com/documentation/advancedcommerceapi/displayname)
+    pub display_name: String,
+
+    /// An offer for the item.
+    ///
+    /// [Offer](https://developer.apple.com/documentation/advancedcommerceapi/offer)
+    pub offer: Offer,
+
+    /// The price in milliunits.
+    ///
+    /// [Price](https://developer.apple.com/documentation/advancedcommerceapi/price)
+    pub price: i64,
+
+    pub refunds: Vec<Refund>,
+
+    #[serde_as(as = "TimestampMilliSeconds<String, Flexible>")]
+    pub revocation_date: DateTime<Utc>,
+}

src/primitives/jws_renewal_info_decoded_payload.rs

@@ -9,6 +9,7 @@ use serde::{Deserialize, Serialize};
 use serde_with::formats::Flexible;
 use serde_with::TimestampMilliSeconds;
 use uuid::Uuid;
+use crate::primitives::advanced_commerce_renewal_info::AdvancedCommerceRenewalInfo;
 
 /// A decoded payload containing subscription renewal information for an auto-renewable subscription.
 ///
@@ -144,4 +145,9 @@ pub struct JWSRenewalInfoDecodedPayload {
     /// [offerPeriod](https://developer.apple.com/documentation/appstoreserverapi/offerPeriod)
     #[serde(rename = "offerPeriod")]
     pub offer_period: Option<String>,
+
+    /// Renewal information that is present only for Advanced Commerce SKUs.
+    ///
+    /// [advancedCommerceRenewalInfo](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercerenewalinfo)
+    pub advanced_commerce_info: Option<AdvancedCommerceRenewalInfo>,
 }

src/primitives/jws_transaction_decoded_payload.rs

@@ -9,6 +9,7 @@ use chrono::{DateTime, Utc};
 use serde_with::formats::Flexible;
 use serde_with::TimestampMilliSeconds;
 use uuid::Uuid;
+use crate::primitives::advanced_commerce_transaction_info::AdvancedCommerceTransactionInfo;
 
 /// A decoded payload containing transaction information.
 ///
@@ -184,4 +185,10 @@ pub struct JWSTransactionDecodedPayload {
     /// [offerPeriod](https://developer.apple.com/documentation/appstoreserverapi/offerPeriod)
     #[serde(rename = "offerPeriod")]
     pub offer_period: Option<String>,
+
+    /// Transaction information that is present only for Advanced Commerce SKUs.
+    ///
+    /// [advancedCommerceTransactionInfo](https://developer.apple.com/documentation/appstoreserverapi/advancedcommercetransactioninfo)
+    #[serde(rename = "advancedCommerceInfo")]
+    pub advanced_commerce_info: Option<AdvancedCommerceTransactionInfo>,
 }

src/primitives/mod.rs

@@ -57,3 +57,7 @@ pub mod transaction_reason;
 pub mod update_app_account_token_request;
 pub mod user_status;
 pub mod advanced_commerce;
+pub mod advanced_commerce_transaction_item;
+pub mod advanced_commerce_transaction_info;
+pub mod advanced_commerce_renewal_info;
+pub mod advanced_commerce_renewal_item;