- feat(FN-2262): document Paperclip runtime configuration and constraints - docs(FN-2261): update README with implementation details - feat(FN-2261): add paperclip runtime resolution compatibility tests - feat(FN-2261): add runtime adapter and registration tests - feat(FN-2261): integrate adapter into plugin entrypoint - feat(FN-2261): implement PaperclipRuntimeAdapter - fix(FN-2261): remove pi-coding-agent re-exports from types.ts - feat(FN-2261): define runtime types for Paperclip plugin - feat(FN-2260): merge fusion/fn-2260
358 lines
12 KiB
TypeScript
358 lines
12 KiB
TypeScript
import { fireEvent, render, screen, waitFor } from "@testing-library/react";
|
|
import { beforeEach, describe, expect, it, vi } from "vitest";
|
|
import type { DevServerConfig, DevServerState } from "../../api";
|
|
import { DevServerView } from "../DevServerView";
|
|
|
|
const mockUseDevServer = vi.fn();
|
|
const mockUseDevServerConfig = vi.fn();
|
|
const mockUseDevServerLogs = vi.fn();
|
|
const mockUsePreviewEmbed = vi.fn();
|
|
|
|
vi.mock("../../hooks/useDevServer", () => ({
|
|
useDevServer: (...args: unknown[]) => mockUseDevServer(...args),
|
|
}));
|
|
|
|
vi.mock("../../hooks/useDevServerConfig", () => ({
|
|
useDevServerConfig: (...args: unknown[]) => mockUseDevServerConfig(...args),
|
|
}));
|
|
|
|
vi.mock("../../hooks/useDevServerLogs", () => ({
|
|
useDevServerLogs: (...args: unknown[]) => mockUseDevServerLogs(...args),
|
|
}));
|
|
|
|
vi.mock("../../hooks/usePreviewEmbed", () => ({
|
|
usePreviewEmbed: (...args: unknown[]) => mockUsePreviewEmbed(...args),
|
|
}));
|
|
|
|
vi.mock("../DevServerLogViewer", () => ({
|
|
DevServerLogViewer: () => <div data-testid="mock-devserver-log-viewer" />,
|
|
}));
|
|
|
|
vi.mock("lucide-react", () => ({
|
|
AlertTriangle: () => <span data-testid="icon-alert-triangle" />,
|
|
ChevronDown: () => <span data-testid="icon-chevron-down" />,
|
|
ExternalLink: () => <span data-testid="icon-external-link" />,
|
|
Eye: () => <span data-testid="icon-eye" />,
|
|
Loader2: () => <span data-testid="icon-loader" />,
|
|
Maximize2: () => <span data-testid="icon-maximize" />,
|
|
Minimize2: () => <span data-testid="icon-minimize" />,
|
|
Monitor: () => <span data-testid="icon-monitor" />,
|
|
Play: () => <span data-testid="icon-play" />,
|
|
RefreshCw: () => <span data-testid="icon-refresh" />,
|
|
RotateCw: () => <span data-testid="icon-rotate" />,
|
|
Search: () => <span data-testid="icon-search" />,
|
|
Square: () => <span data-testid="icon-square" />,
|
|
}));
|
|
|
|
function createState(overrides: Partial<DevServerState> = {}): DevServerState {
|
|
return {
|
|
id: "default",
|
|
name: "default",
|
|
status: "stopped",
|
|
command: "pnpm dev",
|
|
scriptName: "dev",
|
|
cwd: ".",
|
|
logs: [],
|
|
...overrides,
|
|
};
|
|
}
|
|
|
|
function legacyStateToSession(legacy: DevServerState) {
|
|
return {
|
|
config: {
|
|
id: legacy.id ?? "default",
|
|
name: legacy.name ?? "Dev Server",
|
|
command: legacy.command ?? "",
|
|
cwd: legacy.cwd ?? ".",
|
|
},
|
|
status: legacy.status,
|
|
runtime: legacy.pid
|
|
? {
|
|
pid: legacy.pid,
|
|
startedAt: legacy.startedAt ?? new Date().toISOString(),
|
|
exitCode: legacy.exitCode ?? undefined,
|
|
previewUrl: legacy.previewUrl,
|
|
}
|
|
: undefined,
|
|
previewUrl: legacy.previewUrl ?? legacy.detectedUrl ?? legacy.manualUrl,
|
|
logHistory: [],
|
|
};
|
|
}
|
|
|
|
function createDevServerHookState(overrides: Record<string, unknown> = {}) {
|
|
const defaultCandidates = [
|
|
{ name: "dev", command: "pnpm dev", scriptName: "dev", cwd: ".", source: "root", label: "project · dev (root)" },
|
|
{ name: "start", command: "pnpm start --filter web", scriptName: "start", cwd: "apps/web", source: "apps/web", workspaceName: "@demo/web", label: "@demo/web · start (apps/web)" },
|
|
];
|
|
const candidates = (overrides.candidates as typeof defaultCandidates | undefined) ?? defaultCandidates;
|
|
const start = (overrides.start as ReturnType<typeof vi.fn> | undefined) ?? vi.fn().mockResolvedValue(undefined);
|
|
const stop = (overrides.stop as ReturnType<typeof vi.fn> | undefined) ?? vi.fn().mockResolvedValue(undefined);
|
|
const restart = (overrides.restart as ReturnType<typeof vi.fn> | undefined) ?? vi.fn().mockResolvedValue(undefined);
|
|
const setPreviewUrl = (overrides.setPreviewUrl as ReturnType<typeof vi.fn> | undefined) ?? vi.fn().mockResolvedValue(undefined);
|
|
const detect = (overrides.detect as ReturnType<typeof vi.fn> | undefined) ?? vi.fn().mockResolvedValue(undefined);
|
|
const refresh = (overrides.refresh as ReturnType<typeof vi.fn> | undefined) ?? vi.fn().mockResolvedValue(undefined);
|
|
const serverState = (overrides.serverState as DevServerState | undefined) ?? createState();
|
|
return {
|
|
// legacy API (still read by some tests as aliases)
|
|
logs: ["ready"],
|
|
loading: false,
|
|
error: null,
|
|
setManualUrl: setPreviewUrl,
|
|
refreshStatus: refresh,
|
|
// new API consumed by the current component
|
|
sessions: [],
|
|
previewUrl: serverState.previewUrl ?? null,
|
|
isLoading: false,
|
|
...overrides,
|
|
// the following must come AFTER `...overrides` so aliases track the
|
|
// overridden legacy fields (start, serverState, candidates, ...).
|
|
candidates,
|
|
serverState,
|
|
start,
|
|
stop,
|
|
restart,
|
|
setPreviewUrl,
|
|
detect,
|
|
session: legacyStateToSession(serverState),
|
|
detectedCommands: candidates,
|
|
startServer: start,
|
|
stopServer: stop,
|
|
restartServer: restart,
|
|
detectCommands: detect,
|
|
refresh,
|
|
};
|
|
}
|
|
|
|
function createConfig(overrides: Partial<DevServerConfig> = {}): DevServerConfig {
|
|
return {
|
|
selectedScript: null,
|
|
selectedSource: null,
|
|
selectedCommand: null,
|
|
previewUrlOverride: null,
|
|
detectedPreviewUrl: null,
|
|
selectedAt: null,
|
|
...overrides,
|
|
};
|
|
}
|
|
|
|
function createConfigHookState(overrides: Record<string, unknown> = {}) {
|
|
return {
|
|
config: createConfig(),
|
|
loading: false,
|
|
error: null,
|
|
selectScript: vi.fn().mockResolvedValue(undefined),
|
|
clearSelection: vi.fn().mockResolvedValue(undefined),
|
|
setPreviewUrlOverride: vi.fn().mockResolvedValue(undefined),
|
|
refresh: vi.fn().mockResolvedValue(undefined),
|
|
...overrides,
|
|
};
|
|
}
|
|
|
|
function createDevServerLogsHookState(overrides: Record<string, unknown> = {}) {
|
|
return {
|
|
entries: [],
|
|
loading: false,
|
|
loadingMore: false,
|
|
hasMore: false,
|
|
total: 0,
|
|
loadMore: vi.fn(),
|
|
clear: vi.fn(),
|
|
...overrides,
|
|
};
|
|
}
|
|
|
|
function createPreviewEmbedState(overrides: Record<string, unknown> = {}) {
|
|
return {
|
|
embedStatus: "embedded",
|
|
iframeRef: { current: null },
|
|
handleIframeLoad: vi.fn(),
|
|
handleIframeError: vi.fn(),
|
|
resetEmbed: vi.fn(),
|
|
isEmbedded: true,
|
|
isBlocked: false,
|
|
...overrides,
|
|
};
|
|
}
|
|
|
|
describe("DevServerView", () => {
|
|
const addToast = vi.fn();
|
|
|
|
beforeEach(() => {
|
|
vi.clearAllMocks();
|
|
mockUseDevServer.mockReturnValue(createDevServerHookState());
|
|
mockUseDevServerConfig.mockReturnValue(createConfigHookState());
|
|
mockUseDevServerLogs.mockReturnValue(createDevServerLogsHookState());
|
|
mockUsePreviewEmbed.mockReturnValue(createPreviewEmbedState());
|
|
});
|
|
|
|
it("renders without crashing", () => {
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
expect(screen.getByTestId("dev-server-view")).toBeInTheDocument();
|
|
});
|
|
|
|
it("renders candidate list when detection returns scripts", () => {
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
expect(screen.getByTestId("dev-server-candidates")).toBeInTheDocument();
|
|
expect(screen.getByText("dev")).toBeInTheDocument();
|
|
expect(screen.getByText("start")).toBeInTheDocument();
|
|
});
|
|
|
|
it("renders no-candidates message when candidates are empty", () => {
|
|
mockUseDevServer.mockReturnValue(createDevServerHookState({ candidates: [] }));
|
|
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
expect(screen.getByTestId("dev-server-empty-candidates")).toHaveTextContent("No dev server scripts detected");
|
|
});
|
|
|
|
it("shows stopped status badge", () => {
|
|
mockUseDevServer.mockReturnValue(createDevServerHookState({ serverState: createState({ status: "stopped" }) }));
|
|
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
expect(screen.getByTestId("dev-server-status-badge")).toHaveTextContent("Stopped");
|
|
});
|
|
|
|
it("shows running status badge", () => {
|
|
mockUseDevServer.mockReturnValue(createDevServerHookState({ serverState: createState({ status: "running" }) }));
|
|
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
expect(screen.getByTestId("dev-server-status-badge")).toHaveTextContent("Running");
|
|
});
|
|
|
|
it("disables start when running and stop when stopped", () => {
|
|
mockUseDevServer.mockReturnValue(createDevServerHookState({ serverState: createState({ status: "running" }) }));
|
|
|
|
const { rerender } = render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
expect(screen.getByTestId("dev-server-start-button")).toBeDisabled();
|
|
|
|
mockUseDevServer.mockReturnValue(createDevServerHookState({ serverState: createState({ status: "stopped" }) }));
|
|
rerender(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
expect(screen.getByTestId("dev-server-stop-button")).toBeDisabled();
|
|
});
|
|
|
|
it("clicking start calls start from hook", async () => {
|
|
const start = vi.fn().mockResolvedValue(undefined);
|
|
mockUseDevServer.mockReturnValue(createDevServerHookState({ start }));
|
|
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
fireEvent.click(screen.getByTestId("dev-server-start-button"));
|
|
|
|
await waitFor(() => {
|
|
expect(start).toHaveBeenCalled();
|
|
});
|
|
});
|
|
|
|
it("clicking stop calls stop from hook", async () => {
|
|
const stop = vi.fn().mockResolvedValue(undefined);
|
|
mockUseDevServer.mockReturnValue(
|
|
createDevServerHookState({
|
|
stop,
|
|
serverState: createState({ status: "running" }),
|
|
}),
|
|
);
|
|
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
fireEvent.click(screen.getByTestId("dev-server-stop-button"));
|
|
|
|
await waitFor(() => {
|
|
expect(stop).toHaveBeenCalled();
|
|
});
|
|
});
|
|
|
|
it("clicking restart calls restart from hook", async () => {
|
|
const restart = vi.fn().mockResolvedValue(undefined);
|
|
mockUseDevServer.mockReturnValue(
|
|
createDevServerHookState({
|
|
restart,
|
|
serverState: createState({ status: "running" }),
|
|
}),
|
|
);
|
|
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
fireEvent.click(screen.getByTestId("dev-server-restart-button"));
|
|
|
|
await waitFor(() => {
|
|
expect(restart).toHaveBeenCalled();
|
|
});
|
|
});
|
|
|
|
it("clicking a candidate shows the selected-script summary", async () => {
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
fireEvent.click(screen.getByTestId("dev-server-candidate-dev-root"));
|
|
|
|
await waitFor(() => {
|
|
expect(screen.getByTestId("dev-server-selected-summary")).toBeInTheDocument();
|
|
});
|
|
});
|
|
|
|
it("re-shows the candidates list when the user clicks Change after selecting", () => {
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
fireEvent.click(screen.getByTestId("dev-server-candidate-dev-root"));
|
|
expect(screen.getByTestId("dev-server-selected-summary")).toBeInTheDocument();
|
|
|
|
fireEvent.click(screen.getByTestId("dev-server-change-selection"));
|
|
|
|
expect(screen.getByTestId("dev-server-candidates")).toBeInTheDocument();
|
|
});
|
|
|
|
it("saves preview URL override from input", async () => {
|
|
const setPreviewUrl = vi.fn().mockResolvedValue(undefined);
|
|
mockUseDevServer.mockReturnValue(createDevServerHookState({ setPreviewUrl }));
|
|
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
fireEvent.change(screen.getByTestId("dev-server-preview-input"), {
|
|
target: { value: "http://localhost:3000" },
|
|
});
|
|
fireEvent.click(screen.getByTestId("dev-server-set-preview"));
|
|
|
|
await waitFor(() => {
|
|
expect(setPreviewUrl).toHaveBeenCalledWith("http://localhost:3000");
|
|
});
|
|
});
|
|
|
|
it("renders log viewer panel", () => {
|
|
mockUseDevServerLogs.mockReturnValue(
|
|
createDevServerLogsHookState({
|
|
entries: [{ id: 1, text: "server started", stream: "stdout", timestamp: "2026-01-01T00:00:00.000Z" }],
|
|
}),
|
|
);
|
|
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
expect(screen.getByTestId("mock-devserver-log-viewer")).toBeInTheDocument();
|
|
});
|
|
|
|
it("renders preview iframe when preview URL is available", () => {
|
|
mockUseDevServer.mockReturnValue(
|
|
createDevServerHookState({
|
|
serverState: createState({ status: "running", previewUrl: "http://localhost:3000" }),
|
|
}),
|
|
);
|
|
mockUsePreviewEmbed.mockReturnValue(createPreviewEmbedState({ embedStatus: "embedded", isBlocked: false }));
|
|
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
expect(screen.getByTitle("Dev server preview")).toBeInTheDocument();
|
|
});
|
|
|
|
it("renders selected script summary after user selects a script", () => {
|
|
render(<DevServerView addToast={addToast} projectId="project-a" />);
|
|
|
|
fireEvent.click(screen.getByTestId("dev-server-candidate-dev-root"));
|
|
|
|
expect(screen.getByTestId("dev-server-selected-summary")).toBeInTheDocument();
|
|
});
|
|
});
|