feat(notifications): add settings and migration

src/main/constants.ts

@@ -125,9 +125,16 @@ export function defaultSettings(): AppSettings {
     backupIncludeRemoteDiagnostics: false,
     notifyUrl: "",
     notifyMention: "",
-    notifyOnPackageCompleted: false,
-    notifyOnPackageFailed: false,
-    notifyOnRunFinished: false,
+    notifyOnPackageCompleted: false,
+    notifyOnPackageFailed: false,
+    notifyOnRunFinished: false,
+    notifyPackageSuccessMode: "digest",
+    notifyOnRemainingBelow: false,
+    notifyRemainingThresholdGb: 50,
+    notifyOnDownloadStall: false,
+    notifyStallAfterSeconds: 90,
+    notifyStallCooldownMinutes: 10,
+    notifyOnDownloadRecovery: true,
     totalDownloadedAllTime: 0,
     totalCompletedFilesAllTime: 0,
     totalRuntimeAllTimeMs: 0,

src/main/renderer-state.ts

@@ -220,6 +220,13 @@ export function createRendererSettings(settings: AppSettings): RendererSettings
     notifyOnPackageCompleted: settings.notifyOnPackageCompleted,
     notifyOnPackageFailed: settings.notifyOnPackageFailed,
     notifyOnRunFinished: settings.notifyOnRunFinished,
+    notifyPackageSuccessMode: settings.notifyPackageSuccessMode,
+    notifyOnRemainingBelow: settings.notifyOnRemainingBelow,
+    notifyRemainingThresholdGb: settings.notifyRemainingThresholdGb,
+    notifyOnDownloadStall: settings.notifyOnDownloadStall,
+    notifyStallAfterSeconds: settings.notifyStallAfterSeconds,
+    notifyStallCooldownMinutes: settings.notifyStallCooldownMinutes,
+    notifyOnDownloadRecovery: settings.notifyOnDownloadRecovery,
     totalDownloadedAllTime: settings.totalDownloadedAllTime,
     totalCompletedFilesAllTime: settings.totalCompletedFilesAllTime,
     totalRuntimeAllTimeMs: settings.totalRuntimeAllTimeMs,

src/main/storage.ts

@@ -413,10 +413,14 @@ function migrateUpdateRepo(raw: string, fallback: string): string {
   return trimmed;
 }
 
-export function normalizeSettings(settings: AppSettings): AppSettings {
-  const defaults = defaultSettings();
-  const directorySettings = migrateLegacyDefaultDirectories(settings, defaults);
-  const currentUsageDay = getProviderUsageDayKey();
+export function normalizeSettings(settings: AppSettings): AppSettings {
+  const defaults = defaultSettings();
+  const directorySettings = migrateLegacyDefaultDirectories(settings, defaults);
+  const legacySuccessMode = settings.notifyOnPackageCompleted === true ? "individual" : "digest";
+  const notifyPackageSuccessMode = settings.notifyPackageSuccessMode === "individual" || settings.notifyPackageSuccessMode === "digest"
+    ? settings.notifyPackageSuccessMode
+    : legacySuccessMode;
+  const currentUsageDay = getProviderUsageDayKey();
   const legacyMegaLogin = asText(settings.megaLogin);
   const legacyMegaPassword = asText(settings.megaPassword);
   let legacyMegaCredentials = String(settings.megaCredentials ?? "").replace(/\r\n|\r/g, "\n").trim();
@@ -604,9 +608,16 @@ export function normalizeSettings(settings: AppSettings): AppSettings {
     backupIncludeRemoteDiagnostics: settings.backupIncludeRemoteDiagnostics !== undefined ? Boolean(settings.backupIncludeRemoteDiagnostics) : defaults.backupIncludeRemoteDiagnostics,
     notifyUrl: asText(settings.notifyUrl) || defaults.notifyUrl,
     notifyMention: asText(settings.notifyMention) || defaults.notifyMention,
-    notifyOnPackageCompleted: settings.notifyOnPackageCompleted !== undefined ? Boolean(settings.notifyOnPackageCompleted) : defaults.notifyOnPackageCompleted,
-    notifyOnPackageFailed: settings.notifyOnPackageFailed !== undefined ? Boolean(settings.notifyOnPackageFailed) : defaults.notifyOnPackageFailed,
-    notifyOnRunFinished: settings.notifyOnRunFinished !== undefined ? Boolean(settings.notifyOnRunFinished) : defaults.notifyOnRunFinished,
+    notifyOnPackageCompleted: settings.notifyOnPackageCompleted !== undefined ? Boolean(settings.notifyOnPackageCompleted) : defaults.notifyOnPackageCompleted,
+    notifyOnPackageFailed: settings.notifyOnPackageFailed !== undefined ? Boolean(settings.notifyOnPackageFailed) : defaults.notifyOnPackageFailed,
+    notifyOnRunFinished: settings.notifyOnRunFinished !== undefined ? Boolean(settings.notifyOnRunFinished) : defaults.notifyOnRunFinished,
+    notifyPackageSuccessMode,
+    notifyOnRemainingBelow: settings.notifyOnRemainingBelow !== undefined ? Boolean(settings.notifyOnRemainingBelow) : defaults.notifyOnRemainingBelow,
+    notifyRemainingThresholdGb: clampNumber(settings.notifyRemainingThresholdGb, 50, 1, 100000),
+    notifyOnDownloadStall: settings.notifyOnDownloadStall !== undefined ? Boolean(settings.notifyOnDownloadStall) : defaults.notifyOnDownloadStall,
+    notifyStallAfterSeconds: clampNumber(settings.notifyStallAfterSeconds, 90, 60, 3600),
+    notifyStallCooldownMinutes: clampNumber(settings.notifyStallCooldownMinutes, 10, 5, 1440),
+    notifyOnDownloadRecovery: settings.notifyOnDownloadRecovery !== undefined ? Boolean(settings.notifyOnDownloadRecovery) : defaults.notifyOnDownloadRecovery,
     totalDownloadedAllTime: typeof settings.totalDownloadedAllTime === "number" && settings.totalDownloadedAllTime >= 0 ? settings.totalDownloadedAllTime : defaults.totalDownloadedAllTime,
     totalCompletedFilesAllTime: typeof settings.totalCompletedFilesAllTime === "number" && settings.totalCompletedFilesAllTime >= 0 ? settings.totalCompletedFilesAllTime : defaults.totalCompletedFilesAllTime,
     totalRuntimeAllTimeMs: typeof settings.totalRuntimeAllTimeMs === "number" && settings.totalRuntimeAllTimeMs >= 0 ? settings.totalRuntimeAllTimeMs : defaults.totalRuntimeAllTimeMs,
@@ -801,6 +812,9 @@ function readSettingsFile(filePath: string): LoadedSettingsFile | null {
     if (!Object.prototype.hasOwnProperty.call(parsed, "realDebridWebAccountIds")) {
       delete (mergedInput as Partial<AppSettings>).realDebridWebAccountIds;
     }
+    if (!Object.prototype.hasOwnProperty.call(parsed, "notifyPackageSuccessMode")) {
+      delete (mergedInput as Partial<AppSettings>).notifyPackageSuccessMode;
+    }
     const merged = normalizeSettings(mergedInput);
     return { settings: merged, needsCredentialRewrite };
   } catch (error) {

src/renderer/App.tsx

@@ -786,6 +786,8 @@ const emptySnapshot = (): UiSnapshot => ({
     updateRepo: "", autoUpdateCheck: true, clipboardWatch: false, minimizeToTray: false,
     theme: "dark", logStorageLocation: "appdata", collapseNewPackages: true, animatePackageDisclosure: true, historyRetentionMode: "permanent", historyMaxEntries: 500, historyMaxAgeDays: 0, autoSortPackagesByProgress: false, autoSkipExtracted: false, hideExtractedItems: true, confirmDeleteSelection: true, backupIncludeDownloads: false, backupIncludeRemoteDiagnostics: false,
     notifyMention: "", notifyOnPackageCompleted: false, notifyOnPackageFailed: false, notifyOnRunFinished: false,
+    notifyPackageSuccessMode: "digest", notifyOnRemainingBelow: false, notifyRemainingThresholdGb: 50,
+    notifyOnDownloadStall: false, notifyStallAfterSeconds: 90, notifyStallCooldownMinutes: 10, notifyOnDownloadRecovery: true,
     accountListShowDetailedDebridLinkKeys: false,
     bandwidthSchedules: [], totalDownloadedAllTime: 0, totalCompletedFilesAllTime: 0, totalRuntimeAllTimeMs: 0,
     columnOrder: ["name", "size", "progress", "hoster", "account", "prio", "status", "speed", "availability"],

src/shared/types.ts

@@ -120,6 +120,8 @@ export interface DebridAccountStatus {
   checkedAt: number;
 }
 
+export type NotifyPackageSuccessMode = "digest" | "individual";
+
 export interface AppSettings {
   language: AppLanguage;
   token: string;
@@ -200,11 +202,18 @@ export interface AppSettings {
   confirmDeleteSelection: boolean;
   backupIncludeDownloads: boolean;
   backupIncludeRemoteDiagnostics: boolean;
-  notifyUrl: string;
-  notifyMention: string;
-  notifyOnPackageCompleted: boolean;
-  notifyOnPackageFailed: boolean;
-  notifyOnRunFinished: boolean;
+  notifyUrl: string;
+  notifyMention: string;
+  notifyOnPackageCompleted: boolean;
+  notifyOnPackageFailed: boolean;
+  notifyOnRunFinished: boolean;
+  notifyPackageSuccessMode: NotifyPackageSuccessMode;
+  notifyOnRemainingBelow: boolean;
+  notifyRemainingThresholdGb: number;
+  notifyOnDownloadStall: boolean;
+  notifyStallAfterSeconds: number;
+  notifyStallCooldownMinutes: number;
+  notifyOnDownloadRecovery: boolean;
   totalDownloadedAllTime: number;
   totalCompletedFilesAllTime: number;
   totalRuntimeAllTimeMs: number;
@@ -332,6 +341,13 @@ export interface RendererSettings {
   notifyOnPackageCompleted: boolean;
   notifyOnPackageFailed: boolean;
   notifyOnRunFinished: boolean;
+  notifyPackageSuccessMode: NotifyPackageSuccessMode;
+  notifyOnRemainingBelow: boolean;
+  notifyRemainingThresholdGb: number;
+  notifyOnDownloadStall: boolean;
+  notifyStallAfterSeconds: number;
+  notifyStallCooldownMinutes: number;
+  notifyOnDownloadRecovery: boolean;
   totalDownloadedAllTime: number;
   totalCompletedFilesAllTime: number;
   totalRuntimeAllTimeMs: number;