@umituz/react-native-subscription 2.15.7 → 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.15.7",
+  "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/config/SandboxDurationConfig.ts

@@ -1,23 +0,0 @@
-/**
- * Subscription Duration Configuration
- * Production subscription durations by package type
- */
-
-import type { SubscriptionPackageType } from '../../../utils/packageTypeDetector';
-
-/**
- * Subscription durations in days
- */
-export const SUBSCRIPTION_DURATIONS: Record<SubscriptionPackageType, number> = {
-  weekly: 7,
-  monthly: 30,
-  yearly: 365,
-  unknown: 30,
-};
-
-/**
- * Get subscription duration in days for a package type
- */
-export function getProductionDurationDays(packageType: SubscriptionPackageType): number {
-  return SUBSCRIPTION_DURATIONS[packageType] ?? SUBSCRIPTION_DURATIONS.unknown;
-}

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

@@ -1,49 +0,0 @@
-/**
- * Expiration Date Calculator
- * Handles RevenueCat expiration date edge case
- *
- * Problem: RevenueCat sometimes returns expiration date = purchase date
- * Solution: If same day, add subscription period based on package type
- */
-
-import type { RevenueCatEntitlement } from '../../domain/types/RevenueCatTypes';
-import { detectPackageType } from '../../../utils/packageTypeDetector';
-import { addProductionPeriod } from './SandboxDurationConverter';
-
-/**
- * Check if two dates are on the same day
- */
-function isSameDay(date1: Date, date2: Date): boolean {
-  return (
-    date1.getFullYear() === date2.getFullYear() &&
-    date1.getMonth() === date2.getMonth() &&
-    date1.getDate() === date2.getDate()
-  );
-}
-
-/**
- * Get expiration date from entitlement
- *
- * Handles edge case: If expiration date equals purchase date (same day),
- * calculates correct expiration by adding subscription period.
- */
-export function getExpirationDate(
-  entitlement: RevenueCatEntitlement | null
-): string | null {
-  if (!entitlement?.expirationDate) {
-    return null;
-  }
-
-  const expDate = new Date(entitlement.expirationDate);
-  const purchaseDate = entitlement.latestPurchaseDate
-    ? new Date(entitlement.latestPurchaseDate)
-    : null;
-
-  // Only adjust if expiration equals purchase date (same day bug)
-  if (purchaseDate && isSameDay(expDate, purchaseDate)) {
-    const packageType = detectPackageType(entitlement.productIdentifier);
-    return addProductionPeriod(purchaseDate, packageType).toISOString();
-  }
-
-  return entitlement.expirationDate;
-}

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

@@ -1,20 +0,0 @@
-/**
- * Subscription Duration Utilities
- * Calculates subscription period based on package type
- */
-
-import type { SubscriptionPackageType } from '../../../utils/packageTypeDetector';
-import { getProductionDurationDays } from '../config/SandboxDurationConfig';
-
-/**
- * Add subscription period to a date based on package type
- */
-export function addProductionPeriod(
-  date: Date,
-  packageType: SubscriptionPackageType
-): Date {
-  const newDate = new Date(date);
-  const daysToAdd = getProductionDurationDays(packageType);
-  newDate.setDate(newDate.getDate() + daysToAdd);
-  return newDate;
-}