@umituz/react-native-subscription 2.45.2 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.45.2",
+  "version": "3.0.0",
   "description": "Complete subscription management with RevenueCat, paywall UI, and credits system for React Native apps",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -8,6 +8,10 @@
   "exports": {
     ".": "./src/index.ts",
     "./init": "./src/init/index.ts",
+    "./exports/wallet": "./src/exports/wallet.ts",
+    "./exports/onboarding": "./src/exports/onboarding.ts",
+    "./exports/analytics": "./src/exports/analytics.ts",
+    "./exports/experimental": "./src/exports/experimental.ts",
     "./package.json": "./package.json"
   },
   "scripts": {

package/src/exports/analytics.ts

@@ -0,0 +1,53 @@
+/**
+ * SUBSCRIPTION ANALYTICS (Optional)
+ *
+ * Advanced analytics for subscription events and user behavior
+ *
+ * @example
+ * import { SubscriptionAnalytics, useSubscriptionMetrics } from '@umituz/react-native-subscription/exports/analytics';
+ */
+
+// Subscription Analytics Hook
+export { useSubscriptionAnalytics } from '../../presentation/hooks/analytics/useSubscriptionAnalytics';
+export type {
+  SubscriptionAnalyticsData,
+  SubscriptionMetrics,
+  ConversionFunnelData,
+} from '../../presentation/hooks/analytics/useSubscriptionAnalytics.types';
+
+// Paywall Analytics
+export { usePaywallAnalytics } from '../../domains/paywall/hooks/usePaywallAnalytics';
+export type {
+  PaywallAnalyticsData,
+  PaywallImpressionData,
+  PaywallConversionData,
+} from '../../domains/paywall/hooks/usePaywallAnalytics.types';
+
+// Revenue Analytics
+export { useRevenueAnalytics } from '../../domains/subscription/presentation/hooks/useRevenueAnalytics';
+export type {
+  RevenueAnalyticsData,
+  RevenueMetrics,
+  ARPUData,
+  LTVData,
+} from '../../domains/subscription/presentation/hooks/useRevenueAnalytics.types';
+
+// Churn Analytics
+export { useChurnAnalytics } from '../../domains/subscription/presentation/hooks/useChurnAnalytics';
+export type {
+  ChurnAnalyticsData,
+  ChurnRiskData,
+  RetentionData,
+} from '../../domains/subscription/presentation/hooks/useChurnAnalytics.types';
+
+// Analytics Helpers
+export {
+  trackSubscriptionEvent,
+  trackPaywallEvent,
+  trackRevenueEvent,
+} from '../../utils/analyticsHelpers';
+export type {
+  SubscriptionEventType,
+  PaywallEventType,
+  RevenueEventType,
+} from '../../utils/analyticsHelpers.types';

package/src/exports/experimental.ts

@@ -0,0 +1,93 @@
+/**
+ * EXPERIMENTAL Features (Beta)
+ *
+ * Cutting-edge features that may change or be removed
+ * Use at your own risk!
+ *
+ * @example
+ * import { AIUpsell, SmartPaywall } from '@umituz/react-native-subscription/exports/experimental';
+ */
+
+// ============================================================================
+// AI-POWERED FEATURES
+// ============================================================================
+
+// AI-Powered Upsell Recommendations
+export { useAIUpsellRecommendations } from '../../domains/paywall/experimental/useAIUpsellRecommendations';
+export type {
+  AIUpsellData,
+  UpsellRecommendation,
+  UpsellStrategy,
+} from '../../domains/paywall/experimental/useAIUpsellRecommendations.types';
+
+// Smart Paywall (Dynamic pricing based on user behavior)
+export { SmartPaywall } from '../../domains/paywall/experimental/SmartPaywall';
+export type {
+  SmartPaywallProps,
+  SmartPaywallConfig,
+} from '../../domains/paywall/experimental/SmartPaywall.types';
+
+// ============================================================================
+// EXPERIMENTAL COMPONENTS
+// ============================================================================
+
+// Interactive Pricing Tiers
+export { InteractivePricingTiers } from '../../domains/paywall/experimental/InteractivePricingTiers';
+export type {
+  InteractivePricingTiersProps,
+  PricingTierConfig,
+} from '../../domains/paywall/experimental/InteractivePricingTiers.types';
+
+// Gamified Paywall (Rewards for engagement)
+export { GamifiedPaywall } from '../../domains/paywall/experimental/GamifiedPaywall';
+export type {
+  GamifiedPaywallProps,
+  GamificationConfig,
+  RewardConfig,
+} from '../../domains/paywall/experimental/GamifiedPaywall.types';
+
+// ============================================================================
+// EXPERIMENTAL HOOKS
+// ============================================================================
+
+// Predictive Churn Prevention
+export { usePredictiveChurnPrevention } from '../../domains/subscription/presentation/experimental/usePredictiveChurnPrevention';
+export type {
+  ChurnPredictionData,
+  ChurnPreventionAction,
+  InterventionStrategy,
+} from '../../domains/subscription/presentation/experimental/usePredictiveChurnPrevention.types';
+
+// Dynamic Offer Generator
+export { useDynamicOfferGenerator } from '../../domains/paywall/experimental/useDynamicOfferGenerator';
+export type {
+  DynamicOfferData,
+  OfferConfig,
+  OfferStrategy,
+} from '../../domains/paywall/experimental/useDynamicOfferGenerator.types';
+
+// ============================================================================
+// EXPERIMENTAL UTILS
+// ============================================================================
+
+// Behavioral Segmentation
+export {
+  segmentUsersByBehavior,
+  getUserBehaviorScore,
+} from '../../utils/experimental/behavioralSegmentation';
+export type {
+  UserBehavior,
+  BehaviorSegment,
+  BehaviorScore,
+} from '../../utils/experimental/behavioralSegmentation.types';
+
+// Price Optimization
+export {
+  optimizePriceForUser,
+  getOptimalPricePoint,
+} from '../../utils/experimental/priceOptimization';
+export type {
+  PriceOptimizationData,
+  PricePoint,
+  OptimizationStrategy,
+} from '../../utils/experimental/priceOptimization.types';

package/src/exports/onboarding.ts

@@ -0,0 +1,34 @@
+/**
+ * ONBOARDING Helpers (Optional)
+ *
+ * Advanced onboarding utilities for custom flows
+ *
+ * @example
+ * import { OnboardingProgress, useOnboardingAnalytics } from '@umituz/react-native-subscription/exports/onboarding';
+ */
+
+// Onboarding Progress Tracking
+export { useOnboardingProgress } from '../../domains/subscription/presentation/hooks/useOnboardingProgress';
+export type { OnboardingProgressData } from '../../domains/subscription/presentation/hooks/useOnboardingProgress.types';
+
+// Onboarding Analytics
+export { useOnboardingAnalytics } from '../../presentation/hooks/onboarding/useOnboardingAnalytics';
+export type {
+  OnboardingEvent,
+  OnboardingAnalyticsData,
+} from '../../presentation/hooks/onboarding/useOnboardingAnalytics.types';
+
+// Onboarding Completion Helpers
+export { useOnboardingCompletion } from '../../presentation/hooks/onboarding/useOnboardingCompletion';
+export type {
+  OnboardingCompletionData,
+  OnboardingCompletionOptions,
+} from '../../presentation/hooks/onboarding/useOnboardingCompletion.types';
+
+// Onboarding Utils
+export {
+  calculateOnboardingProgress,
+  isOnboardingComplete,
+  getOnboardingStep,
+} from '../../utils/onboardingUtils';
+export type { OnboardingStep } from '../../utils/onboardingUtils.types';

package/src/exports/wallet.ts

@@ -0,0 +1,35 @@
+/**
+ * WALLET Features (Optional)
+ *
+ * Import only if your app needs wallet UI and transaction history
+ *
+ * @example
+ * import { WalletScreen } from '@umituz/react-native-subscription/exports/wallet';
+ */
+
+// Wallet Screen
+export {
+  WalletScreen as WalletScreenContainer,
+} from '../../domains/wallet/presentation/screens/WalletScreen';
+
+export type {
+  WalletScreenProps,
+  WalletScreenTranslations,
+} from '../../domains/wallet/presentation/screens/WalletScreen.types';
+
+// Wallet Hooks
+export { useWallet } from '../../domains/wallet/presentation/hooks/useWallet';
+export type { WalletData } from '../../domains/wallet/presentation/hooks/useWallet';
+
+export { useTransactionHistory } from '../../domains/wallet/presentation/hooks/useTransactionHistory';
+export type { TransactionHistoryResult } from '../../domains/wallet/presentation/hooks/useTransactionHistory';
+
+// Wallet Components
+export { BalanceCard } from '../../domains/wallet/presentation/components/BalanceCard';
+export type { BalanceCardProps } from '../../domains/wallet/presentation/components/BalanceCard.types';
+
+export { TransactionList } from '../../domains/wallet/presentation/components/TransactionList';
+export type { TransactionListProps } from '../../domains/wallet/presentation/components/TransactionList.types';
+
+export { TransactionItem } from '../../domains/wallet/presentation/components/TransactionItem';
+export type { TransactionItemProps } from '../../domains/wallet/presentation/components/TransactionItem.types';

package/src/index.ts

@@ -1,4 +1,14 @@
-// Domain Layer - Constants & Types
+/**
+ * CORE Exports
+ *
+ * Essential subscription & paywall features - all apps need these
+ * No optional features to keep bundle size minimal
+ */
+
+// ============================================================================
+// DOMAIN LAYER - Constants & Types
+// ============================================================================
+
 export {
   USER_TIER,
   SUBSCRIPTION_STATUS,
@@ -27,7 +37,10 @@ export {
 } from "./domains/subscription/core/SubscriptionStatus";
 export type { SubscriptionStatus, StatusResolverInput } from "./domains/subscription/core/SubscriptionStatus";
 
-// Domain Events
+// ============================================================================
+// DOMAIN EVENTS
+// ============================================================================
+
 export { SUBSCRIPTION_EVENTS } from "./domains/subscription/core/events/SubscriptionEvents";
 export type { SubscriptionEventType, SyncStatusChangedEvent } from "./domains/subscription/core/events/SubscriptionEvents";
 export type { PurchaseCompletedEvent, RenewalDetectedEvent, PremiumStatusChangedEvent } from "./domains/subscription/core/SubscriptionEvents";
@@ -38,11 +51,35 @@ export type { SubscriptionMetadata } from "./domains/subscription/core/types/Sub
 export type { PremiumStatus as PremiumStatusMetadata } from "./domains/subscription/core/types/PremiumStatus";
 export type { CreditInfo } from "./domains/subscription/core/types/CreditInfo";
 
-// Application Layer - Ports
+// ============================================================================
+// CREDITS TYPES (Core credits, wallet is separate)
+// ============================================================================
+
+export type {
+  CreditType,
+  UserCredits,
+  CreditsConfig,
+  CreditsResult,
+  DeductCreditsResult,
+} from "./domains/credits/core/Credits";
+
+// ============================================================================
+// PAYWALL TYPES
+// ============================================================================
+
+export type { PaywallTranslations, PaywallLegalUrls, SubscriptionFeature } from "./domains/paywall/entities/types";
+
+// ============================================================================
+// APPLICATION LAYER - Ports
+// ============================================================================
+
 export type { ISubscriptionRepository } from "./shared/application/ports/ISubscriptionRepository";
 export type { IRevenueCatService } from "./shared/application/ports/IRevenueCatService";
 
-// Result Pattern
+// ============================================================================
+// RESULT PATTERN
+// ============================================================================
+
 export {
   success,
   failure,
@@ -54,7 +91,10 @@ export {
 } from "./shared/utils/Result";
 export type { Result, Success, Failure } from "./shared/utils/Result";
 
-// Infrastructure Layer
+// ============================================================================
+// INFRASTRUCTURE LAYER - Core Services (No wallet)
+// ============================================================================
+
 export { initializeSubscription } from "./domains/subscription/application/initializer/SubscriptionInitializer";
 export type { SubscriptionInitConfig, CreditPackageConfig } from "./domains/subscription/application/SubscriptionInitializerTypes";
 
@@ -68,7 +108,10 @@ export {
 
 export { CreditLimitService, calculateCreditLimit } from "./domains/credits/domain/services/CreditLimitService";
 
-// Presentation Layer - Hooks
+// ============================================================================
+// PRESENTATION LAYER - Hooks (Core)
+// ============================================================================
+
 export { useAuthAwarePurchase } from "./domains/subscription/presentation/useAuthAwarePurchase";
 export { useCredits } from "./domains/credits/presentation/useCredits";
 export { useDeductCredit } from "./domains/credits/presentation/deduct-credit/useDeductCredit";
@@ -77,74 +120,96 @@ export { usePaywallVisibility, paywallControl } from "./domains/subscription/pre
 export { usePremiumStatus } from "./domains/subscription/presentation/usePremiumStatus";
 export { usePremiumPackages } from "./domains/subscription/presentation/usePremiumPackages";
 export { usePremiumActions } from "./domains/subscription/presentation/usePremiumActions";
-export type { PremiumStatus } from "./domains/subscription/presentation/usePremiumStatus";
-export type { PremiumPackages } from "./domains/subscription/presentation/usePremiumPackages";
-export type { PremiumActions } from "./domains/subscription/presentation/usePremiumActions";
 export { useSubscriptionFlowStore } from "./domains/subscription/presentation/useSubscriptionFlow";
 export type { SubscriptionFlowState, SubscriptionFlowActions, SubscriptionFlowStore } from "./domains/subscription/presentation/useSubscriptionFlow";
 export { useSubscriptionStatus } from "./domains/subscription/presentation/useSubscriptionStatus";
 export type { SubscriptionStatusResult } from "./domains/subscription/presentation/useSubscriptionStatus.types";
+
+export type { PremiumStatus } from "./domains/subscription/presentation/usePremiumStatus";
+export type { PremiumPackages } from "./domains/subscription/presentation/usePremiumPackages";
+export type { PremiumActions } from "./domains/subscription/presentation/usePremiumActions";
+
 export { usePaywallFeedback } from "./presentation/hooks/feedback/usePaywallFeedback";
 export {
   usePaywallFeedbackSubmit,
   useSettingsFeedbackSubmit,
 } from "./presentation/hooks/feedback/useFeedbackSubmit";
+
 export type {
   UsePaywallFeedbackSubmitOptions,
   SettingsFeedbackData,
   UseSettingsFeedbackSubmitOptions,
 } from "./presentation/hooks/feedback/useFeedbackSubmit";
 
-// Presentation Layer - Components
+// ============================================================================
+// PRESENTATION LAYER - Components (Core - No wallet)
+// ============================================================================
+
 export { PremiumDetailsCard } from "./domains/subscription/presentation/components/details/PremiumDetailsCard";
 export type {
   PremiumDetailsTranslations,
   PremiumDetailsCardProps,
 } from "./domains/subscription/presentation/components/details/PremiumDetailsCardTypes";
+
 export { PremiumStatusBadge } from "./domains/subscription/presentation/components/details/PremiumStatusBadge";
 export type { PremiumStatusBadgeProps } from "./domains/subscription/presentation/components/details/PremiumStatusBadge.types";
+
 export { SubscriptionSection } from "./domains/subscription/presentation/components/sections/SubscriptionSection";
 export type { SubscriptionSectionProps } from "./domains/subscription/presentation/components/sections/SubscriptionSection.types";
+
 export { PaywallFeedbackScreen } from "./domains/subscription/presentation/components/feedback/PaywallFeedbackScreen";
 export type { PaywallFeedbackScreenProps } from "./domains/subscription/presentation/components/feedback/PaywallFeedbackScreen.types";
+
 export type {
   SubscriptionDetailConfig,
   SubscriptionDetailTranslations,
   SubscriptionDisplayFlags,
   UpgradePromptConfig,
 } from "./domains/subscription/presentation/screens/SubscriptionDetailScreen.types";
+
 export { SubscriptionDetailScreen } from "./domains/subscription/presentation/screens/SubscriptionDetailScreen";
 export type { SubscriptionDetailScreenProps } from "./domains/subscription/presentation/screens/SubscriptionDetailScreen.types";
+
 export { PaywallScreen } from "./domains/paywall/components/PaywallScreen";
 export type { PaywallScreenProps } from "./domains/paywall/components/PaywallScreen.types";
+
 export { usePaywallOrchestrator } from "./domains/paywall/hooks/usePaywallOrchestrator";
 export type { PaywallOrchestratorOptions } from "./domains/paywall/hooks/usePaywallOrchestrator";
 
-export type {
-  CreditType,
-  UserCredits,
-  CreditsConfig,
-  CreditsResult,
-  DeductCreditsResult,
-} from "./domains/credits/core/Credits";
+// ============================================================================
+// ROOT FLOW COMPONENTS
+// ============================================================================
+
+export { ManagedSubscriptionFlow } from "./domains/subscription/presentation/components/ManagedSubscriptionFlow";
+export type { ManagedSubscriptionFlowProps } from "./domains/subscription/presentation/components/ManagedSubscriptionFlow";
+export { SubscriptionFlowStatus } from "./domains/subscription/presentation/useSubscriptionFlow";
+export { SubscriptionFlowProvider, useSubscriptionFlowStatus } from "./domains/subscription/presentation/providers/SubscriptionFlowProvider";
+
+// ============================================================================
+// UTILS (Core)
+// ============================================================================
 
-// Utils
 export {
   getCreditAllocation,
   createCreditAmountsFromPackages,
 } from "./utils/creditMapper";
+
 export {
   isCreditPackage,
   detectPackageType,
 } from "./utils/packageTypeDetector";
 export type { SubscriptionPackageType } from "./utils/packageTypeDetector";
+
 export {
   formatPrice,
   getBillingPeriodSuffix,
   formatPriceWithPeriod,
 } from "./utils/priceUtils";
+
 export type { UserTierInfo, PremiumStatusFetcher } from "./utils/types";
+
 export type { DateLike } from "./utils/dateUtils.core";
+
 export {
   isNow,
   isPast,
@@ -154,47 +219,38 @@ export {
   formatISO,
   now,
 } from "./utils/dateUtils.core";
+
 export {
   daysBetween,
   daysUntil,
   isSameDay,
   isToday,
 } from "./utils/dateUtils.compare";
+
 export {
   formatRelative,
   formatShort,
   formatLong,
 } from "./utils/dateUtils.format";
+
 export {
   addDays,
   addMonths,
   addYears,
 } from "./utils/dateUtils.math";
+
 export { getAppVersion, validatePlatform } from "./utils/appUtils";
+
 export { toDate, toISOString, toTimestamp, getCurrentISOString } from "./shared/utils/dateConverter";
 
-// Paywall Types & Utils
-export type { PaywallTranslations, PaywallLegalUrls, SubscriptionFeature } from "./domains/paywall/entities/types";
 export { createPaywallTranslations, createFeedbackTranslations } from "./domains/paywall/utils/paywallTranslationUtils";
 
-// Root Flow Components
-export { ManagedSubscriptionFlow } from "./domains/subscription/presentation/components/ManagedSubscriptionFlow";
-export type { ManagedSubscriptionFlowProps } from "./domains/subscription/presentation/components/ManagedSubscriptionFlow";
-export { SubscriptionFlowStatus } from "./domains/subscription/presentation/useSubscriptionFlow";
-export { SubscriptionFlowProvider, useSubscriptionFlowStatus } from "./domains/subscription/presentation/providers/SubscriptionFlowProvider";
+// ============================================================================
+// INIT MODULE
+// ============================================================================
 
-// Init Module Factory
 export {
   createSubscriptionInitModule,
   cleanupSubscriptionModule,
   type SubscriptionInitModuleConfig,
 } from './init';
-
-// Wallet Domain
-export {
-  WalletScreen as WalletScreenContainer,
-} from './domains/wallet/presentation/screens/WalletScreen';
-export type {
-  WalletScreenProps,
-  WalletScreenTranslations,
-} from './domains/wallet/presentation/screens/WalletScreen.types';