Files
kandev/apps/web/lib/task-status-summary.test.ts
2026-09-15 09:36:47 +01:00

113 lines
3.9 KiB
TypeScript

import { describe, it, expect } from "vitest";
import {
isNewerStatusSummary,
pickFreshestStatusSummary,
selectTaskStatusSummary,
statusSummaryActiveErrorPreview,
statusSummaryTaskError,
} from "./task-status-summary";
import type { TaskStatusSummary } from "./types/task-status-summary";
function summary(revision: number, queuedPromptCount = 0): TaskStatusSummary {
return { revision, queued_prompt_count: queuedPromptCount } as TaskStatusSummary;
}
describe("isNewerStatusSummary", () => {
it("accepts a strictly higher revision", () => {
expect(isNewerStatusSummary(summary(5), summary(4))).toBe(true);
});
it("rejects an equal revision", () => {
expect(isNewerStatusSummary(summary(4), summary(4))).toBe(false);
});
it("rejects a lower revision", () => {
expect(isNewerStatusSummary(summary(1), summary(4))).toBe(false);
});
it("accepts any reading when nothing is cached", () => {
expect(isNewerStatusSummary(summary(1), undefined)).toBe(true);
expect(isNewerStatusSummary(summary(1), null)).toBe(true);
});
it("treats an absent incoming reading as not newer", () => {
// HTTP payloads use omitempty: absent means "not carried", not "cleared".
expect(isNewerStatusSummary(undefined, summary(4))).toBe(false);
expect(isNewerStatusSummary(null, summary(4))).toBe(false);
expect(isNewerStatusSummary(undefined, undefined)).toBe(false);
});
});
describe("pickFreshestStatusSummary", () => {
it("keeps the cached reading when the incoming one is strictly older", () => {
const cached = summary(4);
expect(pickFreshestStatusSummary(summary(1), cached)).toBe(cached);
});
it("takes the incoming reading when it is newer", () => {
const next = summary(9);
expect(pickFreshestStatusSummary(next, summary(4))).toBe(next);
});
it("keeps the cached reading when the incoming one is absent", () => {
const cached = summary(4);
expect(pickFreshestStatusSummary(undefined, cached)).toBe(cached);
});
it("takes an equal-revision response so a re-stamped queued count is not pinned", () => {
// buildTaskDTOsWithSessionInfo re-stamps queued_prompt_count from a fresh
// queue read without incrementing the revision, so an equal-revision
// response can still carry a newer count than the cache.
const next = summary(3, 5);
expect(pickFreshestStatusSummary(next, summary(3, 0))).toBe(next);
});
});
describe("selectTaskStatusSummary", () => {
it("selects the newest detail or live cache reading", () => {
const detail = summary(4);
const live = summary(7);
expect(selectTaskStatusSummary(detail, [summary(3), live])).toBe(live);
});
it("lets a newer live reading clear an older detail error", () => {
const detail = summary(5);
detail.active_error = {
stamp: "launch-error-5",
occurred_at: "2026-08-20T10:00:00Z",
preview: "launch failed",
};
const live = summary(6);
live.active_error = null;
expect(selectTaskStatusSummary(detail, [live])).toBe(live);
});
it("keeps a task-owned active error visible without a session key", () => {
const taskOwned = summary(2);
taskOwned.active_error = {
stamp: "task-error-2",
occurred_at: "2026-08-19T10:00:00Z",
preview: "Choose a base branch",
};
expect(statusSummaryActiveErrorPreview(taskOwned, {}, {})).toBe("Choose a base branch");
});
it("selects the independent task error even when a session error is newer", () => {
const taskOwned = summary(3);
taskOwned.task_error = {
scope: "task",
stamp: "task-error-3",
occurred_at: "2026-08-19T10:00:00Z",
preview: "Choose a base branch",
};
taskOwned.active_error = {
scope: "session",
session_id: "session-1",
stamp: "session-error-4",
occurred_at: "2026-08-19T11:00:00Z",
preview: "The session failed",
};
expect(statusSummaryTaskError(taskOwned)).toBe(taskOwned.task_error);
});
});