feat: Implement primitives

Author: tikhop

.gitignore

@@ -1,3 +1,87 @@
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# AWS User-specific
+.idea/**/aws.xml
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# SonarLint plugin
+.idea/sonarlint/
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### CLion+all Patch ###
+# Ignore everything but code style settings and run configurations
+# that are supposed to be shared within teams.
+
+.idea/*
+
+!.idea/codeStyles
+!.idea/runConfigurations
+
+### Rust ###
 # Generated by Cargo
 # will have compiled files and executables
 debug/
@@ -6,9 +90,12 @@ target/
 # Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
 # More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
 Cargo.lock
-
+api/Cargo.lock
+core/Cargo.lock
+sdk/bindings/Cargo.lock
+sdk/example/Cargo.lock
+sdk/lib/Cargo.lock
 # These are backup files generated by rustfmt
 **/*.rs.bk
 
-# MSVC Windows builds of rustc generate these, which store debugging information
-*.pdb
+.env

Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "app-store-server-library"
+version = "0.1.0"
+edition = "2021"
+license-file = "LICENSE"
+authors = ["tkhp", "namecare"]
+repository = "https://github.com/namecare/app-store-server-library-rust"
+homepage = "https://github.com/namecare/app-store-server-library-rust"
+
+[dependencies]
+
+# Serialization
+serde = { version = "1.0.176", features = ["derive"] }
+serde_json = { version = "1.0.104" }
+uuid = { version = "1.4.0", features = ["serde", "v4"] }
+chrono = { version = "0.4.26", features = ["serde"] }

src/lib.rs

@@ -0,0 +1,2 @@
+pub mod primitives;
+

src/primitives/account_tenure.rs

@@ -0,0 +1,13 @@
+use serde::{Deserialize, Serialize};
+
+#[derive(Debug, Deserialize, Serialize, Hash, PartialEq, Eq)]
+pub enum AccountTenure {
+    Undeclared = 0,
+    ZeroToThreeDays = 1,
+    ThreeDaysToTenDays = 2,
+    TenDaysToThirtyDays = 3,
+    ThirtyDaysToNinetyDays = 4,
+    NinetyDaysToOneHundredEightyDays = 5,
+    OneHundredEightyDaysToThreeHundredSixtyFiveDays = 6,
+    GreaterThanThreeHundredSixtyFiveDays = 7,
+}

src/primitives/app_transaction.rs

@@ -0,0 +1,55 @@
+use chrono::{DateTime, Utc};
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+use crate::primitives::environment::Environment;
+
+#[derive(Debug, Deserialize, Serialize, Hash)]
+pub struct AppTransaction {
+    /// The server environment that signs the app transaction.
+    /// [environment](https://developer.apple.com/documentation/storekit/apptransaction/3963901-environment)
+    pub receipt_type: Option<Environment>,
+
+    /// The unique identifier the App Store uses to identify the app.
+    /// [appId](https://developer.apple.com/documentation/storekit/apptransaction/3954436-appid)
+    pub app_apple_id: Option<i64>,
+
+    /// The bundle identifier that the app transaction applies to.
+    /// [bundle_id](https://developer.apple.com/documentation/storekit/apptransaction/3954439-bundleid)
+    pub bundle_id: Option<String>,
+
+    /// The app version that the app transaction applies to.
+    /// [appVersion](https://developer.apple.com/documentation/storekit/apptransaction/3954437-appversion)
+    pub application_version: Option<String>,
+
+    /// The version external identifier of the app.
+    /// [appVersionID](https://developer.apple.com/documentation/storekit/apptransaction/3954438-appversionid)
+    pub version_external_identifier: Option<i64>,
+
+    /// The date that the App Store signed the JWS app transaction.
+    /// [signedDate](https://developer.apple.com/documentation/storekit/apptransaction/3954449-signeddate)
+    pub receipt_creation_date: Option<DateTime<Utc>>,
+
+    /// The date the user originally purchased the app from the App Store.
+    /// [originalPurchaseDate](https://developer.apple.com/documentation/storekit/apptransaction/3954448-originalpurchasedate)
+    pub original_purchase_date: Option<DateTime<Utc>>,
+
+    /// The app version that the user originally purchased from the App Store.
+    /// [originalAppVersion](https://developer.apple.com/documentation/storekit/apptransaction/3954447-originalappversion)
+    pub original_application_version: Option<String>,
+
+    /// The Base64 device verification value to use to verify whether the app transaction belongs to the device.
+    /// [deviceVerification](https://developer.apple.com/documentation/storekit/apptransaction/3954441-deviceverification)
+    pub device_verification: Option<String>,
+
+    /// The UUID used to compute the device verification value.
+    /// [deviceVerificationNonce](https://developer.apple.com/documentation/storekit/apptransaction/3954442-deviceverificationnonce)
+    pub device_verification_nonce: Option<Uuid>,
+
+    /// The date the customer placed an order for the app before it’s available in the App Store.
+    /// [preorderDate](https://developer.apple.com/documentation/storekit/apptransaction/4013175-preorderdate)
+    pub preorder_date: Option<DateTime<Utc>>,
+
+    /// The date that the App Store signed the JWS app transaction.
+    /// [signedDate](https://developer.apple.com/documentation/storekit/apptransaction/3954449-signeddate)
+    pub signed_date: Option<DateTime<Utc>>,
+}

src/primitives/auto_renew_status.rs

@@ -0,0 +1,7 @@
+use serde::{Deserialize, Serialize};
+
+#[derive(Debug, Deserialize, Serialize, Hash, PartialEq, Eq)]
+pub enum AutoRenewStatus {
+    Off = 0,
+    On = 1,
+}

src/primitives/check_test_notification_response.rs

@@ -0,0 +1,20 @@
+use serde::{Deserialize, Serialize};
+use crate::primitives::send_attempt_item::SendAttemptItem;
+
+/// A response that contains the contents of the test notification sent by the App Store server and the result from your server.
+///
+/// [CheckTestNotificationResponse](https://developer.apple.com/documentation/appstoreserverapi/checktestnotificationresponse)
+#[derive(Debug, Deserialize, Serialize, Hash)]
+pub struct CheckTestNotificationResponse {
+    /// A cryptographically signed payload, in JSON Web Signature (JWS) format, containing the response body for a version 2 notification.
+    ///
+    /// [signedPayload](https://developer.apple.com/documentation/appstoreservernotifications/signedpayload)
+    #[serde(rename = "signedPayload")]
+    pub signed_payload: Option<String>,
+
+    /// An array of information the App Store server records for its attempts to send the TEST notification to your server. The array may contain a maximum of six sendAttemptItem objects.
+    ///
+    /// [sendAttemptItem](https://developer.apple.com/documentation/appstoreserverapi/sendattemptitem)
+    #[serde(rename = "sendAttemptItem")]
+    pub send_attempts: Option<Vec<SendAttemptItem>>,
+}

src/primitives/consumption_request.rs

@@ -0,0 +1,81 @@
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+use crate::primitives::account_tenure::AccountTenure;
+use crate::primitives::consumption_status::ConsumptionStatus;
+use crate::primitives::delivery_status::DeliveryStatus;
+use crate::primitives::lifetime_dollars_purchased::LifetimeDollarsPurchased;
+use crate::primitives::lifetime_dollars_refunded::LifetimeDollarsRefunded;
+use crate::primitives::platform::Platform;
+use crate::primitives::play_time::PlayTime;
+use crate::primitives::user_status::UserStatus;
+
+/// The request body containing consumption information.
+///
+/// [ConsumptionRequest](https://developer.apple.com/documentation/appstoreserverapi/consumptionrequest)
+#[derive(Debug, Deserialize, Serialize, Hash)]
+pub struct ConsumptionRequest {
+    /// A Boolean value that indicates whether the customer consented to provide consumption data to the App Store.
+    ///
+    /// [customerConsented](https://developer.apple.com/documentation/appstoreserverapi/customerconsented)
+    #[serde(rename = "customerConsented")]
+    pub customer_consented: Option<bool>,
+
+    /// A value that indicates the extent to which the customer consumed the in-app purchase.
+    ///
+    /// [consumptionStatus](https://developer.apple.com/documentation/appstoreserverapi/consumptionstatus)
+    #[serde(rename = "consumptionStatus")]
+    pub consumption_status: Option<ConsumptionStatus>,
+
+    /// A value that indicates the platform on which the customer consumed the in-app purchase.
+    ///
+    /// [platform](https://developer.apple.com/documentation/appstoreserverapi/platform)
+    pub platform: Option<Platform>,
+
+    /// A Boolean value that indicates whether you provided, prior to its purchase, a free sample or trial of the content, or information about its functionality.
+    ///
+    /// [sampleContentProvided](https://developer.apple.com/documentation/appstoreserverapi/samplecontentprovided)
+    #[serde(rename = "sampleContentProvided")]
+    pub sample_content_provided: Option<bool>,
+
+    /// A value that indicates whether the app successfully delivered an in-app purchase that works properly.
+    ///
+    /// [deliveryStatus](https://developer.apple.com/documentation/appstoreserverapi/deliverystatus)
+    #[serde(rename = "deliveryStatus")]
+    pub delivery_status: Option<DeliveryStatus>,
+
+    /// The UUID that an app optionally generates to map a customer’s in-app purchase with its resulting App Store transaction.
+    ///
+    /// [appAccountToken](https://developer.apple.com/documentation/appstoreserverapi/appaccounttoken)
+    #[serde(rename = "appAccountToken")]
+    pub app_account_token: Option<Uuid>,
+
+    /// The age of the customer’s account.
+    ///
+    /// [accountTenure](https://developer.apple.com/documentation/appstoreserverapi/accounttenure)
+    #[serde(rename = "accountTenure")]
+    pub account_tenure: Option<AccountTenure>,
+
+    /// A value that indicates the amount of time that the customer used the app.
+    ///
+    /// [playTime](https://developer.apple.com/documentation/appstoreserverapi/playtime)
+    #[serde(rename = "playTime")]
+    pub play_time: Option<PlayTime>,
+
+    /// A value that indicates the total amount, in USD, of refunds the customer has received, in your app, across all platforms.
+    ///
+    /// [lifetimeDollarsRefunded](https://developer.apple.com/documentation/appstoreserverapi/lifetimedollarsrefunded)
+    #[serde(rename = "lifetimeDollarsRefunded")]
+    pub lifetime_dollars_refunded: Option<LifetimeDollarsRefunded>,
+
+    /// A value that indicates the total amount, in USD, of in-app purchases the customer has made in your app, across all platforms.
+    ///
+    /// [lifetimeDollarsPurchased](https://developer.apple.com/documentation/appstoreserverapi/lifetimedollarspurchased)
+    #[serde(rename = "lifetimeDollarsPurchased")]
+    pub lifetime_dollars_purchased: Option<LifetimeDollarsPurchased>,
+
+    /// The status of the customer’s account.
+    ///
+    /// [userStatus](https://developer.apple.com/documentation/appstoreserverapi/userstatus)
+    #[serde(rename = "userStatus")]
+    pub user_status: Option<UserStatus>,
+}

src/primitives/consumption_status.rs

@@ -0,0 +1,12 @@
+use serde::{Deserialize, Serialize};
+
+/// A value that indicates the extent to which the customer consumed the in-app purchase.
+///
+/// [consumptionStatus](https://developer.apple.com/documentation/appstoreserverapi/consumptionstatus)
+#[derive(Debug, Deserialize, Serialize, Hash, PartialEq, Eq)]
+pub enum ConsumptionStatus {
+    Undeclared = 0,
+    NotConsumed = 1,
+    PartiallyConsumed = 2,
+    FullyConsumed = 3,
+}

src/primitives/data.rs

@@ -0,0 +1,38 @@
+use serde::{Deserialize, Serialize};
+use crate::primitives::environment::Environment;
+
+/// The app metadata and the signed renewal and transaction information.
+///
+/// [data](https://developer.apple.com/documentation/appstoreservernotifications/data)
+#[derive(Debug, Deserialize, Serialize, Hash)]
+pub struct Data {
+    /// The server environment that the notification applies to, either sandbox or production.
+    ///
+    /// [environment](https://developer.apple.com/documentation/appstoreservernotifications/environment)
+    pub environment: Option<Environment>,
+
+    /// The unique identifier of an app in the App Store.
+    ///
+    /// [app_apple_id](https://developer.apple.com/documentation/appstoreservernotifications/appappleid)
+    pub app_apple_id: Option<i64>,
+
+    /// The bundle identifier of an app.
+    ///
+    /// [bundle_id](https://developer.apple.com/documentation/appstoreserverapi/bundleid)
+    pub bundle_id: Option<String>,
+
+    /// The version of the build that identifies an iteration of the bundle.
+    ///
+    /// [bundleVersion](https://developer.apple.com/documentation/appstoreservernotifications/bundleversion)
+    pub bundle_version: Option<String>,
+
+    /// Transaction information signed by the App Store, in JSON Web Signature (JWS) format.
+    ///
+    /// [JWSTransaction](https://developer.apple.com/documentation/appstoreserverapi/jwstransaction)
+    pub signed_transaction_info: Option<String>,
+
+    /// Subscription renewal information, signed by the App Store, in JSON Web Signature (JWS) format.
+    ///
+    /// [JWSRenewalInfo](https://developer.apple.com/documentation/appstoreserverapi/jwsrenewalinfo)
+    pub signed_renewal_info: Option<String>,
+}

src/primitives/delivery_status.rs

@@ -0,0 +1,14 @@
+use serde::{Deserialize, Serialize};
+
+/// A value that indicates whether the app successfully delivered an in-app purchase that works properly.
+///
+/// [deliveryStatus](https://developer.apple.com/documentation/appstoreserverapi/deliverystatus)
+#[derive(Debug, Deserialize, Serialize, Hash, PartialEq, Eq)]
+pub enum DeliveryStatus {
+    DeliveredAndWorkingProperly = 0,
+    DidNotDeliverDueToQualityIssue = 1,
+    DeliveredWrongItem = 2,
+    DidNotDeliverDueToServerOutage = 3,
+    DidNotDeliverDueToIngameCurrencyChange = 4,
+    DidNotDeliverForOtherReason = 5,
+}

src/primitives/environment.rs

@@ -0,0 +1,9 @@
+use serde::{Deserialize, Serialize};
+
+#[derive(Debug, Deserialize, Serialize, Hash, PartialEq, Eq)]
+pub enum Environment {
+    #[serde(rename = "Sandbox")]
+    Sandbox,
+    #[serde(rename = "Production")]
+    Production,
+}

src/primitives/error_payload.rs

@@ -0,0 +1,7 @@
+use serde::{Deserialize, Serialize};
+
+#[derive(Debug, Deserialize, Serialize, Hash)]
+pub struct ErrorPayload {
+    pub error_code: Option<i64>,
+    pub error_message: Option<String>,
+}