@umituz/react-native-subscription 2.37.39 → 2.37.40

package/src/domains/subscription/infrastructure/hooks/README.md

@@ -1,50 +0,0 @@
-# RevenueCat Presentation Hooks
-
-React hooks for accessing RevenueCat data and operations.
-
-## Location
-
-`src/revenuecat/presentation/hooks/`
-
-## Strategy
-
-React hooks that expose RevenueCat functionality to the presentation layer, providing access to customer info, subscription packages, and offerings.
-
-## Restrictions
-
-### REQUIRED
-
-- MUST handle loading states appropriately
-- MUST handle error states gracefully
-- MUST cache responses when appropriate
-- MUST subscribe to real-time updates when needed
-- MUST validate all data before use
-
-### PROHIBITED
-
-- MUST NOT expose RevenueCat implementation details to components
-- MUST NOT bypass error handling
-- MUST NOT create infinite loops with subscriptions
-- MUST NOT assume data is always available
-
-### CRITICAL
-
-- Always handle loading and error states
-- Unsubscribe from all listeners on unmount
-- Validate all data before using it in components
-- Handle null/undefined states properly
-
-## AI Agent Guidelines
-
-When working with RevenueCat hooks:
-1. Always handle loading and error states
-2. Unsubscribe from listeners on unmount
-3. Validate all data before use
-4. Cache responses appropriately
-5. Handle null/undefined states gracefully
-
-## Related Documentation
-
-- [Main Hooks](../../../presentation/hooks/README.md)
-- [Domain](../../domain/README.md)
-- [Services](../infrastructure/services/README.md)

package/src/domains/subscription/infrastructure/managers/README.md

@@ -1,41 +0,0 @@
-# RevenueCat Infrastructure Managers
-
-## Location
-Manager classes for coordinating RevenueCat operations.
-
-## Strategy
-This directory contains high-level manager classes that coordinate between different RevenueCat services and handle complex operations like SDK configuration and entitlement access.
-
-## Restrictions
-
-### REQUIRED
-- Must coordinate between services properly
-- Must manage SDK configuration correctly
-- Must provide access to entitlement IDs
-- Must handle complex operations safely
-
-### PROHIBITED
-- DO NOT bypass service coordination
-- DO NOT misconfigure SDK
-- DO NOT expose invalid entitlement IDs
-- DO NOT oversimplify complex operations
-
-### CRITICAL SAFETY
-- Service coordination MUST be correct
-- SDK configuration MUST be valid
-- Entitlement access MUST be safe
-- Complex operations MUST be handled properly
-
-## AI Agent Guidelines
-1. Coordinate properly between RevenueCat services
-2. Manage SDK configuration with correct parameters
-3. Provide safe access to entitlement IDs
-4. Handle complex operations with proper error handling
-5. Test coordination logic thoroughly
-6. Document manager responsibilities clearly
-7. Maintain separation of concerns
-
-## Related Documentation
-- [Services](../services/README.md)
-- [Config](../config/README.md)
-- [Domain](../../domain/README.md)

package/src/domains/subscription/infrastructure/services/README.md

@@ -1,42 +0,0 @@
-# RevenueCat Infrastructure Services
-
-## Location
-Service implementations for RevenueCat operations.
-
-## Strategy
-This directory contains concrete implementations of RevenueCat interfaces, providing the actual integration with the RevenueCat SDK using singleton pattern with proper error handling and caching.
-
-## Restrictions
-
-### REQUIRED
-- Must use singleton pattern for service instance
-- Must wrap all service calls in try-catch
-- Must use TypeScript types for all operations
-- Must log all RevenueCat operations
-
-### PROHIBITED
-- DO NOT create multiple service instances
-- DO NOT skip error handling
-- DO NOT bypass type safety
-- DO NOT skip logging operations
-
-### CRITICAL SAFETY
-- Service MUST be configured only once
-- All calls MUST be wrapped in error handling
-- All operations MUST be type-safe
-- All operations MUST be logged
-
-## AI Agent Guidelines
-1. Use singleton pattern for service instance
-2. Wrap all service calls in try-catch blocks
-3. Use TypeScript types for all operations
-4. Log all RevenueCat operations for debugging
-5. Cache customer info and offerings appropriately
-6. Validate parameters before calling SDK
-7. Configure service only once at startup
-8. Use mock implementations for testing
-
-## Related Documentation
-- [RevenueCat Infrastructure](../README.md)
-- [RevenueCat Handlers](../handlers/README.md)
-- [RevenueCat Application Ports](../../application/ports/README.md)

package/src/domains/subscription/infrastructure/utils/README.md

@@ -1,41 +0,0 @@
-# RevenueCat Infrastructure Utils
-
-## Location
-Utility functions for RevenueCat operations.
-
-## Strategy
-This directory contains utility functions for common RevenueCat operations including error mapping, data transformation, validation, and formatting with proper type safety.
-
-## Restrictions
-
-### REQUIRED
-- Must use error mapping for user-facing messages
-- Must ensure types are validated before use
-- Must respect user locale for formatting
-- Must check for null/undefined values
-
-### PROHIBITED
-- DO NOT show SDK errors directly to users
-- DO NOT use data without type validation
-- DO NOT ignore locale settings
-- DO NOT skip null checks
-
-### CRITICAL SAFETY
-- All errors MUST be mapped to domain errors
-- All types MUST be validated before use
-- Locale MUST be respected for formatting
-- Null checks MUST be performed consistently
-
-## AI Agent Guidelines
-1. Always map SDK errors to domain errors for user-facing messages
-2. Ensure type safety by validating types before use
-3. Respect user locale when formatting prices and periods
-4. Always check for null/undefined values before processing
-5. Use debug helpers in development for troubleshooting
-6. Validate all data before processing
-7. Test utility functions with edge cases
-
-## Related Documentation
-- [RevenueCat Infrastructure](../README.md)
-- [RevenueCat Domain Types](../../domain/types/README.md)
-- [RevenueCat Errors](../../domain/errors/README.md)

package/src/domains/subscription/presentation/components/README.md

@@ -1,155 +0,0 @@
-# Presentation Components
-
-React Native UI components for subscription and paywall features.
-
-## Location
-
-**Directory**: `src/presentation/components/`
-
-**Type**: Component Library
-
-## Strategy
-
-### Component Categories
-
-Components are organized by functionality:
-
-1. **Details Components**
-   - CreditRow: Display credit balance and info
-   - DetailRow: Generic detail display row
-   - PremiumStatusBadge: Visual premium indicator
-   - PremiumDetailsCard: Premium subscription details
-
-2. **Feedback Components**
-   - PaywallFeedbackModal: User feedback collection
-   - Alert components: Warning and info displays
-
-3. **Section Components**
-   - SubscriptionSection: Subscription info section
-   - CreditsSection: Credits balance section
-
-4. **Paywall Components**
-   - PaywallModal: Upgrade/purchase modal
-   - Purchase options: Subscription and credit packages
-
-### Design Principles
-
-All components follow these principles:
-- **Reusable**: Composable and configurable
-- **Typed**: Full TypeScript support
-- **Accessible**: WCAG compliant where possible
-- **Testable**: Easy to test in isolation
-- **Themeable**: Support custom styling
-
-### Integration Points
-
-- **React Native**: Core UI framework
-- **Design System**: Shared UI components
-- **Localization**: i18n string support
-- **Theme**: Custom styling support
-
-## Restrictions
-
-### REQUIRED
-
-- **Props Typing**: All components MUST have TypeScript interfaces
-- **Default Props**: MUST provide sensible defaults
-- **Accessibility**: MUST implement accessibility labels
-- **Responsive**: MUST handle different screen sizes
-
-### PROHIBITED
-
-- **NEVER** hardcode colors or sizes (use theme)
-- **NEVER** include business logic in components
-- **DO NOT** make direct API calls
-- **NEVER** hardcode strings (use localization)
-
-### CRITICAL SAFETY
-
-- **ALWAYS** validate props before rendering
-- **ALWAYS** handle loading and error states
-- **NEVER** trust user input for security decisions
-- **MUST** implement proper error boundaries
-- **ALWAYS** sanitize user-provided content
-
-## AI Agent Guidelines
-
-### When Building Components
-
-1. **Always** define TypeScript interfaces for props
-2. **Always** use theme for styling (no hardcoded values)
-3. **Always** implement accessibility labels
-4. **Always** handle loading and error states
-5. **Never** include business logic in components
-
-### Integration Checklist
-
-- [ ] Define TypeScript interface for props
-- [ ] Use theme for all styling
-- [ ] Implement accessibility labels
-- [ ] Handle loading state
-- [ ] Handle error state
-- [ ] Provide sensible defaults
-- [ ] Test with different screen sizes
-- [ ] Test accessibility
-- [ ] Test with various prop combinations
-- [ ] Document component usage
-
-### Common Patterns
-
-1. **Compound Components**: Build complex UIs from simple parts
-2. **Render Props**: Share stateful logic
-3. **Slot Pattern**: Allow content injection
-4. **Control Props**: Make components controlled or uncontrolled
-5. **Asynchronous States**: Handle loading, error, success states
-6. **Responsive Design**: Adapt to different screen sizes
-7. **Theme Integration**: Use design system tokens
-8. **Accessibility First**: Include a11y from the start
-
-## Related Documentation
-
-- **Details Components**: `details/README.md`
-- **Feedback Components**: `feedback/README.md`
-- **Section Components**: `sections/README.md`
-- **Paywall Components**: `paywall/README.md`
-- **Design System**: External design system documentation
-- **Hooks**: `../hooks/README.md`
-
-## Component Examples
-
-### CreditRow
-
-Display user's credit balance with optional actions.
-
-Usage:
-- Set amount prop to number of credits
-- Set isLoading to true during data fetch
-- Provide onPress callback for navigation
-- Component displays credit count and handles tap
-
-### PremiumStatusBadge
-
-Visual indicator for premium subscription status.
-
-Usage:
-- Set isPremium to boolean status
-- Set tier to subscription level (gold, silver, etc.)
-- Component renders styled badge
-
-### PaywallModal
-
-Modal for subscription and credit purchase.
-
-Usage:
-- Set isVisible to boolean for show/hide
-- Provide onClose callback
-- Pass features array for premium features list
-- Modal handles purchase flow
-
-## Directory Structure
-
-The components directory contains:
-- **details/** - Detail display components (CreditRow, DetailRow, PremiumStatusBadge, PremiumDetailsCard)
-- **feedback/** - Feedback and alert components (PaywallFeedbackModal)
-- **sections/** - Section components (SubscriptionSection)
-- **paywall/** - Paywall components (PaywallModal)

package/src/domains/subscription/presentation/components/details/CreditRow.md

@@ -1,92 +0,0 @@
-# CreditRow Component
-
-Row component displaying credit information with amount and label.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/components/details/CreditRow.tsx`
-
-**Type**: Component
-
-## Strategy
-
-### Credit Information Display
-
-1. **Amount Display**: Show credit amount with icon
-2. **Label Display**: Show credit type or source label
-3. **Visual Hierarchy**: Clear separation between amount and label
-4. **Icon Integration**: Display appropriate icon for credit type
-5. **Styling Options**: Support custom styling override
-6. **Compact Layout**: Efficient use of space for list items
-
-### Integration Points
-
-- **useCredits**: For credit balance and transaction data
-- **Icon System**: For credit type icons
-- **List Components**: For credit transaction lists
-- **Settings UI**: For credits section in settings
-
-## Restrictions
-
-### REQUIRED
-
-- **Amount Prop**: MUST provide valid credit amount
-- **Label Prop**: MUST provide descriptive label
-- **Icon Display**: SHOULD display appropriate icon
-- **Null Handling**: MUST handle null or zero values
-
-### PROHIBITED
-
-- **NEVER** display without amount
-- **NEVER** hardcode icon types
-- **DO NOT** use for non-credit data
-- **DO NOT** display negative amounts without clear indication
-
-### CRITICAL SAFETY
-
-- **ALWAYS** validate amount prop
-- **MUST** handle zero or null amounts
-- **ALWAYS** provide clear labels
-- **NEVER** expose raw transaction data
-
-## AI Agent Guidelines
-
-### When Implementing Credit Rows
-
-1. **Always** provide valid amount
-2. **Always** provide clear label
-3. **Always** display appropriate icon
-4. **Always** handle zero amounts
-5. **Never** use for non-credit display
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Provide valid amount prop
-- [ ] Provide clear label prop
-- [ ] Display appropriate icon
-- [ ] Handle zero amounts
-- [ ] Handle null amounts
-- [ ] Apply custom styling if needed
-- [ ] Test with positive amount
-- [ ] Test with zero amount
-- [ ] Test in list context
-- [ ] Test standalone display
-
-### Common Patterns
-
-1. **Transaction List**: Show credit transactions
-2. **Balance Display**: Show current balance
-3. **Allocation Breakdown**: Show credit sources
-4. **History View**: Display transaction history
-5. **Settings Section**: Credits section in settings
-
-## Related Documentation
-
-- **DetailRow**: Generic detail row component
-- **PremiumDetailsCard**: Premium details card
-- **useCredits**: Credits hook
-- **Credits README**: `../../../../domains/wallet/README.md`
-- **Details README**: `./README.md`

package/src/domains/subscription/presentation/components/details/DetailRow.md

@@ -1,91 +0,0 @@
-# DetailRow Component
-
-Simple row component displaying a label-value pair for subscription details.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/components/details/DetailRow.tsx`
-
-**Type**: Component
-
-## Strategy
-
-### Label-Value Display
-
-1. **Label Positioning**: Display label on left side
-2. **Value Positioning**: Display value on right side
-3. **Space Distribution**: Even spacing between label and value
-4. **Highlight Option**: Support highlighting values (e.g., expiration warnings)
-5. **Custom Styling**: Allow style overrides for flexibility
-6. **Consistent Layout**: Maintain consistent vertical spacing
-
-### Integration Points
-
-- **PremiumDetailsCard**: Uses this component internally
-- **SubscriptionSection**: For subscription detail display
-- **Settings Screens**: For settings detail items
-- **List Components**: For detail lists
-
-## Restrictions
-
-### REQUIRED
-
-- **Label Prop**: MUST provide valid label string
-- **Value Prop**: MUST provide valid value string
-- **Spacing**: MUST maintain consistent spacing
-- **Null Handling**: MUST handle null or undefined values
-
-### PROHIBITED
-
-- **NEVER** display without label and value
-- **NEVER** use highlight for non-warning cases
-- **DO NOT** use excessively long labels (affects layout)
-- **DO NOT** mix different data types in same list
-
-### CRITICAL SAFETY
-
-- **ALWAYS** validate label and value props
-- **MUST** handle empty strings
-- **ALWAYS** use highlight sparingly (for warnings only)
-- **NEVER** expose sensitive raw data
-
-## AI Agent Guidelines
-
-### When Implementing Detail Rows
-
-1. **Always** provide clear, concise labels
-2. **Always** format values appropriately
-3. **Always** use highlight only for warnings
-4. **Always** keep labels short and consistent
-5. **Never** display implementation details
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Provide valid label prop
-- [ ] Provide valid value prop
-- [ ] Format values appropriately
-- [ ] Use highlight for warnings only
-- [ ] Apply custom styling if needed
-- [ ] Test with short values
-- [ ] Test with long values
-- [ ] Test with highlight enabled
-- [ ] Test in list context
-- [ ] Test standalone display
-
-### Common Patterns
-
-1. **Subscription Details**: Show subscription info
-2. **Settings Items**: Display settings values
-3. **Status Information**: Show various status types
-4. **Date Display**: Format and show dates
-5. **Compact Lists**: Display multiple details
-
-## Related Documentation
-
-- **PremiumDetailsCard**: Uses this component
-- **CreditRow**: Similar component for credits
-- **SubscriptionSection**: Section containing detail rows
-- **Details README**: `./README.md`

package/src/domains/subscription/presentation/components/details/PremiumDetailsCard.md

@@ -1,93 +0,0 @@
-# PremiumDetailsCard Component
-
-Premium subscription details card component.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/components/details/PremiumDetailsCard.tsx`
-
-**Type**: Component
-
-## Strategy
-
-### Premium Status Card Display
-
-1. **Status Display**: Show premium status with badge
-2. **Detail Rendering**: Display subscription details (expiration, renewal, etc.)
-3. **Action Buttons**: Show manage or upgrade button based on status
-4. **Translation Support**: Support custom translations
-5. **Visual Hierarchy**: Clear structure with header, details, and actions
-6. **Responsive Design**: Adapt to different screen sizes
-
-### Integration Points
-
-- **useSubscriptionStatus**: For subscription status data
-- **DetailRow**: For displaying individual details
-- **PremiumStatusBadge**: For status badge
-- **usePremium**: For premium status check
-- **Navigation**: For button actions
-
-## Restrictions
-
-### REQUIRED
-
-- **Status Prop**: MUST provide valid subscription status object
-- **Callback Handling**: MUST implement button callbacks
-- **Loading State**: MUST handle loading state
-- **Null Handling**: MUST handle null status values
-
-### PROHIBITED
-
-- **NEVER** display without status data
-- **NEVER** hardcode status text (use translations)
-- **DO NOT** show both manage and upgrade buttons
-- **DO NOT** expose sensitive implementation details
-
-### CRITICAL SAFETY
-
-- **ALWAYS** validate status object
-- **MUST** handle loading state
-- **ALWAYS** provide clear button labels
-- **NEVER** trust client-side status for security
-
-## AI Agent Guidelines
-
-### When Implementing Premium Cards
-
-1. **Always** provide valid subscription status
-2. **Always** handle loading state
-3. **Always** implement button callbacks
-4. **Always** use translations for localization
-5. **Never** hardcode status strings
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Provide valid subscription status
-- [ ] Implement onManagePress callback
-- [ ] Implement onUpgradePress callback
-- [ ] Handle loading state
-- [ ] Handle null dates
-- [ ] Provide translations
-- [ ] Test with active premium
-- [ ] Test with expired subscription
-- [ ] Test with free user
-- [ ] Test with lifetime subscription
-
-### Common Patterns
-
-1. **Profile Display**: Show in user profile
-2. **Settings Card**: Display in settings screen
-3. **Status Overview**: Show premium status overview
-4. **With Navigation**: Navigate to management
-5. **Localized Display**: Use with i18n
-
-## Related Documentation
-
-- **PremiumStatusBadge**: Status badge component
-- **DetailRow**: Detail item component
-- **SubscriptionSection**: Subscription section
-- **usePremium**: Premium status hook
-- **Details README**: `./README.md`

package/src/domains/subscription/presentation/components/details/PremiumStatusBadge.md

@@ -1,91 +0,0 @@
-# PremiumStatusBadge Component
-
-Compact badge component displaying premium status.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/components/details/PremiumStatusBadge.tsx`
-
-**Type**: Component
-
-## Strategy
-
-### Status Badge Display
-
-1. **Status Detection**: Display appropriate status (premium/free)
-2. **Visual Indication**: Use color and icon to indicate status
-3. **Compact Design**: Small footprint for various use cases
-4. **Styling Options**: Support different sizes and styles
-5. **Accessibility**: Include accessibility labels
-6. **Color Coding**: Use consistent colors for status types
-
-### Integration Points
-
-- **usePremium**: For premium status check
-- **Headers**: Display in screen headers
-- **Cards**: Add to cards as status indicator
-- **Lists**: Use in list items as badge
-- **Buttons**: Add to buttons for premium features
-
-## Restrictions
-
-### REQUIRED
-
-- **Status Prop**: MUST provide valid status boolean
-- **Accessibility**: MUST include accessibility label
-- **Color Consistency**: MUST use consistent colors
-- **Size Constraint**: SHOULD maintain compact size
-
-### PROHIBITED
-
-- **NEVER** display without status prop
-- **NEVER** use inconsistent colors
-- **DO NOT** make badge too large
-- **DO NOT** use for non-premium status
-
-### CRITICAL SAFETY
-
-- **ALWAYS** validate status prop
-- **MUST** include accessibility support
-- **ALWAYS** use approved color schemes
-- **NEVER** expose implementation logic
-
-## AI Agent Guidelines
-
-### When Implementing Status Badges
-
-1. **Always** provide valid status boolean
-2. **Always** include accessibility label
-3. **Always** use consistent colors
-4. **Always** maintain compact size
-5. **Never** use for non-status indicators
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Provide valid status prop
-- [ ] Include accessibility label
-- [ ] Apply appropriate styling
-- [ ] Test with premium status
-- [ ] Test with free status
-- [ ] Test in different contexts
-- [ ] Verify color consistency
-- [ ] Check accessibility support
-- [ ] Test size constraints
-
-### Common Patterns
-
-1. **Header Badge**: Display in screen headers
-2. **Card Badge**: Add to premium cards
-3. **List Indicator**: Use in list items
-4. **Button Badge**: Add to premium feature buttons
-5. **Profile Badge**: Show in user profile
-
-## Related Documentation
-
-- **PremiumDetailsCard**: Premium status card
-- **DetailRow**: Detail row component
-- **usePremium**: Premium status hook
-- **Details README**: `./README.md`