@umituz/react-native-subscription 2.26.14 → 2.26.16

package/src/presentation/hooks/useSubscription.ts

@@ -1,119 +0,0 @@
-/**
- * useSubscription Hook
- * React hook for subscription management
- */
-
-import { useState, useCallback } from 'react';
-import type { SubscriptionStatus } from '../../domain/entities/SubscriptionStatus';
-import { isSubscriptionValid } from '../../domain/entities/SubscriptionStatus';
-import {
-  checkSubscriptionService,
-  validateUserId,
-  executeSubscriptionOperation,
-} from './useSubscription.utils';
-
-export interface UseSubscriptionResult {
-  /** Current subscription status */
-  status: SubscriptionStatus | null;
-  /** Whether subscription is loading */
-  loading: boolean;
-  /** Error if any */
-  error: string | null;
-  /** Whether user has active subscription */
-  isPremium: boolean;
-  /** Load subscription status */
-  loadStatus: (userId: string) => Promise<void>;
-  /** Refresh subscription status */
-  refreshStatus: (userId: string) => Promise<void>;
-  /** Activate subscription */
-  activateSubscription: (
-    userId: string,
-    productId: string,
-    expiresAt: string | null,
-  ) => Promise<void>;
-  /** Deactivate subscription */
-  deactivateSubscription: (userId: string) => Promise<void>;
-}
-
-/**
- * Hook for subscription operations
- *
- * @example
- * ```typescript
- * const { status, isPremium, loadStatus } = useSubscription();
- * ```
- */
-export function useSubscription(): UseSubscriptionResult {
-  const [status, setStatus] = useState<SubscriptionStatus | null>(null);
-  const [loading, setLoading] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-
-  const performOperation = useCallback(async (
-    userId: string,
-    operation: () => Promise<SubscriptionStatus | null | void>
-  ) => {
-    const errorMsg = validateUserId(userId);
-    if (errorMsg) {
-      setError(errorMsg);
-      return;
-    }
-
-    const check = checkSubscriptionService();
-    if (!check.success) {
-      setError(check.error || "Service error");
-      return;
-    }
-
-    await executeSubscriptionOperation(
-      operation,
-      setLoading,
-      setError,
-      (result) => { if (result) setStatus(result as SubscriptionStatus); }
-    );
-  }, []);
-
-  const loadStatus = useCallback((userId: string) => 
-    performOperation(userId, () => {
-      const { service } = checkSubscriptionService();
-       
-      return service!.getSubscriptionStatus(userId);
-    }), [performOperation]);
-
-  const refreshStatus = loadStatus;
-
-  const activateSubscription = useCallback(
-    (userId: string, productId: string, expiresAt: string | null) => {
-      if (!productId) {
-        setError("Product ID is required");
-        return Promise.resolve();
-      }
-      return performOperation(userId, () => {
-        const { service } = checkSubscriptionService();
-         
-        return service!.activateSubscription(userId, productId, expiresAt).then(res => res ?? undefined);
-      });
-    },
-    [performOperation]
-  );
-
-  const deactivateSubscription = useCallback((userId: string) => 
-    performOperation(userId, () => {
-        const { service } = checkSubscriptionService();
-         
-        return service!.deactivateSubscription(userId).then(res => res ?? undefined);
-    }), [performOperation]);
-
-  const isPremium = isSubscriptionValid(status);
-
-  return {
-    status,
-    loading,
-    error,
-    isPremium,
-    loadStatus,
-    refreshStatus,
-    activateSubscription,
-    deactivateSubscription,
-  };
-}
-

package/src/presentation/hooks/useSubscriptionDetails.md

@@ -1,93 +0,0 @@
-# useSubscriptionDetails Hook
-
-Hook for accessing detailed subscription information including package details.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/hooks/useSubscriptionDetails.ts`
-
-**Type**: Hook
-
-## Strategy
-
-### Detailed Subscription Information
-
-1. **Subscription Status**: Fetch current subscription status object
-2. **Package Details**: Retrieve RevenueCat package information
-3. **Period Detection**: Determine subscription period (monthly/annual/lifetime)
-4. **Price Calculation**: Calculate current price and monthly equivalent
-5. **Feature List**: Extract feature list from package configuration
-6. **Real-time Updates**: Refresh when subscription changes
-
-### Integration Points
-
-- **Subscription Repository**: `src/infrastructure/repositories/SubscriptionRepository.ts`
-- **Package Configuration**: RevenueCat package definitions
-- **useSubscriptionStatus**: For detailed status information
-- **TanStack Query**: For caching and background updates
-
-## Restrictions
-
-### REQUIRED
-
-- **Loading State**: MUST handle loading state
-- **Null Handling**: MUST handle null subscription and package
-- **Error Handling**: MUST handle error state
-- **Price Formatting**: MUST format prices appropriately
-
-### PROHIBITED
-
-- **NEVER** assume subscription exists (check for null)
-- **NEVER** assume package exists (check for null)
-- **DO NOT** use prices without formatting
-- **DO NOT** hardcode feature lists
-
-### CRITICAL SAFETY
-
-- **ALWAYS** check for null subscription and package
-- **MUST** handle loading state before accessing details
-- **ALWAYS** format prices with currency codes
-- **NEVER** trust client-side details for security
-
-## AI Agent Guidelines
-
-### When Implementing Subscription Details
-
-1. **Always** check for null subscription and package
-2. **Always** handle loading state
-3. **Always** format prices properly
-4. **Always** handle all period types (monthly, annual, lifetime)
-5. **Never** use for security decisions without server validation
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Handle loading state
-- [ ] Check subscription for null
-- [ ] Check package for null
-- [ ] Format prices with currency codes
-- [ ] Handle all period types
-- [ ] Display features properly
-- [ ] Test with monthly subscription
-- [ ] Test with annual subscription
-- [ ] Test with lifetime subscription
-- [ ] Test with no subscription
-
-### Common Patterns
-
-1. **Detailed Card**: Display comprehensive subscription information
-2. **Price Comparison**: Show monthly vs annual pricing
-3. **Upgrade Suggestion**: Suggest upgrades based on current plan
-4. **Feature List**: Display included features
-5. **Billing History**: Show subscription history
-6. **Cancellation Flow**: Handle subscription cancellation
-
-## Related Documentation
-
-- **useSubscription**: Basic subscription status
-- **useSubscriptionStatus**: Detailed status
-- **usePremium**: Simple premium check
-- **useSubscriptionPackages**: Available packages
-- **Package Utilities**: `src/utils/README.md`

package/src/presentation/hooks/useSubscriptionDetails.ts

@@ -1,85 +0,0 @@
-import { useMemo } from "react";
-import { 
-  type SubscriptionStatus, 
-  SUBSCRIPTION_STATUS, 
-  type SubscriptionStatusType,
-  isSubscriptionValid,
-  calculateDaysRemaining
-} from "../../domain/entities/SubscriptionStatus";
-import { formatDate } from "../utils/subscriptionDateUtils";
-
-export interface SubscriptionDetails {
-  /** Raw subscription status */
-  status: SubscriptionStatus | null;
-  /** Whether user has active premium */
-  isPremium: boolean;
-  /** Whether subscription is expired */
-  isExpired: boolean;
-  /** Whether this is a lifetime subscription */
-  isLifetime: boolean;
-  /** Days remaining until expiration (null for lifetime) */
-  daysRemaining: number | null;
-  /** Formatted expiration date (null if lifetime) */
-  formattedExpirationDate: string | null;
-  /** Formatted purchase date */
-  formattedPurchaseDate: string | null;
-  /** Status text key for localization */
-  statusKey: SubscriptionStatusType;
-}
-
-interface UseSubscriptionDetailsParams {
-  status: SubscriptionStatus | null;
-}
-
-/**
- * Hook for formatted subscription details
- */
-export function useSubscriptionDetails(
-  params: UseSubscriptionDetailsParams,
-): SubscriptionDetails {
-  const { status } = params;
-
-  return useMemo(() => {
-    if (!status) {
-      return {
-        status: null,
-        isPremium: false,
-        isExpired: false,
-        isLifetime: false,
-        daysRemaining: null,
-        formattedExpirationDate: null,
-        formattedPurchaseDate: null,
-        statusKey: SUBSCRIPTION_STATUS.NONE,
-      };
-    }
-
-    const isValid = isSubscriptionValid(status);
-    const isExpired = status.isPremium && !isValid;
-    const isLifetime = status.isPremium && !status.expiresAt;
-    const daysRemainingValue = calculateDaysRemaining(status.expiresAt ?? null);
-    const isPremium = status.isPremium && isValid;
-
-    let statusKey: SubscriptionStatusType = status.status || SUBSCRIPTION_STATUS.NONE;
-    
-    // Override status key based on current calculation for active/expired
-    if (status.isPremium) {
-      statusKey = isExpired ? SUBSCRIPTION_STATUS.EXPIRED : SUBSCRIPTION_STATUS.ACTIVE;
-    } else if (status.status === SUBSCRIPTION_STATUS.CANCELED) {
-      statusKey = SUBSCRIPTION_STATUS.CANCELED;
-    } else {
-      statusKey = SUBSCRIPTION_STATUS.NONE;
-    }
-
-    return {
-      status,
-      isPremium,
-      isExpired,
-      isLifetime,
-      daysRemaining: daysRemainingValue,
-      formattedExpirationDate: formatDate(status.expiresAt ?? null),
-      formattedPurchaseDate: formatDate(status.purchasedAt ?? null),
-      statusKey,
-    };
-  }, [status]);
-}
-

package/src/presentation/hooks/useSubscriptionGate.md

@@ -1,84 +0,0 @@
-# useSubscriptionGate Hook
-
-Subscription-only feature gating with simple, focused API.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/hooks/useSubscriptionGate.ts`
-
-**Type**: Hook
-
-## Strategy
-
-### Subscription Gating Flow
-
-1. **Subscription Check**: Verify if user has active subscription
-2. **Gate Function**: Provide requireSubscription function for gating
-3. **Action Wrapping**: Wrap actions behind subscription check
-4. **Callback Trigger**: Execute callback when subscription is required
-5. **Boolean Access**: Provide simple hasSubscription boolean for conditional rendering
-
-### Integration Points
-
-- **usePremium**: For subscription status check
-- **Paywall Domain**: For subscription upgrade flow
-- **Feature Gates**: For unified feature access control
-
-## Restrictions
-
-### REQUIRED
-
-- **Subscription Status**: MUST provide hasSubscription parameter
-- **Callback**: MUST implement onSubscriptionRequired callback
-- **Return Check**: SHOULD check return value from requireSubscription
-
-### PROHIBITED
-
-- **NEVER** show protected content without checking hasSubscription
-- **NEVER** use for security decisions without server validation
-- **DO NOT** assume subscription status (always verify)
-
-### CRITICAL SAFETY
-
-- **ALWAYS** verify hasSubscription before allowing access
-- **NEVER** trust client-side state for security
-- **MUST** implement proper upgrade flow
-- **ALWAYS** handle both subscribed and non-subscribed states
-
-## AI Agent Guidelines
-
-### When Implementing Subscription Gates
-
-1. **Always** check hasSubscription before showing protected content
-2. **Always** provide clear upgrade path in callback
-3. **Always** use requireSubscription for action gating
-4. **Never** bypass subscription checks
-5. **Always** test with both subscribed and non-subscribed users
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Provide hasSubscription from usePremium
-- [ ] Implement onSubscriptionRequired callback
-- [ ] Use requireSubscription for action gating
-- [ ] Check hasSubscription for conditional rendering
-- [ ] Test with subscribed user
-- [ ] Test with non-subscribed user
-- [ ] Verify upgrade flow triggers correctly
-
-### Common Patterns
-
-1. **Action Gating**: Use requireSubscription to wrap actions
-2. **Conditional Rendering**: Check hasSubscription for UI
-3. **Button States**: Disable buttons when not subscribed
-4. **Upgrade Prompts**: Show in callback when not subscribed
-
-## Related Documentation
-
-- **usePremium**: Subscription status check
-- **usePremiumGate**: Premium feature gating
-- **useAuthGate**: Auth + subscription gating
-- **useFeatureGate**: Unified feature gating
-- **Paywall Domain**: `src/domains/paywall/README.md`

package/src/presentation/hooks/useSubscriptionGate.ts

@@ -1,67 +0,0 @@
-/**
- * useSubscriptionGate Hook
- *
- * Single responsibility: Subscription/Premium gating
- * Checks if user has active subscription before allowing actions.
- *
- * @example
- * ```typescript
- * const { requireSubscription, hasSubscription } = useSubscriptionGate({
- *   hasSubscription: isPremium,
- *   onSubscriptionRequired: () => showPaywall(),
- * });
- *
- * const handlePremiumAction = () => {
- *   requireSubscription(() => doPremiumThing());
- * };
- * ```
- */
-
-import { useCallback } from "react";
-
-declare const __DEV__: boolean;
-
-export interface UseSubscriptionGateParams {
-  /** Whether user has active subscription */
-  hasSubscription: boolean;
-  /** Callback when subscription is required */
-  onSubscriptionRequired: () => void;
-}
-
-export interface UseSubscriptionGateResult {
-  /** Whether user has active subscription */
-  hasSubscription: boolean;
-  /** Gate action behind subscription - executes if subscribed, else shows paywall */
-  requireSubscription: (action: () => void | Promise<void>) => boolean;
-}
-
-export function useSubscriptionGate(
-  params: UseSubscriptionGateParams
-): UseSubscriptionGateResult {
-  const { hasSubscription, onSubscriptionRequired } = params;
-
-  const requireSubscription = useCallback(
-    (_action: () => void | Promise<void>): boolean => {
-      if (!hasSubscription) {
-        if (__DEV__) {
-           
-          console.log("[useSubscriptionGate] No subscription, showing paywall");
-        }
-        onSubscriptionRequired();
-        return false;
-      }
-
-      if (__DEV__) {
-         
-        console.log("[useSubscriptionGate] Has subscription, proceeding");
-      }
-      return true;
-    },
-    [hasSubscription, onSubscriptionRequired]
-  );
-
-  return {
-    hasSubscription,
-    requireSubscription,
-  };
-}

package/src/presentation/hooks/useSubscriptionStatus.md

@@ -1,94 +0,0 @@
-# useSubscriptionStatus Hook
-
-Hook for accessing detailed subscription status information.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/hooks/useSubscriptionStatus.ts`
-
-**Type**: Hook
-
-## Strategy
-
-### Subscription Status Flow
-
-1. **Status Fetch**: Retrieve current subscription status from repository
-2. **Status Parsing**: Extract tier, active state, expiration info
-3. **Real-time Updates**: Update when subscription changes
-4. **Expiration Tracking**: Calculate days until expiration
-5. **Renewal Status**: Determine if subscription will auto-renew
-6. **Caching**: Cache status for performance (5 min default)
-
-### Integration Points
-
-- **Subscription Repository**: `src/infrastructure/repositories/SubscriptionRepository.ts`
-- **SubscriptionStatus Entity**: `src/domain/entities/README.md`
-- **TanStack Query**: For caching and real-time updates
-- **RevenueCat**: For subscription data source
-
-## Restrictions
-
-### REQUIRED
-
-- **Loading State**: MUST handle loading state
-- **Error Handling**: MUST handle error state
-- **Null Check**: MUST handle null status (guest users)
-- **Expiration**: SHOULD warn users before expiration
-
-### PROHIBITED
-
-- **NEVER** assume status exists (check for null)
-- **NEVER** use for security decisions without server validation
-- **DO NOT** show expiration for lifetime subscriptions
-- **DO NOT** cache beyond configured time
-
-### CRITICAL SAFETY
-
-- **ALWAYS** check if status is null before accessing properties
-- **NEVER** trust client-side status for security
-- **MUST** implement error boundaries
-- **ALWAYS** refresh status when app comes to foreground
-
-## AI Agent Guidelines
-
-### When Displaying Subscription Info
-
-1. **Always** check for null status (guest users)
-2. **Always** handle loading and error states
-3. **Always** show expiration warnings
-4. **Always** display auto-renewal status
-5. **Never** show technical details to end users
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Handle loading state
-- [ ] Handle error state
-- [ ] Check for null status (guest users)
-- [ ] Display subscription tier
-- [ ] Show expiration date
-- [ ] Show days until expiration
-- [ ] Show auto-renewal status
-- [ ] Implement expiration warnings
-- [ ] Test with active subscription
-- [ ] Test with expired subscription
-- [ ] Test with guest user (null status)
-
-### Common Patterns
-
-1. **Status Badge**: Visual indicator of subscription status
-2. **Expiration Countdown**: Days remaining until expiration
-3. **Warning System**: Notify users before expiration
-4. **Detail Card**: Comprehensive subscription information
-5. **Lifecycle Management**: Handle subscription events
-
-## Related Documentation
-
-- **usePremium**: Simple premium status check
-- **useSubscription**: Detailed subscription information
-- **useSubscriptionDetails**: Package and feature details
-- **useUserTier**: Tier information
-- **SubscriptionStatus Entity**: `src/domain/entities/README.md`
-- **Subscription Repository**: `src/infrastructure/repositories/README.md`

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`