import type { PreviewSessionSnapshot, ScopedThreadRef } from "@t3tools/contracts"; import * as Cause from "effect/Cause"; import { AsyncResult } from "effect/unstable/reactivity"; import { afterEach, beforeEach, describe, expect, it, vi } from "vite-plus/test"; import { openTerminalLinkInPreview, TerminalLinkPreviewOpenError, } from "./openTerminalLinkInPreview"; vi.mock("~/previewStateStore", () => ({ applyPreviewServerSnapshot: vi.fn(), isPreviewSupportedInRuntime: () => true, })); vi.mock("~/rightPanelStore", () => ({ useRightPanelStore: { getState: () => ({ openBrowser: vi.fn() }), }, })); const browserDefaultsMocks = vi.hoisted(() => ({ resolve: vi.fn(), })); vi.mock("~/browser/browserDefaults", () => ({ resolveBrowserDefaults: browserDefaultsMocks.resolve, browserDefaultOpenViewport: (defaults: { viewport: unknown }) => defaults.viewport, browserDefaultOpenProfileId: (defaults: { profileId: string }) => defaults.profileId, })); const linkTargetMocks = vi.hoisted(() => ({ preference: vi.fn<() => "system" | "app">(), })); vi.mock("~/browser/browserLinkTarget", () => ({ resolveBrowserLinkTargetPreference: async () => linkTargetMocks.preference(), isWebUrl: (url: string) => /^https?:/u.test(url), })); const hydratedDefaults = { viewport: { _tag: "fixed", width: 1280, height: 720 } as const, profileId: "work", }; const threadRef = { environmentId: "local" as ScopedThreadRef["environmentId"], threadId: "thread-1" as ScopedThreadRef["threadId"], }; const snapshot: PreviewSessionSnapshot = { threadId: threadRef.threadId, tabId: "tab-1", navStatus: { _tag: "Idle" }, canGoBack: false, canGoForward: false, updatedAt: "2026-06-20T00:00:00.000Z", }; beforeEach(() => { browserDefaultsMocks.resolve.mockReset(); browserDefaultsMocks.resolve.mockResolvedValue(hydratedDefaults); linkTargetMocks.preference.mockReturnValue("app"); }); afterEach(() => { vi.restoreAllMocks(); }); describe("openTerminalLinkInPreview", () => { it("opens in the system browser while that is the configured target", async () => { linkTargetMocks.preference.mockReturnValue("system"); const fallbackToBrowser = vi.fn(); const openPreview = vi.fn(async () => AsyncResult.success(snapshot)); await openTerminalLinkInPreview({ url: "http://localhost:3000/", threadRef, openPreview, fallbackToBrowser, }); expect(fallbackToBrowser).toHaveBeenCalledOnce(); expect(openPreview).not.toHaveBeenCalled(); }); it("opens public URLs in-app too, not only local servers", async () => { const fallbackToBrowser = vi.fn(); const openPreview = vi.fn(async () => AsyncResult.success(snapshot)); await openTerminalLinkInPreview({ url: "https://example.com/docs", threadRef, openPreview, fallbackToBrowser, }); expect(openPreview).toHaveBeenCalledOnce(); expect(fallbackToBrowser).not.toHaveBeenCalled(); }); it("waits for hydrated viewport and profile defaults before opening", async () => { let hydrate: ((defaults: typeof hydratedDefaults) => void) | undefined; browserDefaultsMocks.resolve.mockImplementationOnce( () => new Promise((resolve) => { hydrate = resolve; }), ); const openPreview = vi.fn(async () => AsyncResult.success(snapshot)); const opening = openTerminalLinkInPreview({ url: "http://localhost:3000/", threadRef, openPreview, fallbackToBrowser: vi.fn(), }); await vi.waitFor(() => expect(browserDefaultsMocks.resolve).toHaveBeenCalledOnce()); expect(openPreview).not.toHaveBeenCalled(); hydrate?.(hydratedDefaults); await opening; expect(openPreview).toHaveBeenCalledWith({ environmentId: "local", input: { threadId: "thread-1", url: "http://localhost:3000/", viewport: hydratedDefaults.viewport, profileId: hydratedDefaults.profileId, }, }); }); it("preserves the complete preview failure cause before falling back", async () => { const rpcError = new Error("preview unavailable"); const cause = Cause.combine(Cause.fail(rpcError), Cause.die("preview defect")); const fallbackToBrowser = vi.fn(); const reportError = vi.spyOn(console, "error").mockImplementation(() => undefined); await openTerminalLinkInPreview({ url: "http://127.0.0.1:5173/", threadRef, openPreview: async () => AsyncResult.failure(cause), fallbackToBrowser, }); expect(fallbackToBrowser).toHaveBeenCalledOnce(); expect(reportError).toHaveBeenCalledOnce(); const error = reportError.mock.calls[0]?.[0]; expect(error).toBeInstanceOf(TerminalLinkPreviewOpenError); expect(error).toMatchObject({ environmentId: "local", threadId: "thread-1", targetOrigin: "http://127.0.0.1:5173", cause, }); expect(error.message).not.toContain("preview unavailable"); }); it("does not report or fall back when opening the preview is interrupted", async () => { const fallbackToBrowser = vi.fn(); const reportError = vi.spyOn(console, "error").mockImplementation(() => undefined); await openTerminalLinkInPreview({ url: "http://localhost:5173/", threadRef, openPreview: async () => AsyncResult.failure(Cause.interrupt()), fallbackToBrowser, }); expect(reportError).not.toHaveBeenCalled(); expect(fallbackToBrowser).not.toHaveBeenCalled(); }); });