@umituz/react-native-subscription 3.1.9 → 3.1.11

package/src/domains/subscription/presentation/components/ManagedSubscriptionFlow.tsx

@@ -2,77 +2,21 @@
  * ManagedSubscriptionFlow
  *
  * Clean state machine-based flow orchestration.
- * All state components separated to individual files.
+ * State components and logic separated to individual modules.
  */
 
-import React, { useEffect } from "react";
-import type { NavigationProp } from "@react-navigation/native";
-import type { ImageSourcePropType } from "react-native";
+import React from "react";
 import { useAppDesignTokens } from "@umituz/react-native-design-system/theme";
 import { usePremiumStatus } from "../../presentation/usePremiumStatus";
 import { usePremiumPackages } from "../../presentation/usePremiumPackages";
 import { usePremiumActions } from "../../presentation/usePremiumActions";
 import { useSubscriptionFlowStore, SubscriptionFlowStatus } from "../useSubscriptionFlow";
-import type { PaywallFeedbackTranslations } from "./feedback/PaywallFeedbackScreen.types";
-import type { PaywallTranslations, PaywallLegalUrls, SubscriptionFeature } from "../../../paywall/entities/types";
-import {
-  InitializingState,
-  OnboardingState,
-  PaywallState,
-  ReadyState,
-} from "./ManagedSubscriptionFlow.states";
-
-export interface ManagedSubscriptionFlowProps {
-  children: React.ReactNode;
-  navigation: NavigationProp<any>;
-  islocalizationReady: boolean;
-
-  // Splash Configuration
-  splash?: {
-    appName: string;
-    tagline: string;
-    duration?: number;
-  };
-
-  // Onboarding Configuration
-  onboarding: {
-    slides: any[];
-    translations: {
-      nextButton: string;
-      getStartedButton: string;
-      of: string;
-    };
-    themeColors: any;
-    showSkipButton?: boolean;
-    showBackButton?: boolean;
-    showProgressBar?: boolean;
-  };
-
-  // Paywall Configuration
-  paywall: {
-    translations: PaywallTranslations;
-    features: SubscriptionFeature[];
-    legalUrls: PaywallLegalUrls;
-    heroImage: ImageSourcePropType;
-    bestValueIdentifier?: string;
-    creditsLabel?: string;
-  };
-
-  // Feedback Configuration
-  feedback: {
-    translations: PaywallFeedbackTranslations;
-    onSubmit?: (data: { reason: string; otherText?: string }) => void | Promise<void>;
-  };
-
-  // Offline Configuration (optional)
-  offline?: {
-    isOffline: boolean;
-    message: string;
-    backgroundColor?: string;
-    position?: "top" | "bottom";
-  };
-}
-
+import { useStateTransitions } from "./ManagedSubscriptionFlow.logic";
+import type { ManagedSubscriptionFlowProps } from "./ManagedSubscriptionFlow.types";
+import { InitializingState } from "./states/InitializingState";
+import { OnboardingState } from "./states/OnboardingState";
+import { PaywallState } from "./states/PaywallState";
+import { ReadyState } from "./states/ReadyState";
 import {
   SubscriptionFlowProvider,
   useSubscriptionFlowStatus
@@ -97,35 +41,17 @@ const ManagedSubscriptionFlowInner: React.FC<ManagedSubscriptionFlowProps> = ({
 
   // Store actions
   const completeOnboarding = useSubscriptionFlowStore((s) => s.completeOnboarding);
-  const showPaywall = useSubscriptionFlowStore((s) => s.showPaywall);
   const completePaywall = useSubscriptionFlowStore((s) => s.completePaywall);
   const hideFeedback = useSubscriptionFlowStore((s) => s.hideFeedback);
-  const showFeedbackScreen = useSubscriptionFlowStore((s) => s.showFeedbackScreen);
   const showFeedback = useSubscriptionFlowStore((s) => s.showFeedback);
 
-  // ========================================================================
-  // STATE TRANSITIONS
-  // ========================================================================
-
-  useEffect(() => {
-    if (status === SubscriptionFlowStatus.CHECK_PREMIUM && !isSyncing) {
-      const paywallShown = useSubscriptionFlowStore.getState().paywallShown;
-
-      if (isPremium) {
-        completePaywall(true);
-      } else if (!paywallShown) {
-        showPaywall();
-      } else {
-        completePaywall(false);
-      }
-    }
-  }, [status, isPremium, isSyncing, showPaywall, completePaywall]);
-
-  useEffect(() => {
-    if (status === SubscriptionFlowStatus.READY && showFeedback) {
-      showFeedbackScreen();
-    }
-  }, [status, showFeedback, showFeedbackScreen]);
+  // State transitions
+  useStateTransitions({
+    status,
+    isPremium,
+    isSyncing,
+    showFeedback,
+  });
 
   // ========================================================================
   // RENDER BY STATE

package/src/domains/subscription/presentation/components/ManagedSubscriptionFlow.types.ts

@@ -0,0 +1,59 @@
+/**
+ * ManagedSubscriptionFlow Types
+ */
+
+import type { NavigationProp } from "@react-navigation/native";
+import type { ImageSourcePropType } from "react-native";
+import type { PaywallFeedbackTranslations } from "./feedback/PaywallFeedbackScreen.types";
+import type { PaywallTranslations, PaywallLegalUrls, SubscriptionFeature } from "../../../paywall/entities/types";
+
+export interface ManagedSubscriptionFlowProps {
+  children: React.ReactNode;
+  navigation: NavigationProp<any>;
+  islocalizationReady: boolean;
+
+  // Splash Configuration
+  splash?: {
+    appName: string;
+    tagline: string;
+    duration?: number;
+  };
+
+  // Onboarding Configuration
+  onboarding: {
+    slides: any[];
+    translations: {
+      nextButton: string;
+      getStartedButton: string;
+      of: string;
+    };
+    themeColors: any;
+    showSkipButton?: boolean;
+    showBackButton?: boolean;
+    showProgressBar?: boolean;
+  };
+
+  // Paywall Configuration
+  paywall: {
+    translations: PaywallTranslations;
+    features: SubscriptionFeature[];
+    legalUrls: PaywallLegalUrls;
+    heroImage: ImageSourcePropType;
+    bestValueIdentifier?: string;
+    creditsLabel?: string;
+  };
+
+  // Feedback Configuration
+  feedback: {
+    translations: PaywallFeedbackTranslations;
+    onSubmit?: (data: { reason: string; otherText?: string }) => void | Promise<void>;
+  };
+
+  // Offline Configuration (optional)
+  offline?: {
+    isOffline: boolean;
+    message: string;
+    backgroundColor?: string;
+    position?: "top" | "bottom";
+  };
+}

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

@@ -55,6 +55,15 @@ export const CreditRow: React.FC<CreditRowProps> = React.memo(({
       )}
     </View>
   );
+}, (prevProps, nextProps) => {
+  // PERFORMANCE: Custom comparison to prevent unnecessary re-renders
+  // Only re-render if these values actually change
+  return (
+    prevProps.label === nextProps.label &&
+    prevProps.current === nextProps.current &&
+    prevProps.total === nextProps.total &&
+    prevProps.remainingLabel === nextProps.remainingLabel
+  );
 });
 
 const styles = StyleSheet.create({

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

@@ -68,4 +68,27 @@ export const PremiumDetailsCard: React.FC<PremiumDetailsCardProps> = React.memo(
       />
     </View>
   );
+}, (prevProps, nextProps) => {
+  // PERFORMANCE: Custom comparison to prevent unnecessary re-renders
+  // Deep comparison for credits array since it's frequently updated
+  const creditsEqual = prevProps.credits === nextProps.credits ||
+    (prevProps.credits?.length === nextProps.credits?.length &&
+      prevProps.credits?.every((credit, i) =>
+        credit.id === nextProps.credits?.[i]?.id &&
+        credit.current === nextProps.credits?.[i]?.current &&
+        credit.total === nextProps.credits?.[i]?.total &&
+        credit.label === nextProps.credits?.[i]?.label
+      ));
+
+  return (
+    prevProps.statusType === nextProps.statusType &&
+    prevProps.isPremium === nextProps.isPremium &&
+    prevProps.expirationDate === nextProps.expirationDate &&
+    prevProps.purchaseDate === nextProps.purchaseDate &&
+    prevProps.daysRemaining === nextProps.daysRemaining &&
+    creditsEqual &&
+    prevProps.translations === nextProps.translations &&
+    prevProps.onManageSubscription === nextProps.onManageSubscription &&
+    prevProps.onUpgrade === nextProps.onUpgrade
+  );
 });

package/src/domains/subscription/presentation/components/states/FeedbackState.tsx

@@ -0,0 +1,36 @@
+/**
+ * Feedback State Component
+ *
+ * Displays feedback screen to collect user input.
+ */
+
+import React from "react";
+import { PaywallFeedbackScreen } from "../feedback/PaywallFeedbackScreen";
+import { usePaywallFeedbackSubmit } from "../../../../../presentation/hooks/feedback/useFeedbackSubmit";
+import type { ManagedSubscriptionFlowProps } from "../ManagedSubscriptionFlow.types";
+
+interface FeedbackStateProps {
+  config: ManagedSubscriptionFlowProps["feedback"];
+  onClose: () => void;
+}
+
+export const FeedbackState: React.FC<FeedbackStateProps> = ({ config, onClose }) => {
+  const { submit: internalSubmit } = usePaywallFeedbackSubmit();
+
+  const handleSubmit = async (data: { reason: string; otherText?: string }) => {
+    if (config.onSubmit) {
+      await config.onSubmit(data);
+    } else {
+      const description = data.otherText ? `${data.reason}: ${data.otherText}` : data.reason;
+      await internalSubmit(description);
+    }
+  };
+
+  return (
+    <PaywallFeedbackScreen
+      onClose={onClose}
+      onSubmit={handleSubmit}
+      translations={config.translations}
+    />
+  );
+};

package/src/domains/subscription/presentation/components/states/InitializingState.tsx

@@ -0,0 +1,47 @@
+/**
+ * Initializing State Component
+ *
+ * Displays splash screen during initialization.
+ */
+
+import React from "react";
+import { View, Text, StyleSheet } from "react-native";
+import type { ManagedSubscriptionFlowProps } from "../ManagedSubscriptionFlow.types";
+
+interface InitializingStateProps {
+  tokens: any;
+  splash?: ManagedSubscriptionFlowProps["splash"];
+}
+
+export const InitializingState: React.FC<InitializingStateProps> = ({ tokens, splash }) => {
+  if (!splash) {
+    return null;
+  }
+
+  return (
+    <View style={[styles.container, { backgroundColor: tokens.colors.background }]}>
+      <Text style={[styles.appName, { color: tokens.colors.text }]}>
+        {splash.appName}
+      </Text>
+      <Text style={[styles.tagline, { color: tokens.colors.textSecondary }]}>
+        {splash.tagline}
+      </Text>
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    justifyContent: "center",
+    alignItems: "center",
+  },
+  appName: {
+    fontSize: 32,
+    fontWeight: "bold",
+    marginBottom: 8,
+  },
+  tagline: {
+    fontSize: 16,
+  },
+});

package/src/domains/subscription/presentation/components/states/OnboardingState.tsx

@@ -0,0 +1,27 @@
+/**
+ * Onboarding State Component
+ *
+ * Displays onboarding slides to the user.
+ */
+
+import React from "react";
+import { OnboardingScreen } from "@umituz/react-native-design-system/onboarding";
+import type { ManagedSubscriptionFlowProps } from "../ManagedSubscriptionFlow.types";
+
+interface OnboardingStateProps {
+  config: ManagedSubscriptionFlowProps["onboarding"];
+  onComplete: () => void;
+}
+
+export const OnboardingState: React.FC<OnboardingStateProps> = ({ config, onComplete }) => {
+  return (
+    <OnboardingScreen
+      slides={config.slides}
+      translations={config.translations}
+      onComplete={onComplete}
+      showSkipButton={config.showSkipButton ?? true}
+      showBackButton={config.showBackButton ?? true}
+      showProgressBar={config.showProgressBar ?? true}
+    />
+  );
+};

package/src/domains/subscription/presentation/components/states/PaywallState.tsx

@@ -0,0 +1,66 @@
+/**
+ * Paywall State Component
+ *
+ * Displays paywall screen for purchase/restore.
+ */
+
+import React, { useState } from "react";
+import type { PurchasesPackage } from "react-native-purchases";
+import type { UserCredits } from "../../../../credits/core/Credits";
+import { PaywallScreen } from "../../../../paywall/components/PaywallScreen";
+import type { ManagedSubscriptionFlowProps } from "../ManagedSubscriptionFlow.types";
+
+interface PaywallStateProps {
+  config: ManagedSubscriptionFlowProps["paywall"];
+  packages: PurchasesPackage[];
+  isPremium: boolean;
+  credits: UserCredits | null;
+  isSyncing: boolean;
+  onPurchase: (pkg: PurchasesPackage) => Promise<boolean>;
+  onRestore: () => Promise<boolean>;
+  onClose: (purchased: boolean) => void;
+}
+
+export const PaywallState: React.FC<PaywallStateProps> = ({
+  config,
+  packages,
+  isPremium,
+  credits,
+  isSyncing,
+  onPurchase,
+  onRestore,
+  onClose,
+}) => {
+  const [purchaseSuccessful, setPurchaseSuccessful] = useState(false);
+
+  const handlePurchase = async (pkg: PurchasesPackage) => {
+    const result = await onPurchase(pkg);
+    if (result) {
+      setPurchaseSuccessful(true);
+    }
+    return result;
+  };
+
+  const handleClose = () => {
+    onClose(purchaseSuccessful);
+  };
+
+  return (
+    <PaywallScreen
+      translations={config.translations}
+      legalUrls={config.legalUrls}
+      features={config.features}
+      bestValueIdentifier={config.bestValueIdentifier}
+      creditsLabel={config.creditsLabel}
+      heroImage={config.heroImage}
+      source="onboarding"
+      packages={packages}
+      isPremium={isPremium}
+      credits={credits}
+      isSyncing={isSyncing}
+      onPurchase={handlePurchase}
+      onRestore={onRestore}
+      onClose={handleClose}
+    />
+  );
+};

package/src/domains/subscription/presentation/components/states/ReadyState.tsx

@@ -0,0 +1,51 @@
+/**
+ * Ready State Component
+ *
+ * Displays app content with optional offline banner and feedback.
+ */
+
+import React from "react";
+import { FeedbackState } from "./FeedbackState";
+import type { ManagedSubscriptionFlowProps } from "../ManagedSubscriptionFlow.types";
+
+interface ReadyStateProps {
+  children: React.ReactNode;
+  offline?: ManagedSubscriptionFlowProps["offline"];
+  feedbackConfig: ManagedSubscriptionFlowProps["feedback"];
+  showFeedback: boolean;
+  tokens: any;
+  onFeedbackClose: () => void;
+}
+
+export const ReadyState: React.FC<ReadyStateProps> = ({
+  children,
+  offline,
+  feedbackConfig,
+  showFeedback,
+  tokens,
+  onFeedbackClose,
+}) => {
+  const { OfflineBanner } = require("@umituz/react-native-design-system/offline");
+
+  return (
+    <>
+      {children}
+
+      {offline && (
+        <OfflineBanner
+          visible={offline.isOffline}
+          message={offline.message}
+          backgroundColor={offline.backgroundColor || tokens.colors.error}
+          position={offline.position || "top"}
+        />
+      )}
+
+      {showFeedback && (
+        <FeedbackState
+          config={feedbackConfig}
+          onClose={onFeedbackClose}
+        />
+      )}
+    </>
+  );
+};

package/src/domains/subscription/presentation/flowInitialState.ts

@@ -0,0 +1,22 @@
+/**
+ * Subscription Flow Initial State
+ *
+ * Default state for the subscription flow state machine.
+ */
+
+import { SubscriptionFlowStatus, SyncStatus, type SubscriptionFlowState } from "./flowTypes";
+
+/**
+ * Initial state for the subscription flow store.
+ * Represents a fresh install scenario.
+ */
+export const initialFlowState: SubscriptionFlowState = {
+  status: SubscriptionFlowStatus.INITIALIZING,
+  syncStatus: SyncStatus.IDLE,
+  syncError: null,
+  isOnboardingComplete: false,
+  paywallShown: false,
+  showFeedback: false,
+  isAuthModalOpen: false,
+  isInitialized: false,
+};

package/src/domains/subscription/presentation/flowTypes.ts

@@ -0,0 +1,106 @@
+/**
+ * Subscription Flow State Machine Types
+ *
+ * Type definitions for the subscription flow state machine.
+ * Separated from implementation for better maintainability.
+ */
+
+/**
+ * States in the subscription flow.
+ * Represents the user's journey from first launch to premium access.
+ */
+export enum SubscriptionFlowStatus {
+  /** App is initializing, determining next state */
+  INITIALIZING = "INITIALIZING",
+  /** User is seeing onboarding for the first time */
+  ONBOARDING = "ONBOARDING",
+  /** Checking if user has premium access */
+  CHECK_PREMIUM = "CHECK_PREMIUM",
+  /** Showing paywall after onboarding */
+  POST_ONBOARDING_PAYWALL = "POST_ONBOARDING_PAYWALL",
+  /** App is ready to use */
+  READY = "READY",
+}
+
+/**
+ * Sync status for subscription/credits data.
+ */
+export enum SyncStatus {
+  /** No sync in progress */
+  IDLE = "IDLE",
+  /** Syncing data from RevenueCat/Firestore */
+  SYNCING = "SYNCING",
+  /** Sync completed successfully */
+  SUCCESS = "SUCCESS",
+  /** Sync failed with error */
+  ERROR = "ERROR",
+}
+
+/**
+ * Complete state shape for the subscription flow store.
+ */
+export interface SubscriptionFlowState {
+  /** Current flow status */
+  status: SubscriptionFlowStatus;
+
+  /** Sync status for subscription/credits data */
+  syncStatus: SyncStatus;
+
+  /** Error message from last sync failure */
+  syncError: string | null;
+
+  /** Whether user has completed onboarding */
+  isOnboardingComplete: boolean;
+
+  /** Whether paywall has been shown at least once */
+  paywallShown: boolean;
+
+  /** Whether to show feedback screen */
+  showFeedback: boolean;
+
+  /** Whether auth modal is currently open */
+  isAuthModalOpen: boolean;
+
+  /** Whether store has been initialized */
+  isInitialized: boolean;
+}
+
+/**
+ * Actions available on the subscription flow store.
+ */
+export interface SubscriptionFlowActions {
+  /** Mark onboarding as complete and transition to CHECK_PREMIUM */
+  completeOnboarding: () => void;
+
+  /** Show paywall and transition to POST_ONBOARDING_PAYWALL */
+  showPaywall: () => void;
+
+  /** Complete paywall interaction and transition to READY */
+  completePaywall: (purchased: boolean) => void;
+
+  /** Show feedback screen */
+  showFeedbackScreen: () => void;
+
+  /** Hide feedback screen */
+  hideFeedback: () => void;
+
+  /** Open/close auth modal */
+  setAuthModalOpen: (open: boolean) => void;
+
+  /** Update sync status */
+  setSyncStatus: (status: SyncStatus, error?: string | null) => void;
+
+  /** Set initialized flag (internal use) */
+  setInitialized: (initialized: boolean) => void;
+
+  /** Set flow status (internal use) */
+  setStatus: (status: SubscriptionFlowStatus) => void;
+
+  /** Reset flow to initial state */
+  resetFlow: () => void;
+}
+
+/**
+ * Combined store type with state and actions.
+ */
+export type SubscriptionFlowStore = SubscriptionFlowState & SubscriptionFlowActions;