@umituz/react-native-subscription 2.43.4 → 2.43.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.43.4",
+  "version": "2.43.6",
   "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/DeductCreditsCommand.ts

@@ -1,7 +1,6 @@
 import { runTransaction, serverTimestamp, type Transaction, type DocumentReference, type Firestore } from "@umituz/react-native-firebase";
 import type { DeductCreditsResult } from "../core/Credits";
 import { CREDIT_ERROR_CODES, MAX_SINGLE_DEDUCTION } from "../core/CreditsConstants";
-import { subscriptionEventBus, SUBSCRIPTION_EVENTS } from "../../../shared/infrastructure/SubscriptionEventBus";
 
 export async function deductCreditsOperation(
   _db: Firestore,
@@ -65,8 +64,6 @@ export async function deductCreditsOperation(
 
     if (__DEV__) console.log('[DeductCreditsCommand] transaction SUCCESS, remaining:', remaining);
 
-    subscriptionEventBus.emit(SUBSCRIPTION_EVENTS.CREDITS_UPDATED, userId);
-
     return {
       success: true,
       remainingCredits: remaining,

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

@@ -1,7 +1,6 @@
 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";
 
 export async function refundCreditsOperation(
   _db: Firestore,
@@ -53,8 +52,6 @@ export async function refundCreditsOperation(
       return updated;
     });
 
-    subscriptionEventBus.emit(SUBSCRIPTION_EVENTS.CREDITS_UPDATED, userId);
-
     return {
       success: true,
       remainingCredits: remaining,

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

@@ -72,11 +72,7 @@ export function createDeductCreditMutationConfig(
         );
       }
     },
-    onSuccess: (_data: unknown, _cost: number, context: MutationContext | undefined) => {
-      const targetUserId = context?.capturedUserId ?? userId;
-      if (targetUserId) {
-        queryClient.invalidateQueries({ queryKey: creditsQueryKeys.user(targetUserId) });
-      }
-    },
+    // onSuccess removed - real-time sync (onSnapshot) handles automatic updates
+    // Optimistic update already applied, real-time listener will confirm actual value
   };
 }

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

@@ -4,7 +4,6 @@ import { getCreditsRepository } from "../../infrastructure/CreditsRepositoryMana
 import type { UseDeductCreditParams, UseDeductCreditResult } from "./types";
 import type { DeductCreditsResult } from "../../core/Credits";
 import { createDeductCreditMutationConfig, type MutationContext } from "./mutationConfig";
-import { creditsQueryKeys } from "../creditsQueryKeys";
 
 export const useDeductCredit = ({
   userId,
@@ -57,8 +56,7 @@ export const useDeductCredit = ({
     try {
       const result = await repository.refundCredit(userId, amount);
       if (result.success) {
-        // Invalidate queries to refresh credit balance
-        await queryClient.invalidateQueries({ queryKey: creditsQueryKeys.user(userId) });
+        // Real-time sync (onSnapshot) handles automatic update
         return true;
       }
       return false;
@@ -72,7 +70,7 @@ export const useDeductCredit = ({
       }
       return false;
     }
-  }, [userId, repository, queryClient]);
+  }, [userId, repository]);
 
   return {
     checkCredits,

package/src/domains/credits/presentation/useCredits.ts

@@ -1,27 +1,22 @@
-import { useQuery, useQueryClient } from "@umituz/react-native-design-system/tanstack";
-import { useCallback, useMemo, useEffect } from "react";
+import { useCallback, useMemo } from "react";
 import { useAuthStore, selectUserId } from "@umituz/react-native-auth";
-import { subscriptionEventBus, SUBSCRIPTION_EVENTS } from "../../../shared/infrastructure/SubscriptionEventBus";
-import { SHORT_CACHE_CONFIG } from "../../../shared/infrastructure/react-query/queryConfig";
-import { usePreviousUserCleanup } from "../../../shared/infrastructure/react-query/hooks/usePreviousUserCleanup";
 import {
-  getCreditsRepository,
   getCreditsConfig,
   isCreditsRepositoryConfigured,
 } from "../infrastructure/CreditsRepositoryManager";
 import { calculateSafePercentage, canAffordAmount } from "../utils/creditValidation";
 import { isAuthenticated } from "../../subscription/utils/authGuards";
-import { creditsQueryKeys } from "./creditsQueryKeys";
 import type { UseCreditsResult, CreditsLoadStatus } from "./useCredits.types";
-import type { UserCredits } from "../core/Credits";
+import { useCreditsRealTime } from "./useCreditsRealTime";
 
 const deriveLoadStatus = (
-  queryStatus: "pending" | "error" | "success",
+  isLoading: boolean,
+  error: Error | null,
   queryEnabled: boolean
 ): CreditsLoadStatus => {
   if (!queryEnabled) return "idle";
-  if (queryStatus === "pending") return "loading";
-  if (queryStatus === "error") return "error";
+  if (isLoading) return "loading";
+  if (error) return "error";
   return "ready";
 };
 
@@ -33,41 +28,7 @@ export const useCredits = (): UseCreditsResult => {
   const hasUser = isAuthenticated(userId);
   const queryEnabled = hasUser && isConfigured;
 
-  const { data, status, error, refetch } = useQuery<UserCredits | null, Error>({
-    queryKey: creditsQueryKeys.user(userId),
-    queryFn: async () => {
-      if (!hasUser || !isConfigured) return null;
-
-      const repository = getCreditsRepository();
-      const result = await repository.getCredits(userId);
-
-      if (!result.success) {
-        throw new Error(result.error?.message || "Failed to fetch credits");
-      }
-
-      return result.data ?? null;
-    },
-    enabled: queryEnabled,
-    ...SHORT_CACHE_CONFIG,
-  });
-
-  const queryClient = useQueryClient();
-
-  usePreviousUserCleanup(userId, queryClient, creditsQueryKeys.user);
-
-  useEffect(() => {
-    if (!hasUser) return undefined;
-
-    const unsubscribe = subscriptionEventBus.on(SUBSCRIPTION_EVENTS.CREDITS_UPDATED, (updatedUserId) => {
-      if (updatedUserId === userId) {
-        queryClient.invalidateQueries({ queryKey: creditsQueryKeys.user(userId) });
-      }
-    });
-
-    return unsubscribe;
-  }, [userId, hasUser, queryClient]);
-
-  const credits = data ?? null;
+  const { credits, isLoading, error } = useCreditsRealTime(userId);
 
   const derivedValues = useMemo(() => {
     const has = (credits?.credits ?? 0) > 0;
@@ -81,19 +42,18 @@ export const useCredits = (): UseCreditsResult => {
     [credits]
   );
 
-  const loadStatus = deriveLoadStatus(status, queryEnabled);
+  const loadStatus = deriveLoadStatus(isLoading, error, queryEnabled);
   const isCreditsLoaded = loadStatus === "ready";
-  const isLoading = loadStatus === "loading";
 
   return {
     credits,
     isLoading,
     isCreditsLoaded,
     loadStatus,
-    error: error instanceof Error ? error : null,
+    error,
     hasCredits: derivedValues.hasCredits,
     creditsPercent: derivedValues.creditsPercent,
-    refetch,
+    refetch: async () => {},
     canAfford,
   };
 };

package/src/domains/credits/presentation/useCreditsRealTime.ts

@@ -0,0 +1,115 @@
+import { useEffect, useState, useCallback } from "react";
+import { onSnapshot } from "firebase/firestore";
+import type { UserCredits } from "../core/Credits";
+import { getCreditsConfig } from "../infrastructure/CreditsRepositoryManager";
+import { mapCreditsDocumentToEntity } from "../core/CreditsMapper";
+import { requireFirestore, buildDocRef, type CollectionConfig } from "../../../shared/infrastructure/firestore/collectionUtils";
+import type { UserCreditsDocumentRead } from "../core/UserCreditsDocument";
+
+/**
+ * Real-time sync for credits using Firestore onSnapshot.
+ * Provides instant updates without cache invalidation complexity.
+ *
+ * Benefits:
+ * - Zero cache invalidation needed
+ * - Instant updates from Firestore
+ * - Always consistent with server state
+ * - Simpler code (no event listeners needed)
+ *
+ * @param userId - User ID to sync credits for
+ * @returns Credits state and loading status
+ */
+export function useCreditsRealTime(userId: string | null | undefined) {
+  const [credits, setCredits] = useState<UserCredits | null>(null);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  useEffect(() => {
+    // Reset state when userId changes
+    if (!userId) {
+      setCredits(null);
+      setIsLoading(false);
+      setError(null);
+      return;
+    }
+
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const db = requireFirestore();
+      const config = getCreditsConfig();
+
+      // Build doc ref using same logic as repository
+      const collectionConfig: CollectionConfig = {
+        collectionName: config.collectionName,
+        useUserSubcollection: config.useUserSubcollection,
+      };
+      const docRef = buildDocRef(db, userId, "balance", collectionConfig);
+
+      // Real-time listener
+      const unsubscribe = onSnapshot(
+        docRef,
+        (snapshot) => {
+          if (snapshot.exists()) {
+            const entity = mapCreditsDocumentToEntity(snapshot.data() as UserCreditsDocumentRead);
+            setCredits(entity);
+          } else {
+            setCredits(null);
+          }
+          setIsLoading(false);
+        },
+        (err) => {
+          console.error("[useCreditsRealTime] Snapshot error:", err);
+          setError(err as Error);
+          setIsLoading(false);
+        }
+      );
+
+      return () => {
+        unsubscribe();
+      };
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      console.error("[useCreditsRealTime] Setup error:", err);
+      setError(error);
+      setIsLoading(false);
+    }
+  }, [userId]);
+
+  const refetch = useCallback(() => {
+    // Real-time sync doesn't need refetch, but keep for API compatibility
+    // The snapshot listener will automatically update when data changes
+    if (__DEV__) {
+      console.warn("[useCreditsRealTime] Refetch called - not needed for real-time sync");
+    }
+  }, []);
+
+  return {
+    credits,
+    isLoading,
+    error,
+    refetch, // No-op but kept for compatibility
+  };
+}
+
+/**
+ * Hook to get derived credit values with real-time sync.
+ * This is the real-time equivalent of the computed values in useCredits.
+ */
+export function useCreditsRealTimeDerived(userId: string | null | undefined) {
+  const { credits, isLoading } = useCreditsRealTime(userId);
+
+  const hasCredits = (credits?.credits ?? 0) > 0;
+  const creditsPercent = credits ? Math.min(
+    (credits.credits / credits.creditLimit) * 100,
+    100
+  ) : 0;
+
+  return {
+    hasCredits,
+    creditsPercent,
+    isLoading,
+    credits,
+  };
+}

package/src/domains/subscription/application/SubscriptionSyncProcessor.ts

@@ -234,7 +234,6 @@ export class SubscriptionSyncProcessor {
         throw new Error(`[SubscriptionSyncProcessor] Credit initialization failed for purchase: ${result.error?.message ?? 'unknown'}`);
       }
 
-      this.emitCreditsUpdated(creditsUserId);
       if (typeof __DEV__ !== "undefined" && __DEV__) {
         console.log('[SubscriptionSyncProcessor] 🟢 processPurchase: Credits initialized successfully', {
           creditsUserId,
@@ -271,7 +270,6 @@ export class SubscriptionSyncProcessor {
         throw new Error(`[SubscriptionSyncProcessor] Credit initialization failed for renewal: ${result.error?.message ?? 'unknown'}`);
       }
 
-      this.emitCreditsUpdated(creditsUserId);
     } finally {
       this.purchaseInProgress = false;
     }
@@ -315,7 +313,6 @@ export class SubscriptionSyncProcessor {
 
   private async expireSubscription(userId: string): Promise<void> {
     await getCreditsRepository().syncExpiredStatus(userId);
-    this.emitCreditsUpdated(userId);
   }
 
   private async syncPremiumStatus(userId: string, event: PremiumStatusChangedEvent): Promise<void> {
@@ -357,7 +354,6 @@ export class SubscriptionSyncProcessor {
       store: event.store ?? null,
       ownershipType: event.ownershipType ?? null,
     });
-    this.emitCreditsUpdated(userId);
 
     if (__DEV__) {
       console.log('[SubscriptionSyncProcessor] 🟢 syncPremiumStatus: Completed', {
@@ -367,8 +363,4 @@ export class SubscriptionSyncProcessor {
       });
     }
   }
-
-  private emitCreditsUpdated(userId: string): void {
-    subscriptionEventBus.emit(SUBSCRIPTION_EVENTS.CREDITS_UPDATED, userId);
-  }
 }

package/src/domains/subscription/infrastructure/hooks/usePurchasePackage.ts

@@ -6,8 +6,6 @@ import {
   selectUserId,
 } from "@umituz/react-native-auth";
 import { SubscriptionManager } from "../../infrastructure/managers/SubscriptionManager";
-import { subscriptionStatusQueryKeys } from "../../presentation/useSubscriptionStatus";
-import { creditsQueryKeys } from "../../../credits/presentation/creditsQueryKeys";
 import { SUBSCRIPTION_QUERY_KEYS } from "./subscriptionQueryKeys";
 import { getErrorMessage } from "../../../revenuecat/core/errors/RevenueCatErrorHandler";
 
@@ -40,12 +38,13 @@ export const usePurchasePackage = () => {
       if (result.success) {
         showSuccess("Purchase Successful", "Your subscription is now active!");
 
-        // Invalidate caches after successful purchase
+        // Invalidate packages cache (no event listener for packages)
         queryClient.invalidateQueries({ queryKey: SUBSCRIPTION_QUERY_KEYS.packages });
-        if (userId) {
-          queryClient.invalidateQueries({ queryKey: subscriptionStatusQueryKeys.user(userId) });
-          queryClient.invalidateQueries({ queryKey: creditsQueryKeys.user(userId) });
-        }
+
+        // Credits and subscription status updated via real-time sync:
+        // - Credits: Firestore onSnapshot (useCreditsRealTime)
+        // - Subscription status: PREMIUM_STATUS_CHANGED event (RevenueCat)
+        // No manual invalidation needed here
       } else {
         showError("Purchase Failed", "Unable to complete purchase. Please try again.");
       }

package/src/domains/subscription/infrastructure/hooks/useRestorePurchase.ts

@@ -5,8 +5,6 @@ import {
   selectUserId,
 } from "@umituz/react-native-auth";
 import { SubscriptionManager } from "../../infrastructure/managers/SubscriptionManager";
-import { subscriptionStatusQueryKeys } from "../../presentation/useSubscriptionStatus";
-import { creditsQueryKeys } from "../../../credits/presentation/creditsQueryKeys";
 import { SUBSCRIPTION_QUERY_KEYS } from "./subscriptionQueryKeys";
 import { getErrorMessage } from "../../../revenuecat/core/errors/RevenueCatErrorHandler";
 
@@ -31,12 +29,13 @@ export const useRestorePurchase = () => {
     },
     onSuccess: (result) => {
       if (result.success) {
-        // Invalidate caches after successful restore
+        // Invalidate packages cache (no event listener for packages)
         queryClient.invalidateQueries({ queryKey: SUBSCRIPTION_QUERY_KEYS.packages });
-        if (userId) {
-          queryClient.invalidateQueries({ queryKey: subscriptionStatusQueryKeys.user(userId) });
-          queryClient.invalidateQueries({ queryKey: creditsQueryKeys.user(userId) });
-        }
+
+        // Credits and subscription status updated via real-time sync:
+        // - Credits: Firestore onSnapshot (useCreditsRealTime)
+        // - Subscription status: PREMIUM_STATUS_CHANGED event (RevenueCat)
+        // No manual invalidation needed here
 
         if (result.productId) {
           showSuccess("Restore Successful", "Your subscription has been restored!");

package/src/domains/subscription/infrastructure/hooks/useSubscriptionPackages.ts

@@ -42,6 +42,7 @@ export const useSubscriptionPackages = () => {
     prevUserIdRef.current = userId;
 
     if (prevUserId !== userId) {
+      // Clean up previous user's cache to prevent data leakage
       if (prevUserId) {
         queryClient.cancelQueries({
           queryKey: [...SUBSCRIPTION_QUERY_KEYS.packages, prevUserId],
@@ -58,9 +59,8 @@ export const useSubscriptionPackages = () => {
         });
       }
 
-      queryClient.invalidateQueries({
-        queryKey: [...SUBSCRIPTION_QUERY_KEYS.packages, userId ?? "anonymous"],
-      });
+      // No need to invalidate - removeQueries already cleared cache
+      // Query will refetch automatically on mount if needed
     }
   }, [userId, queryClient]);
 

package/src/domains/subscription/presentation/screens/SubscriptionDetailScreen.tsx

@@ -7,7 +7,6 @@ import { useAppDesignTokens } from "@umituz/react-native-design-system/theme";
 import { useAuthStore, selectUserId } from "@umituz/react-native-auth";
 import { ScreenLayout } from "../../../../shared/presentation/layouts/ScreenLayout";
 import { getCreditsRepository } from "../../../credits/infrastructure/CreditsRepositoryManager";
-import { subscriptionEventBus, SUBSCRIPTION_EVENTS } from "../../../../shared/infrastructure/SubscriptionEventBus";
 import { SubscriptionHeader } from "./components/SubscriptionHeader";
 import { CreditsList } from "./components/CreditsList";
 import { UpgradePrompt } from "./components/UpgradePrompt";
@@ -116,7 +115,6 @@ const DevTestPanel: React.FC<{ statusType: string }> = ({ statusType }) => {
     const userId = selectUserId(useAuthStore.getState());
     if (!userId) throw new Error("No userId found");
     await getCreditsRepository().syncExpiredStatus(userId);
-    subscriptionEventBus.emit(SUBSCRIPTION_EVENTS.CREDITS_UPDATED, userId);
   }), [run]);
 
   const handleRestore = useCallback(() => run("Restore", async () => {