@umituz/react-native-subscription 2.12.32 → 2.12.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.12.32",
+  "version": "2.12.34",
   "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

@@ -239,10 +239,9 @@ export {
 } from "./presentation/hooks/usePaywallVisibility";
 
 export {
-  usePremiumWithConfig,
-  type UsePremiumWithConfigParams,
-  type UsePremiumWithConfigResult,
-} from "./presentation/hooks/usePremiumWithConfig";
+  usePremium,
+  type UsePremiumResult,
+} from "./presentation/hooks/usePremium";
 
 export {
   useAuthSubscriptionSync,

package/src/presentation/hooks/{usePremiumWithConfig.ts → usePremium.ts}

@@ -1,81 +1,88 @@
 /**
- * usePremiumWithConfig Hook
- * Premium status from TanStack Query (credits)
- * Subscription state from TanStack Query
- * Generic implementation for 100+ apps with auth provider abstraction
- *
- * Note: Credit allocation is handled by CustomerInfo Listener (onCreditRenewal)
- * configured in SubscriptionManager. Manual credit initialization removed to
- * prevent duplicate allocation.
+ * usePremium Hook
+ * Complete subscription management for 100+ apps
+ * Works for both authenticated and anonymous users
  */
 
-import { useCallback } from "react";
-import type { PurchasesPackage } from "react-native-purchases";
-import type { UserCredits } from "../../domain/entities/Credits";
-import { useCredits } from "./useCredits";
+import { useCallback } from 'react';
+import type { PurchasesPackage } from 'react-native-purchases';
+import type { UserCredits } from '../../domain/entities/Credits';
+import { useCredits } from './useCredits';
 import {
   useSubscriptionPackages,
   usePurchasePackage,
   useRestorePurchase,
-} from "../../revenuecat/presentation/hooks/useSubscriptionQueries";
-import { usePaywallVisibility } from "./usePaywallVisibility";
-
-export interface UsePremiumWithConfigParams {
-  /** Function to get current user ID (can be from Firebase, Supabase, etc.) */
-  getUserId: () => string | null | undefined;
-  /** Enable/disable credits query */
-  enabled?: boolean;
-}
+} from '../../revenuecat/presentation/hooks/useSubscriptionQueries';
+import { usePaywallVisibility } from './usePaywallVisibility';
 
-export interface UsePremiumWithConfigResult {
+export interface UsePremiumResult {
+  /** User has active premium subscription */
   isPremium: boolean;
+  /** Loading credits or packages */
   isLoading: boolean;
+  /** Available subscription packages */
   packages: PurchasesPackage[];
+  /** User's credits (null if not premium) */
   credits: UserCredits | null;
+  /** Paywall visibility state */
   showPaywall: boolean;
+  /** Purchase a subscription package */
   purchasePackage: (pkg: PurchasesPackage) => Promise<boolean>;
+  /** Restore previous purchases */
   restorePurchase: () => Promise<boolean>;
+  /** Set paywall visibility */
   setShowPaywall: (show: boolean) => void;
+  /** Close paywall */
   closePaywall: () => void;
+  /** Open paywall */
   openPaywall: () => void;
 }
 
-export const usePremiumWithConfig = (
-  params: UsePremiumWithConfigParams,
-): UsePremiumWithConfigResult => {
-  const { getUserId, enabled = true } = params;
-  const userId = getUserId() ?? undefined;
-
+/**
+ * Complete premium subscription management
+ *
+ * @param userId - User ID (undefined for anonymous users)
+ * @returns Premium status, packages, and subscription actions
+ *
+ * @example
+ * ```typescript
+ * const { isPremium, packages, purchasePackage } = usePremium(userId);
+ * ```
+ */
+export const usePremium = (userId?: string): UsePremiumResult => {
+  // Fetch user credits (server state)
   const { credits, isLoading: creditsLoading } = useCredits({
     userId,
-    enabled: enabled && !!userId,
+    enabled: !!userId,
   });
 
+  // Fetch subscription packages (works for anonymous too)
   const { data: packages = [], isLoading: packagesLoading } =
     useSubscriptionPackages(userId);
+
+  // Purchase and restore mutations
   const purchaseMutation = usePurchasePackage(userId);
   const restoreMutation = useRestorePurchase(userId);
 
+  // Paywall visibility state
   const { showPaywall, setShowPaywall, closePaywall, openPaywall } =
     usePaywallVisibility();
 
-  // User is premium if they have credits
-  // NOTE: This assumes credits system = premium subscription
-  // If your app uses CustomerInfo for premium status, use useCustomerInfo() instead
+  // Premium status = has credits
   const isPremium = credits !== null;
 
+  // Purchase handler
   const handlePurchase = useCallback(
     async (pkg: PurchasesPackage): Promise<boolean> => {
       const success = await purchaseMutation.mutateAsync(pkg);
-      // Credit allocation handled by CustomerInfo Listener (onCreditRenewal)
       return success;
     },
     [purchaseMutation],
   );
 
+  // Restore handler
   const handleRestore = useCallback(async (): Promise<boolean> => {
     const success = await restoreMutation.mutateAsync();
-    // Credit allocation handled by CustomerInfo Listener (onCreditRenewal)
     return success;
   }, [restoreMutation]);