@umituz/react-native-settings 4.14.0 → 4.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-settings",
-  "version": "4.14.0",
+  "version": "4.16.0",
   "description": "Settings management for React Native apps - user preferences, theme, language, notifications",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -91,4 +91,4 @@
     "README.md",
     "LICENSE"
   ]
-}
+}

package/src/index.ts

@@ -50,7 +50,11 @@ export type {
 // PRESENTATION LAYER - Types
 // =============================================================================
 
-export type { SettingsConfig, CustomSettingsSection } from './presentation/screens/types';
+export type {
+  SettingsConfig,
+  CustomSettingsSection,
+  SubscriptionConfig,
+} from './presentation/screens/types';
 
 // =============================================================================
 // PRESENTATION LAYER - Components
@@ -78,3 +82,6 @@ export type { StorageClearSettingProps } from './presentation/components/Storage
 
 export { DevSettingsSection } from './presentation/components/DevSettingsSection';
 export type { DevSettingsProps } from './presentation/components/DevSettingsSection';
+
+export { OnboardingResetSetting } from './presentation/components/OnboardingResetSetting';
+export type { OnboardingResetSettingProps } from './presentation/components/OnboardingResetSetting';

package/src/presentation/components/DevSettingsSection.tsx

@@ -42,12 +42,15 @@ export interface DevSettingsProps {
   onAfterClear?: () => Promise<void>;
   /** Custom texts (optional - defaults to English) */
   texts?: Partial<typeof DEFAULT_TEXTS>;
+  /** Custom dev components to render before the clear data button */
+  customDevComponents?: React.ReactNode[];
 }
 
 export const DevSettingsSection: React.FC<DevSettingsProps> = ({
   enabled = true,
   onAfterClear,
   texts = {},
+  customDevComponents = [],
 }) => {
   const tokens = useAppDesignTokens();
 
@@ -102,6 +105,7 @@ export const DevSettingsSection: React.FC<DevSettingsProps> = ({
 
   return (
     <SettingsSection title={t.sectionTitle}>
+      {customDevComponents.map((component) => component)}
       <SettingItem
         icon={TrashIcon}
         title={t.clearTitle}

package/src/presentation/screens/components/SettingsContent.tsx

@@ -32,6 +32,18 @@ try {
   // Package not available
 }
 
+// Optional subscription component
+let SubscriptionSection: React.ComponentType<any> | null = null;
+try {
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
+  const module = require("@umituz/react-native-subscription");
+  if (module?.SubscriptionSection) {
+    SubscriptionSection = module.SubscriptionSection;
+  }
+} catch {
+  // Package not available
+}
+
 interface SettingsContentProps {
   normalizedConfig: NormalizedConfig;
   config?: any; // Original config for emptyStateText
@@ -43,6 +55,7 @@ interface SettingsContentProps {
     legal: boolean;
     disclaimer: boolean;
     userProfile: boolean;
+    subscription: boolean;
   };
   showUserProfile?: boolean;
   userProfile?: {
@@ -88,6 +101,7 @@ export const SettingsContent: React.FC<SettingsContentProps> = ({
     features.about ||
     features.legal ||
     features.disclaimer ||
+    features.subscription ||
     customSections.length > 0,
     [features, customSections.length]
   );
@@ -125,6 +139,14 @@ export const SettingsContent: React.FC<SettingsContentProps> = ({
         </View>
       )}
 
+      {features.subscription &&
+        SubscriptionSection &&
+        normalizedConfig.subscription.config?.sectionConfig && (
+          <SubscriptionSection
+            config={normalizedConfig.subscription.config.sectionConfig}
+          />
+        )}
+
       {features.appearance && (
         <AppearanceSection
           config={{

package/src/presentation/screens/hooks/useFeatureDetection.ts

@@ -61,10 +61,19 @@ export function useFeatureDetection(
   },
 ) {
   return useMemo(() => {
-    const { appearance, language, notifications, about, legal, disclaimer, userProfile } =
-      normalizedConfig;
+    const {
+      appearance,
+      language,
+      notifications,
+      about,
+      legal,
+      disclaimer,
+      userProfile,
+      subscription,
+    } = normalizedConfig;
 
-    const notificationServiceAvailable = options?.notificationServiceAvailable ?? notificationService !== null;
+    const notificationServiceAvailable =
+      options?.notificationServiceAvailable ?? notificationService !== null;
 
     return {
       appearance:
@@ -106,8 +115,14 @@ export function useFeatureDetection(
         disclaimer.enabled &&
         (disclaimer.config?.enabled === true ||
           (disclaimer.config?.enabled !== false &&
-            hasNavigationScreen(navigation, disclaimer.config?.route || "Disclaimer"))),
+            hasNavigationScreen(
+              navigation,
+              disclaimer.config?.route || "Disclaimer",
+            ))),
       userProfile: userProfile.enabled,
+      subscription:
+        subscription.enabled &&
+        subscription.config?.sectionConfig !== undefined,
     };
   }, [normalizedConfig, navigation, options]);
 }

package/src/presentation/screens/types/FeatureConfig.ts

@@ -128,3 +128,43 @@ export interface UserProfileConfig {
   /** Navigation route for account settings (shows chevron if set) */
   accountSettingsRoute?: string;
 }
+
+/**
+ * Subscription Settings Configuration
+ * App must provide all data via sectionConfig (no internal fetch)
+ */
+export interface SubscriptionConfig {
+  /** Show subscription section */
+  enabled?: FeatureVisibility;
+  /** Section configuration (app provides all data) */
+  sectionConfig?: {
+    statusType: "active" | "expired" | "none";
+    isPremium: boolean;
+    expirationDate?: string | null;
+    purchaseDate?: string | null;
+    isLifetime?: boolean;
+    daysRemaining?: number | null;
+    credits?: Array<{
+      id: string;
+      label: string;
+      current: number;
+      total: number;
+    }>;
+    translations: {
+      title: string;
+      statusLabel: string;
+      expiresLabel: string;
+      purchasedLabel: string;
+      creditsTitle?: string;
+      remainingLabel?: string;
+      manageButton?: string;
+      upgradeButton?: string;
+      lifetimeLabel?: string;
+      statusActive?: string;
+      statusExpired?: string;
+      statusFree?: string;
+    };
+    onManageSubscription?: () => void;
+    onUpgrade?: () => void;
+  };
+}

package/src/presentation/screens/types/SettingsConfig.ts

@@ -12,6 +12,7 @@ import type {
   LegalConfig,
   DisclaimerConfig,
   UserProfileConfig,
+  SubscriptionConfig,
 } from "./FeatureConfig";
 
 /**
@@ -88,6 +89,13 @@ export interface SettingsConfig {
    */
   userProfile?: boolean | UserProfileConfig;
 
+  /**
+   * Subscription/Premium settings
+   * App must provide all data via sectionConfig
+   * @default false
+   */
+  subscription?: FeatureVisibility | SubscriptionConfig;
+
   /**
    * Custom empty state text when no settings are available
    */

package/src/presentation/screens/types/index.ts

@@ -12,6 +12,7 @@ export type {
   LegalConfig,
   DisclaimerConfig,
   UserProfileConfig,
+  SubscriptionConfig,
 } from "./FeatureConfig";
 export type { SettingsConfig } from "./SettingsConfig";
 export type { CustomSettingsSection } from "./CustomSection";

package/src/presentation/screens/utils/normalizeConfig.ts

@@ -12,6 +12,7 @@ import type {
   LegalConfig,
   DisclaimerConfig,
   UserProfileConfig,
+  SubscriptionConfig,
   SettingsConfig,
 } from "../types";
 
@@ -44,6 +45,10 @@ export interface NormalizedConfig {
     enabled: boolean;
     config?: UserProfileConfig;
   };
+  subscription: {
+    enabled: boolean;
+    config?: SubscriptionConfig;
+  };
 }
 
 /**
@@ -85,6 +90,7 @@ export function normalizeSettingsConfig(
     legal: normalizeConfigValue(config?.legal, "auto"),
     disclaimer: normalizeConfigValue(config?.disclaimer, false),
     userProfile: normalizeConfigValue(config?.userProfile, false),
+    subscription: normalizeConfigValue(config?.subscription, false),
   };
 }