import { describe, expect, it } from "vite-plus/test";
import {
COMPOSER_CONTEXT_CLIPBOARD_MIME,
decodeComposerContextFragment,
encodeComposerContextFragment,
encodeComposerContextClipboardHtml,
decodeComposerContextClipboardHtml,
} from "./composerContextClipboard.ts";
describe("composerContextClipboard", () => {
it("preserves rich HTML while carrying context metadata", () => {
const fragment = encodeComposerContextFragment({
version: 1,
source: { environmentId: "env" as never },
records: [],
})!;
const rich = '<p><strong>Important</strong> <a href="https://example.com">link</a></p>';
const html = encodeComposerContextClipboardHtml("Important link", fragment, rich);
expect(html).toContain(rich);
expect(decodeComposerContextClipboardHtml(html)).toEqual(JSON.parse(fragment));
});
it("round-trips selections larger than two million characters", () => {
const fragment = {
version: 1 as const,
source: { environmentId: "env" as never },
records: Array.from({ length: 32 }, (_, index) => ({
version: 1 as const,
contextId: `terminal-${index}` as never,
kind: "terminal" as const,
label: "Build",
terminalId: "build",
terminalLabel: "Build",
lineStart: 1,
lineEnd: 1,
text: "x".repeat(64_000),
})),
};
const encoded = encodeComposerContextFragment(fragment);
expect(encoded?.length).toBeGreaterThan(2_000_000);
expect(decodeComposerContextFragment(encoded)).toEqual(fragment);
expect(
encodeComposerContextFragment({
...fragment,
records: Array.from({ length: 200 }, () => ({
...fragment.records[0]!,
text: "\u0000".repeat(64_000),
})),
}),
).toBeNull();
});
it("round-trips native/browser HTML without interpreting captured content as markup", () => {
const raw = JSON.stringify({
version: 1,
source: { environmentId: "env-1" },
records: [
{
version: 1,
kind: "terminal",
contextId: "terminal",
label: 'Build "failure"',
terminalId: "main",
terminalLabel: "Main",
lineStart: 1,
lineEnd: 1,
text: "<script> & café",
},
],
});
const html = encodeComposerContextClipboardHtml("<script> & café", raw);
expect(html).toContain("<script> & café");
expect(html).not.toContain("<script>");
expect(decodeComposerContextClipboardHtml(html)).toEqual(JSON.parse(raw));
expect(
decodeComposerContextClipboardHtml('<pre data-t3-context-fragment="%ZZ">bad</pre>'),
).toBeNull();
expect(decodeComposerContextClipboardHtml("<p>Ordinary clipboard</p>")).toBeNull();
});
it("round-trips context whose text contains an apostrophe", () => {
const raw = JSON.stringify({
version: 1,
source: { environmentId: "env-1" },
records: [
{
version: 1,
kind: "terminal",
contextId: "terminal",
label: "Build",
terminalId: "main",
terminalLabel: "Main",
lineStart: 1,
lineEnd: 1,
text: "error: can't find module",
},
],
});
const html = encodeComposerContextClipboardHtml("error: can't find module", raw);
expect(decodeComposerContextClipboardHtml(html)).toEqual(JSON.parse(raw));
expect(
decodeComposerContextClipboardHtml(
`<pre data-t3-context-fragment='${encodeURIComponent(raw).replaceAll("'", "%27")}'>x</pre>`,
),
).toEqual(JSON.parse(raw));
});
it("accepts a large non-ASCII fragment through the HTML attribute", () => {
// CJK code units expand to nine encoded characters despite fitting the fragment limit.
const raw = JSON.stringify({
version: 1,
source: { environmentId: "env-1" },
records: [
{
version: 1,
kind: "terminal",
contextId: "terminal",
label: "ビルド",
terminalId: "main",
terminalLabel: "Main",
lineStart: 1,
lineEnd: 1,
text: "日本語".repeat(21_000),
},
],
});
const html = encodeComposerContextClipboardHtml("output", raw);
expect(html.length).toBeGreaterThan(raw.length * 8);
expect(decodeComposerContextClipboardHtml(html)).toEqual(JSON.parse(raw));
});
it("round-trips a fragment and drops records it cannot decode", () => {
const encoded = encodeComposerContextFragment({
version: 1,
source: { environmentId: "env-1" as never, threadId: "thread-1" as never },
records: [
{ version: 1, contextId: "ctx-1" as never, kind: "skill", label: "$x", name: "x" },
{ version: 1, contextId: "ctx-2" as never, kind: "image", label: "bad" } as never,
],
});
const decoded = decodeComposerContextFragment(encoded);
expect(decoded?.source.threadId).toBe("thread-1");
expect(decoded?.records.map((record) => record.contextId)).toEqual(["ctx-1"]);
});
it("rejects garbage, other versions, and oversized payloads", () => {
expect(decodeComposerContextFragment(null)).toBeNull();
expect(decodeComposerContextFragment("not json")).toBeNull();
expect(
decodeComposerContextFragment(
JSON.stringify({ version: 2, source: { environmentId: "e" }, records: [] }),
),
).toBeNull();
expect(decodeComposerContextFragment("x".repeat(2_000_001))).toBeNull();
expect(COMPOSER_CONTEXT_CLIPBOARD_MIME).toMatch(/^web application\//);
});
});