@umituz/react-native-subscription 1.8.2 → 1.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "1.8.2",
+  "version": "1.9.0",
   "description": "Subscription management, paywall UI and credits system for React Native apps",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/index.ts

@@ -64,6 +64,12 @@ export {
   type UsePremiumGateResult,
 } from "./presentation/hooks/usePremiumGate";
 
+export {
+  useFeatureGate,
+  type UseFeatureGateParams,
+  type UseFeatureGateResult,
+} from "./presentation/hooks/useFeatureGate";
+
 export {
   useUserTier,
   type UseUserTierParams,

package/src/infrastructure/repositories/CreditsRepository.ts

@@ -12,11 +12,11 @@ import {
   getDoc,
   runTransaction,
   serverTimestamp,
+  type FieldValue,
 } from "firebase/firestore";
 import { BaseRepository, getFirestore } from "@umituz/react-native-firestore";
 import type {
   CreditType,
-  UserCredits,
   CreditsConfig,
   CreditsResult,
   DeductCreditsResult,
@@ -24,15 +24,14 @@ import type {
 
 interface FirestoreTimestamp {
   toDate: () => Date;
-  isEqual: (other: FirestoreTimestamp) => boolean;
 }
 
 interface UserCreditsDocument {
   textCredits: number;
   imageCredits: number;
-  purchasedAt: FirestoreTimestamp;
-  lastUpdatedAt: FirestoreTimestamp;
-  lastPurchaseAt?: FirestoreTimestamp;
+  purchasedAt: FirestoreTimestamp | FieldValue;
+  lastUpdatedAt: FirestoreTimestamp | FieldValue;
+  lastPurchaseAt?: FirestoreTimestamp | FieldValue;
   processedPurchases?: string[];
 }
 

package/src/presentation/hooks/useFeatureGate.ts

@@ -0,0 +1,97 @@
+/**
+ * useFeatureGate Hook
+ *
+ * Centralized gate for premium features - checks auth first, then premium.
+ * Generic and reusable - accepts all dependencies via params.
+ *
+ * Flow:
+ * 1. NOT authenticated → Show auth modal (login/register)
+ * 2. Authenticated but not premium → Show paywall
+ * 3. Authenticated and premium → Execute action
+ *
+ * @example
+ * ```typescript
+ * const { requireFeature } = useFeatureGate({
+ *   isAuthenticated: user !== null,
+ *   isPremium: subscriptionStore.isPremium,
+ *   onShowAuthModal: (callback) => authModalStore.show(callback),
+ *   onShowPaywall: () => setShowPaywall(true),
+ *   getIsPremium: () => subscriptionStore.getState().isPremium,
+ * });
+ *
+ * const handleGenerate = () => {
+ *   requireFeature(() => generateContent());
+ * };
+ * ```
+ */
+
+import { useCallback } from "react";
+
+export interface UseFeatureGateParams {
+  /** Whether user is currently authenticated */
+  isAuthenticated: boolean;
+  /** Whether user has premium access (for immediate check) */
+  isPremium: boolean;
+  /** Callback to show auth modal with pending action */
+  onShowAuthModal: (pendingCallback: () => void | Promise<void>) => void;
+  /** Callback to show paywall */
+  onShowPaywall: () => void;
+  /** Function to get fresh isPremium status (avoids stale closure after login) */
+  getIsPremium: () => boolean;
+}
+
+export interface UseFeatureGateResult {
+  /** Gate a feature - checks auth first, then premium */
+  requireFeature: (action: () => void | Promise<void>) => void;
+  /** Whether user is authenticated */
+  isAuthenticated: boolean;
+  /** Whether user has premium access */
+  isPremium: boolean;
+  /** Whether feature access is allowed (authenticated + premium) */
+  canAccess: boolean;
+}
+
+export function useFeatureGate(
+  params: UseFeatureGateParams
+): UseFeatureGateResult {
+  const {
+    isAuthenticated,
+    isPremium,
+    onShowAuthModal,
+    onShowPaywall,
+    getIsPremium,
+  } = params;
+
+  const requireFeature = useCallback(
+    (action: () => void | Promise<void>) => {
+      // Step 1: Check if user is NOT authenticated → show auth modal
+      if (!isAuthenticated) {
+        // After login, get FRESH premium status (not stale closure)
+        onShowAuthModal(() => {
+          const currentIsPremium = getIsPremium();
+          if (currentIsPremium) {
+            action();
+          } else {
+            onShowPaywall();
+          }
+        });
+        return;
+      }
+
+      // Step 2: Check premium (will show paywall if not premium)
+      if (isPremium) {
+        action();
+      } else {
+        onShowPaywall();
+      }
+    },
+    [isAuthenticated, isPremium, onShowAuthModal, onShowPaywall, getIsPremium]
+  );
+
+  return {
+    requireFeature,
+    isAuthenticated,
+    isPremium,
+    canAccess: isAuthenticated && isPremium,
+  };
+}