@umituz/react-native-subscription 2.27.10 → 2.27.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.27.10",
+  "version": "2.27.11",
   "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/domain/entities/Credits.ts

@@ -74,10 +74,10 @@ export interface CreditsConfig {
   creditPackageAmounts?: Record<string, number>;
   /** Credit allocations for different subscription types (weekly, monthly, yearly) */
   packageAllocations?: PackageAllocationMap;
-  /** Free credits given to new users on registration (default: 0) */
+  /** Enable free credits for new users (default: false) */
+  enableFreeCredits?: boolean;
+  /** Free credits given to new users on registration (only used when enableFreeCredits: true) */
   freeCredits?: number;
-  /** Whether to auto-initialize free credits when user has no credits document (default: true if freeCredits > 0) */
-  autoInitializeFreeCredits?: boolean;
 }
 
 export interface CreditsResult<T = UserCredits> {

package/src/presentation/hooks/useFreeCreditsInit.ts

@@ -115,7 +115,8 @@ export function useFreeCreditsInit(params: UseFreeCreditsInitParams): UseFreeCre
   const isConfigured = isCreditsRepositoryConfigured();
   const config = getCreditsConfig();
   const freeCredits = config.freeCredits ?? 0;
-  const autoInit = config.autoInitializeFreeCredits !== false && freeCredits > 0;
+  // Free credits only enabled when explicitly set to true AND freeCredits > 0
+  const isFreeCreditsEnabled = config.enableFreeCredits === true && freeCredits > 0;
 
   // Check if THIS user's init is in progress (shared across all hook instances)
   const isInitializing = userId ? inProgressSet.has(userId) : false;
@@ -127,7 +128,7 @@ export function useFreeCreditsInit(params: UseFreeCreditsInitParams): UseFreeCre
     isRegisteredUser &&
     isConfigured &&
     !hasCredits &&
-    autoInit &&
+    isFreeCreditsEnabled &&
     !freeCreditsInitAttempted.has(userId);
 
   // Stable callback reference
@@ -143,12 +144,12 @@ export function useFreeCreditsInit(params: UseFreeCreditsInitParams): UseFreeCre
       if (!freeCreditsInitAttempted.has(userId)) {
         initializeFreeCreditsForUser(userId, stableOnComplete);
       }
-    } else if (querySuccess && isAnonymous && !hasCredits && autoInit) {
+    } else if (querySuccess && isAnonymous && !hasCredits && isFreeCreditsEnabled) {
       if (typeof __DEV__ !== "undefined" && __DEV__) {
         console.log("[useFreeCreditsInit] Skipping - anonymous user must register first");
       }
     }
-  }, [needsInit, userId, querySuccess, isAnonymous, hasCredits, autoInit, stableOnComplete]);
+  }, [needsInit, userId, querySuccess, isAnonymous, hasCredits, isFreeCreditsEnabled, stableOnComplete]);
 
   return {
     isInitializing: isInitializing || needsInit,