@umituz/react-native-subscription 2.36.3 → 2.37.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.36.3",
+  "version": "2.37.0",
   "description": "Complete subscription management with RevenueCat, paywall UI, and credits system for React Native apps",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/domains/credits/application/RefundCreditsCommand.ts

@@ -0,0 +1,76 @@
+import { runTransaction, serverTimestamp, type Transaction, type DocumentReference, type Firestore } from "@umituz/react-native-firebase";
+import type { DeductCreditsResult } from "../core/Credits";
+import { CREDIT_ERROR_CODES } from "../core/CreditsConstants";
+import { subscriptionEventBus, SUBSCRIPTION_EVENTS } from "../../../shared/infrastructure/SubscriptionEventBus";
+
+/**
+ * Refunds credits to a user's balance.
+ * Used for optimistic billing rollbacks when generation fails due to transient errors.
+ */
+export async function refundCreditsOperation(
+  _db: Firestore,
+  creditsRef: DocumentReference,
+  amount: number,
+  userId: string
+): Promise<DeductCreditsResult> {
+  if (!userId || userId.trim().length === 0) {
+    return {
+      success: false,
+      remainingCredits: null,
+      error: {
+        message: 'Valid userId is required for credit refund',
+        code: 'INVALID_USER'
+      }
+    };
+  }
+
+  if (amount <= 0) {
+    return {
+      success: false,
+      remainingCredits: null,
+      error: {
+        message: 'Refund amount must be positive',
+        code: 'INVALID_AMOUNT'
+      }
+    };
+  }
+
+  try {
+    const remaining = await runTransaction(async (tx: Transaction) => {
+      const docSnap = await tx.get(creditsRef);
+
+      if (!docSnap.exists()) {
+        throw new Error(CREDIT_ERROR_CODES.NO_CREDITS);
+      }
+
+      const current = docSnap.data().credits as number;
+      const updated = current + amount;
+
+      tx.update(creditsRef, {
+        credits: updated,
+        lastUpdatedAt: serverTimestamp()
+      });
+
+      return updated;
+    });
+
+    subscriptionEventBus.emit(SUBSCRIPTION_EVENTS.CREDITS_UPDATED, userId);
+
+    return {
+      success: true,
+      remainingCredits: remaining,
+      error: null
+    };
+  } catch (e: unknown) {
+    const message = e instanceof Error ? e.message : String(e);
+    const code = message === CREDIT_ERROR_CODES.NO_CREDITS
+      ? message
+      : 'REFUND_ERROR';
+
+    return {
+      success: false,
+      remainingCredits: null,
+      error: { message, code }
+    };
+  }
+}

package/src/domains/credits/infrastructure/CreditsRepository.ts

@@ -4,6 +4,7 @@ import type { CreditsConfig, CreditsResult, DeductCreditsResult } from "../core/
 import type { PurchaseSource } from "../core/UserCreditsDocument";
 import type { RevenueCatData } from "../../revenuecat/core/types";
 import { deductCreditsOperation } from "../application/DeductCreditsCommand";
+import { refundCreditsOperation } from "../application/RefundCreditsCommand";
 import { PURCHASE_TYPE, type PurchaseType } from "../../subscription/core/SubscriptionConstants";
 import { requireFirestore, buildDocRef, type CollectionConfig } from "../../../shared/infrastructure/firestore";
 import { fetchCredits, checkHasCredits } from "./operations/CreditsFetcher";
@@ -59,6 +60,11 @@ export class CreditsRepository extends BaseRepository {
     return deductCreditsOperation(db, this.getRef(db, userId), cost, userId);
   }
 
+  async refundCredit(userId: string, amount: number): Promise<DeductCreditsResult> {
+    const db = requireFirestore();
+    return refundCreditsOperation(db, this.getRef(db, userId), amount, userId);
+  }
+
   async hasCredits(userId: string, cost: number): Promise<boolean> {
     const db = requireFirestore();
     return checkHasCredits(this.getRef(db, userId), cost);

package/src/domains/credits/presentation/deduct-credit/types.ts

@@ -7,5 +7,6 @@ export interface UseDeductCreditResult {
   checkCredits: (cost?: number) => Promise<boolean>;
   deductCredit: (cost?: number) => Promise<boolean>;
   deductCredits: (cost: number) => Promise<boolean>;
+  refundCredits: (amount: number) => Promise<boolean>;
   isDeducting: boolean;
 }

package/src/domains/credits/presentation/deduct-credit/useDeductCredit.ts

@@ -45,10 +45,31 @@ export const useDeductCredit = ({
     return repository.hasCredits(userId, cost);
   }, [userId, repository]);
 
+  const refundCredits = useCallback(async (amount: number): Promise<boolean> => {
+    if (!userId) return false;
+    try {
+      const result = await repository.refundCredit(userId, amount);
+      if (result.success) {
+        // Invalidate queries to refresh credit balance
+        await queryClient.invalidateQueries({ queryKey: ['credits', userId] });
+        return true;
+      }
+      return false;
+    } catch (error) {
+      console.error('[useDeductCredit] Unexpected error during credit refund', {
+        amount,
+        userId,
+        error
+      });
+      return false;
+    }
+  }, [userId, repository, queryClient]);
+
   return {
     checkCredits,
     deductCredit,
     deductCredits,
+    refundCredits,
     isDeducting: mutation.isPending
   };
 };