@umituz/react-native-subscription 2.26.13 → 2.26.15

package/src/presentation/hooks/useSubscriptionStatus.ts

@@ -1,64 +0,0 @@
-/**
- * useSubscriptionStatus Hook
- *
- * TanStack Query hook for checking real subscription status from RevenueCat.
- * This provides the actual premium status based on entitlements, not credits.
- */
-
-import { useQuery } from "@umituz/react-native-design-system";
-import { SubscriptionManager } from "../../revenuecat/infrastructure/managers/SubscriptionManager";
-
-export const subscriptionStatusQueryKeys = {
-  all: ["subscriptionStatus"] as const,
-  user: (userId: string) => ["subscriptionStatus", userId] as const,
-};
-
-export interface SubscriptionStatusResult {
-  isPremium: boolean;
-  expirationDate: Date | null;
-  isLoading: boolean;
-  error: Error | null;
-  refetch: () => void;
-}
-
-export interface UseSubscriptionStatusParams {
-  userId: string | undefined;
-  enabled?: boolean;
-}
-
-/**
- * Check real subscription status from RevenueCat
- *
- * @param userId - User ID
- * @param enabled - Whether to enable the query
- * @returns Subscription status with isPremium flag
- */
-export const useSubscriptionStatus = ({
-  userId,
-  enabled = true,
-}: UseSubscriptionStatusParams): SubscriptionStatusResult => {
-  const { data, isLoading, error, refetch } = useQuery({
-    queryKey: subscriptionStatusQueryKeys.user(userId ?? ""),
-    queryFn: async () => {
-      if (!userId) {
-        return { isPremium: false, expirationDate: null };
-      }
-
-      return SubscriptionManager.checkPremiumStatus();
-    },
-    enabled: enabled && !!userId && SubscriptionManager.isInitializedForUser(userId),
-    staleTime: 0, // No cache - always fetch fresh premium status
-    gcTime: 0, // Don't cache - garbage collect immediately
-    refetchOnMount: true,
-    refetchOnWindowFocus: true,
-    refetchOnReconnect: true,
-  });
-
-  return {
-    isPremium: data?.isPremium ?? false,
-    expirationDate: data?.expirationDate ?? null,
-    isLoading,
-    error: error as Error | null,
-    refetch,
-  };
-};

package/src/presentation/hooks/useTrialEligibility.ts

@@ -1,66 +0,0 @@
-/**
- * useTrialEligibility Hook
- * Checks if device is eligible for free trial
- * Uses persistent device ID to prevent trial abuse
- */
-
-import { useState, useEffect, useCallback } from "react";
-import {
-  checkTrialEligibility,
-  getDeviceId,
-} from "../../infrastructure/services/TrialService";
-
-export interface UseTrialEligibilityResult {
-  /** Whether device is eligible for trial */
-  isEligible: boolean;
-  /** Whether eligibility check is in progress */
-  isLoading: boolean;
-  /** Reason why not eligible (if applicable) */
-  reason?: "already_used" | "device_not_found" | "error";
-  /** Device ID used for checking */
-  deviceId: string | null;
-  /** Refresh eligibility status */
-  refresh: () => Promise<void>;
-}
-
-/**
- * Hook to check trial eligibility based on device ID
- * Device ID persists across app reinstalls via Keychain
- */
-export function useTrialEligibility(): UseTrialEligibilityResult {
-  const [isEligible, setIsEligible] = useState(true);
-  const [isLoading, setIsLoading] = useState(true);
-  const [reason, setReason] = useState<"already_used" | "device_not_found" | "error">();
-  const [deviceId, setDeviceId] = useState<string | null>(null);
-
-  const checkEligibility = useCallback(async () => {
-    setIsLoading(true);
-
-    try {
-      const id = await getDeviceId();
-      setDeviceId(id);
-
-      const result = await checkTrialEligibility(id);
-      setIsEligible(result.eligible);
-      setReason(result.reason);
-    } catch {
-      // On error, allow trial (better UX)
-      setIsEligible(true);
-      setReason("error");
-    } finally {
-      setIsLoading(false);
-    }
-  }, []);
-
-  useEffect(() => {
-    checkEligibility();
-  }, [checkEligibility]);
-
-  return {
-    isEligible,
-    isLoading,
-    reason,
-    deviceId,
-    refresh: checkEligibility,
-  };
-}

package/src/presentation/hooks/useUserTier.md

@@ -1,91 +0,0 @@
-# useUserTier Hook
-
-Hook for determining and tracking user tier (guest, free, premium).
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/hooks/useUserTier.ts`
-
-**Type**: Hook
-
-## Strategy
-
-### Tier Determination Flow
-
-1. **Auth State Check**: Determine if user is authenticated
-2. **Subscription Check**: Verify active subscription status
-3. **Tier Assignment**: Assign tier based on auth + subscription
-4. **Real-time Updates**: Update tier when auth or subscription changes
-5. **Caching**: Cache tier status for performance
-6. **Transition Tracking**: Monitor and track tier changes
-
-### Integration Points
-
-- **Auth Context**: User authentication 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
-
-- **Tier Handling**: MUST handle all three tiers (guest, free, premium)
-- **Loading State**: MUST handle loading state
-- **Auth Integration**: MUST sync with authentication state
-- **Guest Support**: MUST support unauthenticated users
-
-### PROHIBITED
-
-- **NEVER** assume user is authenticated (check isGuest)
-- **NEVER** use for security decisions without server validation
-- **DO NOT** hardcode tier values (use hook return values)
-
-### CRITICAL SAFETY
-
-- **ALWAYS** check loading state before using tier values
-- **NEVER** trust client-side tier for security enforcement
-- **MUST** handle tier transitions gracefully
-- **ALWAYS** test with all three tier types
-
-## AI Agent Guidelines
-
-### When Implementing Tier-Based Features
-
-1. **Always** handle loading state before checking tier
-2. **Always** handle all three tiers (guest, free, premium)
-3. **Always** provide upgrade path for free users
-4. **Never** show features to guests that require auth
-5. **Always** track tier changes in analytics
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Handle loading state
-- [ ] Implement logic for guest users
-- [ ] Implement logic for free users
-- [ ] Implement logic for premium users
-- [ ] Provide upgrade prompts for free users
-- [ ] Provide auth prompts for guest users
-- [ ] Test tier transitions (guest → free → premium)
-- [ ] Test tier downgrade (premium → free)
-- [ ] Track tier changes in analytics
-
-### Common Patterns
-
-1. **Conditional Rendering**: Show/hide features based on tier
-2. **Navigation Guards**: Redirect based on tier requirements
-3. **Feature Flags**: Enable features per tier
-4. **Progress Indicators**: Show tier progression
-5. **Upgrade Prompts**: Guide users to higher tiers
-
-## Related Documentation
-
-- **useAuth**: Authentication state
-- **usePremium**: Premium subscription check
-- **useSubscription**: Detailed subscription information
-- **useAuthGate**: Authentication and subscription gating
-- **Domain Entities**: `src/domain/entities/README.md`
-- **User Tier Utils**: `src/utils/README.md`

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,
-  };
-}
-