@umituz/react-native-subscription 2.26.13 → 2.26.15

package/src/presentation/hooks/usePremiumWithCredits.ts

@@ -1,48 +0,0 @@
-/**
- * usePremiumWithCredits Hook
- *
- * Combined hook for premium subscription with credits system.
- * Ensures premium users always have credits initialized.
- */
-
-import { useEffect, useCallback } from "react";
-import { useCredits, type UseCreditsResult } from "./useCredits";
-import { useInitializeCredits } from "./useInitializeCredits";
-
-export interface UsePremiumWithCreditsParams {
-  userId: string | undefined;
-  isPremium: boolean;
-}
-
-export interface UsePremiumWithCreditsResult extends UseCreditsResult {
-  ensureCreditsInitialized: () => Promise<void>;
-}
-
-export const usePremiumWithCredits = ({
-  userId,
-  isPremium,
-}: UsePremiumWithCreditsParams): UsePremiumWithCreditsResult => {
-  const creditsResult = useCredits({ userId });
-  const { initializeCredits, isInitializing } = useInitializeCredits({
-    userId,
-  });
-
-  const ensureCreditsInitialized = useCallback(async () => {
-    if (!userId || !isPremium) return;
-    if (creditsResult.credits) return;
-    if (isInitializing) return;
-
-    await initializeCredits();
-  }, [userId, isPremium, creditsResult.credits, isInitializing, initializeCredits]);
-
-  useEffect(() => {
-    if (isPremium && userId && !creditsResult.credits && !creditsResult.isLoading) {
-      ensureCreditsInitialized();
-    }
-  }, [isPremium, userId, creditsResult.credits, creditsResult.isLoading, ensureCreditsInitialized]);
-
-  return {
-    ...creditsResult,
-    ensureCreditsInitialized,
-  };
-};

package/src/presentation/hooks/useSubscription.md

@@ -1,94 +0,0 @@
-# useSubscription Hook
-
-Core hook for subscription status management and operations.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/hooks/useSubscription.ts`
-
-**Type**: Hook
-
-## Strategy
-
-### Subscription Management Flow
-
-1. **Status Retrieval**: Fetch current subscription status from repository
-2. **State Caching**: Cache status for 5 minutes using TanStack Query
-3. **Real-time Updates**: Auto-refresh when user auth state changes
-4. **Manual Operations**: Provide functions for manual activation/deactivation
-5. **Loading States**: Handle loading and error states properly
-6. **Refresh Mechanisms**: Support both load and refresh operations
-
-### Integration Points
-
-- **Subscription Repository**: `src/infrastructure/repositories/SubscriptionRepository.ts`
-- **TanStack Query**: For caching and background updates
-- **Auth Context**: Sync with user authentication state
-- **RevenueCat**: For subscription data source
-
-## Restrictions
-
-### REQUIRED
-
-- **User ID**: MUST provide valid userId for operations
-- **Loading State**: MUST handle loading state in UI
-- **Error Handling**: MUST handle error state
-- **Status Check**: MUST verify isPremium before showing premium features
-
-### PROHIBITED
-
-- **NEVER** assume instant data availability (always check loading state)
-- **NEVER** use for security decisions without server validation
-- **DO NOT** call loadStatus/refreshStatus without userId
-- **DO NOT** activate/deactivate subscriptions without proper validation
-
-### CRITICAL SAFETY
-
-- **ALWAYS** check loading state before accessing status
-- **NEVER** trust client-side state for security enforcement
-- **MUST** validate userId before all operations
-- **ALWAYS** handle errors gracefully
-
-## AI Agent Guidelines
-
-### When Implementing Subscription Features
-
-1. **Always** check loading state before rendering subscription data
-2. **Always** handle error state
-3. **Always** verify isPremium before showing premium features
-4. **Always** validate userId before operations
-5. **Never** use for security decisions without server validation
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Handle loading state
-- [ ] Handle error state
-- [ ] Check isPremium before rendering premium content
-- [ ] Validate userId before operations
-- [ ] Implement refresh mechanism
-- [ ] Test with premium user
-- [ ] Test with free user
-- [ ] Test with guest user
-- [ ] Test offline scenario
-
-### Common Patterns
-
-1. **Status Display**: Show current subscription status
-2. **Conditional Rendering**: Show/hide features based on isPremium
-3. **Manual Refresh**: Provide refresh button for users
-4. **Auto-refresh**: Refresh on screen focus or app foreground
-5. **Status Polling**: Periodic refresh for real-time updates
-6. **Purchase Completion**: Refresh after successful purchase
-7. **Error Recovery**: Provide retry mechanism on failure
-
-## Related Documentation
-
-- **usePremium**: Simplified premium checking
-- **useSubscriptionStatus**: Detailed subscription status
-- **useSubscriptionDetails**: Package and pricing info
-- **useUserTier**: Tier information
-- **Subscription Repository**: `src/infrastructure/repositories/README.md`
-- **Domain Layer**: `src/domain/README.md`

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`