@umituz/react-native-subscription 2.27.65 → 2.27.67

package/src/infrastructure/services/TrialService.ts

@@ -1,197 +0,0 @@
-/**
- * Trial Service - Device-based trial tracking to prevent abuse
- */
-
-import { doc, getDoc, setDoc, serverTimestamp, arrayUnion } from "firebase/firestore";
-import { getFirestore } from "@umituz/react-native-firebase";
-import { PersistentDeviceIdService } from "@umituz/react-native-design-system";
-import type { TrialEligibilityResult } from "./TrialTypes";
-
-export { TRIAL_CONFIG, type DeviceTrialRecord, type TrialEligibilityResult } from "./TrialTypes";
-
-const DEVICE_TRIALS_COLLECTION = "device_trials";
-
-/** Get persistent device ID */
-export async function getDeviceId(): Promise<string> {
-  return PersistentDeviceIdService.getDeviceId();
-}
-
-/** Check if device is eligible for trial */
-export async function checkTrialEligibility(deviceId?: string): Promise<TrialEligibilityResult> {
-  try {
-    const effectiveDeviceId = deviceId || await getDeviceId();
-    const db = getFirestore();
-
-    if (!db) {
-      if (__DEV__) {
-        console.log("[TrialService] No Firestore instance");
-      }
-      return { eligible: true, deviceId: effectiveDeviceId };
-    }
-
-    const trialRef = doc(db, DEVICE_TRIALS_COLLECTION, effectiveDeviceId);
-    const trialDoc = await getDoc(trialRef);
-
-    if (!trialDoc.exists()) {
-      if (__DEV__) {
-        console.log("[TrialService] No trial record found, eligible");
-      }
-      return { eligible: true, deviceId: effectiveDeviceId };
-    }
-
-    const data = trialDoc.data();
-    const hasUsedTrial = data?.hasUsedTrial === true;
-    const trialInProgress = data?.trialInProgress === true;
-
-    if (__DEV__) {
-      console.log("[TrialService] Trial record found:", {
-        deviceId: effectiveDeviceId.slice(0, 8),
-        hasUsedTrial,
-        trialInProgress,
-      });
-    }
-
-    // Not eligible if trial was already used (converted or ended)
-    // OR if trial is currently in progress
-    if (hasUsedTrial || trialInProgress) {
-      return {
-        eligible: false,
-        reason: "already_used",
-        deviceId: effectiveDeviceId,
-      };
-    }
-
-    return { eligible: true, deviceId: effectiveDeviceId };
-  } catch (error) {
-    if (__DEV__) {
-      console.error("[TrialService] Eligibility check error:", error);
-    }
-    return { eligible: false, reason: "error" };
-  }
-}
-
-/** Record trial start for a device */
-export async function recordTrialStart(userId: string, deviceId?: string): Promise<boolean> {
-  try {
-    const effectiveDeviceId = deviceId || await getDeviceId();
-    const db = getFirestore();
-
-    if (!db) {
-      if (__DEV__) {
-        console.log("[TrialService] No Firestore instance");
-      }
-      return false;
-    }
-
-    const trialRef = doc(db, DEVICE_TRIALS_COLLECTION, effectiveDeviceId);
-
-    await setDoc(
-      trialRef,
-      {
-        deviceId: effectiveDeviceId,
-        trialInProgress: true,
-        trialStartedAt: serverTimestamp(),
-        lastUserId: userId,
-        userIds: arrayUnion(userId),
-        updatedAt: serverTimestamp(),
-      },
-      { merge: true }
-    );
-
-    // Also set createdAt if it's a new record
-    const existingDoc = await getDoc(trialRef);
-    if (!existingDoc.data()?.createdAt) {
-      await setDoc(
-        trialRef,
-        { createdAt: serverTimestamp() },
-        { merge: true }
-      );
-    }
-
-    if (__DEV__) {
-      console.log("[TrialService] Trial recorded:", {
-        deviceId: effectiveDeviceId.slice(0, 8),
-        userId: userId.slice(0, 8),
-      });
-    }
-
-    return true;
-  } catch (error) {
-    if (__DEV__) {
-      console.error("[TrialService] Record trial error:", error);
-    }
-    return false;
-  }
-}
-
-/**
- * Record trial end (cancelled or expired)
- */
-export async function recordTrialEnd(deviceId?: string): Promise<boolean> {
-  try {
-    const effectiveDeviceId = deviceId || await getDeviceId();
-    const db = getFirestore();
-
-    if (!db) return false;
-
-    const trialRef = doc(db, DEVICE_TRIALS_COLLECTION, effectiveDeviceId);
-
-    await setDoc(
-      trialRef,
-      {
-        hasUsedTrial: true,
-        trialInProgress: false,
-        trialEndedAt: serverTimestamp(),
-        updatedAt: serverTimestamp(),
-      },
-      { merge: true }
-    );
-
-    if (__DEV__) {
-      console.log("[TrialService] Trial end recorded - trial now consumed");
-    }
-
-    return true;
-  } catch (error) {
-    if (__DEV__) {
-      console.error("[TrialService] Record trial end error:", error);
-    }
-    return false;
-  }
-}
-
-/**
- * Record trial conversion to paid subscription
- */
-export async function recordTrialConversion(deviceId?: string): Promise<boolean> {
-  try {
-    const effectiveDeviceId = deviceId || await getDeviceId();
-    const db = getFirestore();
-
-    if (!db) return false;
-
-    const trialRef = doc(db, DEVICE_TRIALS_COLLECTION, effectiveDeviceId);
-
-    await setDoc(
-      trialRef,
-      {
-        hasUsedTrial: true,
-        trialInProgress: false,
-        trialConvertedAt: serverTimestamp(),
-        updatedAt: serverTimestamp(),
-      },
-      { merge: true }
-    );
-
-    if (__DEV__) {
-      console.log("[TrialService] Trial conversion recorded - user converted to paid");
-    }
-
-    return true;
-  } catch (error) {
-    if (__DEV__) {
-      console.error("[TrialService] Record conversion error:", error);
-    }
-    return false;
-  }
-}

package/src/infrastructure/services/app-service-helpers.ts

@@ -1,111 +0,0 @@
-/**
- * App Service Helpers
- * Creates ready-to-use service implementations for configureAppServices
- */
-
-import { getCreditsRepository } from "../repositories/CreditsRepositoryProvider";
-import { getRevenueCatService } from "../../revenuecat/infrastructure/services/RevenueCatService";
-import { getPremiumEntitlement } from "../../revenuecat/domain/types/RevenueCatTypes";
-import { creditsQueryKeys } from "../../presentation/hooks/useCredits";
-import { paywallControl } from "../../presentation/hooks/usePaywallVisibility";
-import {
-  getGlobalQueryClient,
-  hasGlobalQueryClient,
-} from "@umituz/react-native-design-system";
-import {
-  useAuthStore,
-  selectUserId,
-} from "@umituz/react-native-auth";
-
-export interface CreditServiceConfig {
-  entitlementId: string;
-}
-
-export interface ICreditService {
-  checkCredits: (cost: number) => Promise<boolean>;
-  deductCredits: (cost: number) => Promise<void>;
-  refundCredits: (amount: number, error?: unknown) => Promise<void>;
-  calculateCost: (capability: string, metadata?: Record<string, unknown>) => number;
-}
-
-export interface IPaywallService {
-  showPaywall: (requiredCredits: number) => void;
-}
-
-const checkPremiumStatus = async (entitlementId: string): Promise<boolean> => {
-  try {
-    const rcService = getRevenueCatService();
-    if (!rcService) return false;
-
-    const customerInfo = await rcService.getCustomerInfo();
-    if (!customerInfo) return false;
-
-    return !!getPremiumEntitlement(customerInfo, entitlementId);
-  } catch {
-    return false;
-  }
-};
-
-/**
- * Creates a credit service implementation
- */
-export function createCreditService(config: CreditServiceConfig): ICreditService {
-  const { entitlementId } = config;
-
-  return {
-    checkCredits: async (cost: number): Promise<boolean> => {
-      const userId = selectUserId(useAuthStore.getState());
-      if (!userId) return false;
-
-      // Premium users bypass credit check
-      if (await checkPremiumStatus(entitlementId)) return true;
-
-      try {
-        const repository = getCreditsRepository();
-        const result = await repository.getCredits(userId);
-        if (!result.success || !result.data) return false;
-        return (result.data.credits ?? 0) >= cost;
-      } catch {
-        return false;
-      }
-    },
-
-    deductCredits: async (cost: number): Promise<void> => {
-      const userId = selectUserId(useAuthStore.getState());
-      if (!userId) return;
-
-      // Premium users don't consume credits
-      if (await checkPremiumStatus(entitlementId)) return;
-
-      try {
-        const repository = getCreditsRepository();
-        await repository.deductCredit(userId, cost);
-
-        if (hasGlobalQueryClient()) {
-          getGlobalQueryClient().invalidateQueries({
-            queryKey: creditsQueryKeys.user(userId),
-          });
-        }
-      } catch (error) {
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.error("[CreditService] Deduct error:", error);
-        }
-      }
-    },
-
-    refundCredits: async (): Promise<void> => {
-      // No-op for now
-    },
-
-    calculateCost: (): number => 1,
-  };
-}
-
-/**
- * Creates a paywall service implementation
- */
-export function createPaywallService(): IPaywallService {
-  return {
-    showPaywall: () => paywallControl.open(),
-  };
-}

package/src/revenuecat/README.md

@@ -1,104 +0,0 @@
-# RevenueCat Integration
-
-Comprehensive integration and API wrapper for subscription management with RevenueCat.
-
-## Location
-
-- **Base Path**: `/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/revenuecat/`
-- **Domain**: `src/revenuecat/domain/`
-- **Infrastructure**: `src/revenuecat/infrastructure/`
-- **Presentation**: `src/revenuecat/presentation/`
-
-## Strategy
-
-### RevenueCat SDK Integration
-
-Seamless RevenueCat SDK initialization and configuration.
-
-- **Automatic Initialization**: SDK startup and configuration
-- **User ID Management**: Auth system integration
-- **Purchase Flow**: Managed purchase operations
-- **Restore Operations**: Purchase restoration support
-- **Error Handling**: RevenueCat error management
-
-### Hook Architecture
-
-React hooks for RevenueCat functionality.
-
-- **useRevenueCat**: Core RevenueCat access
-- **useCustomerInfo**: Subscription information tracking
-- **useInitializeSubscription**: Initialization status monitoring
-- **useSubscriptionPackages**: Package listing and selection
-- **usePaywallFlow**: Complete paywall flow management
-- **useRestorePurchase**: Purchase restoration
-
-### State Management
-
-Customer info and subscription state tracking.
-
-- **Customer Info Tracking**: Real-time subscription updates
-- **Offerings Management**: Package offering configuration
-- **Purchase State**: Purchase operation states
-- **Error States**: Comprehensive error handling
-
-### User ID Synchronization
-
-Auth system integration for user management.
-
-- **Auth Sync**: Automatic user ID synchronization
-- **Login/Logout**: User ID management on auth changes
-- **Anonymous Users**: Anonymous user support
-- **Migration**: User migration support
-
-## Restrictions
-
-### REQUIRED
-
-- **Initialization**: Must initialize before any operations
-- **User ID Sync**: Sync user IDs with auth system
-- **Error Handling**: All operations must handle errors
-- **Loading States**: Show appropriate loading indicators
-
-### PROHIBITED
-
-- **Direct SDK Calls**: Use hooks instead of direct RevenueCat calls
-- **Missing User IDs**: Operations require valid user IDs
-- **Uninitialized Access**: Don't call methods before initialization
-- **Ignoring Errors**: All errors must be handled
-
-### CRITICAL
-
-- **API Key Security**: Never expose API keys in client code
-- **User ID Consistency**: Maintain consistent user IDs
-- **Purchase Validation**: Validate all purchase results
-- **Entitlement Check**: Always verify entitlements
-
-## AI Agent Guidelines
-
-### When Modifying RevenueCat Integration
-
-1. **SDK Version**: Check RevenueCat SDK version compatibility
-2. **Type Definitions**: Update TypeScript types
-3. **Error Handling**: Maintain comprehensive error handling
-4. **Testing**: Test with different subscription states
-
-### When Adding New Hooks
-
-1. **Hook Pattern**: Follow existing hook patterns
-2. **State Management**: Proper state management
-3. **Error Handling**: Comprehensive error handling
-4. **Documentation**: Document hook usage and return values
-
-### When Fixing RevenueCat Bugs
-
-1. **SDK Integration**: Check RevenueCat SDK integration
-2. **State Updates**: Verify state update mechanisms
-3. **User ID**: Verify user ID consistency
-4. **Purchase Flow**: Test complete purchase flows
-
-## Related Documentation
-
-- [Paywall Domain](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/domains/paywall/README.md)
-- [Config Domain](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/domains/config/README.md)
-- [Infrastructure Layer](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/infrastructure/README.md)
-- [Application Layer](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/application/README.md)

package/src/revenuecat/application/README.md

@@ -1,43 +0,0 @@
-# RevenueCat Application Layer
-
-## Location
-Application layer for RevenueCat integration, containing use cases and orchestration logic.
-
-## Strategy
-This directory contains use cases and application-level operations for managing RevenueCat subscriptions and purchases with proper error handling and state synchronization.
-
-## Restrictions
-
-### REQUIRED
-- Must handle RevenueCat errors gracefully
-- Must provide user ID when available
-- Must use entitlements instead of product IDs
-- Must keep local state synchronized
-
-### PROHIBITED
-- DO NOT ignore RevenueCat errors
-- DO NOT skip user ID provision
-- DO NOT use product IDs directly
-- DO NOT allow state desynchronization
-
-### CRITICAL SAFETY
-- All errors MUST be handled gracefully
-- User IDs MUST be provided when available
-- Entitlements MUST be used for flexibility
-- Local state MUST stay synchronized
-
-## AI Agent Guidelines
-1. Always handle RevenueCat errors with proper recovery
-2. Provide user ID when available for better tracking
-3. Use entitlements instead of product IDs for flexibility
-4. Check if offerings are available before purchasing
-5. Validate customer info after purchases
-6. Keep local state synchronized with RevenueCat
-7. Handle network timeouts appropriately
-8. Log all RevenueCat operations for debugging
-
-## Related Documentation
-- [RevenueCat Integration](../README.md)
-- [RevenueCat Domain](../domain/README.md)
-- [RevenueCat Infrastructure](../infrastructure/README.md)
-- [Application Ports](./ports/README.md)

package/src/revenuecat/application/ports/IRevenueCatService.ts

@@ -1,76 +0,0 @@
-/**
- * RevenueCat Service Interface
- * Port for subscription operations
- */
-
-import type { PurchasesPackage, PurchasesOffering, CustomerInfo } from "react-native-purchases";
-
-export interface InitializeResult {
-  success: boolean;
-  offering: PurchasesOffering | null;
-  isPremium: boolean;
-}
-
-export interface PurchaseResult {
-  success: boolean;
-  isPremium: boolean;
-  customerInfo?: CustomerInfo;
-  isConsumable?: boolean;
-  productId?: string;
-}
-
-export interface RestoreResult {
-  success: boolean;
-  isPremium: boolean;
-  customerInfo?: CustomerInfo;
-}
-
-export interface IRevenueCatService {
-  /**
-   * Initialize RevenueCat SDK
-   * @param userId User identifier
-   * @param apiKey Optional API key (auto-resolved if not provided)
-   */
-  initialize(userId: string, apiKey?: string): Promise<InitializeResult>;
-
-  /**
-   * Fetch offerings from RevenueCat
-   */
-  fetchOfferings(): Promise<PurchasesOffering | null>;
-
-  /**
-   * Purchase a package
-   */
-  purchasePackage(pkg: PurchasesPackage, userId: string): Promise<PurchaseResult>;
-
-  /**
-   * Restore purchases
-   */
-  restorePurchases(userId: string): Promise<RestoreResult>;
-
-  /**
-   * Reset RevenueCat SDK (for logout)
-   */
-  reset(): Promise<void>;
-
-  /**
-   * Get current customer info
-   */
-  getCustomerInfo(): Promise<CustomerInfo | null>;
-
-  /**
-   * Get RevenueCat API key for current platform
-   */
-  getRevenueCatKey(): string | null;
-
-  /**
-   * Check if RevenueCat is initialized
-   */
-  isInitialized(): boolean;
-
-  /**
-   * Get current user ID
-   */
-  getCurrentUserId(): string | null;
-}
-

package/src/revenuecat/application/ports/README.md

@@ -1,41 +0,0 @@
-# RevenueCat Application Ports
-
-## Location
-Interface definitions for RevenueCat service layer.
-
-## Strategy
-This directory defines the ports (interfaces) that the RevenueCat infrastructure must implement, following the Dependency Inversion Principle for testability and flexibility.
-
-## Restrictions
-
-### REQUIRED
-- Must define clear interfaces for all operations
-- Must support mocking for testing
-- Must enable implementation swapping
-- Must maintain contracts between layers
-
-### PROHIBITED
-- DO NOT depend on concrete implementations
-- DO NOT create interfaces without clear purpose
-- DO NOT break interface contracts
-- DO NOT couple application to infrastructure
-
-### CRITICAL SAFETY
-- All dependencies MUST be inverted
-- Interfaces MUST be clearly defined
-- Implementations MUST be swappable
-- Contracts MUST be maintained
-
-## AI Agent Guidelines
-1. Define clear interfaces for all RevenueCat operations
-2. Design interfaces for easy mocking in tests
-3. Enable implementation swapping when needed
-4. Keep application layer decoupled from infrastructure
-5. Maintain clear contracts between layers
-6. Document interface behavior thoroughly
-7. Test with mock implementations
-
-## Related Documentation
-- [RevenueCat Application Layer](../README.md)
-- [RevenueCat Infrastructure](../infrastructure/README.md)
-- [RevenueCat Domain](../domain/README.md)

package/src/revenuecat/domain/README.md

@@ -1,48 +0,0 @@
-# RevenueCat Domain
-
-Domain entities and types for RevenueCat integration.
-
-## Location
-
-`src/revenuecat/domain/`
-
-## Strategy
-
-Domain-specific entities representing RevenueCat concepts like entitlements, offerings, and packages, with proper type mapping and validation.
-
-## Restrictions
-
-### REQUIRED
-
-- MUST map RevenueCat types to domain types
-- MUST handle optional properties safely (null safety)
-- MUST validate RevenueCat data
-- MUST format prices and dates consistently
-- MUST use constants for identifiers
-
-### PROHIBITED
-
-- MUST NOT expose RevenueCat implementation details to other layers
-- MUST NOT leak RevenueCat SDK types outside this module
-- MUST NOT assume all properties are present (null safety)
-
-### CRITICAL
-
-- Always validate RevenueCat data before use
-- Handle all optional properties safely
-- Use constants for all identifiers
-- Maintain consistent formatting for prices and dates
-
-## AI Agent Guidelines
-
-When working with RevenueCat domain:
-1. Type Mapping - map RevenueCat types to domain types
-2. Null Safety - handle optional properties safely
-3. Validation - validate RevenueCat data
-4. Formatting - format prices and dates consistently
-5. Constants - use constants for identifiers
-
-## Related Documentation
-
-- [RevenueCat README](../README.md)
-- [Subscription Manager](../../infrastructure/managers/README.md)

package/src/revenuecat/domain/constants/README.md

@@ -1,41 +0,0 @@
-# RevenueCat Domain Constants
-
-## Location
-Constants used throughout the RevenueCat integration.
-
-## Strategy
-This directory contains constant definitions for RevenueCat-specific values including entitlement IDs, error codes, and configuration defaults for maintainability and consistency.
-
-## Restrictions
-
-### REQUIRED
-- Must use constants for all RevenueCat-specific values
-- Must provide clear constant names
-- Must maintain consistency across codebase
-- Must document constant purposes
-
-### PROHIBITED
-- DO NOT use magic strings or numbers
-- DO NOT duplicate constant definitions
-- DO NOT use hardcoded values
-- DO NOT create ambiguous constants
-
-### CRITICAL SAFETY
-- All RevenueCat-specific values MUST use constants
-- Constants MUST be clearly named and documented
-- Constant values MUST be consistent
-- Entitlement IDs MUST match RevenueCat dashboard
-
-## AI Agent Guidelines
-1. Use constants for all RevenueCat-specific values
-2. Provide clear, descriptive constant names
-3. Maintain consistency across the codebase
-4. Document the purpose of each constant
-5. Organize constants by category (entitlements, offerings, errors)
-6. Validate constants match RevenueCat dashboard configuration
-7. Avoid magic strings and numbers throughout code
-
-## Related Documentation
-- [RevenueCat Domain](../README.md)
-- [RevenueCat Errors](../errors/README.md)
-- [RevenueCat Entities](../entities/README.md)