import { afterEach, beforeEach, describe, expect, it, vi } from "vite-plus/test";
import { createPreviewStreamClient, type PreviewStreamControl } from "./serverBrowserStream.ts";
class FakeSocket extends EventTarget {
static readonly OPEN = 1;
static current: FakeSocket;
readyState = 1;
binaryType = "";
readonly sent: string[] = [];
readonly url: string;
constructor(url: string) {
super();
this.url = url;
FakeSocket.current = this;
}
send(value: string) {
this.sent.push(value);
}
close() {
this.readyState = 3;
}
message(data: unknown) {
this.dispatchEvent(new MessageEvent("message", { data }));
}
control(value: PreviewStreamControl) {
this.message(JSON.stringify({ type: "control", ...value }));
}
}
const target = {
access: {
httpBase: "http://preview.test/api/preview-stream",
wsBase: "ws://preview.test/api/preview-stream",
query: {},
credentials: true,
},
threadId: "thread",
tabId: "tab",
maxWidth: 800,
maxHeight: 600,
};
describe("preview stream control", () => {
beforeEach(() => vi.stubGlobal("WebSocket", FakeSocket));
afterEach(() => vi.unstubAllGlobals());
const connect = () => {
const onFrame = vi.fn();
const onControl = vi.fn();
const client = createPreviewStreamClient(target, {
onFrame,
onControl,
onViewport: vi.fn(),
onConnectedChange: vi.fn(),
onUnauthorized: vi.fn(),
});
return { client, socket: FakeSocket.current, onFrame, onControl };
};
const agent: PreviewStreamControl = {
canOperate: true,
controller: "agent",
generation: 1,
dialog: null,
};
it("does not grant control from malformed dialog metadata", () => {
const { client, socket, onControl } = connect();
socket.message(
JSON.stringify({
type: "control",
...agent,
controller: "you",
dialog: { type: "prompt", message: 42, defaultValue: "" },
}),
);
expect(onControl).not.toHaveBeenCalled();
expect(client.send({ type: "reload" })).toBe(false);
client.stop();
});
it("keeps read-only frames flowing while refusing takeover and every mutation", () => {
const { client, socket, onFrame } = connect();
socket.control({ ...agent, canOperate: false });
const frame = new ArrayBuffer(3);
socket.message(frame);
expect(onFrame).toHaveBeenCalledWith(frame);
expect(client.send({ type: "takeControl" })).toBe(false);
expect(client.send({ type: "resize", width: 390, height: 844 })).toBe(false);
expect(client.send({ type: "reload" })).toBe(false);
expect(socket.sent).toEqual(['{"type":"ack"}']);
client.stop();
});
it("revokes input immediately on release and exposes pending dialog state", () => {
const { client, socket, onControl } = connect();
const owned = {
...agent,
controller: "you" as const,
dialog: { type: "prompt", message: "Name?", defaultValue: "initial" },
};
socket.control(owned);
expect(onControl).toHaveBeenLastCalledWith(owned);
expect(client.send({ type: "dialog", accept: true, promptText: "answer" })).toBe(true);
expect(client.send({ type: "releaseControl" })).toBe(true);
socket.control({ ...agent, generation: 2 });
expect(client.send({ type: "text", text: "late input" })).toBe(false);
expect(client.send({ type: "dialog", accept: false })).toBe(false);
client.stop();
});
it("withdraws an offered file picker when the stream drops or stops", () => {
const onFileChooser = vi.fn();
const events = {
onFrame: vi.fn(),
onFileChooser,
onViewport: vi.fn(),
onConnectedChange: vi.fn(),
onUnauthorized: vi.fn(),
};
const client = createPreviewStreamClient(target, events);
const socket = FakeSocket.current;
socket.dispatchEvent(new Event("open"));
socket.message(JSON.stringify({ type: "fileChooser", id: "c1", multiple: false, accept: "" }));
socket.dispatchEvent(Object.assign(new Event("close"), { code: 1012 }));
expect(onFileChooser).toHaveBeenLastCalledWith(null);
client.stop();
const restarted = createPreviewStreamClient(target, events);
FakeSocket.current.message(
JSON.stringify({ type: "fileChooser", id: "c2", multiple: false, accept: "" }),
);
restarted.stop();
expect(onFileChooser).toHaveBeenLastCalledWith(null);
});
});
describe("preview stream downloads", () => {
beforeEach(() => vi.stubGlobal("WebSocket", FakeSocket));
afterEach(() => vi.unstubAllGlobals());
it("offers a download at a URL carrying the stream's ticket", () => {
const onDownload = vi.fn();
createPreviewStreamClient(
{
...target,
access: { ...target.access, query: { wsTicket: "ticket" }, credentials: false },
},
{
onFrame: vi.fn(),
onDownload,
onViewport: vi.fn(),
onConnectedChange: vi.fn(),
onUnauthorized: vi.fn(),
},
);
FakeSocket.current.message(
JSON.stringify({ type: "download", id: "d1", fileName: "a b.csv", sizeBytes: 3 }),
);
expect(onDownload).toHaveBeenCalledExactlyOnceWith({
fileName: "a b.csv",
sizeBytes: 3,
url: "http://preview.test/api/preview-stream/download?threadId=thread&tabId=tab&id=d1&wsTicket=ticket",
});
});
});
describe("preview stream agent pointer", () => {
beforeEach(() => vi.stubGlobal("WebSocket", FakeSocket));
afterEach(() => vi.unstubAllGlobals());
it("reports where the agent moves and clicks, ignoring malformed points", () => {
const onPointer = vi.fn();
createPreviewStreamClient(target, {
onFrame: vi.fn(),
onPointer,
onViewport: vi.fn(),
onConnectedChange: vi.fn(),
onUnauthorized: vi.fn(),
});
FakeSocket.current.message(
JSON.stringify({ type: "pointer", phase: "drag", x: 1, y: 2, sequence: 1 }),
);
FakeSocket.current.message(
JSON.stringify({ type: "pointer", phase: "click", x: 140, y: 50, sequence: 2 }),
);
expect(onPointer).toHaveBeenCalledExactlyOnceWith({
phase: "click",
x: 140,
y: 50,
sequence: 2,
});
});
});