@umituz/react-native-subscription 2.26.14 → 2.26.16

package/src/presentation/hooks/useUserTier.ts

@@ -1,78 +0,0 @@
-/**
- * useUserTier Hook
- *
- * Centralized hook for determining user tier (Guest, Freemium, Premium)
- * Single source of truth for all premium/freemium/guest checks
- *
- * This hook only handles LOGICAL tier determination.
- * Database operations should be handled by the app via PremiumStatusFetcher.
- *
- * @example
- * ```typescript
- * const { tier, isPremium, isGuest } = useUserTier({
- *   isGuest: false,
- *   userId: 'user123',
- *   isPremium: true, // App should fetch this from database
- * });
- *
- * // Simple, clean checks
- * if (tier === "guest") {
- *   // Show guest upgrade card
- * } else if (tier === "freemium") {
- *   // Show freemium limits
- * } else {
- *   // Premium features
- * }
- * ```
- */
-
-import { useMemo } from 'react';
-import { getUserTierInfo } from '../../utils/tierUtils';
-import type { UserTierInfo } from '../../utils/types';
-
-export interface UseUserTierParams {
-  /** Whether user is a guest */
-  isGuest: boolean;
-  /** User ID (null for guests) */
-  userId: string | null;
-  /** Whether user has active premium subscription (app should fetch from database) */
-  isPremium: boolean;
-  /** Optional: Loading state from app */
-  isLoading?: boolean;
-  /** Optional: Error state from app */
-  error?: string | null;
-}
-
-export interface UseUserTierResult extends UserTierInfo {
-  /** Whether premium status is currently loading */
-  isLoading: boolean;
-  /** Premium status error (if any) */
-  error: string | null;
-}
-
-/**
- * Hook to get user tier information
- * Combines auth state and premium status into single source of truth
- * 
- * All premium/freemium/guest checks are centralized here:
- * - Guest: isGuest || !userId → always freemium, never premium
- * - Freemium: authenticated but !isPremium
- * - Premium: authenticated && isPremium
- * 
- * Note: This hook only handles LOGICAL tier determination.
- * Database operations (fetching premium status) should be handled by the app.
- */
-export function useUserTier(params: UseUserTierParams): UseUserTierResult {
-  const { isGuest, userId, isPremium, isLoading = false, error = null } = params;
-
-  // Calculate tier info using centralized logic
-  const tierInfo = useMemo(() => {
-    return getUserTierInfo(isGuest, userId, isPremium);
-  }, [isGuest, userId, isPremium]);
-
-  return {
-    ...tierInfo,
-    isLoading,
-    error,
-  };
-}

package/src/presentation/hooks/useUserTierWithRepository.md

@@ -1,92 +0,0 @@
-# useUserTierWithRepository Hook
-
-Automatically fetches premium status and provides tier information with repository integration.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/hooks/useUserTierWithRepository.ts`
-
-**Type**: Hook
-
-## Strategy
-
-### Tier Determination with Repository
-
-1. **Auth State Check**: Use provided auth provider to check authentication
-2. **Premium Fetch**: Automatically fetch premium status from repository for authenticated users
-3. **Tier Assignment**: Assign tier based on auth + subscription (guest/freemium/premium)
-4. **Abort Control**: Use AbortController to prevent race conditions on rapid user changes
-5. **Guest Optimization**: Skip repository fetch for guest users (no fetch needed)
-6. **Real-time Updates**: React to auth state changes
-
-### Integration Points
-
-- **Auth Provider**: Custom auth provider with user state
-- **Subscription Repository**: `src/infrastructure/repositories/SubscriptionRepository.ts`
-- **Domain Layer**: `src/domain/entities/README.md`
-- **TanStack Query**: For caching and real-time updates
-
-## Restrictions
-
-### REQUIRED
-
-- **Auth Provider**: MUST provide valid auth provider object
-- **Repository**: MUST provide subscription repository
-- **Loading State**: MUST handle loading state
-- **Error Handling**: MUST handle error state
-
-### PROHIBITED
-
-- **NEVER** call without valid auth provider
-- **NEVER** call without valid repository
-- **DO NOT** hardcode tier values (use hook return values)
-- **DO NOT** assume instant data availability
-
-### CRITICAL SAFETY
-
-- **ALWAYS** check loading state before using tier values
-- **NEVER** trust client-side tier for security enforcement
-- **MUST** provide valid auth provider structure
-- **ALWAYS** handle tier transitions gracefully
-
-## AI Agent Guidelines
-
-### When Implementing Tier Determination
-
-1. **Always** provide valid auth provider with user, isGuest, isAuthenticated
-2. **Always** provide valid subscription repository
-3. **Always** handle loading state
-4. **Always** handle error state
-5. **Never** use for security decisions without server validation
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Provide valid auth provider object
-- [ ] Provide valid subscription repository
-- [ ] Handle loading state
-- [ ] Handle error state
-- [ ] Use refresh() when needed
-- [ ] Test with guest user
-- [ ] Test with freemium user
-- [ ] Test with premium user
-- [ ] Test user switching scenarios
-
-### Common Patterns
-
-1. **Auth Provider Setup**: Use with Firebase, custom auth, or auth library
-2. **Tier-Based UI**: Show different features based on tier
-3. **Navigation Guards**: Redirect based on tier requirements
-4. **Tier Monitoring**: Track tier changes for analytics
-5. **Manual Refresh**: Call refresh() after subscription changes
-
-## Related Documentation
-
-- **useUserTier**: Tier logic without repository
-- **usePremium**: Premium status checking
-- **useAuthGate**: Authentication gating
-- **useSubscription**: Subscription details
-- **Repository Pattern**: `src/infrastructure/repositories/README.md`
-- **User Tier Utils**: `src/utils/README.md`

package/src/presentation/hooks/useUserTierWithRepository.ts

@@ -1,151 +0,0 @@
-/**
- * useUserTierWithRepository Hook
- * Automatically fetches premium status and provides user tier information.
- */
-
-import { useEffect, useState, useCallback } from 'react';
-import { useUserTier, type UseUserTierParams } from './useUserTier';
-import type { ISubscriptionRepository } from '../../application/ports/ISubscriptionRepository';
-
-/**
- * Auth provider interface
- * Apps should provide an object that matches this interface
- */
-export interface AuthProvider {
-  /** Current user object (null for guests) */
-  user: { uid: string } | null;
-  /** Whether user is a guest */
-  isGuest: boolean;
-  /** Whether user is authenticated */
-  isAuthenticated: boolean;
-}
-
-export interface UseUserTierWithRepositoryParams {
-  /** Auth provider (e.g., result of useAuth hook) */
-  auth: AuthProvider;
-  /** Subscription repository for fetching premium status */
-  repository: ISubscriptionRepository;
-}
-
-export interface UseUserTierWithRepositoryResult {
-  /** User tier: 'guest' | 'freemium' | 'premium' */
-  tier: 'guest' | 'freemium' | 'premium';
-  /** Whether user has premium access */
-  isPremium: boolean;
-  /** Whether user is a guest */
-  isGuest: boolean;
-  /** Whether user is authenticated */
-  isAuthenticated: boolean;
-  /** User ID (null for guests) */
-  userId: string | null;
-  /** Whether premium status is currently loading */
-  isLoading: boolean;
-  /** Premium status error (if any) */
-  error: string | null;
-  /** Refresh premium status from repository */
-  refresh: () => Promise<void>;
-}
-
-/**
- * Hook that automatically fetches premium status and provides user tier information
- * 
- * This hook eliminates the need for app-specific useUserTier wrappers by:
- * 1. Automatically fetching premium status from repository
- * 2. Handling loading and error states
- * 3. Providing refresh functionality
- * 4. Using centralized tier logic from useUserTier
- */
-export function useUserTierWithRepository(
-  params: UseUserTierWithRepositoryParams,
-): UseUserTierWithRepositoryResult {
-  const { auth, repository } = params;
-  const { user, isGuest, isAuthenticated } = auth;
-
-  const [isPremium, setIsPremium] = useState<boolean>(false);
-  const [isLoading, setIsLoading] = useState<boolean>(true);
-  const [error, setError] = useState<string | null>(null);
-
-  // Fetch premium status from repository
-  const fetchPremiumStatus = useCallback(async (signal?: AbortSignal) => {
-    // Guest users are never premium - no need to fetch
-    if (!isAuthenticated || !user) {
-      setIsPremium(false);
-      setIsLoading(false);
-      setError(null);
-      return;
-    }
-
-    try {
-      setIsLoading(true);
-      setError(null);
-
-      const status = await repository.getSubscriptionStatus(user.uid);
-      
-      // Check if operation was aborted
-      if (signal?.aborted) {
-        return;
-      }
-
-      const isPremiumValue =
-        status !== null && repository.isSubscriptionValid(status);
-
-      // Check again before setting state
-      if (!signal?.aborted) {
-        setIsPremium(isPremiumValue);
-        setIsLoading(false);
-      }
-    } catch (err) {
-      // Don't set state if operation was aborted
-      if (!signal?.aborted) {
-        const errorMessage =
-          err instanceof Error ? err.message : 'Failed to fetch premium status';
-        setError(errorMessage);
-        setIsPremium(false);
-        setIsLoading(false);
-      }
-    }
-  }, [isAuthenticated, user, repository]);
-
-  // Fetch premium status when auth state changes
-  useEffect(() => {
-    const abortController = new AbortController();
-
-    fetchPremiumStatus(abortController.signal).catch(() => {
-      // Error is handled in fetchPremiumStatus
-    });
-
-    return () => {
-      abortController.abort();
-    };
-  }, [fetchPremiumStatus]);
-
-  // Refresh function
-  const refresh = useCallback(async () => {
-    if (!isAuthenticated || !user) {
-      return;
-    }
-    const abortController = new AbortController();
-    try {
-      await fetchPremiumStatus(abortController.signal);
-    } finally {
-      abortController.abort();
-    }
-  }, [isAuthenticated, user, fetchPremiumStatus]);
-
-  // Use base useUserTier hook for tier logic
-  const useUserTierParams: UseUserTierParams = {
-    isGuest: isGuest || !isAuthenticated,
-    userId: user?.uid || null,
-    isPremium,
-    isLoading,
-    error,
-  };
-
-  const tierInfo = useUserTier(useUserTierParams);
-
-  return {
-    ...tierInfo,
-    refresh,
-  };
-}
-