@umituz/react-native-settings 5.4.17 → 5.4.19

package/dist/index.d.ts

@@ -7,12 +7,15 @@
  * Usage:
  *   import { useSettings, SettingsScreen, AppearanceScreen, SettingsItemCard, DisclaimerSetting } from '@umituz/react-native-settings';
  */
+export * from './core';
+export * from './presentation/components';
 export type { ISettingsRepository, UserSettings, SettingsError, SettingsResult, } from './application/ports/ISettingsRepository';
 export { getSettingsService } from './infrastructure/services/SettingsService';
 export { SettingsRepository } from './infrastructure/repositories/SettingsRepository';
 export { useSettings } from './presentation/hooks/useSettings';
 export { useSettingsQuery } from './presentation/hooks/queries/useSettingsQuery';
 export { useUpdateSettingsMutation, useResetSettingsMutation } from './presentation/hooks/mutations/useSettingsMutations';
+export { useSettingsScreenConfig, type SettingsFeatures, type UseSettingsScreenConfigParams, type SettingsScreenConfigResult } from './presentation/hooks/useSettingsScreenConfig';
 export { SettingsScreen } from './presentation/screens/SettingsScreen';
 export type { SettingsScreenProps } from './presentation/screens/SettingsScreen';
 export { AppearanceScreen } from './presentation/screens/AppearanceScreen';
@@ -37,5 +40,6 @@ export * from "./domains/cloud-sync";
 export * from "./domains/dev";
 export * from "./domains/gamification";
 export * from "./domains/localization";
+export * from "./domains/ai-consent";
 export * from "./domains/notifications";
 export { createAppearanceConfig, createLanguageConfig, createNotificationsConfig, createAboutConfig, createLegalConfig, createFeedbackConfig, createRatingConfig, createFAQConfig, createSubscriptionConfig, createGamificationConfig, type TranslationFunction, type FeedbackFormData, } from './presentation/utils';

package/dist/infrastructure/services/SettingsService.d.ts

@@ -1,10 +1,13 @@
 /**
  * Settings Service
  *
- * Orchestrates settings operations using SettingsRepository
+ * Orchestrates settings operations using SettingsRepository.
+ * Refactored to extend BaseService for consistent error handling.
  */
+import { BaseService } from '../../core/base/BaseService';
 import type { UserSettings, SettingsResult } from '../../application/ports/ISettingsRepository';
-export declare class SettingsService {
+export declare class SettingsService extends BaseService {
+    protected serviceName: string;
     private repository;
     constructor();
     getSettings(userId: string): Promise<SettingsResult<UserSettings>>;

package/dist/presentation/components/GenericModal.d.ts

@@ -0,0 +1,35 @@
+/**
+ * GenericModal Component
+ *
+ * Universal modal component that works with ModalConfig.
+ * Replaces all custom modal implementations.
+ *
+ * @example
+ * ```ts
+ * const modal = useModalState();
+ *
+ * return (
+ *   <>
+ *     <Button onPress={() => modal.show(ModalPresets.confirm(...))} />
+ *     <GenericModal state={modal} />
+ *   </>
+ * );
+ * ```
+ */
+import React from 'react';
+import type { ModalState } from '../../core/patterns/Modal/ModalConfig';
+export interface GenericModalProps {
+    /**
+     * Modal state from useModalState hook
+     */
+    state: ModalState;
+    /**
+     * Custom container style
+     */
+    containerStyle?: object;
+    /**
+     * Test ID for E2E testing
+     */
+    testID?: string;
+}
+export declare const GenericModal: React.FC<GenericModalProps>;

package/dist/presentation/components/GenericScreen.d.ts

@@ -0,0 +1,41 @@
+/**
+ * GenericScreen Component
+ *
+ * Universal screen component that works with ScreenConfig.
+ * Handles loading, error, and empty states automatically.
+ *
+ * @example
+ * ```ts
+ * const screenData = useScreenData({ fetch: async () => await api.getData() });
+ *
+ * return (
+ *   <GenericScreen
+ *     data={screenData}
+ *     config={ScreenPresets.default}
+ *   >
+ *     <MyContent data={screenData.data} />
+ *   </GenericScreen>
+ * );
+ * ```
+ */
+import React from 'react';
+import type { ScreenConfig, ScreenData } from '../../core/patterns/Screen/ScreenConfig';
+export interface GenericScreenProps<T> {
+    /**
+     * Screen data from useScreenData hook
+     */
+    data: ScreenData<T>;
+    /**
+     * Screen configuration
+     */
+    config?: ScreenConfig;
+    /**
+     * Content component (renders when data is loaded)
+     */
+    children: React.ReactNode | ((data: T) => React.ReactNode);
+    /**
+     * Test ID for E2E testing
+     */
+    testID?: string;
+}
+export declare function GenericScreen<T>({ data, config, children, testID, }: GenericScreenProps<T>): React.JSX.Element;

package/dist/presentation/components/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Presentation Components - Public API
+ *
+ * Shared UI components for the entire application.
+ *
+ * @example
+ * ```ts
+ * import { GenericModal, GenericScreen } from '@/presentation/components';
+ *
+ * const modal = useModalState();
+ * return <GenericModal state={modal} />;
+ * ```
+ */
+export { GenericModal } from './GenericModal';
+export type { GenericModalProps } from './GenericModal';
+export { GenericScreen } from './GenericScreen';
+export type { GenericScreenProps } from './GenericScreen';

package/dist/presentation/navigation/hooks/useSettingsNavigation.d.ts

@@ -1,22 +1,28 @@
 /**
- * Typed Settings Navigation Hook
+ * Settings Navigation Hook
  *
- * Provides type-safe navigation for Settings stack screens.
- * Replaces unsafe `as never` casts throughout the codebase.
- */
-import type { StackNavigationProp } from '@react-navigation/stack';
-import type { SettingsStackParamList } from '../types';
-/**
- * Type for Settings navigation prop
- */
-export type SettingsNavigationProp = StackNavigationProp<SettingsStackParamList>;
-/**
- * Hook to get typed navigation for Settings screens
+ * Provides standardized navigation for Settings stack screens.
+ * Uses useAppNavigation from design system for consistency.
  *
  * @example
  * ```typescript
- * const navigation = useSettingsNavigation();
- * navigation.navigate('LanguageSelection'); // Fully typed!
+ * import { useSettingsNavigation } from '@umituz/react-native-settings/presentation/navigation';
+ *
+ * function LanguageSelectionScreen() {
+ *   const navigation = useSettingsNavigation();
+ *   navigation.navigate('Appearance');
+ *   navigation.goBack();
+ * }
  * ```
  */
-export declare const useSettingsNavigation: () => SettingsNavigationProp;
+import { useAppNavigation } from '@umituz/react-native-design-system/molecules';
+/**
+ * Navigation result type inferred from useAppNavigation
+ */
+type SettingsNavigation = ReturnType<typeof useAppNavigation>;
+/**
+ * Hook to get navigation for Settings screens
+ * Delegates to useAppNavigation for consistent API
+ */
+export declare const useSettingsNavigation: () => SettingsNavigation;
+export {};

package/dist/presentation/navigation/types.d.ts

@@ -5,6 +5,10 @@ import type React from 'react';
 import type { SettingsConfig, CustomSettingsSection } from "../screens/types";
 import type { DevSettingsProps } from "../../domains/dev";
 import type { FAQCategory } from "../../domains/faqs";
+import type { DisclaimerScreenParams } from "../../domains/disclaimer/presentation/screens/DisclaimerScreen";
+import type { FeedbackScreenParams } from "../../domains/feedback/presentation/screens/FeedbackScreen";
+import type { RatingPromptScreenParams } from "../../domains/rating/presentation/screens/RatingPromptScreen";
+import type { AIConsentScreenParams } from "../../domains/ai-consent/presentation/screens/AIConsentScreen";
 /**
  * App Info passed from main app (APP_INFO constant)
  */
@@ -44,6 +48,10 @@ export type SettingsStackParamList = {
     Account: undefined;
     VideoTutorial: undefined;
     FeatureRequest: undefined;
+    Disclaimer: DisclaimerScreenParams;
+    Feedback: FeedbackScreenParams;
+    RatingPrompt: RatingPromptScreenParams;
+    AIConsent: AIConsentScreenParams;
     PasswordPrompt: {
         onComplete: (password: string | null) => void;
         title?: string;

package/dist/presentation/navigation/utils/navigationHelpers.d.ts

@@ -5,7 +5,7 @@
 import type { SettingsStackParamList } from '../types';
 type NavigateFunction = <RouteName extends keyof SettingsStackParamList>(route: RouteName, params?: SettingsStackParamList[RouteName]) => void;
 interface RouteOrPressConfig<T extends keyof SettingsStackParamList = keyof SettingsStackParamList> {
-    route?: T;
+    route?: T | string;
     onPress?: () => void;
     fallback?: T;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-settings",
-  "version": "5.4.17",
+  "version": "5.4.19",
   "description": "Complete settings hub for React Native apps - consolidated package with settings, localization, about, legal, appearance, feedback, FAQs, rating, and gamification - expo-store-review and expo-device now lazy loaded",
   "main": "./src/index.ts",
   "types": "./dist/index.d.ts",

package/src/domains/ai-consent/index.ts

@@ -0,0 +1,53 @@
+/**
+ * @umituz/react-native-settings - AI Consent Domain
+ *
+ * AI consent management for React Native apps
+ * Required by Apple App Store Guidelines 5.1.1(i) & 5.1.2(i)
+ *
+ * Displays AI technology disclosure and obtains user consent before
+ * using AI generation features.
+ *
+ * Usage:
+ *   import {
+ *     AIConsentScreen,
+ *     AIConsentModal,
+ *     AIConsentSetting,
+ *     useAIConsent
+ *   } from '@umituz/react-native-settings/ai-consent';
+ *
+ *   // Show modal on app launch
+ *   const { isConsentModalVisible, handleAcceptConsent, handleDeclineConsent } = useAIConsent();
+ *
+ *   <AIConsentModal
+ *     visible={isConsentModalVisible}
+ *     onAccept={handleAcceptConsent}
+ *     onDecline={handleDeclineConsent}
+ *   />
+ *
+ *   // Add to settings screen
+ *   <AIConsentSetting />
+ */
+
+// =============================================================================
+// PRESENTATION LAYER - Components
+// =============================================================================
+
+export { AIConsentModal } from './presentation/components/AIConsentModal';
+export type { AIConsentModalProps } from './presentation/components/AIConsentModal';
+
+export { AIConsentSetting } from './presentation/components/AIConsentSetting';
+export type { AIConsentSettingProps } from './presentation/components/AIConsentSetting';
+
+// =============================================================================
+// PRESENTATION LAYER - Screens
+// =============================================================================
+
+export { AIConsentScreen } from './presentation/screens/AIConsentScreen';
+export type { AIConsentScreenProps, AIConsentScreenParams, AIProvider } from './presentation/screens/AIConsentScreen';
+
+// =============================================================================
+// PRESENTATION LAYER - Hooks
+// =============================================================================
+
+export { useAIConsent } from './presentation/hooks/useAIConsent';
+export type { UseAIConsentReturn, AIConsentState } from './presentation/hooks/useAIConsent';

package/src/domains/ai-consent/presentation/components/AIConsentModal.tsx

@@ -0,0 +1,64 @@
+/**
+ * AI Consent Modal
+ *
+ * Modal wrapper for AI consent screen.
+ * Required by Apple App Store Guidelines 5.1.1(i) & 5.1.2(i)
+ *
+ * Displays on first app launch before any AI features are used.
+ * Can also be shown manually from settings.
+ *
+ * Usage:
+ *   <AIConsentModal
+ *     visible={isConsentModalVisible}
+ *     onAccept={handleAccept}
+ *     onDecline={handleDecline}
+ *   />
+ */
+
+import React, { memo } from 'react';
+import { Modal, View, StyleSheet } from 'react-native';
+import { AIConsentScreen, type AIProvider } from '../screens/AIConsentScreen';
+
+export interface AIConsentModalProps {
+  visible: boolean;
+  onAccept: () => void;
+  onDecline: () => void;
+  providers?: AIProvider[];
+  customMessage?: string;
+}
+
+export const AIConsentModal: React.FC<AIConsentModalProps> = memo(({
+  visible,
+  onAccept,
+  onDecline,
+  providers,
+  customMessage,
+}) => {
+  return (
+    <Modal
+      visible={visible}
+      animationType="slide"
+      transparent={false}
+      onRequestClose={onDecline}
+    >
+      <View style={styles.container}>
+        <AIConsentScreen
+          providers={providers}
+          customMessage={customMessage}
+          onAccept={onAccept}
+          onDecline={onDecline}
+          standalone={true}
+        />
+      </View>
+    </Modal>
+  );
+});
+
+AIConsentModal.displayName = 'AIConsentModal';
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#FFFFFF',
+  },
+});

package/src/domains/ai-consent/presentation/components/AIConsentSetting.tsx

@@ -0,0 +1,106 @@
+/**
+ * AIConsentSetting Component
+ *
+ * Settings list item for AI consent management.
+ * Shows current consent status and navigates to full consent screen.
+ *
+ * Features:
+ * - Displays consent status (accepted/declined/pending)
+ * - Tappable card that opens AI consent screen
+ * - Icon with background color
+ * - Internationalized
+ * - Universal across iOS, Android, Web
+ *
+ * Usage:
+ *   import { AIConsentSetting } from '@umituz/react-native-settings/ai-consent';
+ *
+ *   <AIConsentSetting />
+ */
+
+import React, { useCallback, memo } from 'react';
+import { View, StyleSheet } from 'react-native';
+import { useAppDesignTokens, withAlpha } from '@umituz/react-native-design-system/theme';
+import { useAppNavigation } from '@umituz/react-native-design-system/molecules';
+import { AtomicText } from '@umituz/react-native-design-system/atoms';
+import { useAIConsent } from '../hooks/useAIConsent';
+
+export interface AIConsentSettingProps {
+  /** Custom title */
+  title?: string;
+  /** Custom description when consented */
+  consentedDescription?: string;
+  /** Custom description when not consented */
+  notConsentedDescription?: string;
+}
+
+export const AIConsentSetting: React.FC<AIConsentSettingProps> = memo(({
+  title = 'AI Technology Consent',
+  consentedDescription = 'You have consented to use AI services',
+  notConsentedDescription = 'Review AI service disclosure',
+}) => {
+  const tokens = useAppDesignTokens();
+  const navigation = useAppNavigation();
+  const { hasConsented, isLoading } = useAIConsent();
+
+  const handlePress = useCallback(() => {
+    navigation.push('AIConsent' as never);
+  }, [navigation]);
+
+  if (isLoading) {
+    return null;
+  }
+
+  const iconColor = hasConsented ? tokens.colors.success : tokens.colors.warning;
+  const backgroundColor = withAlpha(iconColor, 0.1);
+  const description = hasConsented ? consentedDescription : notConsentedDescription;
+
+  return (
+    <View style={[styles.container, { backgroundColor }]}>
+      <View style={[styles.iconContainer, { backgroundColor: iconColor }]}>
+        <AtomicText style={styles.icon}>🤖</AtomicText>
+      </View>
+
+      <View style={styles.content}>
+        <AtomicText style={styles.title}>{title}</AtomicText>
+        <AtomicText style={styles.description}>{description}</AtomicText>
+      </View>
+    </View>
+  );
+});
+
+AIConsentSetting.displayName = 'AIConsentSetting';
+
+const styles = StyleSheet.create({
+  container: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    padding: 16,
+    borderRadius: 12,
+    marginVertical: 8,
+  },
+  iconContainer: {
+    width: 48,
+    height: 48,
+    borderRadius: 24,
+    alignItems: 'center',
+    justifyContent: 'center',
+    marginRight: 16,
+  },
+  icon: {
+    fontSize: 24,
+  },
+  content: {
+    flex: 1,
+  },
+  title: {
+    fontSize: 16,
+    fontWeight: '600',
+    color: '#111827',
+    marginBottom: 4,
+  },
+  description: {
+    fontSize: 14,
+    color: '#6B7280',
+    lineHeight: 20,
+  },
+});

package/src/domains/ai-consent/presentation/hooks/useAIConsent.ts

@@ -0,0 +1,125 @@
+/**
+ * useAIConsent Hook
+ * Manages AI consent state and display logic
+ * Required by Apple App Store Guidelines 5.1.1(i) & 5.1.2(i)
+ *
+ * Features:
+ * - Checks if user has consented to AI services
+ * - Shows modal on first use
+ * - Persists consent state
+ * - Memoized for performance
+ */
+
+import { useState, useEffect, useCallback } from 'react';
+import { useStorage } from '@umituz/react-native-design-system/storage';
+
+export interface AIConsentState {
+  hasConsented: boolean;
+  consentTimestamp?: number;
+  consentVersion?: string;
+}
+
+const CONSENT_STORAGE_KEY = '@app:ai_consent_accepted';
+const CURRENT_CONSENT_VERSION = '1.0';
+
+export interface UseAIConsentReturn {
+  isLoading: boolean;
+  isConsentModalVisible: boolean;
+  hasConsented: boolean;
+  consentState: AIConsentState | null;
+  handleAcceptConsent: () => Promise<void>;
+  handleDeclineConsent: () => void;
+  showConsentModal: () => void;
+  checkConsent: () => Promise<void>;
+}
+
+export const useAIConsent = (): UseAIConsentReturn => {
+  const { getString, setString } = useStorage();
+  const [isConsentModalVisible, setIsConsentModalVisible] = useState(false);
+  const [hasConsented, setHasConsented] = useState(false);
+  const [consentState, setConsentState] = useState<AIConsentState | null>(null);
+  const [isLoading, setIsLoading] = useState(true);
+
+  /**
+   * Check if user has previously consented
+   */
+  const checkConsent = useCallback(async () => {
+    setIsLoading(true);
+    try {
+      const consentData = await getString(CONSENT_STORAGE_KEY, '');
+
+      if (consentData) {
+        const parsed: AIConsentState = JSON.parse(consentData);
+        setConsentState(parsed);
+        setHasConsented(parsed.hasConsented);
+
+        // Show modal if user hasn't consented
+        if (!parsed.hasConsented) {
+          setIsConsentModalVisible(true);
+        }
+      } else {
+        // No consent found - show modal
+        setIsConsentModalVisible(true);
+      }
+    } catch (error) {
+      console.error('[useAIConsent] Failed to check consent:', error);
+      // On error, show modal to be safe
+      setIsConsentModalVisible(true);
+    } finally {
+      setIsLoading(false);
+    }
+  }, [getString]);
+
+  /**
+   * Handle user accepting AI consent
+   */
+  const handleAcceptConsent = useCallback(async () => {
+    try {
+      const newState: AIConsentState = {
+        hasConsented: true,
+        consentTimestamp: Date.now(),
+        consentVersion: CURRENT_CONSENT_VERSION,
+      };
+
+      await setString(CONSENT_STORAGE_KEY, JSON.stringify(newState));
+      setConsentState(newState);
+      setHasConsented(true);
+      setIsConsentModalVisible(false);
+    } catch (error) {
+      console.error('[useAIConsent] Failed to save consent:', error);
+      throw error;
+    }
+  }, [setString]);
+
+  /**
+   * Handle user declining AI consent
+   */
+  const handleDeclineConsent = useCallback(() => {
+    setIsConsentModalVisible(false);
+    // User declined - they can still use the app but AI features will be blocked
+    // This is handled by the hasConsented flag
+  }, []);
+
+  /**
+   * Manually show consent modal (e.g., from settings)
+   */
+  const showConsentModal = useCallback(() => {
+    setIsConsentModalVisible(true);
+  }, []);
+
+  // Check consent on mount
+  useEffect(() => {
+    void checkConsent();
+  }, [checkConsent]);
+
+  return {
+    isLoading,
+    isConsentModalVisible,
+    hasConsented,
+    consentState,
+    handleAcceptConsent,
+    handleDeclineConsent,
+    showConsentModal,
+    checkConsent,
+  };
+};