Initial public release v1.7.233

tests/backup-payload.test.ts

@@ -0,0 +1,81 @@
+import { describe, expect, it } from "vitest";
+import { buildBackupPayload, planBackupImport } from "../src/main/backup-payload";
+import type { AppSettings, SessionState, HistoryEntry } from "../src/shared/types";
+
+function settings(overrides: Partial<AppSettings> = {}): AppSettings {
+  return { backupIncludeDownloads: false, token: "secret", outputDir: "C:\\dl" } as unknown as AppSettings;
+}
+
+const session: SessionState = {
+  version: 2, packageOrder: ["p1"], packages: { p1: {} as never }, items: { i1: {} as never },
+  runStartedAt: 0, totalDownloadedBytes: 0, summaryText: "", reconnectUntil: 0,
+  reconnectReason: "", paused: false, running: true, updatedAt: 0
+};
+const history: HistoryEntry[] = [{ id: "h1" } as unknown as HistoryEntry];
+
+const baseInput = { appVersion: "1.7.183", exportedAt: "2026-06-07T00:00:00Z", session, history };
+
+describe("buildBackupPayload — default is settings-only", () => {
+  it("omits session AND history when backupIncludeDownloads is false (default)", () => {
+    const p = buildBackupPayload({ ...baseInput, settings: { backupIncludeDownloads: false } as AppSettings });
+    expect(p.kind).toBe("settings-only");
+    expect(p.session).toBeUndefined();
+    expect(p.history).toBeUndefined();
+    expect(p.settings).toBeDefined();
+  });
+
+  it("includes session + history when backupIncludeDownloads is true", () => {
+    const p = buildBackupPayload({ ...baseInput, settings: { backupIncludeDownloads: true } as AppSettings });
+    expect(p.kind).toBe("full");
+    expect(p.session).toBe(session);
+    expect(p.history).toBe(history);
+  });
+
+  it("treats a missing flag as settings-only (safe default)", () => {
+    const p = buildBackupPayload({ ...baseInput, settings: {} as AppSettings });
+    expect(p.kind).toBe("settings-only");
+    expect(p.session).toBeUndefined();
+  });
+
+  it("ROUND-TRIP: toggle off -> exported payload carries the flag still false", () => {
+    // "Haken aus bleibt aus": the exported settings object preserves the flag,
+    // so importing it keeps the toggle off.
+    const p = buildBackupPayload({ ...baseInput, settings: { backupIncludeDownloads: false } as AppSettings });
+    expect((p.settings as AppSettings).backupIncludeDownloads).toBe(false);
+  });
+});
+
+describe("planBackupImport — decision follows the file, not the local toggle", () => {
+  it("settings-only backup (no session) -> restore settings only, no relaunch", () => {
+    const plan = planBackupImport({ version: 2, kind: "settings-only", settings: { theme: "dark" } });
+    expect(plan.valid).toBe(true);
+    expect(plan.restoreDownloads).toBe(false);
+    expect(plan.message).toMatch(/Einstellungen/);
+  });
+
+  it("full backup (with session) -> restore downloads + relaunch", () => {
+    const plan = planBackupImport({ version: 2, kind: "full", settings: { theme: "dark" }, session });
+    expect(plan.valid).toBe(true);
+    expect(plan.restoreDownloads).toBe(true);
+  });
+
+  it("rejects payloads without settings", () => {
+    expect(planBackupImport({ session }).valid).toBe(false);
+    expect(planBackupImport(null).valid).toBe(false);
+    expect(planBackupImport("nope").valid).toBe(false);
+    expect(planBackupImport({}).valid).toBe(false);
+  });
+
+  it("a settings-only export then import does NOT pull in the download list", () => {
+    // Build with toggle off, then plan the import of exactly that payload.
+    const exported = buildBackupPayload({ ...baseInput, settings: { backupIncludeDownloads: false } as AppSettings });
+    const plan = planBackupImport(JSON.parse(JSON.stringify(exported)));
+    expect(plan.restoreDownloads).toBe(false); // queue stays untouched
+  });
+
+  it("a full export then import DOES restore the download list", () => {
+    const exported = buildBackupPayload({ ...baseInput, settings: { backupIncludeDownloads: true } as AppSettings });
+    const plan = planBackupImport(JSON.parse(JSON.stringify(exported)));
+    expect(plan.restoreDownloads).toBe(true);
+  });
+});