import { act, cleanup, renderHook, waitFor } from "@testing-library/react"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import type { QueuedMessage } from "@/lib/state/slices/session/types"; import type { EntityReference } from "@/lib/types/entity-reference"; const queueApiMock = vi.hoisted(() => { class QueueEntryNotFoundError extends Error {} return { QueueEntryNotFoundError, queueMessage: vi.fn(), clearQueue: vi.fn(), drainQueuedMessage: vi.fn(), getQueueStatus: vi.fn(), updateQueuedMessage: vi.fn(), removeQueuedEntry: vi.fn(), }; }); type MockQueueState = { queue: { bySessionId: Record; metaBySessionId: Record; isLoading: Record; }; connection: { status: string }; setQueueEntries: ReturnType; removeQueueEntry: ReturnType; setQueueLoading: ReturnType; }; let mockState: MockQueueState; vi.mock("@/components/state-provider", () => ({ useAppStore: (selector: (state: MockQueueState) => unknown) => selector(mockState), })); vi.mock("@/lib/api/domains/queue-api", () => queueApiMock); import { useQueue } from "./use-queue"; const SESSION_ID = "sess-1"; const TASK_ID = "task-1"; const reference: EntityReference = { version: 1, ref: "mention:v1:github:issue:acme%2Frepo:42", provider: "github", kind: "issue", id: "42", key: "acme/repo#42", title: "Fix composer references", url: "https://github.com/acme/repo/issues/42", scope: "acme/repo", }; function entry(overrides: Partial = {}): QueuedMessage { return { id: "q-1", session_id: SESSION_ID, task_id: TASK_ID, content: "queued prompt", plan_mode: false, queued_at: "2026-06-27T00:00:00Z", queued_by: "user", ...overrides, }; } function setDocumentVisibility(value: DocumentVisibilityState) { Object.defineProperty(document, "visibilityState", { configurable: true, value, }); } function resetMockState() { mockState = { queue: { bySessionId: {}, metaBySessionId: {}, isLoading: {}, }, connection: { status: "connected" }, setQueueEntries: vi.fn(), removeQueueEntry: vi.fn(), setQueueLoading: vi.fn(), }; } describe("useQueue", () => { beforeEach(() => { resetMockState(); setDocumentVisibility("visible"); queueApiMock.getQueueStatus.mockResolvedValue({ entries: [], count: 0, max: 10 }); }); afterEach(() => { cleanup(); vi.clearAllMocks(); }); it("refetches the queue snapshot when the WebSocket reconnects", async () => { mockState.connection.status = "disconnected"; const { rerender } = renderHook(() => useQueue(SESSION_ID)); await act(async () => {}); expect(queueApiMock.getQueueStatus).not.toHaveBeenCalled(); mockState.connection.status = "connected"; rerender(); await waitFor(() => expect(queueApiMock.getQueueStatus).toHaveBeenCalledWith(SESSION_ID)); expect(mockState.setQueueEntries).toHaveBeenCalledWith(SESSION_ID, [], { count: 0, max: 10, }); }); it("refetches a stale queue snapshot when a suspended tab becomes visible again", async () => { mockState.queue.bySessionId[SESSION_ID] = [entry()]; mockState.queue.metaBySessionId[SESSION_ID] = { count: 1, max: 10 }; queueApiMock.getQueueStatus.mockResolvedValueOnce({ entries: [entry()], count: 1, max: 10, }); renderHook(() => useQueue(SESSION_ID)); await waitFor(() => expect(queueApiMock.getQueueStatus).toHaveBeenCalledTimes(1)); queueApiMock.getQueueStatus.mockClear(); mockState.setQueueEntries.mockClear(); queueApiMock.getQueueStatus.mockResolvedValueOnce({ entries: [], count: 0, max: 10 }); document.dispatchEvent(new Event("visibilitychange")); await waitFor(() => expect(queueApiMock.getQueueStatus).toHaveBeenCalledWith(SESSION_ID)); expect(mockState.setQueueEntries).toHaveBeenCalledWith(SESSION_ID, [], { count: 0, max: 10, }); }); it("does not refetch on foreground visibility while disconnected", async () => { mockState.connection.status = "disconnected"; renderHook(() => useQueue(SESSION_ID)); await act(async () => {}); document.dispatchEvent(new Event("visibilitychange")); expect(queueApiMock.getQueueStatus).not.toHaveBeenCalled(); }); it("queues structured references with busy-agent messages", async () => { queueApiMock.queueMessage.mockResolvedValue(entry()); const { result } = renderHook(() => useQueue(SESSION_ID)); await waitFor(() => expect(queueApiMock.getQueueStatus).toHaveBeenCalled()); queueApiMock.queueMessage.mockClear(); await act(async () => { await result.current.queue({ taskId: TASK_ID, content: "queued reference", entityReferences: [reference], } as never); }); expect(queueApiMock.queueMessage).toHaveBeenCalledWith({ session_id: SESSION_ID, task_id: TASK_ID, content: "queued reference", model: undefined, plan_mode: undefined, attachments: undefined, entity_references: [reference], }); }); it("replaces queued reference metadata with an explicit empty array", async () => { queueApiMock.updateQueuedMessage.mockResolvedValue({ entry_id: "q-1" }); const { result } = renderHook(() => useQueue(SESSION_ID)); await waitFor(() => expect(queueApiMock.getQueueStatus).toHaveBeenCalled()); await act(async () => { await result.current.editEntry("q-1", "reference removed", undefined, [] as never); }); expect(queueApiMock.updateQueuedMessage).toHaveBeenCalledWith({ session_id: SESSION_ID, entry_id: "q-1", content: "reference removed", attachments: undefined, entity_references: [], }); }); });