import { DEFAULT_CLIENT_SETTINGS, type ConfirmDialogOptions, type ContextMenuItem, type DesktopBridge, } from "@t3tools/contracts"; import { afterEach, beforeEach, describe, expect, it, vi } from "vite-plus/test"; const showContextMenuFallbackMock = vi.fn< ( items: readonly ContextMenuItem[], position?: { x: number; y: number }, ) => Promise >(); const dismissContextMenuMock = vi.fn<() => void>(); const requestConfirmDialogMock = vi.fn<(message: string, options?: ConfirmDialogOptions) => Promise | undefined>(); vi.mock("./contextMenuFallback", () => ({ showContextMenuFallback: showContextMenuFallbackMock, dismissContextMenu: dismissContextMenuMock, })); vi.mock("./confirmDialog", () => ({ requestConfirmDialog: requestConfirmDialogMock, })); function createLocalStorageStub(): Storage { const values = new Map(); return { getItem: (key) => values.get(key) ?? null, setItem: (key, value) => { values.set(key, value); }, removeItem: (key) => { values.delete(key); }, clear: () => values.clear(), key: (index) => [...values.keys()][index] ?? null, get length() { return values.size; }, }; } function testWindow(): Window & typeof globalThis { return globalThis.window ?? (globalThis as unknown as Window & typeof globalThis); } beforeEach(() => { vi.resetModules(); vi.clearAllMocks(); if (globalThis.window === undefined) { Object.defineProperty(globalThis, "window", { configurable: true, value: globalThis, }); } Reflect.deleteProperty(testWindow(), "desktopBridge"); Object.defineProperty(testWindow(), "localStorage", { configurable: true, value: createLocalStorageStub(), }); }); afterEach(() => { vi.restoreAllMocks(); }); describe("LocalApi", () => { it("keeps backend operations out of the local host facade", async () => { const { createLocalApi } = await import("./localApi"); const api = createLocalApi(); expect(api).not.toHaveProperty("server"); expect(api.shell).not.toHaveProperty("openInEditor"); }); it("uses the browser context-menu fallback without a desktop bridge", async () => { showContextMenuFallbackMock.mockResolvedValue("rename"); const { createLocalApi } = await import("./localApi"); const items = [{ id: "rename", label: "Rename" }] as const; await expect(createLocalApi().contextMenu.show(items, { x: 4, y: 5 })).resolves.toBe("rename"); expect(showContextMenuFallbackMock).toHaveBeenCalledWith(items, { x: 4, y: 5 }); }); it("dismisses an open browser context menu without a desktop bridge", async () => { const { createLocalApi } = await import("./localApi"); await createLocalApi().contextMenu.close(); expect(dismissContextMenuMock).toHaveBeenCalledOnce(); }); it("uses the themed confirmation host when it is available", async () => { requestConfirmDialogMock.mockResolvedValue(true); const { createLocalApi } = await import("./localApi"); const options = { variant: "destructive" } as const; await expect(createLocalApi().dialogs.confirm("Delete this thread?", options)).resolves.toBe( true, ); expect(requestConfirmDialogMock).toHaveBeenCalledWith("Delete this thread?", options); }); it("fails closed in a browser when no themed host is available", async () => { requestConfirmDialogMock.mockReturnValue(undefined); const { createLocalApi } = await import("./localApi"); await expect(createLocalApi().dialogs.confirm("Delete this thread?")).resolves.toBe(false); }); it("rejects opening System Settings when the desktop bridge is unavailable", async () => { const { createLocalApi } = await import("./localApi"); await expect(createLocalApi().shell.openSystemSettings("full-disk-access")).rejects.toThrow( "Unable to open System Settings.", ); }); it("delegates host capabilities and persistence to the desktop bridge", async () => { const showContextMenu = vi.fn().mockResolvedValue("delete"); const pickFolder = vi.fn().mockResolvedValue("/tmp/project"); const getClientSettings = vi.fn().mockResolvedValue(DEFAULT_CLIENT_SETTINGS); const setClientSettings = vi.fn().mockResolvedValue(undefined); testWindow().desktopBridge = { showContextMenu, pickFolder, getClientSettings, setClientSettings, } as unknown as DesktopBridge; const { createLocalApi } = await import("./localApi"); const api = createLocalApi(); const items = [{ id: "delete", label: "Delete" }] as const; await expect(api.contextMenu.show(items)).resolves.toBe("delete"); requestConfirmDialogMock.mockReturnValue(undefined); await expect(api.dialogs.confirm("Install update?")).resolves.toBe(false); await expect(api.dialogs.pickFolder({ initialPath: "/tmp" })).resolves.toBe("/tmp/project"); await expect(api.persistence.getClientSettings()).resolves.toEqual(DEFAULT_CLIENT_SETTINGS); await api.persistence.setClientSettings(DEFAULT_CLIENT_SETTINGS); expect(showContextMenu).toHaveBeenCalledWith(items, undefined); expect(pickFolder).toHaveBeenCalledWith({ initialPath: "/tmp" }); expect(getClientSettings).toHaveBeenCalledTimes(1); expect(setClientSettings).toHaveBeenCalledWith(DEFAULT_CLIENT_SETTINGS); }); it("persists client settings in browser storage", async () => { const { createLocalApi } = await import("./localApi"); const api = createLocalApi(); const settings = { ...DEFAULT_CLIENT_SETTINGS, timestampFormat: "12-hour" as const, }; await api.persistence.setClientSettings(settings); await expect(api.persistence.getClientSettings()).resolves.toEqual(settings); }); });