@umituz/react-native-subscription 1.8.2 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "1.8.2",
+  "version": "1.10.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,102 @@
+/**
+ * useFeatureGate Hook
+ *
+ * Feature gating with TanStack Query for server state.
+ * Checks auth and premium status before allowing actions.
+ *
+ * Flow:
+ * 1. NOT authenticated → onShowAuthModal(callback)
+ * 2. Authenticated but not premium → onShowPaywall()
+ * 3. Authenticated and premium → Execute action
+ *
+ * @example
+ * ```typescript
+ * const { requireFeature } = useFeatureGate({
+ *   userId: user?.uid,
+ *   isAuthenticated: !!user,
+ *   onShowAuthModal: (cb) => authModal.show(cb),
+ *   onShowPaywall: () => setShowPaywall(true),
+ * });
+ *
+ * // Gate a premium feature
+ * const handleGenerate = () => {
+ *   requireFeature(() => generateContent());
+ * };
+ * ```
+ */
+
+import { useCallback } from "react";
+import { useCredits } from "./useCredits";
+
+export interface UseFeatureGateParams {
+  /** User ID for credits check */
+  userId: string | undefined;
+  /** Whether user is authenticated */
+  isAuthenticated: boolean;
+  /** Callback to show auth modal with pending action */
+  onShowAuthModal: (pendingCallback: () => void | Promise<void>) => void;
+  /** Callback to show paywall */
+  onShowPaywall: () => void;
+}
+
+export interface UseFeatureGateResult {
+  /** Gate a feature - checks auth first, then premium (credits) */
+  requireFeature: (action: () => void | Promise<void>) => void;
+  /** Whether user is authenticated */
+  isAuthenticated: boolean;
+  /** Whether user has premium access (has credits) */
+  isPremium: boolean;
+  /** Whether feature access is allowed */
+  canAccess: boolean;
+  /** Loading state */
+  isLoading: boolean;
+}
+
+export function useFeatureGate(
+  params: UseFeatureGateParams
+): UseFeatureGateResult {
+  const { userId, isAuthenticated, onShowAuthModal, onShowPaywall } = params;
+
+  // Use TanStack Query to get credits (server state)
+  const { credits, isLoading } = useCredits({
+    userId,
+    enabled: isAuthenticated && !!userId,
+  });
+
+  // User is premium if they have credits
+  const isPremium = credits !== null;
+
+  const requireFeature = useCallback(
+    (action: () => void | Promise<void>) => {
+      // Step 1: Check authentication
+      if (!isAuthenticated) {
+        // After auth, re-check premium before executing
+        onShowAuthModal(() => {
+          // This callback runs after successful auth
+          // The component will re-render with new auth state
+          // and user can try the action again
+          action();
+        });
+        return;
+      }
+
+      // Step 2: Check premium (has credits from TanStack Query)
+      if (!isPremium) {
+        onShowPaywall();
+        return;
+      }
+
+      // Step 3: User is authenticated and premium - execute action
+      action();
+    },
+    [isAuthenticated, isPremium, onShowAuthModal, onShowPaywall]
+  );
+
+  return {
+    requireFeature,
+    isAuthenticated,
+    isPremium,
+    canAccess: isAuthenticated && isPremium,
+    isLoading,
+  };
+}