@umituz/react-native-subscription 2.37.38 → 2.37.40

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`

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

@@ -1,99 +0,0 @@
-# Details Components
-
-UI components for displaying subscription and premium details.
-
-## Location
-
-- **Base Path**: `/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/details/`
-- **Components**: `src/presentation/components/details/`
-
-## Strategy
-
-### Component Architecture
-
-Specialized components for subscription detail display.
-
-- **PremiumDetailsCard**: Premium subscription details card
-- **PremiumStatusBadge**: Status badge display
-- **DetailRow**: Individual detail row component
-- **CreditRow**: Credit balance display component
-
-### Display Components
-
-Structured information display components.
-
-- **Subscription Status**: Active/inactive status display
-- **Expiration Dates**: Date formatting and display
-- **Product Information**: Plan and product details
-- **Credit Balance**: Credit amount display
-
-### Translation Support
-
-Multi-language support for all displayed text.
-
-- **Translation Props**: Optional translation overrides
-- **Default Translations**: Built-in language support
-- **Date Formatting**: Locale-aware date formatting
-- **Currency Formatting**: Locale-aware currency display
-
-### Styling System
-
-Flexible styling and customization.
-
-- **Style Props**: Custom style support
-- **Theme Support**: Theme-aware styling
-- **Responsive Design**: Adaptive layouts
-- **Accessibility**: Accessibility features
-
-## Restrictions
-
-### REQUIRED
-
-- **Loading States**: Show loading indicators while fetching data
-- **Error States**: Handle and display errors appropriately
-- **Translation Support**: Support multiple languages
-- **Accessibility**: Include accessibility labels
-
-### PROHIBITED
-
-- **Hardcoded Text**: All text must support translations
-- **Missing Null Checks**: Handle null/undefined values
-- **Blocking UI**: Never block app flow
-- **Assumed Data**: Never assume data exists
-
-### CRITICAL
-
-- **Data Validation**: Validate all displayed data
-- **Edge Cases**: Handle missing or invalid data
-- **Performance**: Optimize re-renders
-- **User Experience**: Smooth interactions and transitions
-
-## AI Agent Guidelines
-
-### When Modifying Detail Components
-
-1. **Component Props**: Maintain consistent prop interfaces
-2. **Styling**: Preserve responsive design
-3. **Translations**: Ensure translation support
-4. **Testing**: Test with various data states
-
-### When Adding New Detail Components
-
-1. **Pattern Consistency**: Follow existing component patterns
-2. **Type Safety**: Define TypeScript types
-3. **Documentation**: Document props and usage
-4. **Accessibility**: Include accessibility features
-
-### When Fixing Detail Component Bugs
-
-1. **Data Flow**: Check data flow and state
-2. **Edge Cases**: Test with null/undefined
-3. **Rendering**: Verify rendering logic
-4. **Styling**: Check style application
-
-## Related Documentation
-
-- [Presentation Components](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/README.md)
-- [Feedback Components](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/feedback/README.md)
-- [Sections Components](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/sections/README.md)
-- [Paywall Domain](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/domains/paywall/README.md)

package/src/domains/subscription/presentation/components/feedback/PaywallFeedbackModal.md

@@ -1,90 +0,0 @@
-# PaywallFeedbackModal Component
-
-Modal component for collecting user feedback after paywall dismissal.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/components/feedback/PaywallFeedbackModal.tsx`
-
-**Type**: Component
-
-## Strategy
-
-### Feedback Collection Flow
-
-1. **Trigger Display**: Show modal after paywall dismissal
-2. **Feedback Options**: Provide multiple feedback options
-3. **Reason Capture**: Allow users to select reason for not upgrading
-4. **Comment Input**: Optional text input for detailed feedback
-5. **Submission**: Handle feedback submission
-6. **Analytics**: Track feedback for optimization
-
-### Integration Points
-
-- **PaywallModal**: Trigger after paywall close
-- **Analytics Service**: Track feedback responses
-- **Backend API**: Submit feedback to server
-- **usePaywall**: For paywall state management
-
-## Restrictions
-
-### REQUIRED
-
-- **Visible Control**: MUST control visibility via prop
-- **Callback Handling**: MUST implement onFeedbackSubmit callback
-- **Close Handler**: MUST provide close mechanism
-- **Feedback Options**: MUST provide clear feedback options
-
-### PROHIBITED
-
-- **NEVER** show modal automatically (user-triggered only)
-- **NEVER** make feedback mandatory
-- **DO NOT** show too frequently (respect user experience)
-- **DO NOT** require personal information
-
-### CRITICAL SAFETY
-
-- **ALWAYS** make feedback optional
-- **MUST** provide clear close option
-- **ALWAYS** keep feedback anonymous by default
-- **NEVER** collect sensitive information
-
-## AI Agent Guidelines
-
-### When Implementing Feedback Modals
-
-1. **Always** make feedback optional
-2. **Always** provide clear close button
-3. **Always** keep feedback options concise
-4. **Always** handle feedback submission gracefully
-5. **Never** show modal too frequently
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Control visibility via isVisible prop
-- [ ] Implement onFeedbackSubmit callback
-- [ ] Provide onClose callback
-- [ ] Keep feedback options concise (3-5 options)
-- [ ] Make feedback optional
-- [ ] Handle submission errors
-- [ ] Test with various feedback selections
-- [ ] Test close behavior
-- [ ] Verify analytics tracking
-
-### Common Patterns
-
-1. **Post-Paywall**: Show after paywall dismissal
-2. **Anonymous Feedback**: Keep feedback anonymous
-3. **Simple Options**: Provide 3-5 quick options
-4. **Optional Comment**: Allow optional detailed feedback
-5. **Analytics Integration**: Track feedback for insights
-
-## Related Documentation
-
-- **PaywallModal**: Paywall modal component
-- **usePaywall**: Paywall state management
-- **Feedback README**: `./README.md`
-- **Paywall README**: `../paywall/README.md`

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

@@ -1,99 +0,0 @@
-# Feedback Components
-
-UI components for user interaction and feedback collection.
-
-## Location
-
-- **Base Path**: `/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/feedback/`
-- **Components**: `src/presentation/components/feedback/`
-
-## Strategy
-
-### Feedback Collection
-
-User feedback system for paywall and subscription flows.
-
-- **PaywallFeedbackModal**: Paywall experience feedback modal
-- **Rating System**: Optional rating functionality
-- **Text Feedback**: Open text feedback input
-- **Categorization**: Feedback categorization options
-
-### Analytics Integration
-
-Feedback tracking and analytics.
-
-- **Event Tracking**: Feedback submission tracking
-- **User Insights**: Feedback analysis capabilities
-- **Timing Context**: Paywall interaction timing
-- **Reason Categories**: Structured feedback categories
-
-### Modal Architecture
-
-Modal-based feedback collection.
-
-- **Smooth Animations**: Native-feeling transitions
-- **Optional Display**: Non-intrusive feedback requests
-- **Custom Content**: Customizable feedback forms
-- **Context Aware**: Context-aware feedback triggers
-
-### Translation Support
-
-Multi-language feedback interface.
-
-- **Translation Props**: Custom translation support
-- **Placeholder Text**: Localized placeholders
-- **Button Labels**: Localized action buttons
-- **Rating Labels**: Localized rating descriptions
-
-## Restrictions
-
-### REQUIRED
-
-- **Optional Feedback**: Never force feedback submission
-- **Privacy Notice**: Inform users about feedback usage
-- **Analytics Tracking**: Track all feedback submissions
-- **Translation Support**: Support multiple languages
-
-### PROHIBITED
-
-- **Mandatory Feedback**: Feedback must always be optional
-- **Excessive Length**: Keep feedback requests short
-- **Complex UI**: Maintain simple, intuitive interface
-- **Missing Privacy**: Always explain feedback usage
-
-### CRITICAL
-
-- **User Experience**: Non-intrusive feedback requests
-- **Timing**: Show feedback at appropriate times
-- **Actionable Insights**: Collect actionable feedback
-- **Privacy**: Protect user privacy
-
-## AI Agent Guidelines
-
-### When Modifying Feedback Components
-
-1. **User Experience**: Maintain non-intrusive design
-2. **Analytics**: Ensure proper tracking
-3. **Translations**: Support multiple languages
-4. **Privacy**: Maintain privacy standards
-
-### When Adding Feedback Features
-
-1. **Modal Pattern**: Follow existing modal patterns
-2. **Analytics Integration**: Add tracking for new features
-3. **Type Safety**: Define proper TypeScript types
-4. **Documentation**: Document usage and props
-
-### When Fixing Feedback Component Bugs
-
-1. **Modal Logic**: Check modal open/close logic
-2. **Form Handling**: Verify form submission
-3. **Analytics**: Verify analytics tracking
-4. **User Flow**: Test complete feedback flow
-
-## Related Documentation
-
-- [Details Components](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/details/README.md)
-- [Paywall Domain](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/domains/paywall/README.md)
-- [Presentation Components](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/README.md)
-- [RevenueCat Integration](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/revenuecat/README.md)