@umituz/react-native-subscription 2.37.39 → 2.37.41

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)

package/src/domains/subscription/presentation/components/paywall/PaywallModal.md

@@ -1,94 +0,0 @@
-# PaywallModal Component
-
-Modal paywall component for subscription upgrade.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/components/paywall/PaywallModal.tsx`
-
-**Type**: Component
-
-## Strategy
-
-### Paywall Display Flow
-
-1. **Modal Visibility**: Control visibility via isVisible prop
-2. **Configuration**: Display features, pricing, and benefits
-3. **Package Display**: Show available subscription packages
-4. **Purchase Handling**: Handle purchase initiation and completion
-5. **Close Behavior**: Handle modal close/dismissal
-6. **Responsive Design**: Adapt to different screen sizes
-
-### Integration Points
-
-- **usePaywallVisibility**: For modal visibility control
-- **useSubscriptionPackages**: For available packages
-- **usePaywallOperations**: For purchase handling
-- **Analytics**: For tracking impressions and conversions
-- **Navigation**: For post-purchase navigation
-
-## Restrictions
-
-### REQUIRED
-
-- **Visibility Control**: MUST control via isVisible prop
-- **Close Handler**: MUST provide onClose callback
-- **Purchase Handler**: MUST implement onPurchase callback
-- **Package Display**: MUST show available packages
-
-### PROHIBITED
-
-- **NEVER** trap users without close option
-- **NEVER** show without user trigger or clear reason
-- **DO NOT** show too frequently
-- **DO NOT** hide pricing information
-
-### CRITICAL SAFETY
-
-- **ALWAYS** provide clear close button
-- **NEVER** trap users in modal
-- **MUST** handle all purchase outcomes
-- **ALWAYS** show pricing clearly
-
-## AI Agent Guidelines
-
-### When Implementing Paywall Modals
-
-1. **Always** provide clear close button
-2. **Always** show pricing transparently
-3. **Always** handle all purchase outcomes
-4. **Always** track impressions and conversions
-5. **Never** trap users without exit
-
-### Integration Checklist
-
-- [ ] Import from correct path: `@umituz/react-native-subscription`
-- [ ] Control visibility via isVisible prop
-- [ ] Implement onClose callback
-- [ ] Implement onPurchase callback
-- [ ] Configure features and benefits
-- [ ] Display package options
-- [ ] Handle loading states
-- [ ] Track analytics events
-- [ ] Test purchase flow
-- [ ] Test close behavior
-- [ ] Verify responsive design
-
-### Common Patterns
-
-1. **Manual Trigger**: Show on button press
-2. **Usage Limit**: Show after N free uses
-3. **Feature Gate**: Show when accessing premium feature
-4. **Time-based**: Show after certain time/usage
-5. **Event-driven**: Show on specific app events
-6. **A/B Testing**: Test different copy and layouts
-
-## Related Documentation
-
-- **usePaywall**: Paywall state management
-- **usePaywallOperations**: Purchase operations
-- **usePaywallVisibility**: Visibility control
-- **PaywallDomain**: `../../../domains/paywall/README.md`
-- **Paywall README**: `./README.md`

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

@@ -1,54 +0,0 @@
-# Paywall Components
-
-UI components specifically designed for paywall and subscription upgrade screens.
-
-## Location
-
-`src/presentation/components/paywall/`
-
-## Strategy
-
-Specialized components for displaying paywalls, package selection, and subscription upgrade prompts. These components handle the visual presentation of subscription offers and user purchase flows.
-
-## Restrictions
-
-### REQUIRED
-
-- Must use design tokens for consistent styling
-- Must support multiple display modes (card, list, minimal)
-- Must include loading states
-- Must handle accessibility requirements
-- Must support screen readers
-- Must provide proper touch targets
-
-### PROHIBITED
-
-- MUST NOT hardcode pricing or product information
-- MUST NOT bypass payment validation
-- MUST NOT expose RevenueCat implementation details
-- MUST NOT create custom payment flows outside approved patterns
-
-### CRITICAL
-
-- All purchase flows MUST go through RevenueCat
-- Never log or transmit sensitive payment information
-- Always handle errors gracefully with user-friendly messages
-- Must support cancellation and refund flows
-
-## AI Agent Guidelines
-
-When modifying paywall components:
-1. Maintain visual hierarchy for recommended packages
-2. Ensure clear pricing display (price, period, per-month equivalent)
-3. Keep features easy to understand
-4. Include social proof elements (ratings, reviews, user counts)
-5. Add trust signals (guarantees, badges, certifications)
-6. Optimize for mobile screens
-7. Lazy load images and avoid expensive animations
-8. Always support accessibility standards
-
-## Related Documentation
-
-- [Paywall Domain](../../../domains/paywall/README.md)
-- [Paywall Hooks](../../hooks/README.md)
-- [RevenueCat Integration](../../../revenuecat/README.md)

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

@@ -1,99 +0,0 @@
-# Sections Components
-
-Subscription-related section and card components.
-
-## Location
-
-- **Base Path**: `/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/sections/`
-- **Components**: `src/presentation/components/sections/`
-
-## Strategy
-
-### Section Components
-
-Organized sections for subscription information display.
-
-- **SubscriptionSection**: Subscription status and management section
-- **Status Display**: Clear status indicators
-- **Action Buttons**: Management and upgrade actions
-- **Navigation Support**: Deep linking to detail screens
-
-### Display Features
-
-Comprehensive subscription information display.
-
-- **Status Indicators**: Active/inactive status display
-- **Expiration Dates**: Date formatting and display
-- **Management Actions**: Subscription management buttons
-- **Upgrade Options**: Premium upgrade prompts
-
-### Interaction Design
-
-User-friendly interaction patterns.
-
-- **Press Actions**: Navigation to detail screens
-- **Long Press**: Quick management options
-- **Status-Based UI**: Different UI for different subscription states
-- **Refresh Support**: Pull-to-refresh capabilities
-
-### Customization
-
-Flexible styling and behavior.
-
-- **Custom Actions**: Custom action handlers
-- **Style Props**: Custom styling support
-- **Translation Support**: Multi-language support
-- **Conditional Display**: Show/hide elements based on state
-
-## Restrictions
-
-### REQUIRED
-
-- **Status Clarity**: Status must be clearly visible
-- **Action Buttons**: Provide appropriate action buttons
-- **Loading States**: Show loading indicators
-- **Error Handling**: Handle errors gracefully
-
-### PROHIBITED
-
-- **Hardcoded Text**: All text must support translations
-- **Missing Actions**: Never omit necessary actions
-- **Ambiguous Status**: Status must be unambiguous
-- **Blocking UI**: Never block app navigation
-
-### CRITICAL
-
-- **Deep Links**: Include management deep links
-- **State Accuracy**: Display accurate subscription state
-- **User Actions**: Provide clear action options
-- **Platform Links**: Correct platform-specific management links
-
-## AI Agent Guidelines
-
-### When Modifying Section Components
-
-1. **Component Interface**: Maintain consistent prop interfaces
-2. **State Handling**: Proper state management
-3. **Translations**: Ensure translation support
-4. **Accessibility**: Include accessibility features
-
-### When Adding Section Features
-
-1. **Pattern Consistency**: Follow existing patterns
-2. **Type Safety**: Define TypeScript types
-3. **Documentation**: Document props and usage
-4. **Testing**: Test with different subscription states
-
-### When Fixing Section Component Bugs
-
-1. **State Display**: Check state display logic
-2. **Actions**: Verify action handlers
-3. **Navigation**: Test navigation flows
-4. **Edge Cases**: Test with null/undefined states
-
-## Related Documentation
-
-- [Details Components](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/details/README.md)
-- [Feedback Components](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/feedback/README.md)
-- [Presentation Components](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/presentation/components/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/sections/SubscriptionSection.md

@@ -1,94 +0,0 @@
-# SubscriptionSection Component
-
-Section component displaying subscription status with details and actions.
-
-## Location
-
-**Import Path**: `@umituz/react-native-subscription`
-
-**File**: `src/presentation/components/sections/SubscriptionSection.tsx`
-
-**Type**: Component
-
-## Strategy
-
-### Subscription Information Display
-
-1. **Status Detection**: Display current subscription status (active/inactive/free)
-2. **Detail Rendering**: Show expiration date, renewal status, product info
-3. **Action Buttons**: Display manage or upgrade button based on status
-4. **Loading States**: Handle loading and error states gracefully
-5. **Translation Support**: Support custom translations for all text
-6. **Visual Hierarchy**: Clear structure with status badge, details, and actions
-
-### Integration Points
-
-- **useSubscriptionStatus**: For subscription status data
-- **usePremium**: For premium status check
-- **DetailRow**: For displaying individual detail items
-- **PremiumStatusBadge**: For status badge display
-- **Navigation**: For manage/upgrade button actions
-
-## Restrictions
-
-### REQUIRED
-
-- **Config Prop**: MUST provide valid subscription config object
-- **Callback Handling**: MUST implement button callbacks
-- **Loading State**: MUST handle loading state in UI
-- **Null Handling**: MUST handle null status values
-
-### PROHIBITED
-
-- **NEVER** display without config data (show loading instead)
-- **NEVER** hardcode status text (use translations)
-- **DO NOT** show both manage and upgrade buttons simultaneously
-- **DO NOT** show buttons for loading state
-
-### CRITICAL SAFETY
-
-- **ALWAYS** handle loading state before displaying data
-- **MUST** validate config object before rendering
-- **ALWAYS** provide clear button labels
-- **NEVER** expose sensitive implementation details
-
-## AI Agent Guidelines
-
-### When Implementing Subscription Sections
-
-1. **Always** provide valid subscription config
-2. **Always** handle loading state
-3. **Always** implement both 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 config
-- [ ] Implement onUpgradePress callback
-- [ ] Implement onManagePress callback
-- [ ] Handle loading state
-- [ ] Handle null dates
-- [ ] Provide translations for localization
-- [ ] Test with active subscription
-- [ ] Test with expired subscription
-- [ ] Test with free user
-- [ ] Test with lifetime subscription
-
-### Common Patterns
-
-1. **Settings Integration**: Add to settings screen
-2. **Profile Display**: Show in user profile
-3. **Status Card**: Display as standalone card
-4. **With Navigation**: Navigate to detailed management
-5. **Localized Display**: Use with i18n libraries
-6. **Conditional Rendering**: Show/hide based on auth state
-
-## Related Documentation
-
-- **PremiumDetailsCard**: Detailed premium card
-- **DetailRow**: Individual detail item
-- **PremiumStatusBadge**: Status badge component
-- **Subscription Hooks**: `../../hooks/README.md`
-- **Sections README**: `./README.md`

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

@@ -1,31 +0,0 @@
-# Presentation Utils
-
-Utility functions and helpers for the presentation layer.
-
-## Overview
-
-This directory contains utility functions used by presentation components and hooks.
-
-## Contents
-
-- **subscriptionDateUtils.ts** - Date formatting and manipulation for subscription display
-- **paywallUtils.ts** - Paywall-related utility functions
-
-## Date Utilities
-
-### formatDate
-
-Format ISO date string to localized date string.
-
-### calculateDaysRemaining
-
-Calculate days between now and expiration date.
-
-### convertPurchasedAt
-
-Convert purchasedAt date to ISO string.
-
-## Related
-
-- [Hooks](../hooks/README.md)
-- [Types](../types/README.md)