@umituz/react-native-subscription 2.27.10 → 2.27.12

package/package.json

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

@@ -96,3 +96,9 @@ export * from "./utils";
 
 // RevenueCat
 export * from "./revenuecat";
+
+// Init Module Factory
+export {
+  createSubscriptionInitModule,
+  type SubscriptionInitModuleConfig,
+} from './init';

package/src/init/createSubscriptionInitModule.ts

@@ -0,0 +1,121 @@
+/**
+ * Subscription Init Module Factory
+ * Creates a ready-to-use InitModule for app initialization
+ */
+
+import { initializeSubscription, type SubscriptionInitConfig } from '../infrastructure/services/SubscriptionInitializer';
+
+declare const __DEV__: boolean;
+
+/**
+ * InitModule interface (from @umituz/react-native-design-system)
+ */
+export interface InitModule {
+  name: string;
+  init: () => Promise<boolean>;
+  critical?: boolean;
+  dependsOn?: string[];
+}
+
+export interface SubscriptionInitModuleConfig extends Omit<SubscriptionInitConfig, 'apiKey'> {
+  /**
+   * RevenueCat API key getter function
+   * Returns the API key or undefined if not available
+   */
+  getApiKey: () => string | undefined;
+
+  /**
+   * Optional RevenueCat test store key getter
+   */
+  getTestStoreKey?: () => string | undefined;
+
+  /**
+   * Whether this module is critical for app startup
+   * @default true
+   */
+  critical?: boolean;
+
+  /**
+   * Module dependencies
+   * @default ["auth"]
+   */
+  dependsOn?: string[];
+}
+
+/**
+ * Creates a Subscription initialization module for use with createAppInitializer
+ *
+ * @example
+ * ```typescript
+ * import { createAppInitializer } from "@umituz/react-native-design-system";
+ * import { createFirebaseInitModule } from "@umituz/react-native-firebase";
+ * import { createAuthInitModule } from "@umituz/react-native-auth";
+ * import { createSubscriptionInitModule } from "@umituz/react-native-subscription";
+ *
+ * export const initializeApp = createAppInitializer({
+ *   modules: [
+ *     createFirebaseInitModule(),
+ *     createAuthInitModule({ userCollection: "users" }),
+ *     createSubscriptionInitModule({
+ *       getApiKey: () => getRevenueCatApiKey(),
+ *       entitlementId: "premium",
+ *       credits: {
+ *         collectionName: "credits",
+ *         creditLimit: 500,
+ *         enableFreeCredits: true,
+ *         freeCredits: 1,
+ *       },
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export function createSubscriptionInitModule(
+  config: SubscriptionInitModuleConfig
+): InitModule {
+  const {
+    getApiKey,
+    getTestStoreKey,
+    critical = true,
+    dependsOn = ['auth'],
+    ...subscriptionConfig
+  } = config;
+
+  return {
+    name: 'subscription',
+    critical,
+    dependsOn,
+    init: async () => {
+      try {
+        const apiKey = getApiKey();
+
+        if (!apiKey) {
+          if (typeof __DEV__ !== 'undefined' && __DEV__) {
+            console.log('[createSubscriptionInitModule] No API key - skipping');
+          }
+          return true; // Not an error, just skip
+        }
+
+        const testStoreKey = getTestStoreKey?.();
+
+        await initializeSubscription({
+          apiKey,
+          testStoreKey,
+          ...subscriptionConfig,
+        });
+
+        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+          console.log('[createSubscriptionInitModule] Subscription initialized');
+        }
+
+        return true;
+      } catch (error) {
+        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+          console.error('[createSubscriptionInitModule] Error:', error);
+        }
+        // Continue on error - subscription is not critical for app launch
+        return true;
+      }
+    },
+  };
+}

package/src/init/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Subscription Init Module
+ * Provides factory for creating app initialization modules
+ */
+
+export {
+  createSubscriptionInitModule,
+  type SubscriptionInitModuleConfig,
+  type InitModule,
+} from './createSubscriptionInitModule';

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,