@umituz/react-native-settings 2.0.0 → 2.4.1

package/README.md

@@ -20,7 +20,7 @@ npm install @umituz/react-native-settings
 ## Peer Dependencies
 
 ```bash
-npm install zustand lucide-react-native @umituz/react-native-storage @umituz/react-native-design-system @umituz/react-native-design-system-theme @umituz/react-native-localization @umituz/react-native-notifications react-native-paper expo-linear-gradient
+npm install zustand lucide-react-native @umituz/react-native-storage @umituz/react-native-design-system @umituz/react-native-design-system-atoms @umituz/react-native-design-system-organisms @umituz/react-native-design-system-theme @umituz/react-native-localization @umituz/react-native-appearance @react-navigation/native react-native-safe-area-context expo-linear-gradient
 ```
 
 ## Usage
@@ -179,8 +179,51 @@ import { SettingsFooter } from '@umituz/react-native-settings';
 ```tsx
 import { DisclaimerSetting } from '@umituz/react-native-settings';
 
-// In AboutScreen
+// Basic usage with translation keys
 <DisclaimerSetting />
+
+// Custom props
+<DisclaimerSetting
+  titleKey="custom.disclaimer.title"
+  messageKey="custom.disclaimer.message"
+  shortMessageKey="custom.disclaimer.shortMessage"
+  iconName="Info"
+  iconColor="#F59E0B"
+  modalTitle="Custom Disclaimer"
+  modalContent="This is a custom disclaimer message for your app."
+/>
+```
+
+### Cloud Sync Setting Component
+
+```tsx
+import { CloudSyncSetting } from '@umituz/react-native-settings';
+
+// Basic usage
+<CloudSyncSetting />
+
+// With custom props
+<CloudSyncSetting
+  title="Cloud Sync"
+  description="Sync your data across devices"
+  isSyncing={false}
+  lastSynced={new Date()}
+  onPress={() => handleSync()}
+  iconColor="#3B82F6"
+/>
+```
+
+### Settings Error Boundary
+
+```tsx
+import { SettingsErrorBoundary } from '@umituz/react-native-settings';
+
+<SettingsErrorBoundary
+  fallbackTitle="custom.error.title"
+  fallbackMessage="custom.error.message"
+>
+  <YourSettingsComponents />
+</SettingsErrorBoundary>
 ```
 
 ## API Reference
@@ -266,7 +309,48 @@ Footer component displaying app version.
 
 ### `DisclaimerSetting`
 
-Disclaimer component for health/wellness apps with modal display.
+Disclaimer component with modal display for legal notices.
+
+**Props:**
+- `titleKey?: string` - Translation key for title (default: "settings.disclaimer.title")
+- `messageKey?: string` - Translation key for message (default: "settings.disclaimer.message")
+- `shortMessageKey?: string` - Translation key for short message (default: "settings.disclaimer.shortMessage")
+- `iconName?: string` - Icon name (default: "AlertTriangle")
+- `iconColor?: string` - Custom icon color
+- `backgroundColor?: string` - Custom background color
+- `modalTitle?: string` - Custom modal title (overrides translation)
+- `modalContent?: string` - Custom modal content (overrides translation)
+
+### `CloudSyncSetting`
+
+Cloud sync setting component with status display.
+
+**Props:**
+- `title?: string` - Custom title (default: "cloud_sync" translation key)
+- `description?: string` - Custom description
+- `isSyncing?: boolean` - Whether currently syncing
+- `lastSynced?: Date | null` - Last sync time
+- `onPress?: () => void` - Press handler
+- `iconColor?: string` - Custom icon color
+- `titleColor?: string` - Custom title color
+
+### `DisclaimerCard`
+
+Card component for disclaimer display (used internally by DisclaimerSetting).
+
+### `DisclaimerModal`
+
+Modal component for full disclaimer display (used internally by DisclaimerSetting).
+
+### `SettingsErrorBoundary`
+
+Error boundary component for settings screens.
+
+**Props:**
+- `children: ReactNode` - Child components
+- `fallback?: ReactNode` - Custom fallback component
+- `fallbackTitle?: string` - Custom error title translation key
+- `fallbackMessage?: string` - Custom error message translation key
 
 ## Types
 
@@ -300,6 +384,48 @@ interface UserSettings {
 
 ⚠️ **Translations**: Settings screens require i18n translations. Make sure to provide translations for settings keys.
 
+⚠️ **Dynamic Text**: All text in this package uses translation keys to be app-agnostic. Provide translations like:
+  - `cloud_sync`, `syncing`, `sync_to_cloud`, `never_synced`, `just_now`, `Xm_ago`, `Xh_ago`, `Xd_ago`
+  - `error_boundary.title`, `error_boundary.message`, `error_boundary.dev_title`, `error_boundary.dev_message`
+  - `settings.disclaimer.title`, `settings.disclaimer.message`, `settings.disclaimer.shortMessage`
+
+⚠️ **Design System**: Uses @umituz/react-native-design-system packages for consistent styling across apps.
+
+⚠️ **Development Logs**: All console logs are wrapped in `__DEV__` checks for production safety.
+
+## Architecture
+
+This package follows **Domain-Driven Design (DDD)** principles:
+
+- **Domain Layer**: Repository interfaces and business entities
+- **Infrastructure Layer**: Storage implementation with Zustand
+- **Presentation Layer**: UI components and screens
+
+### Key Principles
+
+✅ **SOLID**: Single responsibility, open/closed, Liskov substitution, interface segregation, dependency inversion  
+✅ **DRY**: No code duplication, reusable components  
+✅ **KISS**: Simple, maintainable code  
+✅ **200-line limit**: All files under 200 lines for maintainability  
+✅ **TypeScript**: Full type safety  
+✅ **Memory Leak Prevention**: Proper cleanup and error handling  
+✅ **App-Agnostic**: No hardcoded app-specific text or logic  
+✅ **Test Coverage**: Comprehensive test suite  
+
+## Performance
+
+- ✅ **Optimized Rendering**: React.memo and useMemo where appropriate
+- ✅ **Memory Management**: Proper cleanup in useEffect hooks
+- ✅ **Error Boundaries**: Prevent crashes and provide graceful fallbacks
+- ✅ **Development Logs**: __DEV__ only logging for production safety
+
+## Version History
+
+- **v2.2.0**: Major refactor - removed hardcoded text, improved architecture, added comprehensive tests
+- **v2.1.0**: Enhanced component structure and TypeScript support
+- **v2.0.0**: Breaking changes - removed LanguageSelectionScreen, improved API
+- **v1.x.x**: Initial releases with basic settings functionality
+
 ## License
 
 MIT

package/lib/__tests__/setup.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Jest Test Setup
+ * Mock all external dependencies
+ */
+//# sourceMappingURL=setup.d.ts.map

package/lib/__tests__/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/lib/__tests__/setup.js

@@ -0,0 +1,143 @@
+/**
+ * Jest Test Setup
+ * Mock all external dependencies
+ */
+// Mock React Native modules
+jest.mock('react-native/Libraries/Animated/NativeAnimatedHelper');
+// Mock design system packages
+jest.mock('@umituz/react-native-design-system-theme', () => ({
+    useDesignSystemTheme: () => ({
+        themeMode: 'light',
+    }),
+    useAppDesignTokens: () => ({
+        colors: {
+            backgroundPrimary: '#ffffff',
+            primary: '#007AFF',
+            textPrimary: '#000000',
+            textSecondary: '#666666',
+            surface: '#f5f5f5',
+            borderLight: '#e0e0e0',
+            warning: '#FF9800',
+        },
+        spacing: {
+            md: 16,
+        },
+        typography: {
+            labelLarge: {
+                fontWeight: '500',
+                fontSize: 14,
+            },
+        },
+    }),
+    withAlpha: jest.fn((color, alpha) => `${color}${alpha}`),
+}));
+jest.mock('@umituz/react-native-design-system-atoms', () => ({
+    AtomicText: ({ children, type, color, style, testID }) => {
+        const React = require('react');
+        const { Text } = require('react-native');
+        return React.createElement(Text, {
+            style,
+            testID: testID || `atomic-text-${type}-${color}`
+        }, children);
+    },
+    AtomicIcon: ({ name, color, size, style, testID }) => {
+        const React = require('react');
+        const { Text } = require('react-native');
+        return React.createElement(Text, {
+            style,
+            testID: testID || `atomic-icon-${name}-${color}-${size}`
+        }, `Icon: ${name}`);
+    },
+}));
+// Mock localization
+jest.mock('@umituz/react-native-localization', () => ({
+    useLocalization: () => ({
+        t: (key) => key,
+        changeLanguage: jest.fn(),
+        currentLanguage: 'en-US',
+    }),
+}));
+// Mock storage
+jest.mock('@umituz/react-native-storage', () => ({
+    storageRepository: {
+        getItem: jest.fn(),
+        setItem: jest.fn(),
+        removeItem: jest.fn(),
+        clear: jest.fn(),
+    },
+    StorageKey: {
+        SETTINGS: 'settings',
+    },
+    createUserKey: (key, userId) => `${key}_${userId}`,
+    unwrap: (result, defaultValue) => result.success ? result.data : defaultValue,
+}));
+// Mock lucide-react-native
+jest.mock('lucide-react-native', () => ({
+    Cloud: 'Cloud',
+    Bell: 'Bell',
+    Palette: 'Palette',
+    ChevronRight: 'ChevronRight',
+    AlertTriangle: 'AlertTriangle',
+    Info: 'Info',
+    X: 'X',
+    ArrowRight: 'ArrowRight',
+    Settings: 'Settings',
+}));
+// Mock navigation
+jest.mock('@react-navigation/native', () => ({
+    useNavigation: () => ({
+        navigate: jest.fn(),
+        goBack: jest.fn(),
+        getState: jest.fn(() => ({
+            routes: [{ name: 'Settings' }],
+        })),
+        setOptions: jest.fn(),
+        isFocused: jest.fn(() => true),
+        addListener: jest.fn(() => jest.fn()),
+        removeListener: jest.fn(),
+    }),
+    useFocusEffect: jest.fn(),
+    useIsFocused: jest.fn(() => true),
+    NavigationContainer: ({ children }) => children,
+}));
+// Mock safe area context
+jest.mock('react-native-safe-area-context', () => ({
+    SafeAreaProvider: ({ children }) => children,
+    SafeAreaView: ({ children }) => children,
+    useSafeAreaInsets: () => ({
+        top: 0,
+        bottom: 0,
+        left: 0,
+        right: 0,
+    }),
+}));
+// Mock linear gradient
+jest.mock('expo-linear-gradient', () => ({
+    LinearGradient: ({ children }) => children,
+}));
+// Mock notification service
+jest.mock('@umituz/react-native-notifications', () => ({
+    notificationService: {
+        hasPermissions: jest.fn(() => Promise.resolve(true)),
+        requestPermissions: jest.fn(() => Promise.resolve()),
+    },
+}));
+// Mock appearance
+jest.mock('@umituz/react-native-appearance', () => ({
+    useAppearance: () => ({
+        colorScheme: 'light',
+        setColorScheme: jest.fn(),
+    }),
+}));
+// Mock console methods in tests
+global.console = {
+    ...console,
+    warn: jest.fn(),
+    error: jest.fn(),
+};
+// Set up __DEV__ mock
+Object.defineProperty(global, '__DEV__', {
+    value: true,
+    writable: true,
+});
+//# sourceMappingURL=setup.js.map

package/lib/__tests__/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"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"}

package/lib/domain/repositories/ISettingsRepository.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Settings Repository Interface
+ *
+ * Defines contracts for settings persistence and retrieval
+ * Pure business logic - no dependencies on external frameworks
+ */
+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;
+}
+export interface SettingsError extends Error {
+    code: 'LOAD_FAILED' | 'SAVE_FAILED' | 'NOT_FOUND' | 'INVALID_DATA';
+}
+export type SettingsResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: SettingsError;
+};
+/**
+ * Settings Repository Interface
+ * Repository pattern for settings management
+ */
+export interface ISettingsRepository {
+    /**
+     * Load user settings from persistent storage
+     */
+    loadSettings(userId: string): Promise<SettingsResult<UserSettings>>;
+    /**
+     * Save user settings to persistent storage
+     */
+    saveSettings(settings: Partial<UserSettings>): Promise<SettingsResult<UserSettings>>;
+    /**
+     * Reset settings to default values
+     */
+    resetSettings(userId: string): Promise<SettingsResult<UserSettings>>;
+    /**
+     * Get default settings for a user
+     */
+    getDefaultSettings(userId: string): UserSettings;
+}
+//# sourceMappingURL=ISettingsRepository.d.ts.map

package/lib/domain/repositories/ISettingsRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISettingsRepository.d.ts","sourceRoot":"","sources":["../../../src/domain/repositories/ISettingsRepository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,WAAW,GAAG,cAAc,CAAC;CACpE;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT,GAAG;IACF,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IAEpE;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IAErF;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IAErE;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;CAClD"}

package/lib/domain/repositories/ISettingsRepository.js

@@ -0,0 +1,8 @@
+/**
+ * Settings Repository Interface
+ *
+ * Defines contracts for settings persistence and retrieval
+ * Pure business logic - no dependencies on external frameworks
+ */
+export {};
+//# sourceMappingURL=ISettingsRepository.js.map

package/lib/domain/repositories/ISettingsRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISettingsRepository.js","sourceRoot":"","sources":["../../../src/domain/repositories/ISettingsRepository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @umituz/react-native-settings - Public API
+ *
+ * Settings management for React Native apps
+ * User preferences, theme, language, notifications
+ *
+ * Usage:
+ *   import { useSettings, useSettingsStore, SettingsScreen, AppearanceScreen, LanguageSelectionScreen, SettingItem, DisclaimerSetting } from '@umituz/react-native-settings';
+ */
+export type { ISettingsRepository, UserSettings, SettingsError, SettingsResult, } from './domain/repositories/ISettingsRepository';
+export { useSettingsStore, useSettings, } from './infrastructure/storage/SettingsStore';
+export { SettingsScreen } from './presentation/screens/SettingsScreen';
+export type { SettingsScreenProps } from './presentation/screens/SettingsScreen';
+export { AppearanceScreen } from './presentation/screens/AppearanceScreen';
+export type { SettingsConfig, CustomSettingsSection } from './presentation/screens/types';
+export { SettingItem } from './presentation/components/SettingItem';
+export type { SettingItemProps } from './presentation/components/SettingItem';
+export { SettingsSection } from './presentation/components/SettingsSection';
+export type { SettingsSectionProps } from './presentation/components/SettingsSection';
+export { SettingsFooter } from './presentation/components/SettingsFooter';
+export type { SettingsFooterProps } from './presentation/components/SettingsFooter';
+export { UserProfileHeader } from './presentation/components/UserProfileHeader';
+export type { UserProfileHeaderProps } from './presentation/components/UserProfileHeader';
+export { DisclaimerSetting } from './presentation/components/DisclaimerSetting';
+export type { DisclaimerSettingProps } from './presentation/components/DisclaimerSetting';
+export { DisclaimerCard } from './presentation/components/DisclaimerCard';
+export type { DisclaimerCardProps } from './presentation/components/DisclaimerCard';
+export { DisclaimerModal } from './presentation/components/DisclaimerModal';
+export type { DisclaimerModalProps } from './presentation/components/DisclaimerModal';
+export { SettingsErrorBoundary } from './presentation/components/SettingsErrorBoundary';
+export { CloudSyncSetting } from './presentation/components/CloudSyncSetting';
+export type { CloudSyncSettingProps } from './presentation/components/CloudSyncSetting';
+export { StorageClearSetting } from './presentation/components/StorageClearSetting';
+export type { StorageClearSettingProps } from './presentation/components/StorageClearSetting';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,2CAA2C,CAAC;AAMnD,OAAO,EACL,gBAAgB,EAChB,WAAW,GACZ,MAAM,wCAAwC,CAAC;AAMhD,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAM3E,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAM1F,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,YAAY,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAEpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAChF,YAAY,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAE1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAChF,YAAY,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAE1F,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,YAAY,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAEpF,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAExF,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAExF,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACpF,YAAY,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC"}

package/lib/index.js

@@ -0,0 +1,32 @@
+/**
+ * @umituz/react-native-settings - Public API
+ *
+ * Settings management for React Native apps
+ * User preferences, theme, language, notifications
+ *
+ * Usage:
+ *   import { useSettings, useSettingsStore, SettingsScreen, AppearanceScreen, LanguageSelectionScreen, SettingItem, DisclaimerSetting } from '@umituz/react-native-settings';
+ */
+// =============================================================================
+// INFRASTRUCTURE LAYER - Storage
+// =============================================================================
+export { useSettingsStore, useSettings, } from './infrastructure/storage/SettingsStore';
+// =============================================================================
+// PRESENTATION LAYER - Screens
+// =============================================================================
+export { SettingsScreen } from './presentation/screens/SettingsScreen';
+export { AppearanceScreen } from './presentation/screens/AppearanceScreen';
+// =============================================================================
+// PRESENTATION LAYER - Components
+// =============================================================================
+export { SettingItem } from './presentation/components/SettingItem';
+export { SettingsSection } from './presentation/components/SettingsSection';
+export { SettingsFooter } from './presentation/components/SettingsFooter';
+export { UserProfileHeader } from './presentation/components/UserProfileHeader';
+export { DisclaimerSetting } from './presentation/components/DisclaimerSetting';
+export { DisclaimerCard } from './presentation/components/DisclaimerCard';
+export { DisclaimerModal } from './presentation/components/DisclaimerModal';
+export { SettingsErrorBoundary } from './presentation/components/SettingsErrorBoundary';
+export { CloudSyncSetting } from './presentation/components/CloudSyncSetting';
+export { StorageClearSetting } from './presentation/components/StorageClearSetting';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF,OAAO,EACL,gBAAgB,EAChB,WAAW,GACZ,MAAM,wCAAwC,CAAC;AAEhD,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAQ3E,gFAAgF;AAChF,kCAAkC;AAClC,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAG1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAGhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAGhF,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAG5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAExF,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC"}

package/lib/infrastructure/storage/SettingsStore.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Settings Store - Zustand State Management
+ *
+ * Global settings state for app preferences
+ * Manages theme, language, notifications, and privacy settings
+ *
+ * DDD ARCHITECTURE: Uses @umituz/react-native-storage for all storage operations
+ * - Type-safe storage with StorageKey enum
+ * - Result pattern for error handling
+ * - Single source of truth for all storage
+ */
+import type { UserSettings } from '../../domain/repositories/ISettingsRepository';
+interface SettingsStore {
+    settings: UserSettings | null;
+    loading: boolean;
+    error: string | null;
+    loadSettings: (userId: string) => Promise<void>;
+    updateSettings: (updates: Partial<UserSettings>) => Promise<void>;
+    resetSettings: (userId: string) => Promise<void>;
+    clearError: () => void;
+}
+export declare const useSettingsStore: import("zustand").UseBoundStore<import("zustand").StoreApi<SettingsStore>>;
+/**
+ * Hook for accessing settings state
+ */
+export declare const useSettings: () => {
+    settings: UserSettings | null;
+    loading: boolean;
+    error: string | null;
+    loadSettings: (userId: string) => Promise<void>;
+    updateSettings: (updates: Partial<UserSettings>) => Promise<void>;
+    resetSettings: (userId: string) => Promise<void>;
+    clearError: () => void;
+};
+export {};
+//# sourceMappingURL=SettingsStore.d.ts.map

package/lib/infrastructure/storage/SettingsStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsStore.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/SettingsStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAElF,UAAU,aAAa;IAErB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AA4BD,eAAO,MAAM,gBAAgB,4EAiH1B,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,WAAW;;;;2BAtJC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;8BACrB,OAAO,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC;4BACzC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;sBAC9B,IAAI;CAgKvB,CAAC"}

package/lib/infrastructure/storage/SettingsStore.js

@@ -0,0 +1,144 @@
+/**
+ * Settings Store - Zustand State Management
+ *
+ * Global settings state for app preferences
+ * Manages theme, language, notifications, and privacy settings
+ *
+ * DDD ARCHITECTURE: Uses @umituz/react-native-storage for all storage operations
+ * - Type-safe storage with StorageKey enum
+ * - Result pattern for error handling
+ * - Single source of truth for all storage
+ */
+import { create } from 'zustand';
+import { storageRepository, StorageKey, createUserKey, unwrap } from '@umituz/react-native-storage';
+const DEFAULT_OFFLINE_USER_ID = 'offline_user';
+const DEFAULT_SETTINGS_CACHE = new Map();
+const getDefaultSettings = (userId) => {
+    if (DEFAULT_SETTINGS_CACHE.has(userId)) {
+        return DEFAULT_SETTINGS_CACHE.get(userId);
+    }
+    const settings = {
+        userId,
+        theme: 'auto',
+        language: 'en-US',
+        notificationsEnabled: true,
+        emailNotifications: true,
+        pushNotifications: true,
+        soundEnabled: true,
+        vibrationEnabled: true,
+        privacyMode: false,
+        updatedAt: new Date(),
+    };
+    DEFAULT_SETTINGS_CACHE.set(userId, settings);
+    return settings;
+};
+export const useSettingsStore = create((set, get) => ({
+    settings: null,
+    loading: false,
+    error: null,
+    loadSettings: async (userId) => {
+        if (__DEV__) {
+            console.log('SettingsStore: Loading settings for user:', userId);
+        }
+        set({ loading: true, error: null });
+        try {
+            const defaultSettings = getDefaultSettings(userId);
+            const storageKey = createUserKey(StorageKey.SETTINGS, userId);
+            // ✅ DRY: Storage domain handles JSON parse, error handling
+            const result = await storageRepository.getItem(storageKey, defaultSettings);
+            const data = unwrap(result, defaultSettings);
+            // ✅ CLEAN CODE: Auto-save defaults if not exists
+            if (!result.success) {
+                await storageRepository.setItem(storageKey, defaultSettings);
+            }
+            set({
+                settings: data,
+                loading: false,
+                error: null,
+            });
+            if (__DEV__) {
+                console.log('SettingsStore: Settings loaded successfully');
+            }
+        }
+        catch (error) {
+            if (__DEV__) {
+                console.error('SettingsStore: Failed to load settings:', error);
+            }
+            set({ loading: false, error: 'Failed to load settings' });
+        }
+    },
+    updateSettings: async (updates) => {
+        if (__DEV__) {
+            console.log('SettingsStore: Updating settings with:', updates);
+        }
+        const { settings } = get();
+        // ✅ CLEAN CODE: Auto-initialize if settings not loaded
+        if (!settings) {
+            await get().loadSettings(DEFAULT_OFFLINE_USER_ID);
+        }
+        // ✅ DEFENSIVE: Verify settings loaded successfully
+        const currentSettings = get().settings;
+        if (!currentSettings) {
+            const errorMsg = 'Failed to initialize settings';
+            if (__DEV__) {
+                console.error('SettingsStore:', errorMsg);
+            }
+            set({ error: errorMsg });
+            return;
+        }
+        set({ loading: true, error: null });
+        try {
+            const updatedSettings = {
+                ...currentSettings,
+                ...updates,
+                updatedAt: new Date(),
+            };
+            const storageKey = createUserKey(StorageKey.SETTINGS, currentSettings.userId);
+            // ✅ DRY: Storage domain replaces JSON.stringify + AsyncStorage + try/catch
+            const result = await storageRepository.setItem(storageKey, updatedSettings);
+            set({
+                settings: result.success ? updatedSettings : currentSettings,
+                loading: false,
+                error: null,
+            });
+            if (__DEV__) {
+                console.log('SettingsStore: Settings updated successfully');
+            }
+        }
+        catch (error) {
+            if (__DEV__) {
+                console.error('SettingsStore: Failed to update settings:', error);
+            }
+            set({ loading: false, error: 'Failed to update settings' });
+        }
+    },
+    resetSettings: async (userId) => {
+        set({ loading: true, error: null });
+        const defaultSettings = getDefaultSettings(userId);
+        const storageKey = createUserKey(StorageKey.SETTINGS, userId);
+        // ✅ DRY: Storage domain replaces JSON.stringify + AsyncStorage + try/catch
+        const result = await storageRepository.setItem(storageKey, defaultSettings);
+        set({
+            settings: result.success ? defaultSettings : get().settings,
+            loading: false,
+            error: null,
+        });
+    },
+    clearError: () => set({ error: null }),
+}));
+/**
+ * Hook for accessing settings state
+ */
+export const useSettings = () => {
+    const { settings, loading, error, loadSettings, updateSettings, resetSettings, clearError } = useSettingsStore();
+    return {
+        settings,
+        loading,
+        error,
+        loadSettings,
+        updateSettings,
+        resetSettings,
+        clearError,
+    };
+};
+//# sourceMappingURL=SettingsStore.js.map