hmmhmmhm · hmmhmmhm · May 19, 2026 · May 19, 2026 · May 19, 2026 · May 19, 2026
diff --git a/apps/browser/package.json b/apps/browser/package.json
@@ -21,6 +21,7 @@
     "evs:verify": "node scripts/evs-sign.js --verify",
     "check-types": "tsc --noEmit",
     "lint": "tsc --noEmit --pretty false",
+    "test": "vitest run",
     "audit": "npm audit",
     "audit:fix": "npm audit fix",
     "outdated": "npm outdated"
@@ -48,7 +49,8 @@
     "esbuild": "^0.28.0",
     "tailwindcss": "^4.3.0",
     "typescript": "5.9.2",
-    "vite": "^8.0.13"
+    "vite": "^8.0.13",
+    "vitest": "^3.2.4"
   },
   "build": {
     "appId": "com.aka-browser.app",

diff --git a/apps/browser/src/main/__tests__/browsing-data-manager.test.ts b/apps/browser/src/main/__tests__/browsing-data-manager.test.ts
@@ -0,0 +1,82 @@
+import { describe, expect, it, vi } from "vitest";
+import { BrowsingDataManager } from "../browsing-data-manager";
+
+function createManager() {
+  const history = { clear: vi.fn() };
+  const permissions = { clear: vi.fn() };
+  const sessionState = { clear: vi.fn() };
+  const favicon = { clearCache: vi.fn() };
+  const theme = { clear: vi.fn() };
+  const electronSession = {
+    clearCache: vi.fn(async () => undefined),
+    clearStorageData: vi.fn(async () => undefined),
+  };
+
+  return {
+    electronSession,
+    favicon,
+    history,
+    manager: new BrowsingDataManager({
+      electronSession,
+      faviconCache: favicon,
+      historyManager: history,
+      permissionManager: permissions,
+      sessionManager: sessionState,
+      themeColorCache: theme,
+    }),
+    permissions,
+    sessionState,
+    theme,
+  };
+}
+
+describe("BrowsingDataManager", () => {
+  it("clears history", async () => {
+    const { history, manager } = createManager();
+
+    await expect(manager.clearHistory()).resolves.toEqual({
+      ok: true,
+      target: "history",
+    });
+    expect(history.clear).toHaveBeenCalledOnce();
+  });
+
+  it("clears cookies and cache through Electron session", async () => {
+    const { electronSession, manager } = createManager();
+
+    await manager.clearCookies();
+    await manager.clearCache();
+
+    expect(electronSession.clearStorageData).toHaveBeenCalledWith({
+      storages: ["cookies"],
+    });
+    expect(electronSession.clearCache).toHaveBeenCalledOnce();
+  });
+
+  it("clears all app-owned site data", async () => {
+    const { favicon, history, manager, permissions, sessionState, theme } =
+      createManager();
+
+    const results = await manager.clearAll();
+
+    expect(results.every((result) => result.ok)).toBe(true);
+    expect(history.clear).toHaveBeenCalledOnce();
+    expect(permissions.clear).toHaveBeenCalledOnce();
+    expect(sessionState.clear).toHaveBeenCalledOnce();
+    expect(favicon.clearCache).toHaveBeenCalledOnce();
+    expect(theme.clear).toHaveBeenCalledOnce();
+  });
+
+  it("returns structured failures", async () => {
+    const { manager, history } = createManager();
+    history.clear.mockImplementation(() => {
+      throw new Error("disk failed");
+    });
+
+    await expect(manager.clearHistory()).resolves.toEqual({
+      error: "disk failed",
+      ok: false,
+      target: "history",
+    });
+  });
+});
diff --git a/apps/browser/src/main/__tests__/download-manager.test.ts b/apps/browser/src/main/__tests__/download-manager.test.ts
@@ -0,0 +1,74 @@
+import { describe, expect, it } from "vitest";
+import { DownloadManager } from "../download-manager";
+
+describe("DownloadManager", () => {
+  it("starts downloads and lists newest first", () => {
+    const manager = new DownloadManager();
+
+    const first = manager.startDownload({
+      filename: "a.txt",
+      savePath: "/tmp/a.txt",
+      totalBytes: 10,
+      url: "https://example.com/a.txt",
+    }, 100);
+    const second = manager.startDownload({
+      filename: "b.txt",
+      savePath: "/tmp/b.txt",
+      totalBytes: 20,
+      url: "https://example.com/b.txt",
+    }, 200);
+
+    expect(manager.list().map((item) => item.id)).toEqual([second.id, first.id]);
+  });
+
+  it("tracks progress", () => {
+    const manager = new DownloadManager();
+    const item = manager.startDownload({
+      filename: "a.txt",
+      savePath: "/tmp/a.txt",
+      totalBytes: 10,
+      url: "https://example.com/a.txt",
+    }, 100);
+
+    manager.updateProgress(item.id, 5, 10);
+
+    expect(manager.get(item.id)?.receivedBytes).toBe(5);
+    expect(manager.get(item.id)?.totalBytes).toBe(10);
+  });
+
+  it("marks completed downloads", () => {
+    const manager = new DownloadManager();
+    const item = manager.startDownload({
+      filename: "a.txt",
+      savePath: "/tmp/a.txt",
+      totalBytes: 10,
+      url: "https://example.com/a.txt",
+    }, 100);
+
+    manager.finishDownload(item.id, "completed", 200);
+
+    expect(manager.get(item.id)?.state).toBe("completed");
+    expect(manager.get(item.id)?.endedAt).toBe(200);
+  });
+
+  it("clears completed downloads only", () => {
+    const manager = new DownloadManager();
+    const completed = manager.startDownload({
+      filename: "a.txt",
+      savePath: "/tmp/a.txt",
+      totalBytes: 10,
+      url: "https://example.com/a.txt",
+    }, 100);
+    const active = manager.startDownload({
+      filename: "b.txt",
+      savePath: "/tmp/b.txt",
+      totalBytes: 20,
+      url: "https://example.com/b.txt",
+    }, 200);
+    manager.finishDownload(completed.id, "completed", 300);
+
+    manager.clearCompleted();
+
+    expect(manager.list().map((item) => item.id)).toEqual([active.id]);
+  });
+});
diff --git a/apps/browser/src/main/__tests__/external-protocol.test.ts b/apps/browser/src/main/__tests__/external-protocol.test.ts
@@ -0,0 +1,33 @@
+import { describe, expect, it } from "vitest";
+import {
+  buildExternalProtocolPrompt,
+  getExternalProtocol,
+  isConfirmableExternalProtocol,
+} from "../external-protocol";
+
+describe("external protocol helpers", () => {
+  it("extracts the protocol from app links", () => {
+    expect(getExternalProtocol("mailto:test@example.com")).toBe("mailto:");
+    expect(getExternalProtocol("tel:+15551234567")).toBe("tel:");
+  });
+
+  it("rejects web URLs as external protocols", () => {
+    expect(getExternalProtocol("https://example.com")).toBeNull();
+  });
+
+  it("allows only confirmable external protocols", () => {
+    expect(isConfirmableExternalProtocol("mailto:")).toBe(true);
+    expect(isConfirmableExternalProtocol("tel:")).toBe(true);
+    expect(isConfirmableExternalProtocol("unknown:")).toBe(false);
+  });
+
+  it("builds a user-facing prompt", () => {
+    expect(
+      buildExternalProtocolPrompt("mailto:test@example.com", "https://example.com")
+    ).toEqual({
+      detail:
+        "https://example.com wants to open mailto:test@example.com outside aka-browser.",
+      message: "Open mailto: link?",
+    });
+  });
+});
diff --git a/apps/browser/src/main/__tests__/history-manager.test.ts b/apps/browser/src/main/__tests__/history-manager.test.ts
@@ -0,0 +1,81 @@
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { HistoryManager } from "../history-manager";
+
+let tempDir: string;
+
+beforeEach(() => {
+  tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "aka-history-"));
+});
+
+afterEach(() => {
+  fs.rmSync(tempDir, { force: true, recursive: true });
+});
+
+describe("HistoryManager", () => {
+  it("records new visits", () => {
+    const manager = new HistoryManager(tempDir);
+
+    manager.recordVisit("https://example.com", "Example", 100);
+
+    expect(manager.list()).toEqual([
+      {
+        title: "Example",
+        url: "https://example.com",
+        visitCount: 1,
+        visitedAt: 100,
+      },
+    ]);
+  });
+
+  it("deduplicates by URL and increments visit count", () => {
+    const manager = new HistoryManager(tempDir);
+
+    manager.recordVisit("https://example.com", "Old", 100);
+    manager.recordVisit("https://example.com", "New", 200);
+
+    expect(manager.list()).toEqual([
+      {
+        title: "New",
+        url: "https://example.com",
+        visitCount: 2,
+        visitedAt: 200,
+      },
+    ]);
+  });
+
+  it("sorts newest visits first and applies limits", () => {
+    const manager = new HistoryManager(tempDir);
+
+    manager.recordVisit("https://a.example", "A", 100);
+    manager.recordVisit("https://b.example", "B", 300);
+    manager.recordVisit("https://c.example", "C", 200);
+
+    expect(manager.list(2).map((entry) => entry.url)).toEqual([
+      "https://b.example",
+      "https://c.example",
+    ]);
+  });
+
+  it("clears history", () => {
+    const manager = new HistoryManager(tempDir);
+    manager.recordVisit("https://example.com", "Example", 100);
+
+    manager.clear();
+
+    expect(manager.list()).toEqual([]);
+  });
+
+  it("recovers from corrupt storage", () => {
+    const errorSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+    fs.writeFileSync(path.join(tempDir, "history.json"), "{", "utf-8");
+
+    const manager = new HistoryManager(tempDir);
+
+    expect(manager.list()).toEqual([]);
+    expect(errorSpy).toHaveBeenCalledOnce();
+    errorSpy.mockRestore();
+  });
+});
diff --git a/apps/browser/src/main/__tests__/permission-manager.test.ts b/apps/browser/src/main/__tests__/permission-manager.test.ts
@@ -0,0 +1,77 @@
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import {
+  PermissionManager,
+  SitePermission,
+} from "../permission-manager";
+
+let tempDir: string;
+
+beforeEach(() => {
+  tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "aka-permissions-"));
+});
+
+afterEach(() => {
+  fs.rmSync(tempDir, { force: true, recursive: true });
+});
+
+describe("PermissionManager", () => {
+  it("returns prompt for supported permissions without a saved decision", () => {
+    const manager = new PermissionManager(tempDir);
+
+    expect(manager.getDecision("https://example.com", "media")).toBe("prompt");
+  });
+
+  it("persists allow and block decisions by origin and permission", () => {
+    const manager = new PermissionManager(tempDir);
+
+    manager.setDecision("https://example.com/path", "media", "allow");
+    manager.setDecision("https://example.com/path", "fullscreen", "block");
+
+    const reloaded = new PermissionManager(tempDir);
+    expect(reloaded.getDecision("https://example.com", "media")).toBe("allow");
+    expect(reloaded.getDecision("https://example.com", "fullscreen")).toBe(
+      "block"
+    );
+  });
+
+  it("lists decisions in updated order", () => {
+    const manager = new PermissionManager(tempDir);
+
+    manager.setDecision("https://a.example", "media", "allow", 10);
+    manager.setDecision("https://b.example", "fullscreen", "block", 20);
+
+    expect(manager.list().map((entry) => entry.origin)).toEqual([
+      "https://b.example",
+      "https://a.example",
+    ]);
+  });
+
+  it("clears one origin or all decisions", () => {
+    const manager = new PermissionManager(tempDir);
+    const permission: SitePermission = "media";
+
+    manager.setDecision("https://a.example", permission, "allow");
+    manager.setDecision("https://b.example", permission, "block");
+    manager.clear("https://a.example/path");
+
+    expect(manager.getDecision("https://a.example", permission)).toBe("prompt");
+    expect(manager.getDecision("https://b.example", permission)).toBe("block");
+
+    manager.clear();
+    expect(manager.list()).toEqual([]);
+  });
+
+  it("recovers from corrupt storage", () => {
+    const errorSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+    fs.writeFileSync(path.join(tempDir, "site-permissions.json"), "{", "utf-8");
+
+    const manager = new PermissionManager(tempDir);
+
+    expect(manager.list()).toEqual([]);
+    expect(errorSpy).toHaveBeenCalledOnce();
+    errorSpy.mockRestore();
+  });
+});