refactor!: streamline useIAP purchase handling (#3012)

## Summary
- remove `currentPurchase` / `currentPurchaseError` from `useIAP` in
favor of `onPurchaseSuccess` and `onPurchaseError`
- refresh tests, mocks, and docs to align with the leaner hook API

## Testing
- yarn test src/__tests__/hooks/useIAP.test.ts --watchAll=false


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

- New Features
- Added optional onPurchaseSuccess callback in useIAP to receive
purchase details on successful transactions.

- Breaking Changes
- Removed currentPurchase and currentPurchaseError from useIAP, along
with their clear functions. Migrate to the onPurchaseSuccess callback
for purchase handling.
  - Test/mocking surface adjusted accordingly.

- Documentation
- Updated commit message guidelines to follow the Angular Conventional
Commits format.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: hyochan

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Breaking
+
+- JS: `useIAP` no longer returns `currentPurchase`, `currentPurchaseError`, or the associated clear helpers; consumers should rely on the `onPurchaseSuccess` / `onPurchaseError` callbacks moving forward.
+
 ## [14.3.5]
 
 ### Changed

CLAUDE.md

@@ -168,9 +168,17 @@ Access these from the Run and Debug panel (⌘⇧D) in VSCode.
 
 ### Commit Message Convention
 
-- **With tag**: Use lowercase after tag (e.g., `feat: add new feature`, `fix: resolve bug`)
-- **Without tag**: Start with uppercase (e.g., `Add new feature`, `Fix critical bug`)
-- Common tags: `feat:`, `fix:`, `docs:`, `style:`, `refactor:`, `test:`, `chore:`
+This repository follows the **Angular Conventional Commits** format:
+
+```
+<type>(<scope>): <subject>
+```
+
+- `type` is one of: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`.
+- `scope` is optional but encouraged (e.g., `hooks`, `android`).
+- `subject` is imperative, lowercase, ≤ ~50 chars, and has no trailing period.
+- Wrap commit bodies at ~72 columns; include `BREAKING CHANGE:` / `Closes #123` footers when needed.
+- Examples: `feat(auth): add refresh token support`, `chore(ci): bump workflows`.
 
 ### Code Style
 

example/jest.setup.js

@@ -74,8 +74,6 @@ jest.mock('../src/index', () => ({
     products: [],
     subscriptions: [],
     availablePurchases: [],
-    currentPurchase: undefined,
-    currentPurchaseError: undefined,
     initConnectionAndListen: jest.fn(() => Promise.resolve(true)),
     getProducts: jest.fn(() => Promise.resolve([])),
     getSubscriptions: jest.fn(() => Promise.resolve([])),

src/__tests__/hooks/useIAP.test.ts

@@ -64,8 +64,9 @@ describe('hooks/useIAP (renderer)', () => {
 
   it('connects on mount and updates state on purchase events', async () => {
     let api: any;
+    const onPurchaseSuccess = jest.fn();
     const Harness = () => {
-      api = useIAP();
+      api = useIAP({onPurchaseSuccess});
       return null;
     };
 
@@ -92,7 +93,7 @@ describe('hooks/useIAP (renderer)', () => {
       capturedPurchaseListener?.(purchase);
     });
     await act(async () => {});
-    expect(api.currentPurchase?.productId).toBe('p1');
+    expect(onPurchaseSuccess).toHaveBeenCalledWith(purchase);
 
     // Ensure finishTransaction wrapper works
     await act(async () => {

src/hooks/useIAP.ts

@@ -50,12 +50,8 @@ type UseIap = {
   promotedProductIdIOS?: string;
   subscriptions: ProductSubscription[];
   availablePurchases: Purchase[];
-  currentPurchase?: Purchase;
-  currentPurchaseError?: PurchaseError;
   promotedProductIOS?: Product;
   activeSubscriptions: ActiveSubscription[];
-  clearCurrentPurchase: () => void;
-  clearCurrentPurchaseError: () => void;
   finishTransaction: ({
     purchase,
     isConsumable,
@@ -114,10 +110,7 @@ export function useIAP(options?: UseIapOptions): UseIap {
   const [promotedProductsIOS] = useState<Purchase[]>([]);
   const [subscriptions, setSubscriptions] = useState<ProductSubscription[]>([]);
   const [availablePurchases, setAvailablePurchases] = useState<Purchase[]>([]);
-  const [currentPurchase, setCurrentPurchase] = useState<Purchase>();
   const [promotedProductIOS, setPromotedProductIOS] = useState<Product>();
-  const [currentPurchaseError, setCurrentPurchaseError] =
-    useState<PurchaseError>();
   const [promotedProductIdIOS] = useState<string>();
   const [activeSubscriptions, setActiveSubscriptions] = useState<
     ActiveSubscription[]
@@ -168,14 +161,6 @@ export function useIAP(options?: UseIapOptions): UseIap {
     subscriptionsRefState.current = subscriptions;
   }, [subscriptions]);
 
-  const clearCurrentPurchase = useCallback(() => {
-    setCurrentPurchase(undefined);
-  }, []);
-
-  const clearCurrentPurchaseError = useCallback(() => {
-    setCurrentPurchaseError(undefined);
-  }, []);
-
   const getProductsInternal = useCallback(
     async (skus: string[]): Promise<void> => {
       try {
@@ -313,35 +298,14 @@ export function useIAP(options?: UseIapOptions): UseIap {
         });
       } catch (err) {
         throw err;
-      } finally {
-        if (purchase.id === currentPurchase?.id) {
-          clearCurrentPurchase();
-        }
-        if (purchase.id === currentPurchaseError?.productId) {
-          clearCurrentPurchaseError();
-        }
       }
     },
-    [
-      currentPurchase?.id,
-      currentPurchaseError?.productId,
-      clearCurrentPurchase,
-      clearCurrentPurchaseError,
-    ],
+    [],
   );
 
-  const requestPurchaseWithReset = useCallback(
-    async (requestObj: RequestPurchaseProps) => {
-      clearCurrentPurchase();
-      clearCurrentPurchaseError();
-
-      try {
-        return await requestPurchaseInternal(requestObj);
-      } catch (error) {
-        throw error;
-      }
-    },
-    [clearCurrentPurchase, clearCurrentPurchaseError],
+  const requestPurchase = useCallback(
+    (requestObj: RequestPurchaseProps) => requestPurchaseInternal(requestObj),
+    [],
   );
 
   // No local restorePurchases; use the top-level helper via returned API
@@ -365,8 +329,6 @@ export function useIAP(options?: UseIapOptions): UseIap {
     // Register listeners BEFORE initConnection to avoid race condition
     subscriptionsRef.current.purchaseUpdate = purchaseUpdatedListener(
       async (purchase: Purchase) => {
-        setCurrentPurchaseError(undefined);
-        setCurrentPurchase(purchase);
         // Always refresh subscription state after a purchase event
         try {
           await getActiveSubscriptionsInternal();
@@ -393,8 +355,6 @@ export function useIAP(options?: UseIapOptions): UseIap {
       ) {
         return;
       }
-      setCurrentPurchase(undefined);
-      setCurrentPurchaseError(mappedError);
       if (optionsRef.current?.onPurchaseError) {
         optionsRef.current.onPurchaseError(mappedError);
       }
@@ -445,15 +405,11 @@ export function useIAP(options?: UseIapOptions): UseIap {
     subscriptions,
     finishTransaction,
     availablePurchases,
-    currentPurchase,
-    currentPurchaseError,
     promotedProductIOS,
     activeSubscriptions,
-    clearCurrentPurchase,
-    clearCurrentPurchaseError,
     getAvailablePurchases: getAvailablePurchasesInternal,
     fetchProducts: fetchProductsInternal,
-    requestPurchase: requestPurchaseWithReset,
+    requestPurchase,
     validateReceipt,
     restorePurchases: async () => {
       try {