@umituz/react-native-subscription 2.6.1 → 2.8.0

package/package.json

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

@@ -317,3 +317,11 @@ export {
 
 export { useRevenueCat } from "./revenuecat/presentation/hooks/useRevenueCat";
 export type { UseRevenueCatResult } from "./revenuecat/presentation/hooks/useRevenueCat";
+
+export {
+  useInitializeSubscription,
+  useSubscriptionPackages,
+  usePurchasePackage,
+  useRestorePurchase,
+  SUBSCRIPTION_QUERY_KEYS,
+} from "./revenuecat/presentation/hooks/useSubscriptionQueries";

package/src/revenuecat/infrastructure/services/CustomerInfoListenerManager.ts

@@ -9,6 +9,7 @@ import Purchases, {
 } from "react-native-purchases";
 import type { RevenueCatConfig } from "../../domain/value-objects/RevenueCatConfig";
 import { syncPremiumStatus } from "../utils/PremiumStatusSyncer";
+import { addPackageBreadcrumb } from "@umituz/react-native-sentry";
 
 export class CustomerInfoListenerManager {
   private listener: CustomerInfoUpdateListener | null = null;
@@ -30,12 +31,22 @@ export class CustomerInfoListenerManager {
   setupListener(config: RevenueCatConfig): void {
     this.removeListener();
 
+    addPackageBreadcrumb("subscription", "Setting up customer info listener", {
+      userId: this.currentUserId,
+    });
+
     this.listener = (customerInfo: CustomerInfo) => {
       if (!this.currentUserId) return;
 
       const hasPremium =
         !!customerInfo.entitlements.active[this.entitlementIdentifier];
 
+      addPackageBreadcrumb("subscription", "Customer info updated", {
+        userId: this.currentUserId,
+        hasPremium,
+        entitlementIdentifier: this.entitlementIdentifier,
+      });
+
       if (__DEV__) {
         console.log("[RevenueCat] CustomerInfo updated", {
           userId: this.currentUserId,
@@ -52,6 +63,7 @@ export class CustomerInfoListenerManager {
 
   removeListener(): void {
     if (this.listener) {
+      addPackageBreadcrumb("subscription", "Removing customer info listener", {});
       Purchases.removeCustomerInfoUpdateListener(this.listener);
       this.listener = null;
     }

package/src/revenuecat/infrastructure/services/OfferingsFetcher.ts

@@ -4,7 +4,11 @@
  */
 
 import Purchases, { type PurchasesOffering } from "react-native-purchases";
-
+import {
+  trackPackageError,
+  addPackageBreadcrumb,
+  trackPackageWarning,
+} from "@umituz/react-native-sentry";
 
 export interface OfferingsFetcherDeps {
   isInitialized: () => boolean;
@@ -14,6 +18,10 @@ export interface OfferingsFetcherDeps {
 export async function fetchOfferings(
   deps: OfferingsFetcherDeps
 ): Promise<PurchasesOffering | null> {
+  addPackageBreadcrumb("subscription", "Fetch offerings started", {
+    isInitialized: deps.isInitialized(),
+  });
+
   if (__DEV__) {
     console.log(
       "[RevenueCat] fetchOfferings() called, isInitialized:",
@@ -22,26 +30,41 @@ export async function fetchOfferings(
   }
 
   if (!deps.isInitialized()) {
+    trackPackageWarning("subscription", "Fetch offerings called before initialization", {});
+
     if (__DEV__) {
       console.log("[RevenueCat] fetchOfferings() - NOT initialized");
     }
     return null;
   }
 
-
-
   try {
     const offerings = await Purchases.getOfferings();
 
+    const packagesCount = offerings.current?.availablePackages?.length ?? 0;
+
+    addPackageBreadcrumb("subscription", "Fetch offerings success", {
+      hasCurrent: !!offerings.current,
+      packagesCount,
+    });
+
     if (__DEV__) {
       console.log("[RevenueCat] fetchOfferings() result:", {
         hasCurrent: !!offerings.current,
-        packagesCount: offerings.current?.availablePackages?.length ?? 0,
+        packagesCount,
       });
     }
 
     return offerings.current;
   } catch (error) {
+    trackPackageError(
+      error instanceof Error ? error : new Error(String(error)),
+      {
+        packageName: "subscription",
+        operation: "fetch_offerings",
+      }
+    );
+
     if (__DEV__) {
       console.log("[RevenueCat] fetchOfferings() error:", error);
     }

package/src/revenuecat/infrastructure/services/RevenueCatInitializer.ts

@@ -7,8 +7,12 @@ import Purchases from "react-native-purchases";
 import type { InitializeResult } from "../../application/ports/IRevenueCatService";
 import type { RevenueCatConfig } from "../../domain/value-objects/RevenueCatConfig";
 import { getErrorMessage } from "../../domain/types/RevenueCatTypes";
-
 import { resolveApiKey } from "../utils/ApiKeyResolver";
+import {
+  trackPackageError,
+  addPackageBreadcrumb,
+  trackPackageWarning,
+} from "@umituz/react-native-sentry";
 
 export interface InitializerDeps {
   config: RevenueCatConfig;
@@ -24,6 +28,11 @@ export async function initializeSDK(
   userId: string,
   apiKey?: string
 ): Promise<InitializeResult> {
+  addPackageBreadcrumb("subscription", "SDK initialization started", {
+    userId,
+    hasApiKey: !!apiKey,
+  });
+
   if (__DEV__) {
     console.log("[RevenueCat] initializeSDK() called with userId:", userId);
   }
@@ -32,6 +41,10 @@ export async function initializeSDK(
   if (deps.isInitialized()) {
     const currentUserId = deps.getCurrentUserId();
     if (currentUserId === userId) {
+      addPackageBreadcrumb("subscription", "Already initialized, fetching current state", {
+        userId,
+      });
+
       if (__DEV__) {
         console.log("[RevenueCat] Already initialized with same userId, skipping configure");
       }
@@ -45,20 +58,38 @@ export async function initializeSDK(
         const hasPremium = !!customerInfo.entitlements.active[entitlementId];
         return { success: true, offering: offerings.current, hasPremium };
       } catch (error) {
+        trackPackageError(
+          error instanceof Error ? error : new Error(String(error)),
+          {
+            packageName: "subscription",
+            operation: "get_current_state",
+            userId,
+          }
+        );
+
         if (__DEV__) {
           console.log("[RevenueCat] Failed to get current state:", error);
         }
         return { success: false, offering: null, hasPremium: false };
       }
     } else {
+      addPackageBreadcrumb("subscription", "User changed, logging out previous user", {
+        previousUserId: currentUserId,
+        newUserId: userId,
+      });
+
       if (__DEV__) {
         console.log("[RevenueCat] Different userId, will re-configure");
       }
       // Different userId - need to logout first
       try {
         await Purchases.logOut();
-      } catch {
-        // Ignore logout errors
+      } catch (error) {
+        trackPackageWarning("subscription", "Logout failed during user change", {
+          error: error instanceof Error ? error.message : String(error),
+          previousUserId: currentUserId,
+          newUserId: userId,
+        });
       }
     }
   }
@@ -67,6 +98,13 @@ export async function initializeSDK(
 
   const key = apiKey || resolveApiKey(deps.config);
   if (!key) {
+    const error = new Error("No RevenueCat API key available");
+    trackPackageError(error, {
+      packageName: "subscription",
+      operation: "sdk_init_no_key",
+      userId,
+    });
+
     if (__DEV__) {
       console.log("[RevenueCat] No API key available");
     }
@@ -75,11 +113,17 @@ export async function initializeSDK(
 
   try {
     if (deps.isUsingTestStore()) {
+      addPackageBreadcrumb("subscription", "Using test store configuration", {
+        userId,
+      });
+
       if (__DEV__) {
         console.log("[RevenueCat] Using Test Store key");
       }
     }
 
+    addPackageBreadcrumb("subscription", "Configuring SDK", { userId });
+
     if (__DEV__) {
       console.log("[RevenueCat] Calling Purchases.configure()...");
     }
@@ -88,6 +132,10 @@ export async function initializeSDK(
     deps.setInitialized(true);
     deps.setCurrentUserId(userId);
 
+    addPackageBreadcrumb("subscription", "SDK configured successfully", {
+      userId,
+    });
+
     if (__DEV__) {
       console.log("[RevenueCat] SDK configured successfully");
     }
@@ -97,10 +145,19 @@ export async function initializeSDK(
       Purchases.getOfferings(),
     ]);
 
+    const packagesCount = offerings.current?.availablePackages?.length ?? 0;
+
+    addPackageBreadcrumb("subscription", "Offerings fetched", {
+      userId,
+      hasCurrent: !!offerings.current,
+      packagesCount,
+      allOfferingsCount: Object.keys(offerings.all).length,
+    });
+
     if (__DEV__) {
       console.log("[RevenueCat] Fetched offerings:", {
         hasCurrent: !!offerings.current,
-        packagesCount: offerings.current?.availablePackages?.length ?? 0,
+        packagesCount,
         allOfferingsCount: Object.keys(offerings.all).length,
       });
     }
@@ -111,6 +168,17 @@ export async function initializeSDK(
     return { success: true, offering: offerings.current, hasPremium };
   } catch (error) {
     const errorMessage = getErrorMessage(error, "RevenueCat init failed");
+
+    trackPackageError(
+      error instanceof Error ? error : new Error(errorMessage),
+      {
+        packageName: "subscription",
+        operation: "sdk_init",
+        userId,
+        errorMessage,
+      }
+    );
+
     if (__DEV__) {
       console.log("[RevenueCat] Init failed:", errorMessage);
     }

package/src/revenuecat/infrastructure/utils/PremiumStatusSyncer.ts

@@ -7,6 +7,10 @@ import type { CustomerInfo } from "react-native-purchases";
 import type { RevenueCatConfig } from "../../domain/value-objects/RevenueCatConfig";
 import { getPremiumEntitlement } from "../../domain/types/RevenueCatTypes";
 import { getExpirationDate } from "./ExpirationDateCalculator";
+import {
+  trackPackageError,
+  addPackageBreadcrumb,
+} from "@umituz/react-native-sentry";
 
 export async function syncPremiumStatus(
   config: RevenueCatConfig,
@@ -23,6 +27,14 @@ export async function syncPremiumStatus(
     entitlementIdentifier
   );
 
+  const isPremium = !!premiumEntitlement;
+
+  addPackageBreadcrumb("subscription", "Syncing premium status", {
+    userId,
+    isPremium,
+    productId: premiumEntitlement?.productIdentifier,
+  });
+
   try {
     if (premiumEntitlement) {
       const productId = premiumEntitlement.productIdentifier;
@@ -36,7 +48,22 @@ export async function syncPremiumStatus(
     } else {
       await config.onPremiumStatusChanged(userId, false);
     }
+
+    addPackageBreadcrumb("subscription", "Premium status synced successfully", {
+      userId,
+      isPremium,
+    });
   } catch (error) {
+    trackPackageError(
+      error instanceof Error ? error : new Error(String(error)),
+      {
+        packageName: "subscription",
+        operation: "sync_premium_status",
+        userId,
+        isPremium,
+      }
+    );
+
     if (__DEV__) {
       const message =
         error instanceof Error ? error.message : "Premium sync failed";
@@ -55,9 +82,29 @@ export async function notifyPurchaseCompleted(
     return;
   }
 
+  addPackageBreadcrumb("subscription", "Notifying purchase completed", {
+    userId,
+    productId,
+  });
+
   try {
     await config.onPurchaseCompleted(userId, productId, customerInfo);
+
+    addPackageBreadcrumb("subscription", "Purchase callback completed", {
+      userId,
+      productId,
+    });
   } catch (error) {
+    trackPackageError(
+      error instanceof Error ? error : new Error(String(error)),
+      {
+        packageName: "subscription",
+        operation: "purchase_callback",
+        userId,
+        productId,
+      }
+    );
+
     if (__DEV__) {
       const message =
         error instanceof Error ? error.message : "Purchase callback failed";
@@ -76,9 +123,29 @@ export async function notifyRestoreCompleted(
     return;
   }
 
+  addPackageBreadcrumb("subscription", "Notifying restore completed", {
+    userId,
+    isPremium,
+  });
+
   try {
     await config.onRestoreCompleted(userId, isPremium, customerInfo);
+
+    addPackageBreadcrumb("subscription", "Restore callback completed", {
+      userId,
+      isPremium,
+    });
   } catch (error) {
+    trackPackageError(
+      error instanceof Error ? error : new Error(String(error)),
+      {
+        packageName: "subscription",
+        operation: "restore_callback",
+        userId,
+        isPremium,
+      }
+    );
+
     if (__DEV__) {
       const message =
         error instanceof Error ? error.message : "Restore callback failed";

package/src/revenuecat/presentation/hooks/useSubscriptionQueries.ts

@@ -0,0 +1,199 @@
+/**
+ * Subscription TanStack Query Hooks
+ * Server state management for RevenueCat subscriptions
+ * Generic hooks for 100+ apps
+ */
+
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import type { PurchasesPackage } from "react-native-purchases";
+import { SubscriptionManager } from "../../infrastructure/managers/SubscriptionManager";
+import {
+  trackPackageError,
+  addPackageBreadcrumb,
+} from "@umituz/react-native-sentry";
+
+/**
+ * Query keys for TanStack Query
+ */
+export const SUBSCRIPTION_QUERY_KEYS = {
+  packages: ["subscription", "packages"] as const,
+  initialized: (userId: string) =>
+    ["subscription", "initialized", userId] as const,
+} as const;
+
+const STALE_TIME = 5 * 60 * 1000; // 5 minutes
+const GC_TIME = 30 * 60 * 1000; // 30 minutes
+
+/**
+ * Initialize subscription with RevenueCat
+ */
+export const useInitializeSubscription = (userId: string | undefined) => {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async () => {
+      if (!userId) {
+        throw new Error("User not authenticated");
+      }
+
+      addPackageBreadcrumb("subscription", "Initialize mutation started", {
+        userId,
+      });
+
+      return SubscriptionManager.initialize(userId);
+    },
+    onSuccess: () => {
+      if (userId) {
+        queryClient.invalidateQueries({
+          queryKey: SUBSCRIPTION_QUERY_KEYS.packages,
+        });
+
+        addPackageBreadcrumb(
+          "subscription",
+          "Initialize mutation success - packages invalidated",
+          { userId }
+        );
+      }
+    },
+    onError: (error) => {
+      trackPackageError(
+        error instanceof Error ? error : new Error(String(error)),
+        {
+          packageName: "subscription",
+          operation: "initialize_mutation",
+          userId: userId ?? "NO_USER",
+        }
+      );
+    },
+  });
+};
+
+/**
+ * Fetch available subscription packages
+ */
+export const useSubscriptionPackages = (userId: string | undefined) => {
+  return useQuery({
+    queryKey: [...SUBSCRIPTION_QUERY_KEYS.packages, userId] as const,
+    queryFn: async () => {
+      addPackageBreadcrumb("subscription", "Fetch packages query started", {
+        userId: userId ?? "NO_USER",
+      });
+
+      // Skip if already initialized for this specific user
+      if (!userId || !SubscriptionManager.isInitializedForUser(userId)) {
+        await SubscriptionManager.initialize(userId);
+      }
+
+      const packages = await SubscriptionManager.getPackages();
+
+      addPackageBreadcrumb("subscription", "Fetch packages query success", {
+        userId: userId ?? "NO_USER",
+        count: packages.length,
+      });
+
+      return packages;
+    },
+    staleTime: STALE_TIME,
+    gcTime: GC_TIME,
+    enabled: !!userId, // Only run when userId is available
+  });
+};
+
+/**
+ * Purchase a subscription package
+ */
+export const usePurchasePackage = (userId: string | undefined) => {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (pkg: PurchasesPackage) => {
+      if (!userId) {
+        throw new Error("User not authenticated");
+      }
+
+      addPackageBreadcrumb("subscription", "Purchase mutation started", {
+        packageId: pkg.identifier,
+        userId,
+      });
+
+      const success = await SubscriptionManager.purchasePackage(pkg);
+
+      if (success) {
+        addPackageBreadcrumb("subscription", "Purchase mutation success", {
+          packageId: pkg.identifier,
+          userId,
+        });
+      } else {
+        addPackageBreadcrumb("subscription", "Purchase mutation failed", {
+          packageId: pkg.identifier,
+          userId,
+        });
+      }
+
+      return success;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({
+        queryKey: SUBSCRIPTION_QUERY_KEYS.packages,
+      });
+    },
+    onError: (error) => {
+      trackPackageError(
+        error instanceof Error ? error : new Error(String(error)),
+        {
+          packageName: "subscription",
+          operation: "purchase_mutation",
+          userId: userId ?? "NO_USER",
+        }
+      );
+    },
+  });
+};
+
+/**
+ * Restore previous purchases
+ */
+export const useRestorePurchase = (userId: string | undefined) => {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async () => {
+      if (!userId) {
+        throw new Error("User not authenticated");
+      }
+
+      addPackageBreadcrumb("subscription", "Restore mutation started", {
+        userId,
+      });
+
+      const success = await SubscriptionManager.restore();
+
+      if (success) {
+        addPackageBreadcrumb("subscription", "Restore mutation success", {
+          userId,
+        });
+      } else {
+        addPackageBreadcrumb("subscription", "Restore mutation failed", {
+          userId,
+        });
+      }
+
+      return success;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({
+        queryKey: SUBSCRIPTION_QUERY_KEYS.packages,
+      });
+    },
+    onError: (error) => {
+      trackPackageError(
+        error instanceof Error ? error : new Error(String(error)),
+        {
+          packageName: "subscription",
+          operation: "restore_mutation",
+          userId: userId ?? "NO_USER",
+        }
+      );
+    },
+  });
+};