@umituz/react-native-subscription 2.27.65 → 2.27.67

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

@@ -1,42 +0,0 @@
-# RevenueCat Domain Entities
-
-## Location
-Core domain entities for RevenueCat integration.
-
-## Strategy
-This directory contains TypeScript type definitions and entities representing RevenueCat concepts like customer info, entitlements, offerings, and packages with proper type safety.
-
-## Restrictions
-
-### REQUIRED
-- Must use TypeScript types for all entities
-- Must maintain type safety
-- Must validate entity data
-- Must provide clear type definitions
-
-### PROHIBITED
-- DO NOT use `any` type for entities
-- DO NOT bypass type checking
-- DO NOT create invalid entity states
-- DO NOT use loose type definitions
-
-### CRITICAL SAFETY
-- All entities MUST be type-safe
-- Entity data MUST be validated
-- Type definitions MUST be clear and specific
-- Entity states MUST be valid
-
-## AI Agent Guidelines
-1. Define clear TypeScript types for all RevenueCat concepts
-2. Maintain strict type safety for all entities
-3. Validate entity data before use
-4. Provide comprehensive type definitions
-5. Document entity properties and relationships
-6. Use type guards for runtime validation
-7. Test entity creation and validation thoroughly
-
-## Related Documentation
-- [RevenueCat Domain](../README.md)
-- [RevenueCat Value Objects](../value-objects/README.md)
-- [RevenueCat Errors](../errors/README.md)
-- [RevenueCat Types](../types/README.md)

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

@@ -1,53 +0,0 @@
-# RevenueCat Domain Errors
-
-Domain-specific errors for RevenueCat operations.
-
-## Location
-
-`src/revenuecat/domain/errors/`
-
-## Strategy
-
-Custom error classes for RevenueCat-specific error conditions, providing typed error handling for purchase, entitlement, configuration, and offering failures.
-
-## Restrictions
-
-### REQUIRED
-
-- MUST use specific error types (not generic errors)
-- MUST include machine-readable error codes
-- MUST include relevant contextual data
-- MUST implement recovery strategies
-- MUST convert errors to user-friendly messages
-- MUST log errors for debugging
-- MUST track errors for analytics
-
-### PROHIBITED
-
-- MUST NOT expose sensitive RevenueCat API keys or tokens
-- MUST NOT leak raw RevenueCat errors to users
-- MUST NOT ignore error conditions
-
-### CRITICAL
-
-- Always implement specific error types
-- Include machine-readable codes for programmatic handling
-- Provide recovery strategies where applicable
-- Convert technical errors to user-friendly messages
-- Log all errors for debugging and monitoring
-
-## AI Agent Guidelines
-
-When working with RevenueCat errors:
-1. Specific Errors - use specific error types
-2. Error Codes - include machine-readable codes
-3. Context - include relevant data in error
-4. Recovery - implement recovery strategies
-5. User Feedback - convert errors to user-friendly messages
-6. Logging - log errors for debugging
-7. Analytics - track errors for monitoring
-
-## Related Documentation
-
-- [RevenueCat Domain](../README.md)
-- [RevenueCat Services](../../infrastructure/services/README.md)

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

@@ -1,41 +0,0 @@
-# RevenueCat Domain Types
-
-## Location
-Type definitions and type utilities for RevenueCat integration.
-
-## Strategy
-This directory contains TypeScript type definitions, type guards, and utility types used throughout the RevenueCat integration for type safety and compile-time checks.
-
-## Restrictions
-
-### REQUIRED
-- Must use type guards for runtime checks
-- Must provide utility types for common operations
-- Must maintain type safety throughout
-- Must use strict TypeScript types
-
-### PROHIBITED
-- DO NOT use `any` type
-- DO NOT bypass type guards
-- DO NOT ignore type safety
-- DO NOT use loose type definitions
-
-### CRITICAL SAFETY
-- All type checks MUST use type guards
-- All types MUST be strictly defined
-- Type assertions MUST be safe
-- Utility types MUST be used appropriately
-
-## AI Agent Guidelines
-1. Use type guards for runtime type checking
-2. Define utility types for common operations
-3. Maintain strict type safety throughout codebase
-4. Provide clear type definitions for all RevenueCat concepts
-5. Use type assertions only when safe
-6. Test type guards thoroughly
-7. Document complex types with comments
-
-## Related Documentation
-- [RevenueCat Domain](../README.md)
-- [RevenueCat Entities](../entities/README.md)
-- [RevenueCat Value Objects](../value-objects/README.md)

package/src/revenuecat/domain/value-objects/README.md

@@ -1,41 +0,0 @@
-# RevenueCat Domain Value Objects
-
-## Location
-Value objects for RevenueCat integration.
-
-## Strategy
-This directory contains value objects - immutable types that represent concepts in the RevenueCat domain with no identity, defined by their attributes rather than identity.
-
-## Restrictions
-
-### REQUIRED
-- Must validate in constructor
-- Must keep value objects immutable
-- Must implement proper equality based on values
-- Must provide locale-aware formatting
-
-### PROHIBITED
-- DO NOT modify value objects after creation
-- DO NOT bypass validation in constructor
-- DO NOT use identity-based equality
-- DO NOT ignore locale in formatting
-
-### CRITICAL SAFETY
-- All value objects MUST be immutable
-- Validation MUST happen in constructor
-- Equality MUST be based on values, not identity
-- Formatting MUST be locale-aware
-
-## AI Agent Guidelines
-1. Never modify value objects after creation
-2. Validate all inputs in constructor with fail-fast
-3. Implement proper equality based on values
-4. Provide locale-aware formatting methods
-5. Return new instances for all operations
-6. Use TypeScript for compile-time type safety
-7. Provide toString/JSON methods if needed for serialization
-
-## Related Documentation
-- [RevenueCat Domain](../README.md)
-- [RevenueCat Entities](../entities/README.md)
-- [RevenueCat Types](../types/README.md)

package/src/revenuecat/index.ts

@@ -1,13 +0,0 @@
-export * from "./domain/errors/RevenueCatError";
-export * from "./domain/value-objects/RevenueCatConfig";
-export * from "./domain/types/RevenueCatTypes";
-export * from "./domain/constants/RevenueCatConstants";
-export * from "./application/ports/IRevenueCatService";
-export * from "./infrastructure/services/RevenueCatService";
-export * from "./infrastructure/managers/SubscriptionManager";
-export * from "./infrastructure/handlers/PackageHandler";
-export * from "./presentation/hooks/useRevenueCat";
-export * from "./presentation/hooks/useCustomerInfo";
-export * from "./presentation/hooks/usePaywallFlow";
-export * from "./presentation/hooks/useSubscriptionQueries";
-export * from "./presentation/hooks/useRevenueCatTrialEligibility";

package/src/revenuecat/infrastructure/handlers/PackageHandler.ts

@@ -1,161 +0,0 @@
-/**
- * Package Handler
- * Handles package operations (fetch, purchase, restore, premium status)
- */
-
-import type { PurchasesPackage, CustomerInfo } from "react-native-purchases";
-import type { IRevenueCatService } from "../../application/ports/IRevenueCatService";
-import { getPremiumEntitlement } from "../../domain/types/RevenueCatTypes";
-
-export interface PremiumStatus {
-  isPremium: boolean;
-  expirationDate: Date | null;
-}
-
-export interface RestoreResultInfo {
-  success: boolean;
-  productId: string | null;
-}
-
-export class PackageHandler {
-  constructor(
-    private service: IRevenueCatService | null,
-    private entitlementId: string
-  ) { }
-
-  setService(service: IRevenueCatService | null): void {
-    this.service = service;
-  }
-
-  async fetchPackages(): Promise<PurchasesPackage[]> {
-    if (__DEV__) {
-      console.log('[DEBUG PackageHandler] fetchPackages called', {
-        hasService: !!this.service,
-        isInitialized: this.service?.isInitialized(),
-      });
-    }
-    if (!this.service?.isInitialized()) {
-      if (__DEV__) {
-        console.log('[DEBUG PackageHandler] Service not initialized, returning empty');
-      }
-      return [];
-    }
-
-    try {
-      const offering = await this.service.fetchOfferings();
-
-      if (__DEV__) {
-        console.log('[DEBUG PackageHandler] fetchOfferings result:', {
-          hasOffering: !!offering,
-          identifier: offering?.identifier,
-          packagesCount: offering?.availablePackages?.length ?? 0,
-          packages: offering?.availablePackages?.map(p => ({
-            identifier: p.identifier,
-            productIdentifier: p.product.identifier,
-            offeringIdentifier: p.offeringIdentifier
-          }))
-        });
-      }
-
-      return offering?.availablePackages ?? [];
-    } catch (error) {
-      if (__DEV__) {
-        console.error('[DEBUG PackageHandler] fetchOfferings failed:', error);
-      }
-      return [];
-    }
-  }
-
-  async purchase(pkg: PurchasesPackage, userId: string): Promise<boolean> {
-    if (__DEV__) {
-      console.log('[DEBUG PackageHandler] purchase() called', {
-        productId: pkg.product.identifier,
-        userId,
-        serviceExists: !!this.service,
-        isInitialized: this.service?.isInitialized(),
-      });
-    }
-
-    if (!this.service?.isInitialized()) {
-      if (__DEV__) {
-        console.log('[DEBUG PackageHandler] Service not initialized', {
-          productId: pkg.product.identifier,
-        });
-      }
-      return false;
-    }
-
-    try {
-      if (__DEV__) {
-        console.log('[DEBUG PackageHandler] Calling service.purchasePackage...');
-      }
-      const result = await this.service.purchasePackage(pkg, userId);
-      if (__DEV__) {
-        console.log('[DEBUG PackageHandler] Purchase result:', {
-          success: result.success,
-          productId: pkg.product.identifier,
-          isPremium: result.isPremium,
-        });
-      }
-      return result.success;
-    } catch (error) {
-      if (__DEV__) {
-        console.error('[DEBUG PackageHandler] Purchase failed:', {
-          error,
-          productId: pkg.product.identifier,
-        });
-      }
-      return false;
-    }
-  }
-
-  async restore(userId: string): Promise<RestoreResultInfo> {
-    if (!this.service?.isInitialized()) {
-      return { success: false, productId: null };
-    }
-
-    try {
-      const result = await this.service.restorePurchases(userId);
-
-      // Extract product ID from active entitlement
-      let productId: string | null = null;
-      if (result.success && result.customerInfo) {
-        const entitlement = getPremiumEntitlement(
-          result.customerInfo,
-          this.entitlementId
-        );
-        if (entitlement) {
-          productId = entitlement.productIdentifier;
-        }
-      }
-
-      return { success: result.success, productId };
-    } catch (error) {
-      if (__DEV__) {
-        console.error('[DEBUG PackageHandler] Restore failed:', {
-          error,
-          userId,
-        });
-      }
-      return { success: false, productId: null };
-    }
-  }
-
-  checkPremiumStatusFromInfo(customerInfo: CustomerInfo): PremiumStatus {
-    const entitlement = getPremiumEntitlement(customerInfo, this.entitlementId);
-
-    if (entitlement) {
-      return {
-        isPremium: true,
-        expirationDate: entitlement.expirationDate
-          ? new Date(entitlement.expirationDate)
-          : null,
-      };
-    }
-
-    return {
-      isPremium: false,
-      expirationDate: null,
-    };
-  }
-}

package/src/revenuecat/infrastructure/managers/SubscriptionManager.ts

@@ -1,165 +0,0 @@
-/**
- * Subscription Manager
- * Facade for subscription operations
- * Coordinates UserIdProvider, InitializationCache, and PackageHandler
- */
-
-import type { PurchasesPackage } from "react-native-purchases";
-import type { RevenueCatConfig } from "../../domain/value-objects/RevenueCatConfig";
-import type { IRevenueCatService } from "../../application/ports/IRevenueCatService";
-import { initializeRevenueCatService, getRevenueCatService } from "../services/RevenueCatService";
-import { UserIdProvider } from "../utils/UserIdProvider";
-import { InitializationCache } from "../utils/InitializationCache";
-import { PackageHandler } from "../handlers/PackageHandler";
-import type { PremiumStatus, RestoreResultInfo } from "../handlers/PackageHandler";
-
-export interface SubscriptionManagerConfig {
-  config: RevenueCatConfig;
-  apiKey: string;
-  getAnonymousUserId?: () => Promise<string>;
-}
-
-class SubscriptionManagerImpl {
-  private managerConfig: SubscriptionManagerConfig | null = null;
-  private serviceInstance: IRevenueCatService | null = null;
-  private userIdProvider = new UserIdProvider();
-  private initCache = new InitializationCache();
-  private packageHandler: PackageHandler | null = null;
-
-  configure(config: SubscriptionManagerConfig): void {
-    this.managerConfig = config;
-    this.packageHandler = new PackageHandler(null, config.config.entitlementIdentifier);
-
-    if (config.getAnonymousUserId) {
-      this.userIdProvider.configure(config.getAnonymousUserId);
-    }
-  }
-
-  private ensureConfigured(): void {
-    if (!this.managerConfig || !this.packageHandler) {
-      throw new Error("SubscriptionManager not configured");
-    }
-  }
-
-  private async performInitialization(userId: string): Promise<boolean> {
-    this.ensureConfigured();
-
-    await initializeRevenueCatService(this.managerConfig!.config);
-    this.serviceInstance = getRevenueCatService();
-
-    if (!this.serviceInstance) {
-      return false;
-    }
-
-    this.packageHandler!.setService(this.serviceInstance);
-
-    const result = await this.serviceInstance.initialize(userId);
-    return result.success;
-  }
-
-  async initialize(userId?: string): Promise<boolean> {
-    this.ensureConfigured();
-
-    const effectiveUserId = userId || (await this.userIdProvider.getOrCreateAnonymousUserId());
-
-    // Atomic check-and-acquire to prevent race conditions
-    const { shouldInit, existingPromise } = this.initCache.tryAcquireInitialization(effectiveUserId);
-
-    if (!shouldInit && existingPromise) {
-      return existingPromise;
-    }
-
-    const promise = this.performInitialization(effectiveUserId);
-    this.initCache.setPromise(promise, effectiveUserId);
-
-    return promise;
-  }
-
-  isConfigured(): boolean {
-    return this.managerConfig !== null && this.packageHandler !== null;
-  }
-
-  isInitialized(): boolean {
-    return this.serviceInstance?.isInitialized() ?? false;
-  }
-
-  isInitializedForUser(userId: string): boolean {
-    return this.serviceInstance?.isInitialized() === true &&
-      this.initCache.getCurrentUserId() === userId;
-  }
-
-  getEntitlementId(): string | null {
-    return this.managerConfig?.config.entitlementIdentifier || null;
-  }
-
-  async getPackages(): Promise<PurchasesPackage[]> {
-    if (__DEV__) {
-      console.log('[DEBUG SubscriptionManager] getPackages called', {
-        isConfigured: this.isConfigured(),
-        isInitialized: this.isInitialized(),
-        hasServiceInstance: !!this.serviceInstance,
-      });
-    }
-    this.ensureConfigured();
-    if (!this.serviceInstance) {
-      this.serviceInstance = getRevenueCatService();
-      this.packageHandler!.setService(this.serviceInstance);
-    }
-    return this.packageHandler!.fetchPackages();
-  }
-
-  async purchasePackage(pkg: PurchasesPackage): Promise<boolean> {
-    if (__DEV__) {
-      console.log('[DEBUG SubscriptionManager] purchasePackage called', {
-        productId: pkg.product.identifier,
-        isConfigured: this.isConfigured(),
-        isInitialized: this.isInitialized(),
-      });
-    }
-    this.ensureConfigured();
-    const userId = this.initCache.getCurrentUserId();
-    if (__DEV__) {
-      console.log('[DEBUG SubscriptionManager] userId from cache:', userId);
-    }
-    if (!userId) {
-      if (__DEV__) {
-        console.log('[DEBUG SubscriptionManager] No userId, returning false');
-      }
-      return false;
-    }
-    return this.packageHandler!.purchase(pkg, userId);
-  }
-
-  async restore(): Promise<RestoreResultInfo> {
-    this.ensureConfigured();
-    const userId = this.initCache.getCurrentUserId();
-    if (!userId) return { success: false, productId: null };
-    return this.packageHandler!.restore(userId);
-  }
-
-  async checkPremiumStatus(): Promise<PremiumStatus> {
-    this.ensureConfigured();
-    const userId = this.initCache.getCurrentUserId();
-    if (!userId) return { isPremium: false, expirationDate: null };
-
-    const customerInfo = await this.serviceInstance?.getCustomerInfo();
-    if (customerInfo) {
-      return this.packageHandler!.checkPremiumStatusFromInfo(customerInfo);
-    }
-
-    return { isPremium: false, expirationDate: null };
-  }
-
-  async reset(): Promise<void> {
-    if (this.serviceInstance) {
-      await this.serviceInstance.reset();
-    }
-    this.initCache.reset();
-    this.userIdProvider.reset();
-    this.serviceInstance = null;
-  }
-}
-
-export const SubscriptionManager = new SubscriptionManagerImpl();
-
-export type { PremiumStatus };

package/src/revenuecat/presentation/README.md

@@ -1,42 +0,0 @@
-# RevenueCat Presentation
-
-## Location
-Presentation layer for RevenueCat integration.
-
-## Strategy
-This directory contains React hooks, components, and utilities for integrating RevenueCat functionality into the UI layer with proper loading states, error handling, and caching.
-
-## Restrictions
-
-### REQUIRED
-- Must show loading states during async operations
-- Must handle and display errors appropriately
-- Must cache customer info and offerings
-- Must re-render on entitlement changes
-
-### PROHIBITED
-- DO NOT skip loading states
-- DO NOT show technical errors to users
-- DO NOT ignore cache invalidation
-- DO NOT prevent re-renders on state changes
-
-### CRITICAL SAFETY
-- All async operations MUST show loading states
-- All errors MUST be handled and displayed appropriately
-- Data MUST be cached appropriately
-- UI MUST re-render on entitlement changes
-
-## AI Agent Guidelines
-1. Always show loading states during async operations
-2. Handle and display errors appropriately to users
-3. Update UI optimistically where possible
-4. Cache customer info and offerings appropriately
-5. Re-render on entitlement changes
-6. Provide clear feedback during purchases
-7. Validate data before displaying to users
-
-## Related Documentation
-- [RevenueCat Integration](../README.md)
-- [RevenueCat Application](../application/README.md)
-- [RevenueCat Infrastructure](../infrastructure/README.md)
-- [RevenueCat Domain](../domain/README.md)