@umituz/react-native-settings 4.21.10 → 4.21.12

package/src/notifications/infrastructure/services/NotificationPermissions.ts

@@ -0,0 +1,80 @@
+import * as Notifications from 'expo-notifications';
+import * as Device from 'expo-device';
+import { Platform } from 'react-native';
+import { devWarn, devError, devLog } from '../utils/dev';
+
+export class NotificationPermissions {
+  async requestPermissions(): Promise<boolean> {
+    try {
+      if (!Device.isDevice) {
+        devWarn('[NotificationPermissions] Notifications only work on physical devices');
+        return false;
+      }
+
+      const permissionsResponse = await Notifications.getPermissionsAsync();
+      const existingStatus = (permissionsResponse as any).status || ((permissionsResponse as any).granted ? 'granted' : 'denied');
+      let finalStatus = existingStatus;
+
+      if (existingStatus !== 'granted') {
+        const requestResponse = await Notifications.requestPermissionsAsync();
+        finalStatus = (requestResponse as any).status || ((requestResponse as any).granted ? 'granted' : 'denied');
+      }
+
+      if (Platform.OS === 'android') {
+        await this.createAndroidChannels();
+      }
+
+      return finalStatus === 'granted';
+    } catch (error) {
+      devError('[NotificationPermissions] Permission request failed:', error);
+      return false;
+    }
+  }
+
+  async hasPermissions(): Promise<boolean> {
+    try {
+      if (!Device.isDevice) return false;
+      const permissionsResponse = await Notifications.getPermissionsAsync();
+      return (permissionsResponse as any).status === 'granted' || (permissionsResponse as any).granted === true;
+    } catch (error) {
+      devError('[NotificationPermissions] Permission check failed:', error);
+      return false;
+    }
+  }
+
+  private async createAndroidChannels(): Promise<void> {
+    if (Platform.OS !== 'android') return;
+
+    try {
+      await Notifications.setNotificationChannelAsync('default', {
+        name: 'Default',
+        importance: Notifications.AndroidImportance.DEFAULT,
+        vibrationPattern: [0, 250, 250, 250],
+        sound: 'default',
+        lightColor: '#3B82F6',
+      });
+
+      await Notifications.setNotificationChannelAsync('reminders', {
+        name: 'Reminders',
+        importance: Notifications.AndroidImportance.HIGH,
+        vibrationPattern: [0, 250, 250, 250],
+        sound: 'default',
+        lightColor: '#3B82F6',
+        enableVibrate: true,
+      });
+
+      await Notifications.setNotificationChannelAsync('urgent', {
+        name: 'Urgent',
+        importance: Notifications.AndroidImportance.MAX,
+        vibrationPattern: [0, 500, 250, 500],
+        sound: 'default',
+        lightColor: '#EF4444',
+        enableVibrate: true,
+      });
+
+      devLog('[NotificationPermissions] Android channels created');
+    } catch (error) {
+      devError('[NotificationPermissions] Android channel creation failed:', error);
+    }
+  }
+}

package/src/notifications/infrastructure/services/NotificationScheduler.ts

@@ -0,0 +1,77 @@
+import * as Notifications from 'expo-notifications';
+import type { NotificationTrigger, ScheduleNotificationOptions, ScheduledNotification } from './types';
+
+export class NotificationScheduler {
+  async scheduleNotification(options: ScheduleNotificationOptions): Promise<string> {
+    const { title, body, data = {}, trigger, sound = true, badge, categoryIdentifier } = options;
+
+    let notificationTrigger: any;
+
+    if (trigger.type === 'date') {
+      notificationTrigger = {
+        date: trigger.date,
+        channelId: categoryIdentifier || 'default',
+      };
+    } else if (trigger.type === 'daily') {
+      notificationTrigger = {
+        hour: trigger.hour,
+        minute: trigger.minute,
+        repeats: true,
+        channelId: categoryIdentifier || 'reminders',
+      };
+    } else if (trigger.type === 'weekly') {
+      notificationTrigger = {
+        weekday: trigger.weekday,
+        hour: trigger.hour,
+        minute: trigger.minute,
+        repeats: true,
+        channelId: categoryIdentifier || 'reminders',
+      };
+    } else if (trigger.type === 'monthly') {
+      notificationTrigger = {
+        day: trigger.day,
+        hour: trigger.hour,
+        minute: trigger.minute,
+        repeats: true,
+        channelId: categoryIdentifier || 'reminders',
+      };
+    }
+
+    const notificationId = await Notifications.scheduleNotificationAsync({
+      content: {
+        title,
+        body,
+        data,
+        sound: sound === true ? 'default' : sound || undefined,
+        badge,
+        categoryIdentifier,
+        priority: Notifications.AndroidNotificationPriority.HIGH,
+        vibrate: [0, 250, 250, 250],
+      },
+      trigger: notificationTrigger,
+    });
+
+    return notificationId;
+  }
+
+  async cancelNotification(notificationId: string): Promise<void> {
+    await Notifications.cancelScheduledNotificationAsync(notificationId);
+  }
+
+  async cancelAllNotifications(): Promise<void> {
+    await Notifications.cancelAllScheduledNotificationsAsync();
+  }
+
+  async getScheduledNotifications(): Promise<ScheduledNotification[]> {
+    const notifications = await Notifications.getAllScheduledNotificationsAsync();
+    return notifications.map(notification => ({
+      identifier: notification.identifier,
+      content: {
+        title: notification.content.title || '',
+        body: notification.content.body || '',
+        data: notification.content.data as Record<string, any>,
+      },
+      trigger: notification.trigger,
+    }));
+  }
+}

package/src/notifications/infrastructure/services/NotificationService.ts

@@ -0,0 +1,50 @@
+/**
+ * NotificationService
+ *
+ * Simple facade for offline notification system.
+ * Works in ALL apps - offline, online, hybrid - no backend required.
+ *
+ * @module NotificationService
+ */
+
+import { NotificationManager } from './NotificationManager';
+
+export * from './types';
+
+/**
+ * Notification service singleton
+ * Provides simple access to notification manager
+ */
+export class NotificationService {
+  private static instance: NotificationService;
+
+  readonly notifications = new NotificationManager();
+
+  private constructor() {
+    // Configure notification handler on initialization
+    NotificationManager.configure();
+  }
+
+  static getInstance(): NotificationService {
+    if (!NotificationService.instance) {
+      NotificationService.instance = new NotificationService();
+    }
+    return NotificationService.instance;
+  }
+
+  /**
+   * Request notification permissions
+   */
+  async requestPermissions(): Promise<boolean> {
+    return await this.notifications.requestPermissions();
+  }
+
+  /**
+   * Check if permissions are granted
+   */
+  async hasPermissions(): Promise<boolean> {
+    return await this.notifications.hasPermissions();
+  }
+}
+
+export const notificationService = NotificationService.getInstance();

package/src/notifications/infrastructure/services/types.ts

@@ -0,0 +1,176 @@
+/**
+ * Offline-First Notification Types
+ * Uses expo-notifications for local device notifications
+ */
+
+import * as Notifications from 'expo-notifications';
+
+// ============================================================================
+// NOTIFICATION CHANNEL TYPES
+// ============================================================================
+
+export interface NotificationChannel {
+  id: string;
+  channel_type: 'push' | 'in_app';
+  channel_address: string;
+  preferences: Record<string, unknown>;
+  is_verified: boolean;
+  is_active: boolean;
+  created_at: string;
+}
+
+// ============================================================================
+// NOTIFICATION TRIGGER TYPES
+// ============================================================================
+
+export type NotificationTrigger =
+  | { type: 'date'; date: Date }
+  | { type: 'daily'; hour: number; minute: number }
+  | { type: 'weekly'; weekday: number; hour: number; minute: number }
+  | { type: 'monthly'; day: number; hour: number; minute: number };
+
+export interface ScheduleNotificationOptions {
+  title: string;
+  body: string;
+  data?: Record<string, unknown>;
+  trigger: NotificationTrigger;
+  sound?: boolean | string;
+  badge?: number;
+  categoryIdentifier?: string;
+}
+
+export interface ScheduledNotification {
+  identifier: string;
+  content: {
+    title: string;
+    body: string;
+    data: Record<string, unknown>;
+  };
+  trigger: Notifications.NotificationTrigger;
+}
+
+// ============================================================================
+// TIME PRESET TYPES
+// ============================================================================
+
+export interface TimePreset {
+  id: string;
+  hour: number;
+  minute: number;
+  labelKey: string;
+  iconName: string;
+}
+
+// ============================================================================
+// REMINDER TYPES
+// ============================================================================
+
+export type ReminderFrequency = 'once' | 'daily' | 'weekly' | 'monthly';
+
+export interface Reminder {
+  id: string;
+  title: string;
+  body: string;
+  frequency: ReminderFrequency;
+  timePresetId?: string;
+  hour: number;
+  minute: number;
+  weekday?: number;
+  dayOfMonth?: number;
+  enabled: boolean;
+  notificationId?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface CreateReminderInput {
+  title: string;
+  body: string;
+  frequency: ReminderFrequency;
+  timePresetId?: string;
+  hour: number;
+  minute: number;
+  weekday?: number;
+  dayOfMonth?: number;
+}
+
+export interface UpdateReminderInput {
+  title?: string;
+  body?: string;
+  frequency?: ReminderFrequency;
+  timePresetId?: string;
+  hour?: number;
+  minute?: number;
+  weekday?: number;
+  dayOfMonth?: number;
+  enabled?: boolean;
+}
+
+// ============================================================================
+// QUIET HOURS TYPES
+// ============================================================================
+
+export interface QuietHoursConfig {
+  enabled: boolean;
+  startHour: number;
+  startMinute: number;
+  endHour: number;
+  endMinute: number;
+}
+
+// ============================================================================
+// NOTIFICATION PREFERENCES
+// ============================================================================
+
+export interface NotificationPreferences {
+  enabled: boolean;
+  sound: boolean;
+  vibration: boolean;
+  quietHours: QuietHoursConfig;
+}
+
+// ============================================================================
+// SCREEN CONFIGURATION TYPES
+// ============================================================================
+
+export interface ReminderTranslations {
+  screenTitle: string;
+  emptyTitle: string;
+  emptyDescription: string;
+  addButtonLabel: string;
+  editButtonLabel: string;
+  deleteButtonLabel: string;
+  enabledLabel: string;
+  disabledLabel: string;
+  frequencyOnce: string;
+  frequencyDaily: string;
+  frequencyWeekly: string;
+  frequencyMonthly: string;
+  timeLabel: string;
+  titlePlaceholder: string;
+  bodyPlaceholder: string;
+  saveButtonLabel: string;
+  cancelButtonLabel: string;
+}
+
+export interface QuietHoursTranslations {
+  title: string;
+  description: string;
+  startTimeLabel: string;
+  endTimeLabel: string;
+  enabledLabel: string;
+}
+
+export interface NotificationSettingsTranslations {
+  screenTitle: string;
+  masterToggleTitle: string;
+  masterToggleDescription: string;
+  soundTitle: string;
+  soundDescription: string;
+  vibrationTitle: string;
+  vibrationDescription: string;
+  remindersTitle: string;
+  remindersDescription: string;
+  quietHoursTitle: string;
+  quietHoursDescription: string;
+}

package/src/notifications/infrastructure/storage/NotificationsStore.ts

@@ -0,0 +1,45 @@
+/**
+ * Notifications Store - Zustand State Management
+ * Simple offline-first notification state
+ * NO backend, NO user IDs, NO notification history
+ */
+
+import { createStore } from '@umituz/react-native-storage';
+
+interface NotificationsState {
+  hasPermissions: boolean;
+  isInitialized: boolean;
+}
+
+interface NotificationsActions {
+  setPermissions: (granted: boolean) => void;
+  setInitialized: (initialized: boolean) => void;
+}
+
+export const useNotificationsStore = createStore<NotificationsState, NotificationsActions>({
+  name: 'notifications-store',
+  initialState: {
+    hasPermissions: false,
+    isInitialized: false,
+  },
+  persist: false,
+  actions: (set) => ({
+    setPermissions: (granted) => set({ hasPermissions: granted }),
+    setInitialized: (initialized) => set({ isInitialized: initialized }),
+  }),
+});
+
+/**
+ * Hook for accessing notifications state
+ */
+export const useNotifications = () => {
+  const store = useNotificationsStore();
+  const { hasPermissions, isInitialized, setPermissions, setInitialized } = store;
+
+  return {
+    hasPermissions,
+    isInitialized,
+    setPermissions,
+    setInitialized,
+  };
+};

package/src/notifications/infrastructure/utils/dev.ts

@@ -0,0 +1,25 @@
+export const isDev = () => {
+  try {
+    return typeof __DEV__ !== 'undefined' && __DEV__;
+  } catch {
+    return false;
+  }
+};
+
+export const devLog = (message: string, ...args: any[]) => {
+  if (isDev()) {
+    console.log(message, ...args);
+  }
+};
+
+export const devError = (message: string, ...args: any[]) => {
+  if (isDev()) {
+    console.error(message, ...args);
+  }
+};
+
+export const devWarn = (message: string, ...args: any[]) => {
+  if (isDev()) {
+    console.warn(message, ...args);
+  }
+};

package/src/notifications/infrastructure/utils/idGenerator.ts

@@ -0,0 +1,14 @@
+/**
+ * ID Generator Utility
+ * Generates unique IDs for entities
+ */
+
+export const generateId = (prefix: string = 'id'): string => {
+  const timestamp = Date.now();
+  const random = Math.random().toString(36).substring(2, 11);
+  return `${prefix}_${timestamp}_${random}`;
+};
+
+export const generateReminderId = (): string => {
+  return generateId('reminder');
+};

package/src/notifications/infrastructure/utils/triggerBuilder.ts

@@ -0,0 +1,45 @@
+/**
+ * Trigger Builder Utility
+ * Builds notification triggers from reminder data
+ */
+
+import type { NotificationTrigger, Reminder } from '../services/types';
+
+export const buildTrigger = (reminder: Reminder): NotificationTrigger => {
+  const { frequency, hour, minute, weekday, dayOfMonth } = reminder;
+
+  switch (frequency) {
+    case 'once': {
+      const date = new Date();
+      date.setHours(hour, minute, 0, 0);
+
+      if (date <= new Date()) {
+        date.setDate(date.getDate() + 1);
+      }
+
+      return { type: 'date', date };
+    }
+
+    case 'daily':
+      return { type: 'daily', hour, minute };
+
+    case 'weekly':
+      return {
+        type: 'weekly',
+        weekday: weekday || 1,
+        hour,
+        minute,
+      };
+
+    case 'monthly':
+      return {
+        type: 'monthly',
+        day: dayOfMonth || 1,
+        hour,
+        minute,
+      };
+
+    default:
+      return { type: 'daily', hour, minute };
+  }
+};

package/src/notifications/presentation/components/NotificationsSection.tsx

@@ -0,0 +1,84 @@
+/**
+ * NotificationsSection Component
+ * Settings section for notifications - navigates to full screen
+ */
+
+import React, { useCallback, useMemo } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import { View, TouchableOpacity, StyleSheet } from 'react-native';
+import { AtomicText, AtomicIcon } from '@umituz/react-native-design-system';
+import { useAppDesignTokens } from '@umituz/react-native-design-system';
+// @ts-ignore - Optional peer dependency
+import { useNavigation } from '@react-navigation/native';
+// @ts-ignore - Optional peer dependency
+import { useLocalization } from '@umituz/react-native-localization';
+
+export interface NotificationsSectionConfig {
+  route?: string;
+  title?: string;
+  description?: string;
+  sectionTitle?: string;
+}
+
+export interface NotificationsSectionProps {
+  config?: NotificationsSectionConfig;
+  containerStyle?: StyleProp<ViewStyle>;
+}
+
+export const NotificationsSection: React.FC<NotificationsSectionProps> = ({
+  config,
+  containerStyle,
+}) => {
+  const navigation = useNavigation();
+  const { t } = useLocalization();
+  const tokens = useAppDesignTokens();
+  const styles = useMemo(() => createStyles(tokens), [tokens]);
+
+  const handlePress = useCallback(() => {
+    const route = config?.route || 'Notifications';
+    navigation.navigate(route as never);
+  }, [config?.route, navigation]);
+
+  const title = config?.title || t('settings.notifications.title');
+  const description = config?.description || t('settings.notifications.description');
+  const sectionTitle = config?.sectionTitle || t('settings.notifications.sectionTitle');
+
+  return (
+    <View style={[styles.container, containerStyle]}>
+      <AtomicText type="bodyLarge" style={styles.sectionTitle}>{sectionTitle}</AtomicText>
+
+      <TouchableOpacity
+        style={styles.itemContainer}
+        onPress={handlePress}
+        activeOpacity={0.7}
+      >
+        <View style={styles.iconContainer}>
+          <AtomicIcon name="notifications" size="md" color="primary" />
+        </View>
+        <View style={styles.textContainer}>
+          <AtomicText type="bodyLarge">{title}</AtomicText>
+          <AtomicText type="bodySmall" style={styles.description}>{description}</AtomicText>
+        </View>
+        <AtomicIcon name="chevron-forward" size="md" color="secondary" />
+      </TouchableOpacity>
+    </View>
+  );
+};
+
+const createStyles = (tokens: ReturnType<typeof useAppDesignTokens>) =>
+  StyleSheet.create({
+    container: { marginBottom: 16, borderRadius: 12, overflow: 'hidden', backgroundColor: tokens.colors.surface },
+    sectionTitle: { fontWeight: '600', paddingHorizontal: 16, paddingTop: 16, paddingBottom: 8 },
+    itemContainer: { flexDirection: 'row', alignItems: 'center', paddingHorizontal: 16, paddingVertical: 16, minHeight: 72 },
+    iconContainer: {
+      width: 48,
+      height: 48,
+      borderRadius: 12,
+      justifyContent: 'center',
+      alignItems: 'center',
+      marginRight: 16,
+      backgroundColor: tokens.colors.surfaceSecondary,
+    },
+    textContainer: { flex: 1, marginRight: 8 },
+    description: { color: tokens.colors.textSecondary, marginTop: 4 },
+  });

package/src/notifications/presentation/components/RemindersNavRow.styles.ts

@@ -0,0 +1,38 @@
+/**
+ * RemindersNavRow Styles
+ */
+
+import { StyleSheet } from 'react-native';
+import type { DesignTokens } from '@umituz/react-native-design-system';
+
+export const createStyles = (tokens: DesignTokens) =>
+  StyleSheet.create({
+    navRow: {
+      flexDirection: 'row',
+      alignItems: 'center',
+    },
+    iconContainer: {
+      width: 44,
+      height: 44,
+      borderRadius: 22,
+      backgroundColor: tokens.colors.surfaceSecondary,
+      justifyContent: 'center',
+      alignItems: 'center',
+      marginRight: 12,
+    },
+    textContainer: {
+      flex: 1,
+      marginRight: 12,
+    },
+    badge: {
+      backgroundColor: tokens.colors.primary,
+      paddingHorizontal: 8,
+      paddingVertical: 2,
+      borderRadius: 10,
+      marginRight: 8,
+    },
+    badgeText: {
+      color: tokens.colors.surface,
+      fontWeight: '600',
+    },
+  });

package/src/notifications/presentation/components/RemindersNavRow.tsx

@@ -0,0 +1,51 @@
+/**
+ * RemindersNavRow Component
+ * Reusable navigation row for reminders section with badge
+ */
+
+import React from 'react';
+import { View, TouchableOpacity } from 'react-native';
+import { AtomicText, AtomicIcon } from '@umituz/react-native-design-system';
+import { createStyles } from './RemindersNavRow.styles';
+import { useAppDesignTokens } from '@umituz/react-native-design-system';
+
+export interface RemindersNavRowProps {
+  title: string;
+  description: string;
+  count: number;
+  onPress: () => void;
+}
+
+export const RemindersNavRow: React.FC<RemindersNavRowProps> = ({
+  title,
+  description,
+  count,
+  onPress,
+}) => {
+  const tokens = useAppDesignTokens();
+  const styles = createStyles(tokens);
+
+  return (
+    <TouchableOpacity style={styles.navRow} onPress={onPress} activeOpacity={0.7}>
+      <View style={styles.iconContainer}>
+        <AtomicIcon name="time" size="md" color="primary" />
+      </View>
+      <View style={styles.textContainer}>
+        <AtomicText type="bodyLarge" style={{ color: tokens.colors.textPrimary }}>
+          {title}
+        </AtomicText>
+        <AtomicText type="bodySmall" style={{ color: tokens.colors.textSecondary }}>
+          {description}
+        </AtomicText>
+      </View>
+      {count > 0 && (
+        <View style={styles.badge}>
+          <AtomicText type="bodySmall" style={styles.badgeText}>
+            {count}
+          </AtomicText>
+        </View>
+      )}
+      <AtomicIcon name="chevron-forward" size="md" color="secondary" />
+    </TouchableOpacity>
+  );
+};