kandev/apps/web/lib/task-listing/view-navigation.test.ts

import { describe, expect, it } from "vitest";
import { linkToThreads } from "@/lib/links";
import { listingHistoryHref, resolveTaskListingNavigation } from "./view-navigation";

const WORKSPACE_ID = "workspace-1";
const WORKSPACE_QUERY = "/threads?workspace=workspace-1";

describe("resolveTaskListingNavigation", () => {
  it("sends Threads to its own route from the board", () => {
    expect(
      resolveTaskListingNavigation({
        view: "threads",
        currentPage: "kanban",
        workspaceId: WORKSPACE_ID,
      }),
    ).toEqual({ view: "threads", href: WORKSPACE_QUERY });
  });

  it("stays put when the target view already owns this page", () => {
    expect(resolveTaskListingNavigation({ view: "threads", currentPage: "threads" })).toEqual({
      view: "threads",
      href: null,
    });
    expect(resolveTaskListingNavigation({ view: "list", currentPage: "tasks" })).toEqual({
      view: "list",
      href: null,
    });
    expect(resolveTaskListingNavigation({ view: "kanban", currentPage: "kanban" })).toEqual({
      view: "kanban",
      href: null,
    });
  });

  it("routes both board views back to the task overview", () => {
    expect(
      resolveTaskListingNavigation({
        view: "pipeline",
        currentPage: "threads",
        workspaceId: WORKSPACE_ID,
        workflowId: "workflow-1",
      }),
    ).toEqual({
      view: "pipeline",
      href: "/?home=overview&workspaceId=workspace-1&workflowId=workflow-1",
    });
  });

  it("refuses Pipeline where it has no layout to render", () => {
    expect(
      resolveTaskListingNavigation({
        view: "pipeline",
        currentPage: "kanban",
        allowPipeline: false,
      }),
    ).toBeNull();
  });

  it("ignores a value that is not a listing view", () => {
    expect(resolveTaskListingNavigation({ view: "", currentPage: "kanban" })).toBeNull();
    expect(resolveTaskListingNavigation({ view: "office", currentPage: "kanban" })).toBeNull();
  });
});

describe("linkToThreads", () => {
  it("preserves a focused session only alongside its task", () => {
    expect(linkToThreads(WORKSPACE_ID, "task-1", "session-1")).toBe(
      `${WORKSPACE_QUERY}&taskId=task-1&sessionId=session-1`,
    );
    expect(linkToThreads(WORKSPACE_ID, undefined, "session-1")).toBe(WORKSPACE_QUERY);
  });
  it("keeps the deck link plain when no task is focused", () => {
    expect(linkToThreads()).toBe("/threads");
    expect(linkToThreads(WORKSPACE_ID)).toBe(WORKSPACE_QUERY);
  });

  it("carries the task a caller wants the deck to scroll to", () => {
    expect(linkToThreads(undefined, "task-1")).toBe("/threads?taskId=task-1");
    expect(linkToThreads(WORKSPACE_ID, "task-1")).toBe(
      "/threads?workspace=workspace-1&taskId=task-1",
    );
  });

  it("escapes a task id rather than splicing it into the query raw", () => {
    expect(linkToThreads(undefined, "a b&c")).toBe("/threads?taskId=a+b%26c");
  });
});

describe("listingHistoryHref", () => {
  it("keeps a scope change on the Threads route", () => {
    // The board's handlers pushState directly, without telling the SPA router.
    // Rewriting the URL to Home while the deck is still mounted leaves the two
    // disagreeing until a reload or a back/forward swaps in the board.
    expect(listingHistoryHref("/threads", { workspaceId: WORKSPACE_ID })).toBe(WORKSPACE_QUERY);
  });

  it("keeps a scope change on the Tasks route", () => {
    expect(listingHistoryHref("/tasks", { workspaceId: WORKSPACE_ID })).toBe(
      "/tasks?workspace=workspace-1",
    );
  });

  it("sends every board view back to the task overview", () => {
    expect(listingHistoryHref("/", { workspaceId: WORKSPACE_ID, workflowId: "workflow-1" })).toBe(
      "/?home=overview&workspaceId=workspace-1&workflowId=workflow-1",
    );
  });

  it("ignores a trailing slash rather than falling through to the board", () => {
    expect(listingHistoryHref("/threads/", { workspaceId: WORKSPACE_ID })).toBe(WORKSPACE_QUERY);
  });
});