@umituz/react-native-subscription 2.26.7 → 2.26.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.26.7",
+  "version": "2.26.9",
   "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,6 +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) */
+  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/domain/entities/SubscriptionStatus.ts

@@ -7,6 +7,7 @@ export const SUBSCRIPTION_STATUS = {
   EXPIRED: 'expired',
   CANCELED: 'canceled',
   NONE: 'none',
+  FREE: 'free',
 } as const;
 
 /** RevenueCat period type constants */

package/src/infrastructure/repositories/CreditsRepository.ts

@@ -133,6 +133,72 @@ export class CreditsRepository extends BaseRepository {
     return !!(res.success && res.data && res.data.credits >= cost);
   }
 
+  /**
+   * Initialize free credits for new users
+   * Creates a credits document with freeCredits amount (no subscription)
+   */
+  async initializeFreeCredits(userId: string): Promise<CreditsResult> {
+    const db = getFirestore();
+    if (!db) return { success: false, error: { message: "No DB", code: "INIT_ERR" } };
+
+    const freeCredits = this.config.freeCredits ?? 0;
+    if (freeCredits <= 0) {
+      return { success: false, error: { message: "Free credits not configured", code: "NO_FREE_CREDITS" } };
+    }
+
+    try {
+      const ref = this.getRef(db, userId);
+      const snap = await getDoc(ref);
+
+      // Don't overwrite if document already exists
+      if (snap.exists()) {
+        if (__DEV__) console.log("[CreditsRepository] Credits document already exists, skipping free credits init");
+        const existing = snap.data() as UserCreditsDocumentRead;
+        return { success: true, data: CreditsMapper.toEntity(existing) };
+      }
+
+      // Create new document with free credits
+      const { setDoc } = await import("firebase/firestore");
+      const now = serverTimestamp();
+
+      const creditsData = {
+        // Not premium - just free credits
+        isPremium: false,
+        status: "free" as const,
+
+        // Free credits
+        credits: freeCredits,
+        creditLimit: freeCredits,
+        isFreeCredits: true,
+
+        // Dates
+        createdAt: now,
+        lastUpdatedAt: now,
+      };
+
+      await setDoc(ref, creditsData);
+
+      if (__DEV__) console.log("[CreditsRepository] Initialized free credits:", { userId: userId.slice(0, 8), credits: freeCredits });
+
+      return {
+        success: true,
+        data: {
+          isPremium: false,
+          status: "free",
+          credits: freeCredits,
+          creditLimit: freeCredits,
+          purchasedAt: null,
+          expirationDate: null,
+          lastUpdatedAt: null,
+          willRenew: false,
+        }
+      };
+    } catch (e: any) {
+      if (__DEV__) console.error("[CreditsRepository] Free credits init error:", e.message);
+      return { success: false, error: { message: e.message, code: "INIT_ERR" } };
+    }
+  }
+
   /** Sync expired subscription status to Firestore (background) */
   async syncExpiredStatus(userId: string): Promise<void> {
     const db = getFirestore();

package/src/presentation/components/details/PremiumStatusBadge.tsx

@@ -20,6 +20,8 @@ export interface PremiumStatusBadgeProps {
   trialLabel?: string;
   /** Label for trial_canceled status (defaults to canceledLabel if not provided) */
   trialCanceledLabel?: string;
+  /** Label for free credits status (defaults to noneLabel if not provided) */
+  freeLabel?: string;
 }
 
 export const PremiumStatusBadge: React.FC<PremiumStatusBadgeProps> = ({
@@ -30,6 +32,7 @@ export const PremiumStatusBadge: React.FC<PremiumStatusBadgeProps> = ({
   canceledLabel,
   trialLabel,
   trialCanceledLabel,
+  freeLabel,
 }) => {
   const tokens = useAppDesignTokens();
 
@@ -40,6 +43,7 @@ export const PremiumStatusBadge: React.FC<PremiumStatusBadgeProps> = ({
     expired: expiredLabel,
     none: noneLabel,
     canceled: canceledLabel,
+    free: freeLabel ?? noneLabel,
   };
 
   const backgroundColor = useMemo(() => {
@@ -50,6 +54,7 @@ export const PremiumStatusBadge: React.FC<PremiumStatusBadgeProps> = ({
       expired: tokens.colors.error,
       none: tokens.colors.textTertiary,
       canceled: tokens.colors.warning,
+      free: tokens.colors.info ?? tokens.colors.primary, // Blue for free credits
     };
     return colors[status];
   }, [status, tokens.colors]);

package/src/presentation/hooks/useCredits.ts

@@ -3,10 +3,11 @@
  *
  * TanStack Query hook for fetching user credits.
  * Generic and reusable - uses config from module-level provider.
+ * Auto-initializes free credits for new users if configured.
  */
 
 import { useQuery } from "@umituz/react-native-design-system";
-import { useCallback, useMemo } from "react";
+import { useCallback, useMemo, useRef, useEffect } from "react";
 import type { UserCredits } from "../../domain/entities/Credits";
 import {
     getCreditsRepository,
@@ -65,7 +66,10 @@ export const useCredits = ({
 
   const queryEnabled = enabled && !!userId && isConfigured;
 
-  const { data, isLoading, error, refetch } = useQuery({
+  // Track if free credits initialization has been attempted
+  const freeCreditsInitAttemptedRef = useRef<string | null>(null);
+
+  const { data, isLoading, error, refetch, isFetched } = useQuery({
     queryKey: creditsQueryKeys.user(userId ?? ""),
     queryFn: async () => {
       if (!userId || !isConfigured) {
@@ -98,6 +102,49 @@ export const useCredits = ({
 
   const credits = data ?? null;
 
+  // Auto-initialize free credits for new users
+  const freeCredits = config.freeCredits ?? 0;
+  const autoInit = config.autoInitializeFreeCredits !== false && freeCredits > 0;
+
+  useEffect(() => {
+    // Only run if:
+    // 1. Query has completed (isFetched)
+    // 2. User is authenticated
+    // 3. No credits data exists
+    // 4. Free credits configured
+    // 5. Auto-init enabled
+    // 6. Haven't already attempted for this user
+    if (
+      isFetched &&
+      userId &&
+      isConfigured &&
+      !credits &&
+      autoInit &&
+      freeCreditsInitAttemptedRef.current !== userId
+    ) {
+      freeCreditsInitAttemptedRef.current = userId;
+
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[useCredits] Auto-initializing free credits for new user:", userId.slice(0, 8));
+      }
+
+      const repository = getCreditsRepository();
+      repository.initializeFreeCredits(userId).then((result) => {
+        if (result.success) {
+          if (typeof __DEV__ !== "undefined" && __DEV__) {
+            console.log("[useCredits] Free credits initialized:", result.data?.credits);
+          }
+          // Refetch to get the new credits
+          refetch();
+        } else {
+          if (typeof __DEV__ !== "undefined" && __DEV__) {
+            console.warn("[useCredits] Free credits init failed:", result.error?.message);
+          }
+        }
+      });
+    }
+  }, [isFetched, userId, isConfigured, credits, autoInit, refetch]);
+
   // Memoize derived values to prevent unnecessary re-renders
   const derivedValues = useMemo(() => {
     const has = (credits?.credits ?? 0) > 0;