@umituz/react-native-settings 4.12.0 → 4.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-settings",
-  "version": "4.12.0",
+  "version": "4.15.0",
   "description": "Settings management for React Native apps - user preferences, theme, language, notifications",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/domain/repositories/ISettingsRepository.ts

@@ -0,0 +1,48 @@
+/**
+ * Settings Repository Interface and Types
+ *
+ * Defines the contract for settings storage operations
+ * and the core types used throughout the settings domain.
+ */
+
+/**
+ * User settings data structure
+ */
+export interface UserSettings {
+  userId: string;
+  theme: 'light' | 'dark' | 'auto';
+  language: string;
+  notificationsEnabled: boolean;
+  emailNotifications: boolean;
+  pushNotifications: boolean;
+  soundEnabled: boolean;
+  vibrationEnabled: boolean;
+  privacyMode: boolean;
+  updatedAt: Date;
+}
+
+/**
+ * Settings operation result
+ */
+export interface SettingsResult<T> {
+  success: boolean;
+  data?: T;
+  error?: SettingsError;
+}
+
+/**
+ * Settings error types
+ */
+export interface SettingsError {
+  code: string;
+  message: string;
+}
+
+/**
+ * Settings repository interface
+ */
+export interface ISettingsRepository {
+  getSettings(userId: string): Promise<SettingsResult<UserSettings>>;
+  saveSettings(settings: UserSettings): Promise<SettingsResult<void>>;
+  deleteSettings(userId: string): Promise<SettingsResult<void>>;
+}

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

package/src/presentation/components/DevSettingsSection.tsx

@@ -73,8 +73,13 @@ export const DevSettingsSection: React.FC<DevSettingsProps> = ({
           style: "destructive",
           onPress: async () => {
             try {
-              // Clear all storage
-              await storageRepository.clearAll();
+              // Clear all storage and check result
+              const result = await storageRepository.clearAll();
+
+              if (!result.success) {
+                Alert.alert(t.errorTitle, t.errorMessage);
+                return;
+              }
 
               // If callback provided, call it (e.g., reload app)
               if (onAfterClear) {

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),
   };
 }