// @effect-diagnostics nodeBuiltinImport:off - launcher integration with filesystem and fetch.
import * as NodeFS from "node:fs";
import * as NodeOS from "node:os";
import * as NodePath from "node:path";
import { expect, it, vi } from "vite-plus/test";
import { flushTelemetry, observeSummaries, summarize } from "./telemetry.ts";
vi.mock("node:fs", async (importOriginal) => {
const fs = await importOriginal<typeof import("node:fs")>();
return { ...fs, rmdirSync: vi.fn(fs.rmdirSync) };
});
const task = (result: unknown) => ({
package_name: "@team/server",
task_name: "typecheck",
command: "SECRET",
cwd: "/private",
result,
});
it("counts only confirmed hits, preserves their tier, and never transmits command text", () => {
expect(
summarize({
tasks: [
task({ CacheHit: { source: "Remote", saved_duration_ms: 1200 } }),
task({ CacheHit: { source: "Local", saved_duration_ms: 500 } }),
task({ RestoreFailed: {} }),
task({ Spawned: {} }),
task({ CacheHit: { saved_duration_ms: 999 } }),
task({ CacheHit: { source: "Remote", saved_duration_ms: -1 } }),
],
}),
).toEqual([
{ package: "@team/server", task: "typecheck", source: "remote", savedMs: 1200 },
{ package: "@team/server", task: "typecheck", source: "local", savedMs: 500 },
{ package: "@team/server", task: "typecheck", source: "failed", savedMs: 0 },
{ package: "@team/server", task: "typecheck", source: "executed", savedMs: 0 },
{ package: "@team/server", task: "typecheck", source: "unspecified", savedMs: 999 },
]);
});
it("deduplicates shared summaries and retries delivery without credentials in queued records", async () => {
const root = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "cache-observer-"));
const home = NodePath.join(root, "home");
const endpoint = "https://cache.example/projects/t3code";
try {
const stopA = observeSummaries(root, endpoint, { T3_TASK_CACHE_HOST: "test-host" }, home);
const stopB = observeSummaries(root, endpoint, { T3_TASK_CACHE_HOST: "test-host" }, home);
const version = NodePath.join(root, "node_modules/.vite/task-cache/v18");
NodeFS.mkdirSync(version);
NodeFS.writeFileSync(
NodePath.join(version, "last-summary.json"),
JSON.stringify({
tasks: [task({ CacheHit: { source: "Remote", saved_duration_ms: 1200 } })],
}),
);
stopA();
stopB();
const queue = NodePath.join(home, ".cache/t3-task-cache/telemetry");
const files = NodeFS.readdirSync(queue);
expect(files).toHaveLength(1);
const serialized = NodeFS.readFileSync(NodePath.join(queue, files[0]!), "utf8");
expect(serialized).not.toContain("SECRET");
expect(JSON.parse(serialized).event.host).toBe("test-host");
NodeFS.mkdirSync(NodePath.join(home, ".config/t3-task-cache"), { recursive: true });
NodeFS.writeFileSync(
NodePath.join(home, ".config/t3-task-cache/credentials.json"),
JSON.stringify({ [endpoint]: { name: "alice", token: "secret-token" } }),
);
using request = vi
.spyOn(globalThis, "fetch")
.mockResolvedValueOnce(new Response(null, { status: 503 }))
.mockImplementationOnce(async () => {
const late = JSON.parse(serialized);
late.event.id = "b".repeat(64);
NodeFS.writeFileSync(NodePath.join(queue, "late.json"), JSON.stringify(late));
return new Response(null, { status: 204 });
})
.mockResolvedValue(new Response(null, { status: 204 }));
await flushTelemetry(home, {});
expect(NodeFS.readdirSync(queue)).toEqual(files);
await flushTelemetry(home, {});
expect(NodeFS.readdirSync(queue)).toEqual([]);
expect(request).toHaveBeenCalledTimes(3);
expect(request.mock.calls[0]![0].toString()).toBe(`${endpoint}/telemetry`);
} finally {
NodeFS.rmSync(root, { recursive: true, force: true });
}
});
it("skips unauthenticated endpoints without consuming the delivery budget", async () => {
const home = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "cache-queue-"));
const endpoint = "https://cache.example/projects/t3code";
try {
const queue = NodePath.join(home, ".cache/t3-task-cache/telemetry");
NodeFS.mkdirSync(queue, { recursive: true });
const skipped = Array.from({ length: 101 }, (_, i) => `a${i}.json`);
for (const file of skipped)
NodeFS.writeFileSync(
NodePath.join(queue, file),
JSON.stringify({ endpoint: "https://old.example/projects/t3code", event: { id: file } }),
);
NodeFS.writeFileSync(
NodePath.join(queue, "b.json"),
JSON.stringify({ endpoint, event: { id: "current" } }),
);
NodeFS.mkdirSync(NodePath.join(home, ".config/t3-task-cache"), { recursive: true });
NodeFS.writeFileSync(
NodePath.join(home, ".config/t3-task-cache/credentials.json"),
JSON.stringify({ [endpoint]: { name: "alice", token: "secret-token" } }),
);
using request = vi
.spyOn(globalThis, "fetch")
.mockResolvedValue(new Response(null, { status: 204 }));
await flushTelemetry(home, {});
expect(NodeFS.readdirSync(queue).sort()).toEqual(skipped.sort());
expect(request).toHaveBeenCalledOnce();
expect(request.mock.calls[0]![0].toString()).toBe(`${endpoint}/telemetry`);
} finally {
NodeFS.rmSync(home, { recursive: true, force: true });
}
});
it("excludes tasks that explicitly disable caching from the hit-rate denominator", () => {
expect(
summarize({
tasks: [
task({ Spawned: { cache_status: "Disabled" } }),
task({ Spawned: { cache_status: { Miss: "changed" } } }),
],
}),
).toEqual([{ package: "@team/server", task: "typecheck", source: "executed", savedMs: 0 }]);
});
it("drops revoked credentials and continues delivering other queued endpoints", async () => {
const home = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "cache-revoked-"));
try {
const queue = NodePath.join(home, ".cache/t3-task-cache/telemetry");
const state = NodePath.join(home, ".config/t3-task-cache");
NodeFS.mkdirSync(queue, { recursive: true });
NodeFS.mkdirSync(state, { recursive: true });
NodeFS.writeFileSync(
NodePath.join(state, "credentials.json"),
JSON.stringify({
"https://revoked.example": { name: "a", token: "old" },
"https://current.example": { name: "a", token: "new" },
}),
);
for (const [file, endpoint] of [
["a.json", "https://revoked.example"],
["b.json", "https://current.example"],
])
NodeFS.writeFileSync(
NodePath.join(queue, file!),
JSON.stringify({ endpoint, event: { id: file } }),
);
using request = vi
.spyOn(globalThis, "fetch")
.mockResolvedValueOnce(new Response(null, { status: 403 }))
.mockResolvedValueOnce(new Response(null, { status: 204 }));
await flushTelemetry(home, {});
expect(request).toHaveBeenCalledTimes(2);
expect(NodeFS.readdirSync(queue)).toEqual([]);
} finally {
NodeFS.rmSync(home, { recursive: true, force: true });
}
});
it("delivers an event queued while the previous flusher releases its lock", async () => {
const home = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "cache-handoff-"));
const endpoint = "https://cache.example/projects/t3code";
try {
const queue = NodePath.join(home, ".cache/t3-task-cache/telemetry");
const state = NodePath.join(home, ".config/t3-task-cache");
NodeFS.mkdirSync(queue, { recursive: true });
NodeFS.mkdirSync(state, { recursive: true });
NodeFS.writeFileSync(
NodePath.join(state, "credentials.json"),
JSON.stringify({ [endpoint]: { name: "alice", token: "secret-token" } }),
);
using request = vi
.spyOn(globalThis, "fetch")
.mockImplementation(async () => new Response(null, { status: 204 }));
const rmdirSync = vi.mocked(NodeFS.rmdirSync);
const release = rmdirSync.getMockImplementation()!;
let competing: Promise<void> | undefined;
// The next command queues its event after this flusher's last scan, and its own flusher
// gives up because the lock is still held.
rmdirSync.mockImplementationOnce((path, options) => {
NodeFS.writeFileSync(
NodePath.join(queue, "late.json"),
JSON.stringify({ endpoint, event: { id: "late" } }),
);
competing = flushTelemetry(home, {});
release(path, options);
});
await flushTelemetry(home, {});
await competing;
expect(request).toHaveBeenCalledOnce();
expect(NodeFS.readdirSync(queue)).toEqual([]);
} finally {
NodeFS.rmSync(home, { recursive: true, force: true });
}
});