@umituz/react-native-subscription 2.27.66 → 2.27.68

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)

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";