Merge pull request #285 from qonversion/kamo/dev-343-purchase-with-transaction-info

Author: SpertsyanKM

Runtime/Android/Plugins/com/qonversion/unitywrapper/QonversionWrapper.java

@@ -132,7 +132,7 @@ public static synchronized void purchase(
                 TypeReference<List<String>> typeRef = new TypeReference<List<String>>() {};
                 contextKeysList = mapper.readValue(contextKeys, typeRef);
             }
-            qonversionSandwich.purchase(
+            qonversionSandwich.purchaseWithResult(
                     productId,
                     offerId,
                     applyOffer,
@@ -146,17 +146,6 @@ public static synchronized void purchase(
         }
     }
 
-    public static synchronized void updatePurchase(
-            String productId,
-            @Nullable String offerId,
-            boolean applyOffer,
-            String oldProductId,
-            @Nullable String updatePolicyKey,
-            String unityCallbackName
-    ) {
-        purchase(productId, offerId, applyOffer, oldProductId, updatePolicyKey, null, unityCallbackName);
-    }
-
     public static synchronized void restore(String unityCallbackName) {
         qonversionSandwich.restore(getResultListener(unityCallbackName));
     }

Runtime/Android/QonversionWrapperAndroid.cs

@@ -131,41 +131,11 @@ public void Purchase(string productId, PurchaseOptions purchaseOptions, string c
             );
         }
 
-        public void Purchase(PurchaseModel purchaseModel, string callbackName)
-        {
-            CallQonversion(
-                "purchase",
-                purchaseModel.ProductId,
-                purchaseModel.OfferId,
-                purchaseModel.ApplyOffer,
-                null,
-                null,
-                null,
-                callbackName
-            );
-        }
-
         public void Restore(string callbackName)
         {
             CallQonversion("restore", callbackName);
         }
 
-        public void UpdatePurchase(PurchaseUpdateModel purchaseUpdateModel, string callbackName) {
-            var updatePolicyKey = purchaseUpdateModel.UpdatePolicy == null
-                ? null
-                : Enum.GetName(typeof(PurchaseUpdatePolicy), purchaseUpdateModel.UpdatePolicy);
-
-            CallQonversion(
-                "updatePurchase",
-                purchaseUpdateModel.ProductId,
-                purchaseUpdateModel.OfferId,
-                purchaseUpdateModel.ApplyOffer,
-                purchaseUpdateModel.OldProductId,
-                updatePolicyKey,
-                callbackName
-            );
-        }
-
         public void Products(string callbackName)
         {
             CallQonversion("products", callbackName);

Runtime/Scripts/Dto/PurchaseResult.cs

@@ -0,0 +1,154 @@
+using System.Collections.Generic;
+using JetBrains.Annotations;
+using UnityEngine.Scripting;
+
+namespace QonversionUnity
+{
+    /// <summary>
+    /// Represents the result of a purchase operation.
+    /// Contains the status of the purchase, entitlements, and store transaction details.
+    /// </summary>
+    public class PurchaseResult
+    {
+        /// <summary>
+        /// The status of the purchase operation.
+        /// </summary>
+        public readonly PurchaseResultStatus Status;
+
+        /// <summary>
+        /// The user's entitlements after the purchase.
+        /// May be null if the purchase failed or is pending.
+        /// </summary>
+        [CanBeNull] public readonly Dictionary<string, Entitlement> Entitlements;
+
+        /// <summary>
+        /// The error that occurred during the purchase, if any.
+        /// </summary>
+        [CanBeNull] public readonly QonversionError Error;
+
+        /// <summary>
+        /// Indicates whether the entitlements were generated from a fallback source.
+        /// </summary>
+        public readonly bool IsFallbackGenerated;
+
+        /// <summary>
+        /// The source of the purchase result data.
+        /// </summary>
+        public readonly PurchaseResultSource Source;
+
+        /// <summary>
+        /// The store transaction details from the native platform.
+        /// Contains raw transaction information from Apple App Store or Google Play Store.
+        /// </summary>
+        [CanBeNull] public readonly StoreTransaction StoreTransaction;
+
+        [Preserve]
+        public PurchaseResult(Dictionary<string, object> dict)
+        {
+            if (dict.TryGetValue("status", out object value))
+            {
+                Status = FormatStatus(value as string);
+            }
+            else
+            {
+                Status = PurchaseResultStatus.Unknown;
+            }
+
+            if (dict.TryGetValue("entitlements", out value) && value is Dictionary<string, object> entitlementsDict)
+            {
+                Entitlements = new Dictionary<string, Entitlement>();
+                foreach (var pair in entitlementsDict)
+                {
+                    if (pair.Value is Dictionary<string, object> entitlementDict)
+                    {
+                        Entitlements[pair.Key] = new Entitlement(entitlementDict);
+                    }
+                }
+            }
+
+            if (dict.TryGetValue("error", out value) && value is Dictionary<string, object> errorDict)
+            {
+                Error = new QonversionError(errorDict);
+            }
+
+            if (dict.TryGetValue("isFallbackGenerated", out value) && value != null)
+            {
+                IsFallbackGenerated = (bool)value;
+            }
+
+            if (dict.TryGetValue("source", out value))
+            {
+                Source = FormatSource(value as string);
+            }
+            else
+            {
+                Source = PurchaseResultSource.Unknown;
+            }
+
+            if (dict.TryGetValue("storeTransaction", out value) && value is Dictionary<string, object> transactionDict)
+            {
+                StoreTransaction = new StoreTransaction(transactionDict);
+            }
+        }
+
+        /// <summary>
+        /// Returns true if the purchase was successful.
+        /// </summary>
+        public bool IsSuccess => Status == PurchaseResultStatus.Success;
+
+        /// <summary>
+        /// Returns true if the purchase was canceled by the user.
+        /// </summary>
+        public bool IsCanceled => Status == PurchaseResultStatus.UserCanceled;
+
+        /// <summary>
+        /// Returns true if the purchase is pending.
+        /// </summary>
+        public bool IsPending => Status == PurchaseResultStatus.Pending;
+
+        /// <summary>
+        /// Returns true if an error occurred during the purchase.
+        /// </summary>
+        public bool IsError => Status == PurchaseResultStatus.Error;
+
+        public override string ToString()
+        {
+            return $"{nameof(Status)}: {Status}, " +
+                   $"{nameof(Entitlements)}: {Entitlements?.Count ?? 0} items, " +
+                   $"{nameof(Error)}: {Error}, " +
+                   $"{nameof(IsFallbackGenerated)}: {IsFallbackGenerated}, " +
+                   $"{nameof(Source)}: {Source}, " +
+                   $"{nameof(StoreTransaction)}: {StoreTransaction}";
+        }
+
+        private static PurchaseResultStatus FormatStatus(string value)
+        {
+            switch (value)
+            {
+                case "Success":
+                    return PurchaseResultStatus.Success;
+                case "UserCanceled":
+                    return PurchaseResultStatus.UserCanceled;
+                case "Pending":
+                    return PurchaseResultStatus.Pending;
+                case "Error":
+                    return PurchaseResultStatus.Error;
+                default:
+                    return PurchaseResultStatus.Unknown;
+            }
+        }
+
+        private static PurchaseResultSource FormatSource(string value)
+        {
+            switch (value)
+            {
+                case "Api":
+                    return PurchaseResultSource.Api;
+                case "Local":
+                    return PurchaseResultSource.Local;
+                default:
+                    return PurchaseResultSource.Unknown;
+            }
+        }
+    }
+}

Runtime/Scripts/Dto/PurchaseResult.cs.meta

@@ -0,0 +1,23 @@
+namespace QonversionUnity
+{
+    /// <summary>
+    /// Source of the purchase result data.
+    /// </summary>
+    public enum PurchaseResultSource
+    {
+        /// <summary>
+        /// Unknown source.
+        /// </summary>
+        Unknown,
+
+        /// <summary>
+        /// The result was obtained from the Qonversion API.
+        /// </summary>
+        Api,
+
+        /// <summary>
+        /// The result was obtained from the local store.
+        /// </summary>
+        Local
+    }
+}

Runtime/Scripts/Dto/PurchaseResultSource.cs

@@ -0,0 +1,33 @@
+namespace QonversionUnity
+{
+    /// <summary>
+    /// Status of the purchase result.
+    /// </summary>
+    public enum PurchaseResultStatus
+    {
+        /// <summary>
+        /// Unknown status.
+        /// </summary>
+        Unknown,
+
+        /// <summary>
+        /// The purchase was successful.
+        /// </summary>
+        Success,
+
+        /// <summary>
+        /// The purchase was canceled by the user.
+        /// </summary>
+        UserCanceled,
+
+        /// <summary>
+        /// The purchase is pending (e.g., waiting for parental approval).
+        /// </summary>
+        Pending,
+
+        /// <summary>
+        /// An error occurred during the purchase.
+        /// </summary>
+        Error
+    }
+}

Runtime/Scripts/Dto/PurchaseResultSource.cs.meta

@@ -0,0 +1,93 @@
+using System;
+using System.Collections.Generic;
+using JetBrains.Annotations;
+using UnityEngine.Scripting;
+
+namespace QonversionUnity
+{
+    /// <summary>
+    /// Represents a raw store transaction from the native platform.
+    /// This is the transaction information as received from Apple App Store or Google Play Store.
+    /// </summary>
+    public class StoreTransaction
+    {
+        /// <summary>
+        /// The unique identifier for this transaction.
+        /// </summary>
+        [CanBeNull] public readonly string TransactionId;
+
+        /// <summary>
+        /// The original transaction identifier.
+        /// For subscriptions, this identifies the first transaction in the subscription chain.
+        /// </summary>
+        [CanBeNull] public readonly string OriginalTransactionId;
+
+        /// <summary>
+        /// The date and time when the transaction occurred.
+        /// </summary>
+        [CanBeNull] public readonly DateTime? TransactionDate;
+
+        /// <summary>
+        /// The store product identifier associated with this transaction.
+        /// </summary>
+        [CanBeNull] public readonly string ProductId;
+
+        /// <summary>
+        /// The quantity of items purchased.
+        /// </summary>
+        public readonly int Quantity;
+
+        /// <summary>
+        /// iOS only. The identifier of the promotional offer applied to this purchase.
+        /// </summary>
+        [CanBeNull] public readonly string PromoOfferId;
+
+        /// <summary>
+        /// Android only. The purchase token from Google Play.
+        /// </summary>
+        [CanBeNull] public readonly string PurchaseToken;
+
+        [Preserve]
+        public StoreTransaction(Dictionary<string, object> dict)
+        {
+            if (dict.TryGetValue("transactionId", out object value)) TransactionId = value as string;
+            if (dict.TryGetValue("originalTransactionId", out value)) OriginalTransactionId = value as string;
+            if (dict.TryGetValue("transactionTimestamp", out value) && value != null)
+            {
+                TransactionDate = FormatDate(value);
+            }
+            if (dict.TryGetValue("productId", out value)) ProductId = value as string;
+            if (dict.TryGetValue("quantity", out value) && value != null)
+            {
+                Quantity = Convert.ToInt32(value);
+            }
+            else
+            {
+                Quantity = 1;
+            }
+            if (dict.TryGetValue("promoOfferId", out value)) PromoOfferId = value as string;
+            if (dict.TryGetValue("purchaseToken", out value)) PurchaseToken = value as string;
+        }
+
+        public override string ToString()
+        {
+            return $"{nameof(TransactionId)}: {TransactionId}, " +
+                   $"{nameof(OriginalTransactionId)}: {OriginalTransactionId}, " +
+                   $"{nameof(TransactionDate)}: {TransactionDate}, " +
+                   $"{nameof(ProductId)}: {ProductId}, " +
+                   $"{nameof(Quantity)}: {Quantity}, " +
+                   $"{nameof(PromoOfferId)}: {PromoOfferId}, " +
+                   $"{nameof(PurchaseToken)}: {PurchaseToken}";
+        }
+
+        private DateTime FormatDate(object time)
+        {
+            if (time is double doubleTime)
+            {
+                return Utils.FormatDate(Convert.ToInt64(doubleTime));
+            }
+
+            return Utils.FormatDate(Convert.ToInt64(time));
+        }
+    }
+}