@umituz/react-native-subscription 2.16.0 → 2.16.1

package/README.md

@@ -67,6 +67,51 @@ This package provides comprehensive subscription and credit management with:
 - **State Management**: `@tanstack/react-query` >= 5.0.0
 - **React Native**: `react-native` >= 0.74.0
 
+## RevenueCat Best Practices
+
+This package follows RevenueCat's official best practices:
+
+### 1. Trust RevenueCat Data
+
+- **Expiration dates**: Use RevenueCat's `expirationDate` directly without modification
+- **Premium status**: Check `customerInfo.entitlements.active['premium']`
+- **Server-side validation**: RevenueCat handles receipt validation server-side
+
+### 2. CustomerInfo Listener
+
+```typescript
+// Real-time subscription updates via listener
+Purchases.addCustomerInfoUpdateListener((info) => {
+  const isPremium = !!info.entitlements.active['premium'];
+  const expirationDate = info.entitlements.active['premium']?.expirationDate;
+});
+```
+
+### 3. Entitlements-Based Access
+
+- Use entitlements (not product IDs) to gate features
+- Entitlements abstract away platform differences (iOS/Android)
+- Single source of truth for premium access
+
+### 4. Testing Guidelines
+
+- **Real devices only**: Simulators don't support in-app purchases
+- **TestFlight uses Sandbox**: Short expiration times (5 min for monthly)
+- **App Store Connect delays**: Changes can take hours to propagate
+
+### 5. Anonymous to Identified User Transfer
+
+When user converts from anonymous to identified:
+- `Purchases.logIn(userId)` handles user identity
+- Configure "Transfer if no purchases" in RevenueCat dashboard
+- Use `restorePurchases()` for explicit restore
+
+### Sources
+
+- [RevenueCat React Native SDK](https://github.com/RevenueCat/react-native-purchases)
+- [RevenueCat Documentation](https://www.revenuecat.com/docs/getting-started/installation/reactnative)
+- [Best Practices Guide](https://www.revenuecat.com/blog/engineering/ad-free-subscriptions-in-react-native/)
+
 ## Restrictions
 
 ### REQUIRED

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.16.0",
+  "version": "2.16.1",
   "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/presentation/hooks/useSubscriptionSettingsConfig.ts

@@ -16,7 +16,6 @@ import { useCreditsArray, getSubscriptionStatusType } from "./useSubscriptionSet
 import { getCreditsConfig } from "../../infrastructure/repositories/CreditsRepositoryProvider";
 import { detectPackageType } from "../../utils/packageTypeDetector";
 import { getCreditAllocation } from "../../utils/creditMapper";
-import { getExpirationDate } from "../../revenuecat/infrastructure/utils/ExpirationDateCalculator";
 import type {
   SubscriptionSettingsConfig,
   SubscriptionStatusType,
@@ -75,12 +74,8 @@ export const useSubscriptionSettingsConfig = (
     return allocation ?? creditLimit ?? config.creditLimit;
   }, [premiumEntitlement?.productIdentifier, creditLimit]);
 
-  // Get expiration date from RevenueCat entitlement (source of truth)
-  // Apply sandbox-to-production conversion for better testing UX
-  const entitlementExpirationDate = useMemo(() => {
-    if (!premiumEntitlement) return null;
-    return getExpirationDate(premiumEntitlement);
-  }, [premiumEntitlement]);
+  // Get expiration date directly from RevenueCat (source of truth)
+  const entitlementExpirationDate = premiumEntitlement?.expirationDate ?? null;
 
   // Prefer CustomerInfo expiration (real-time) over cached status
   const expiresAtIso = entitlementExpirationDate || (statusExpirationDate

package/src/revenuecat/infrastructure/handlers/PackageHandler.ts

@@ -6,7 +6,6 @@
 import type { PurchasesPackage, CustomerInfo } from "react-native-purchases";
 import type { IRevenueCatService } from "../../application/ports/IRevenueCatService";
 import { getPremiumEntitlement } from "../../domain/types/RevenueCatTypes";
-import { getExpirationDate } from "../utils/ExpirationDateCalculator";
 
 export interface PremiumStatus {
   isPremium: boolean;
@@ -115,55 +114,17 @@ export class PackageHandler {
   }
 
   checkPremiumStatusFromInfo(customerInfo: CustomerInfo): PremiumStatus {
-    // First, check active entitlements (standard case)
-    const activeEntitlement = getPremiumEntitlement(
-      customerInfo,
-      this.entitlementId
-    );
-
-    if (activeEntitlement) {
-      const adjustedExpiration = getExpirationDate(activeEntitlement);
+    const entitlement = getPremiumEntitlement(customerInfo, this.entitlementId);
+
+    if (entitlement) {
       return {
         isPremium: true,
-        expirationDate: adjustedExpiration ? new Date(adjustedExpiration) : null,
+        expirationDate: entitlement.expirationDate
+          ? new Date(entitlement.expirationDate)
+          : null,
       };
     }
 
-    // Edge case: Check all entitlements (including expired ones)
-    // This handles the bug where RevenueCat hasn't updated the expiration date yet
-    const allEntitlements = customerInfo.entitlements.all[this.entitlementId];
-
-    if (allEntitlements) {
-      const entitlementData = {
-        identifier: allEntitlements.identifier,
-        productIdentifier: allEntitlements.productIdentifier,
-        isSandbox: allEntitlements.isSandbox,
-        willRenew: allEntitlements.willRenew,
-        periodType: allEntitlements.periodType,
-        latestPurchaseDate: allEntitlements.latestPurchaseDate,
-        originalPurchaseDate: allEntitlements.originalPurchaseDate,
-        expirationDate: allEntitlements.expirationDate,
-        unsubscribeDetectedAt: allEntitlements.unsubscribeDetectedAt,
-        billingIssueDetectedAt: allEntitlements.billingIssueDetectedAt,
-      };
-
-      // Get adjusted expiration date
-      const adjustedExpiration = getExpirationDate(entitlementData);
-
-      if (adjustedExpiration) {
-        const expirationDate = new Date(adjustedExpiration);
-        const now = new Date();
-
-        // If adjusted expiration is in the future, user is premium
-        if (expirationDate > now) {
-          return {
-            isPremium: true,
-            expirationDate,
-          };
-        }
-      }
-    }
-
     return {
       isPremium: false,
       expirationDate: null,

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

@@ -6,7 +6,6 @@
 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";
 
 export async function syncPremiumStatus(
     config: RevenueCatConfig,
@@ -17,21 +16,18 @@ export async function syncPremiumStatus(
         return;
     }
 
-    const entitlementIdentifier = config.entitlementIdentifier;
     const premiumEntitlement = getPremiumEntitlement(
         customerInfo,
-        entitlementIdentifier
+        config.entitlementIdentifier
     );
 
     try {
         if (premiumEntitlement) {
-            const productId = premiumEntitlement.productIdentifier;
-            const expiresAt = getExpirationDate(premiumEntitlement);
             await config.onPremiumStatusChanged(
                 userId,
                 true,
-                productId,
-                expiresAt || undefined
+                premiumEntitlement.productIdentifier,
+                premiumEntitlement.expirationDate ?? undefined
             );
         } else {
             await config.onPremiumStatusChanged(userId, false);

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

@@ -1,19 +0,0 @@
-/**
- * Expiration Date Calculator
- * Returns RevenueCat expiration date directly
- *
- * Best Practice: Trust RevenueCat's expiration date
- * RevenueCat handles all subscription logic server-side
- */
-
-import type { RevenueCatEntitlement } from '../../domain/types/RevenueCatTypes';
-
-/**
- * Get expiration date from entitlement
- * Returns RevenueCat's expiration date directly without modification
- */
-export function getExpirationDate(
-  entitlement: RevenueCatEntitlement | null
-): string | null {
-  return entitlement?.expirationDate ?? null;
-}