sjbillingclient 0.2.2__py3-none-any.whl → 1.0.0__py3-none-any.whl

sjbillingclient/jclass/accountidentifiers.py

@@ -0,0 +1,10 @@
+from jnius import JavaClass, MetaJavaClass, JavaMethod
+
+__all__ = ("AccountIdentifiers",)
+
+
+class AccountIdentifiers(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/AccountIdentifiers"
+
+    getObfuscatedAccountId = JavaMethod("()Ljava/lang/String;")
+    getObfuscatedProfileId = JavaMethod("()Ljava/lang/String;")

sjbillingclient/jclass/acknowledge.py

@@ -4,5 +4,5 @@ __all__ = ("AcknowledgePurchaseParams",)
 
 
 class AcknowledgePurchaseParams(JavaClass, metaclass=MetaJavaClass):
-    __javaclass__ = f"com/android/billingclient/api/AcknowledgePurchaseParams"
+    __javaclass__ = "com/android/billingclient/api/AcknowledgePurchaseParams"
     newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/AcknowledgePurchaseParams$Builder;")

sjbillingclient/jclass/billing.py

@@ -1,7 +1,8 @@
 from jnius import JavaClass, MetaJavaClass, JavaStaticMethod, JavaStaticField, JavaMethod, JavaMultipleMethod
 
-__all__ = ("BillingClient", "BillingFlowParams", "ProductType", "GetBillingConfigParams",
-           "ProductDetailsParams", "BillingResponseCode")
+__all__ = ("BillingClient", "BillingFlowParams", "BillingFlowParamsBuilder", "ProductType", "GetBillingConfigParams",
+           "ProductDetailsParams", "BillingResponseCode", "SubscriptionUpdateParams", "SubscriptionUpdateParamsBuilder",
+           "ReplacementMode")
 
 
 class BillingClient(JavaClass, metaclass=MetaJavaClass):
@@ -54,27 +55,28 @@ class BillingClient(JavaClass, metaclass=MetaJavaClass):
         "(Lcom/android/billingclient/api/QueryProductDetailsParams;"
         "Lcom/android/billingclient/api/ProductDetailsResponseListener;)V"
     )
-    queryPurchaseHistoryAsync = JavaMultipleMethod([
-        ("(Lcom/android/billingclient/api/QueryPurchaseHistoryParams;"
-         "Lcom/android/billingclient/api/PurchaseHistoryResponseListener;)V",
-         False, False),
-        ("(Ljava/lang/String;Lcom/android/billingclient/api/PurchaseHistoryResponseListener;)V,",
-         False, False),
-    ])
-    queryPurchasesAsync = JavaMultipleMethod([
-        ("(Lcom/android/billingclient/api/QueryPurchasesParams;"
-         "Lcom/android/billingclient/api/PurchasesResponseListener;)V", False, False),
-        ("(Ljava/lang/String;Lcom/android/billingclient/api/PurchasesResponseListener;)V",
-         False, False),
-    ])
-    querySkuDetailsAsync = JavaMethod(
-        "(Lcom/android/billingclient/api/SkuDetailsParams;"
-        "Lcom/android/billingclient/api/SkuDetailsResponseListener;)V"
+    queryPurchasesAsync = JavaMethod(
+        "(Lcom/android/billingclient/api/QueryPurchasesParams;"
+        "Lcom/android/billingclient/api/PurchasesResponseListener;)V"
     )
     startConnection = JavaMethod("(Lcom/android/billingclient/api/BillingClientStateListener;)V")
     isReady = JavaMethod("()Z")
 
 
+class BillingClientBuilder(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/BillingClient$Builder"
+    build = JavaMethod("()Lcom/android/billingclient/api/BillingClient;")
+    enableAlternativeBillingOnly = JavaMethod("()Lcom/android/billingclient/api/BillingClient$Builder;")
+    enableAutoServiceReconnection = JavaMethod("()Lcom/android/billingclient/api/BillingClient$Builder;")
+    enableExternalOffer = JavaMethod("()Lcom/android/billingclient/api/BillingClient$Builder;")
+    enablePendingPurchases = JavaMethod("(Lcom/android/billingclient/api/PendingPurchasesParams;)"
+                                        "Lcom/android/billingclient/api/BillingClient$Builder;")
+    enableUserChoiceBilling = JavaMethod("(Lcom/android/billingclient/api/UserChoiceBillingListener;)"
+                                         "Lcom/android/billingclient/api/BillingClient$Builder;")
+    setListener = JavaMethod("(Lcom/android/billingclient/api/PurchasesUpdatedListener;)"
+                             "Lcom/android/billingclient/api/BillingClient$Builder;")
+
+
 class ProductType(JavaClass, metaclass=MetaJavaClass):
     __javaclass__ = "com/android/billingclient/api/BillingClient$ProductType"
     INAPP = JavaStaticField("Ljava/lang/String;")
@@ -102,6 +104,19 @@ class BillingFlowParams(JavaClass, metaclass=MetaJavaClass):
     newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/BillingFlowParams$Builder;")
 
 
+class BillingFlowParamsBuilder(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/BillingFlowParams$Builder"
+    build = JavaMethod("()Lcom/android/billingclient/api/BillingFlowParams;")
+    setIsOfferPersonalized = JavaMethod("(Z)Lcom/android/billingclient/api/BillingFlowParams$Builder;")
+    setObfuscatedAccountId = JavaMethod("(Ljava/lang/String;)Lcom/android/billingclient/api/BillingFlowParams$Builder;")
+    setObfuscatedProfileId = JavaMethod("(Ljava/lang/String;)Lcom/android/billingclient/api/BillingFlowParams$Builder;")
+    setProductDetailsParamsList = JavaMethod("(Ljava/util/List;)Lcom/android/billingclient/api"
+                                             "/BillingFlowParams$Builder;")
+    setSubscriptionUpdateParams = JavaMethod("(Lcom/android/billingclient/api"
+                                             "/BillingFlowParams$SubscriptionUpdateParams;)Lcom/android/billingclient"
+                                             "/api/BillingFlowParams$Builder;")
+
+
 class GetBillingConfigParams(JavaClass, metaclass=MetaJavaClass):
     __javaclass__ = "com/android/billingclient/api/GetBillingConfigParams"
     newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/GetBillingConfigParams$Builder;")
@@ -110,3 +125,28 @@ class GetBillingConfigParams(JavaClass, metaclass=MetaJavaClass):
 class ProductDetailsParams(JavaClass, metaclass=MetaJavaClass):
     __javaclass__ = "com/android/billingclient/api/BillingFlowParams$ProductDetailsParams"
     newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/BillingFlowParams$ProductDetailsParams$Builder;")
+
+
+class SubscriptionUpdateParams(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/BillingFlowParams$SubscriptionUpdateParams"
+    newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/BillingFlowParams"
+                                  "$SubscriptionUpdateParams$Builder;")
+
+
+class SubscriptionUpdateParamsBuilder(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/BillingFlowParams$SubscriptionUpdateParams$Builder"
+    build = JavaMethod("()Lcom/android/billingclient/api/BillingFlowParams$SubscriptionUpdateParams;")
+    setOldPurchaseToken = JavaMethod("(Ljava/lang/String;)Lcom/android/billingclient/api"
+                                     "/BillingFlowParams$SubscriptionUpdateParams$Builder;")
+    setSubscriptionReplacementMode = JavaMethod("(I)Lcom/android/billingclient/api"
+                                                "/BillingFlowParams$SubscriptionUpdateParams$Builder;")
+
+
+class ReplacementMode(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/BillingFlowParams$SubscriptionUpdateParams$ReplacementMode"
+    CHARGE_FULL_PRICE = JavaStaticField("I")
+    CHARGE_PRORATED_PRICE = JavaStaticField("I")
+    DEFERRED = JavaStaticField("I")
+    UNKNOWN_REPLACEMENT_MODE = JavaStaticField("I")
+    WITHOUT_PRORATION = JavaStaticField("I")
+    WITH_TIME_PRORATION = JavaStaticField("I")

sjbillingclient/jclass/consume.py

@@ -4,5 +4,5 @@ __all__ = ("ConsumeParams",)
 
 
 class ConsumeParams(JavaClass, metaclass=MetaJavaClass):
-    __javaclass__ = f"com/android/billingclient/api/ConsumeParams"
+    __javaclass__ = "com/android/billingclient/api/ConsumeParams"
     newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/ConsumeParams$Builder;")

sjbillingclient/jclass/purchase.py

@@ -1,16 +1,54 @@
-from jnius import JavaClass, MetaJavaClass, JavaStaticMethod, JavaMethod
+from jnius import JavaClass, MetaJavaClass, JavaStaticMethod, JavaMethod, JavaStaticField
 
-__all__ = ("PendingPurchasesParams", "PendingPurchasesParamsBuilder")
+__all__ = ("PendingPurchasesParams", "PendingPurchasesParamsBuilder", "Purchase", "PurchaseState", "PendingPurchaseUpdate")
 
 
 class PendingPurchasesParams(JavaClass, metaclass=MetaJavaClass):
-    __javaclass__ = f"com/android/billingclient/api/PendingPurchasesParams"
+    __javaclass__ = "com/android/billingclient/api/PendingPurchasesParams"
     newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/PendingPurchasesParams$Builder;")
 
 
 class PendingPurchasesParamsBuilder(JavaClass, metaclass=MetaJavaClass):
-    __javaclass__ = f"com/android/billingclient/api/PendingPurchasesParams$Builder"
+    __javaclass__ = "com/android/billingclient/api/PendingPurchasesParams$Builder"
 
     build = JavaMethod("()Lcom/android/billingclient/api/PendingPurchasesParams;")
     enableOneTimeProducts = JavaMethod("()Lcom/android/billingclient/api/PendingPurchasesParams$Builder;")
     enablePrepaidPlans = JavaMethod("()Lcom/android/billingclient/api/PendingPurchasesParams$Builder;")
+
+
+class Purchase(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/Purchase"
+
+    getAccountIdentifiers = JavaMethod("()Lcom/android/billingclient/api/AccountIdentifiers;")
+    getDeveloperPayload = JavaMethod("()Ljava/lang/String;")
+    getOrderId = JavaMethod("()Ljava/lang/String;")
+    getOriginalJson = JavaMethod("()Ljava/lang/String;")
+    getPackageName = JavaMethod("()Ljava/lang/String;")
+    getPendingPurchaseUpdate = JavaMethod("()Lcom/android/billingclient/api/Purchase$PendingPurchaseUpdate;")
+    getProducts = JavaMethod("()Ljava/util/List;")
+    getPurchaseState = JavaMethod("()I")
+    getPurchaseTime = JavaMethod("()J")
+    getPurchaseToken = JavaMethod("()Ljava/lang/String;")
+    getQuantity = JavaMethod("()I")
+    getSignature = JavaMethod("()Ljava/lang/String;")
+    hashCode = JavaMethod("()I")
+    isAcknowledged = JavaMethod("()Z")
+    isAutoRenewing = JavaMethod("()Z")
+    toString = JavaMethod("()Ljava/lang/String;")
+
+
+class PurchaseState(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/Purchase$PurchaseState"
+
+    # Purchase state constants
+    PENDING = JavaStaticField("I")
+    PURCHASED = JavaStaticField("I")
+    UNSPECIFIED = JavaStaticField("I")
+
+
+class PendingPurchaseUpdate(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/Purchase$PendingPurchaseUpdate"
+
+    getProducts = JavaMethod("()Ljava/util/List;")
+    getPurchaseToken = JavaMethod("()Ljava/lang/String;")
+

sjbillingclient/jclass/queryproduct.py

@@ -1,20 +1,35 @@
 from jnius import JavaClass, MetaJavaClass, JavaStaticMethod, JavaMethod
 
-__all__ = ("QueryProductDetailsParams", "QueryProductDetailsParamsProduct")
+__all__ = ("QueryProductDetailsParams", "QueryProductDetailsParamsProduct", "QueryProductDetailsParamsBuilder", "QueryProductDetailsParamsProductBuilder")
 
 
 class QueryProductDetailsParams(JavaClass, metaclass=MetaJavaClass):
-    __javaclass__ = f"com/android/billingclient/api/QueryProductDetailsParams"
+    __javaclass__ = "com/android/billingclient/api/QueryProductDetailsParams"
     newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/QueryProductDetailsParams$Builder;")
 
 
 class QueryProductDetailsParamsProduct(JavaClass, metaclass=MetaJavaClass):
-    __javaclass__ = f"com/android/billingclient/api/QueryProductDetailsParams$Product"
+    __javaclass__ = "com/android/billingclient/api/QueryProductDetailsParams$Product"
     newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/QueryProductDetailsParams$Product$Builder;")
 
 
+class QueryProductDetailsParamsProductBuilder(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/QueryProductDetailsParams$Product$Builder"
+    build = JavaMethod("()Lcom/android/billingclient/api/QueryProductDetailsParams$Product;")
+    setProductId = JavaMethod("(Ljava/lang/String;)"
+                              "Lcom/android/billingclient/api/QueryProductDetailsParams$Product$Builder;")
+    setProductType = JavaMethod("(Ljava/lang/String;)"
+                                "Lcom/android/billingclient/api/QueryProductDetailsParams$Product$Builder;")
+
+
+class QueryProductDetailsParamsBuilder(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/QueryProductDetailsParams$Builder"
+    build = JavaMethod("()Lcom/android/billingclient/api/QueryProductDetailsParams;")
+    setProductList = JavaMethod("(Ljava/util/List;)Lcom/android/billingclient/api/QueryProductDetailsParams$Builder;")
+
+
 class QueryProductDetailsResult(JavaClass, metaclass=MetaJavaClass):
-    __javaclass__ = f"com/android/billingclient/api/QueryProductDetailsResult"
+    __javaclass__ = "com/android/billingclient/api/QueryProductDetailsResult"
     create = JavaStaticMethod("(Ljava/util/List;Ljava/util/List;)"
                               "Lcom/android/billingclient/api/QueryProductDetailsResult;")
     getProductDetailsList = JavaMethod("()Ljava/util/List;")

sjbillingclient/jclass/querypurchases.py

@@ -0,0 +1,14 @@
+from jnius import JavaClass, MetaJavaClass, JavaStaticMethod, JavaMethod
+
+__all__ = ("QueryPurchasesParams", "QueryPurchasesParamsBuilder")
+
+
+class QueryPurchasesParams(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/QueryPurchasesParams"
+    newBuilder = JavaStaticMethod("()Lcom/android/billingclient/api/QueryPurchasesParams$Builder;")
+
+
+class QueryPurchasesParamsBuilder(JavaClass, metaclass=MetaJavaClass):
+    __javaclass__ = "com/android/billingclient/api/QueryPurchasesParams$Builder"
+    build = JavaMethod("()Lcom/android/billingclient/api/QueryPurchasesParams;")
+    setProductType = JavaMethod("(Ljava/lang/String;)Lcom/android/billingclient/api/QueryPurchasesParams$Builder;")

sjbillingclient/jinterface/purchases.py

@@ -1,4 +1,4 @@
-__all__ = ("PurchasesUpdatedListener", )
+__all__ = ("PurchasesUpdatedListener", "PurchasesResponseListener")
 
 from jnius import PythonJavaClass, java_method
 from sjbillingclient import is_jnull
@@ -14,3 +14,15 @@ class PurchasesUpdatedListener(PythonJavaClass):
     @java_method("(Lcom/android/billingclient/api/BillingResult;Ljava/util/List;)V")
     def onPurchasesUpdated(self, billing_result, purchases):
         self.callback(billing_result, is_jnull(purchases), purchases)
+
+
+class PurchasesResponseListener(PythonJavaClass):
+    __javainterfaces__ = ["com/android/billingclient/api/PurchasesResponseListener"]
+    __javacontext__ = "app"
+
+    def __init__(self, callback):
+        self.callback = callback
+
+    @java_method("(Lcom/android/billingclient/api/BillingResult;Ljava/util/List;)V")
+    def onQueryPurchasesResponse(self, billing_result, purchases):
+        self.callback(billing_result, purchases)

sjbillingclient/tools/__init__.py

@@ -44,11 +44,12 @@ from android.activity import _activity as activity  # noqa
 from sjbillingclient.jclass.consume import ConsumeParams
 from sjbillingclient.jclass.purchase import PendingPurchasesParams
 from sjbillingclient.jclass.queryproduct import QueryProductDetailsParams, QueryProductDetailsParamsProduct
+from sjbillingclient.jclass.querypurchases import QueryPurchasesParams
 from sjbillingclient.jinterface.acknowledge import AcknowledgePurchaseResponseListener
 from sjbillingclient.jinterface.billing import BillingClientStateListener
 from sjbillingclient.jinterface.consume import ConsumeResponseListener
 from sjbillingclient.jinterface.product import ProductDetailsResponseListener
-from sjbillingclient.jinterface.purchases import PurchasesUpdatedListener
+from sjbillingclient.jinterface.purchases import PurchasesUpdatedListener, PurchasesResponseListener
 
 ERROR_NO_BASE_PLAN = "You don't have a base plan"
 ERROR_NO_BASE_PLAN_ID = "You don't have a base plan id"
@@ -76,13 +77,16 @@ class BillingClient:
     :type __consume_response_listener: ConsumeResponseListener | None
     :ivar __acknowledge_purchase_response_listener: Listener handling responses for acknowledging purchases.
     :type __acknowledge_purchase_response_listener: AcknowledgePurchaseResponseListener | None
+    :type __purchases_response_listener: PurchasesResponseListener | None handling responses for purchase queries.
     """
 
     def __init__(
             self,
             on_purchases_updated,
+            enable_auto_service_reconnection: bool = True,
             enable_one_time_products: bool = True,
-            enable_prepaid_plans: bool = False
+            enable_prepaid_plans: bool = False,
+            enable_external_offer: bool = False,
     ) -> None:
         """
         Initializes an instance of the class with the given purchase update callback.
@@ -96,6 +100,7 @@ class BillingClient:
         self.__product_details_response_listener = None
         self.__consume_response_listener = None
         self.__acknowledge_purchase_response_listener = None
+        self.__purchases_response_listener = None
 
         self.__purchase_update_listener = PurchasesUpdatedListener(on_purchases_updated)
         pending_purchase_params = PendingPurchasesParams.newBuilder()
@@ -103,14 +108,18 @@ class BillingClient:
             pending_purchase_params.enableOneTimeProducts()
         if enable_prepaid_plans:
             pending_purchase_params.enablePrepaidPlans()
-        self.__billing_client = (
-            SJBillingClient.newBuilder(activity.context)
-            .setListener(self.__purchase_update_listener)
-            .enablePendingPurchases(pending_purchase_params.build())
+
+        billing_client = SJBillingClient.newBuilder(activity.context)
+        if enable_external_offer:
+            billing_client.enableExternalOffer()
+        if enable_auto_service_reconnection:
+            billing_client.enableAutoServiceReconnection()
+        self.__billing_client = billing_client \
+            .setListener(self.__purchase_update_listener) \
+            .enablePendingPurchases(pending_purchase_params.build()) \
             .build()
-        )
 
-    def start_connection(self, on_billing_setup_finished, on_billing_service_disconnected) -> None:
+    def start_connection(self, on_billing_setup_finished, on_billing_service_disconnected=lambda: None) -> None:
         """
         Starts a connection with the billing client and initializes the billing
         client state listener. This method sets up a listener to handle billing
@@ -140,6 +149,26 @@ class BillingClient:
         """
         self.__billing_client.endConnection()
 
+    def query_purchase_async(self, product_type: str, on_query_purchases_response) -> None:
+        """
+        Queries purchases asynchronously for a given product type.
+
+        This function utilizes the provided purchases response callback to handle the
+        resulting response from the query.
+
+        :param product_type: The type of the products to query purchases for (e.g., "inapp" or "subs").
+        :param on_query_purchases_response: A callback function that is triggered when the
+                                           purchases query is complete.
+        :return: None
+        """
+
+        params = (QueryPurchasesParams.newBuilder()
+                  .setProductType(product_type)
+                  .build())
+
+        self.__purchases_response_listener = PurchasesResponseListener(on_query_purchases_response)
+        self.__billing_client.queryPurchasesAsync(params, self.__purchases_response_listener)
+
     def query_product_details_async(self, product_type: str, products_ids: List[str],
                                     on_product_details_response) -> None:
         """
@@ -188,6 +217,46 @@ class BillingClient:
                 .setProductType(product_type)
                 .build())
 
+    @staticmethod
+    def get_purchase(purchase) -> Dict:
+        """
+        Retrieves detailed information from a purchase object.
+
+        This function extracts important details from a purchase object, such as
+        product IDs, purchase token, purchase state, and other relevant information.
+        The extracted details are then returned as a dictionary.
+
+        :param purchase: The purchase object to extract information from.
+        :type purchase: Purchase
+        :return: A dictionary containing detailed information about the purchase.
+        :rtype: Dict
+        """
+        account_identifiers = purchase.getAccountIdentifiers()
+        pending_purchase_update = purchase.getPendingPurchaseUpdate()
+
+        return {
+            "products": list(purchase.getProducts()),
+            "purchase_token": purchase.getPurchaseToken(),
+            "purchase_state": purchase.getPurchaseState(),
+            "purchase_time": purchase.getPurchaseTime(),
+            "order_id": purchase.getOrderId(),
+            "quantity": purchase.getQuantity(),
+            "is_acknowledged": purchase.isAcknowledged(),
+            "is_auto_renewing": purchase.isAutoRenewing(),
+            "original_json": purchase.getOriginalJson(),
+            "signature": purchase.getSignature(),
+            "package_name": purchase.getPackageName(),
+            "developer_payload": purchase.getDeveloperPayload(),
+            "account_identifiers": {
+                "obfuscated_account_id": account_identifiers.getObfuscatedAccountId(),
+                "obfuscated_profile_id": account_identifiers.getObfuscatedProfileId(),
+            },
+            "pending_purchase_update": {
+                "products": list(pending_purchase_update.getProducts() or []),
+                "purchase_token": pending_purchase_update.getPurchaseToken(),
+            } if pending_purchase_update else None
+        }
+
     @staticmethod
     def get_unfetched_product(unfetched_product) -> Dict:
         """
@@ -325,7 +394,6 @@ class BillingClient:
             self._create_product_params(product_detail, offer_token)
             for product_detail in product_details
         ]
-        print(product_params_list)
 
         billing_flow_params = (BillingFlowParams.newBuilder()
                                .setProductDetailsParamsList(JavaList.of(*product_params_list))

{sjbillingclient-0.2.2.dist-info → sjbillingclient-1.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sjbillingclient
-Version: 0.2.2
+Version: 1.0.0
 Summary: A Python wrapper for the Google Play Billing Library that facilitates in-app purchases and subscriptions in Android applications
 Home-page: https://github.com/SimpleJnius/sj-android-billingclient
 Author: Kenechukwu Akubue
@@ -21,10 +21,6 @@ Description-Content-Type: text/markdown
 
 # SJBillingClient (Google Play Billing SDK for Python)
 
-<!-- GitAds-Verify: 71CCWMQSMVD67LS4WF4N44EXISSL2UTQ -->
-## GitAds Sponsored
-[![Sponsored by GitAds](https://gitads.dev/v1/ad-serve?source=simplejnius/sj-android-billingclient@github)](https://gitads.dev/v1/ad-track?source=simplejnius/sj-android-billingclient@github)
-
 ## Overview
 
 SJBillingClient is a Python wrapper for the Google Play Billing Library that facilitates in-app purchases and subscriptions in Android applications. It provides a high-level, Pythonic interface to interact with Google Play's billing system, making it easier to implement and manage in-app purchases in Python-based Android apps (like those built with Kivy/Python-for-Android).
@@ -41,14 +37,18 @@ SJBillingClient is a Python wrapper for the Google Play Billing Library that fac
 
 - Python 3.9+
 - pyjnius 1.6.1+
-- Android application with Google Play Billing Library (version 8.0.0 recommended)
+- Android application with Google Play Billing Library (version 8.0.0 required)
+
+> **Note**: This library is specifically designed for Google Play Billing Library version 8.0.0. Earlier or later versions may not be compatible due to API changes.
 
 ## Installation
 
 ```shell
 # Using pip
 pip install sjbillingclient
+````
 
+```rpmspec
 # In Buildozer (add to buildozer.spec)
 requirements = sjbillingclient
 android.gradle_dependencies = com.android.billingclient:billing:8.0.0
@@ -161,6 +161,37 @@ def on_acknowledge_purchase_response(billing_result):
 client.acknowledge_purchase(purchase.getPurchaseToken(), on_acknowledge_purchase_response)
 ```
 
+### Querying Purchases
+
+```python
+from sjbillingclient.tools import BillingClient
+from sjbillingclient.jclass.billing import ProductType, BillingResponseCode
+from sjbillingclient.jclass.purchase import PurchaseState
+
+def on_query_purchases_response(billing_result, purchases):
+    if billing_result.getResponseCode() == BillingResponseCode.OK:
+        if purchases and not purchases.isEmpty():
+            for i in range(purchases.size()):
+                purchase = purchases.get(i)
+                # Get formatted purchase details
+                purchase_details = client.get_purchase(purchase)
+                print(f"Products: {purchase_details['products']}")
+                print(f"Purchase token: {purchase_details['purchase_token']}")
+                print(f"Purchase state: {purchase_details['purchase_state']}")
+
+                # Handle the purchase based on its state
+                if purchase_details['purchase_state'] == PurchaseState.PURCHASED:
+                    if not purchase_details['is_acknowledged']:
+                        # Acknowledge the purchase
+                        client.acknowledge_purchase(purchase.getPurchaseToken(), on_acknowledge_purchase_response)
+
+# Query purchases for a specific product type
+client.query_purchase_async(
+    product_type=ProductType.INAPP,
+    on_query_purchases_response=on_query_purchases_response
+)
+```
+
 ### Kivy Integration Example
 
 Here's a complete example of integrating SJBillingClient with a Kivy application:
@@ -284,7 +315,7 @@ class HomeScreen(Screen):
         product_id = self.ids.btn.product_id
         if billing_result.getResponseCode() == BillingResponseCode.OK:
             self.billing_client.query_product_details_async(
-                product_type=ProductType.SUBS if self.ids.subscribe else ProductType.INAPP,
+                product_type=ProductType.SUBS if self.ids.subscribe.active else ProductType.INAPP,
                 products_ids=[product_id],
                 on_product_details_response=self.on_product_details_response,
             )
@@ -428,6 +459,16 @@ The main class for interacting with Google Play Billing.
   - `unfetched_product`: Unfetched product object
   - Returns a dictionary with product ID, type, and status code
 
+- `query_purchase_async(product_type, on_query_purchases_response)`:
+  - Queries purchases asynchronously
+  - `product_type`: Type of products (INAPP or SUBS)
+  - `on_query_purchases_response`: Callback for purchases response
+
+- `get_purchase(purchase)`:
+  - Gets formatted purchase details
+  - `purchase`: Purchase object
+  - Returns a dictionary with purchase details including products, purchase token, purchase state, etc.
+
 #### Purchase Methods
 
 - `launch_billing_flow(product_details, offer_token=None)`: 
@@ -475,6 +516,41 @@ Result of a product details query.
 - `getProductDetailsList()`: Gets the list of product details
 - `getUnfetchedProductList()`: Gets the list of unfetched products
 
+### Purchase
+
+Represents a purchase made by a user.
+
+#### Methods
+
+- `getProducts()`: Gets the list of product IDs associated with the purchase
+- `getPurchaseToken()`: Gets the token that uniquely identifies the purchase
+
+### PurchaseState
+
+Constants for purchase states:
+
+- `PurchaseState.PENDING`: Purchase is pending
+- `PurchaseState.PURCHASED`: Purchase is completed
+- `PurchaseState.UNSPECIFIED`: Purchase state is unspecified
+
+### PendingPurchaseUpdate
+
+Represents a pending update to a purchase.
+
+#### Methods
+
+- `getProducts()`: Gets the list of product IDs associated with the pending purchase update
+- `getPurchaseToken()`: Gets the token that uniquely identifies the pending purchase update
+
+### AccountIdentifiers
+
+Contains account identifiers for a purchase.
+
+#### Methods
+
+- `getObfuscatedAccountId()`: Gets the obfuscated account ID
+- `getProfileId()`: Gets the profile ID
+
 ### ProductType
 
 Constants for product types:
@@ -482,6 +558,48 @@ Constants for product types:
 - `ProductType.INAPP`: One-time purchases
 - `ProductType.SUBS`: Subscriptions
 
+### BillingFlowParamsBuilder
+
+Builder for BillingFlowParams.
+
+#### Methods
+
+- `build()`: Builds the BillingFlowParams object
+- `setIsOfferPersonalized(boolean)`: Sets whether the offer is personalized
+- `setObfuscatedAccountId(String)`: Sets the obfuscated account ID
+- `setObfuscatedProfileId(String)`: Sets the obfuscated profile ID
+- `setProductDetailsParamsList(List)`: Sets the list of product details parameters
+- `setSubscriptionUpdateParams(SubscriptionUpdateParams)`: Sets the subscription update parameters
+
+### SubscriptionUpdateParams
+
+Parameters for updating a subscription.
+
+#### Methods
+
+- `newBuilder()`: Creates a new builder for SubscriptionUpdateParams
+- `build()`: Builds the SubscriptionUpdateParams object
+
+### SubscriptionUpdateParamsBuilder
+
+Builder for SubscriptionUpdateParams.
+
+#### Methods
+
+- `build()`: Builds the SubscriptionUpdateParams object
+- `setOldPurchaseToken(String)`: Sets the token of the old purchase to be replaced
+- `setSubscriptionReplacementMode(int)`: Sets the replacement mode for the subscription
+
+### ReplacementMode
+
+Constants for subscription replacement modes:
+
+- `ReplacementMode.CHARGE_FULL_PRICE`: Charge the full price for the new subscription
+- `ReplacementMode.CHARGE_PRORATED_PRICE`: Charge a prorated price for the new subscription
+- `ReplacementMode.DEFERRED`: Defer the replacement until the next billing cycle
+- `ReplacementMode.WITHOUT_PRORATION`: Replace without proration
+- `ReplacementMode.WITH_TIME_PRORATION`: Replace with time proration
+
 ### BillingResponseCode
 
 Constants for billing response codes:

sjbillingclient-1.0.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+sjbillingclient/__init__.py,sha256=i__3SUZ1MIcciCmCJM43fMtwFaglkoBT0acnbanUulo,125
+sjbillingclient/jclass/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sjbillingclient/jclass/accountidentifiers.py,sha256=7LzLeRPIBCkzyyeBMMxTOqEiTp1dKHpjQ-fzHMH9PH4,354
+sjbillingclient/jclass/acknowledge.py,sha256=dsS25l7SgvB-avfPRjRyRsb9SxiZsFAm4TP1V-CsGs4,357
+sjbillingclient/jclass/billing.py,sha256=eNQLcOc-duy7vfPikAy_bAuA7i64Kel27HWPUyiCuHQ,8486
+sjbillingclient/jclass/consume.py,sha256=a924B3OOfg5jAlOWvFG1lfYvRsZd-XX2G2STBlsJRGM,309
+sjbillingclient/jclass/purchase.py,sha256=BmkUhWHhoyHf70j0xHDjaIEZ4Mjg3iZcxlEjfVYr5ps,2439
+sjbillingclient/jclass/queryproduct.py,sha256=wbrURx5kiWPzhd2DIDb9QUJUZE9RzX57VZTOI487ksY,2157
+sjbillingclient/jclass/querypurchases.py,sha256=njhAhGmjJKPOTsaCPMEWc2ZD_wBubjDzsI0fjZDuKO8,730
+sjbillingclient/jinterface/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sjbillingclient/jinterface/acknowledge.py,sha256=OG5GWYO1TXfC7nscn8pPjsrdm2BGOCASRCzscKfyPFM,522
+sjbillingclient/jinterface/billing.py,sha256=lwBGN8Xe0Qbc1DCRSShrhL8oGqRbjugwrgNspEK-nmc,1265
+sjbillingclient/jinterface/consume.py,sha256=DiugwpRreoVLpPjeHSkNMgncg5f3HnIBCUh0OIyrWhI,524
+sjbillingclient/jinterface/product.py,sha256=kr_oPhRnQd0xbZItFLtACjBhZsnUV8q-kooqG_biVPs,627
+sjbillingclient/jinterface/purchases.py,sha256=LNi4tJIU7TSpiIhmWZDITdyrBe8pNlPnXSQUQntQSWw,1036
+sjbillingclient/tools/__init__.py,sha256=UKL-d-a_DQk9sS_EidCVXHrZhUBT23PqZjguInhK6LA,24508
+sjbillingclient-1.0.0.dist-info/METADATA,sha256=Aj8ib_L_NpAFlhPEALXzdEr2mnUiDpTcCXOfdcPVHDg,23143
+sjbillingclient-1.0.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+sjbillingclient-1.0.0.dist-info/RECORD,,

sjbillingclient-0.2.2.dist-info/RECORD

@@ -1,17 +0,0 @@
-sjbillingclient/__init__.py,sha256=i__3SUZ1MIcciCmCJM43fMtwFaglkoBT0acnbanUulo,125
-sjbillingclient/jclass/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sjbillingclient/jclass/acknowledge.py,sha256=FeaiOsIR2_WxJQC56gaeCtOPTEWb7Dz7AuWE6VYVMJI,358
-sjbillingclient/jclass/billing.py,sha256=Hkk_yvnPQel0Fw_SFVdhP3unmhRkWNDVUa4RM1qhzdY,5499
-sjbillingclient/jclass/consume.py,sha256=Hh8sLGosVvs22NhdQRudFc_NP_ahvrJSJdJTM-_nLBQ,310
-sjbillingclient/jclass/purchase.py,sha256=trFRSDHdMUPZsAxdyU7HuChT0qicDO-EjfPp9d6unrA,844
-sjbillingclient/jclass/queryproduct.py,sha256=Akuxy3fO1djerVPidqmjUclKVtIDmlaNJxZDbyUWOUw,1115
-sjbillingclient/jinterface/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sjbillingclient/jinterface/acknowledge.py,sha256=OG5GWYO1TXfC7nscn8pPjsrdm2BGOCASRCzscKfyPFM,522
-sjbillingclient/jinterface/billing.py,sha256=lwBGN8Xe0Qbc1DCRSShrhL8oGqRbjugwrgNspEK-nmc,1265
-sjbillingclient/jinterface/consume.py,sha256=DiugwpRreoVLpPjeHSkNMgncg5f3HnIBCUh0OIyrWhI,524
-sjbillingclient/jinterface/product.py,sha256=kr_oPhRnQd0xbZItFLtACjBhZsnUV8q-kooqG_biVPs,627
-sjbillingclient/jinterface/purchases.py,sha256=BG6xF3H-35_XhiRr2kWDb1jzsxJ-hIw-jaEi-uSkTmY,574
-sjbillingclient/tools/__init__.py,sha256=PqsUr6tIBdAUN4NNKvWR3aRdNQ-ZN84MAzkBKcm6sik,21127
-sjbillingclient-0.2.2.dist-info/METADATA,sha256=54l9LJqO52QEOq58878VLNLOJIgFfkEw_dTpa7wqmuo,19028
-sjbillingclient-0.2.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-sjbillingclient-0.2.2.dist-info/RECORD,,