homeio

1import type { useDesktopPreferences } from "@/hooks/useDesktopPreferences";
2import type { useSettingsBackend } from "@/modules/settings/hooks/useSettingsBackend";
3import type {
4  AccentColorOption,
5  AppearanceSettings,
6  WallpaperOption,
7} from "@/lib/desktop/appearance";
8import type { SystemSecurityPolicy } from "@/lib/shared/contracts/system";
9import type { ComponentType, ReactNode, SVGProps } from "react";
10
11export type SettingsBackend = ReturnType<typeof useSettingsBackend>;
12export type DesktopPreferencesApi = ReturnType<typeof useDesktopPreferences>;
13
14export type SettingsSectionId =
15  | "general"
16  | "network"
17  | "storage"
18  | "docker"
19  | "integrations"
20  | "users"
21  | "security"
22  | "notifications"
23  | "backup"
24  | "updates"
25  | "appearance"
26  | "power"
27  | "scheduled-tasks"
28  | "advanced";
29
30export type SettingsSection = {
31  id: SettingsSectionId;
32  label: string;
33  icon: ComponentType<SVGProps<SVGSVGElement>>;
34  badge?: string;
35};
36
37export type ControlAvailability = {
38  disabled?: boolean;
39  disabledReason?: string;
40};
41
42export type GeneralPreferencesDraft = {
43  hostname: string;
44  timezone: string;
45};
46
47export type SecuritySettingsDraft = {
48  firewallEnabled: boolean;
49  firewallIncomingPolicy: SystemSecurityPolicy;
50  firewallOutgoingPolicy: SystemSecurityPolicy;
51  fail2banEnabled: boolean;
52  fail2banMaxRetries: string;
53  fail2banBanDurationSeconds: string;
54};
55
56export type NotificationSettingsDraft = {
57  systemAlertsEnabled: boolean;
58  updateNotificationsEnabled: boolean;
59  backupReportsEnabled: boolean;
60  securityEventsEnabled: boolean;
61  cpuAlertThresholdPercent: string;
62  memoryAlertThresholdPercent: string;
63  diskAlertThresholdPercent: string;
64  temperatureAlertThresholdCelsius: string;
65};
66
67export type BackupFrequency = "daily" | "weekly";
68
69export type DayOfWeek =
70  | "monday"
71  | "tuesday"
72  | "wednesday"
73  | "thursday"
74  | "friday"
75  | "saturday"
76  | "sunday";
77
78export type BackupSettingsDraft = {
79  enabled: boolean;
80  frequency: BackupFrequency;
81  dayOfWeek: DayOfWeek;
82  time: string;
83  retentionCount: string;
84};
85
86export type ScheduledRebootInput = {
87  enabled: boolean;
88  frequency: BackupFrequency;
89  dayOfWeek: DayOfWeek;
90  time: string;
91};
92
93export type SettingsPanelProps = {
94  appearance: AppearanceSettings;
95  wallpaperOptions: WallpaperOption[];
96  accentOptions: AccentColorOption[];
97  onAppearanceChange: (patch: Partial<AppearanceSettings>) => void;
98  wallpaperAccentColor: string | null;
99  selectedSection?: string | null;
100  onOpenDiskManager?: () => void;
101};
102
103export type SettingsSectionSaveConfig = {
104  canSave: boolean;
105  title?: string;
106  pending?: boolean;
107  label?: string;
108  onSave?: () => Promise<void>;
109};
110
111export type SettingsSectionDefinition = SettingsSection & {
112  liveApply?: boolean;
113  render: () => ReactNode;
114  save?: SettingsSectionSaveConfig;
115};
116
117export const DAY_OF_WEEK_OPTIONS: DayOfWeek[] = [
118  "monday",
119  "tuesday",
120  "wednesday",
121  "thursday",
122  "friday",
123  "saturday",
124  "sunday",
125];
126
127export const SCHEDULE_TIME_OPTIONS = [
128  "00:00",
129  "01:00",
130  "02:00",
131  "03:00",
132  "04:00",
133  "05:00",
134  "06:00",
135  "07:00",
136  "08:00",
137  "09:00",
138  "10:00",
139  "11:00",
140  "12:00",
141  "13:00",
142  "14:00",
143  "15:00",
144  "16:00",
145  "17:00",
146  "18:00",
147  "19:00",
148  "20:00",
149  "21:00",
150  "22:00",
151  "23:00",
152] as const;
153