kandev/apps/web/lib/ssr/user-settings.test.ts

import { describe, it, expect } from "vitest";
import {
  buildCoreFields,
  mapUserSettingsResponse,
  parseChangesPanelLayout,
  parseVoiceMode,
} from "./user-settings";
import { workspaceId as toWorkspaceId } from "@/lib/types/ids";

const UPDATED_AT = "2026-01-01T00:00:00Z";

describe("buildCoreFields", () => {
  it("maps portable app status bar order", () => {
    const settings = {
      app_status_bar_order: {
        left_item_ids: ["builtin:connection", "plugin:left"],
        right_item_ids: ["builtin:metrics"],
      },
    } as unknown as Parameters<typeof buildCoreFields>[0];

    expect(buildCoreFields(settings).appStatusBarOrder).toEqual({
      leftItemIds: ["builtin:connection", "plugin:left"],
      rightItemIds: ["builtin:metrics"],
    });
  });

  it("maps terminal_font_family to terminalFontFamily", () => {
    const settings = {
      workspace_id: toWorkspaceId(""),
      workflow_filter_id: "",
      kanban_view_mode: "",
      repository_ids: [],
      preferred_shell: "",
      default_editor_id: "",
      enable_preview_on_click: false,
      chat_submit_key: "cmd_enter",
      review_auto_mark_on_scroll: true,
      show_release_notification: true,
      release_notes_last_seen_version: "",
      saved_layouts: [],
      default_utility_agent_id: "",
      default_utility_model: "",
      keyboard_shortcuts: {},
      terminal_link_behavior: "new_tab",
      terminal_font_family: "JetBrains Mono",
      updated_at: UPDATED_AT,
    } as unknown as Parameters<typeof buildCoreFields>[0];

    const result = buildCoreFields(settings);
    expect(result.terminalFontFamily).toBe("JetBrains Mono");
  });

  it("returns null when terminal_font_family is empty", () => {
    const settings = {
      workspace_id: toWorkspaceId(""),
      workflow_filter_id: "",
      kanban_view_mode: "",
      repository_ids: [],
      preferred_shell: "",
      default_editor_id: "",
      enable_preview_on_click: false,
      chat_submit_key: "cmd_enter",
      review_auto_mark_on_scroll: true,
      show_release_notification: true,
      release_notes_last_seen_version: "",
      saved_layouts: [],
      default_utility_agent_id: "",
      default_utility_model: "",
      keyboard_shortcuts: {},
      terminal_link_behavior: "new_tab",
      terminal_font_family: "",
      updated_at: UPDATED_AT,
    } as unknown as Parameters<typeof buildCoreFields>[0];

    const result = buildCoreFields(settings);
    expect(result.terminalFontFamily).toBeNull();
  });

  it("does not mark an empty task-create last-used object as synced", () => {
    const settings = {
      task_create_last_used: {},
    } as unknown as Parameters<typeof buildCoreFields>[0];

    const result = buildCoreFields(settings);
    expect(result.taskCreateLastUsed).toEqual({
      repositoryId: null,
      branch: null,
      agentProfileId: null,
      executorProfileId: null,
      synced: false,
    });
  });

  it("marks task-create last-used as synced when a field is present", () => {
    const settings = {
      task_create_last_used: {
        repository_id: "repo-1",
      },
    } as unknown as Parameters<typeof buildCoreFields>[0];

    const result = buildCoreFields(settings);
    expect(result.taskCreateLastUsed).toMatchObject({
      repositoryId: "repo-1",
      synced: true,
    });
  });
});

describe("buildTerminalFields via buildCoreFields", () => {
  it("maps terminal_font_size to terminalFontSize", () => {
    const settings = {
      terminal_font_size: 16,
      terminal_font_family: "",
      terminal_link_behavior: "new_tab",
    } as unknown as Parameters<typeof buildCoreFields>[0];

    const result = buildCoreFields(settings);
    expect(result.terminalFontSize).toBe(16);
  });

  it("returns null when terminal_font_size is 0", () => {
    const settings = {
      terminal_font_size: 0,
      terminal_font_family: "",
      terminal_link_behavior: "new_tab",
    } as unknown as Parameters<typeof buildCoreFields>[0];

    const result = buildCoreFields(settings);
    expect(result.terminalFontSize).toBeNull();
  });
});

describe("mapUserSettingsResponse", () => {
  it("defaults portable app status bar order to empty arrays", () => {
    expect(mapUserSettingsResponse(null).appStatusBarOrder).toEqual({
      leftItemIds: [],
      rightItemIds: [],
    });
  });

  it("defaults missing and unknown MCP task agent profile preferences", () => {
    const missing = mapUserSettingsResponse(null);
    const unknown = mapUserSettingsResponse({
      settings: {
        user_id: "default-user",
        workspace_id: toWorkspaceId(""),
        repository_ids: [],
        mcp_task_agent_profile_default: "unexpected",
        updated_at: UPDATED_AT,
      } as unknown as NonNullable<Parameters<typeof mapUserSettingsResponse>[0]>["settings"],
    });

    expect(missing.mcpTaskAgentProfileDefault).toBe("current_task");
    expect(unknown.mcpTaskAgentProfileDefault).toBe("current_task");
  });

  it("requires archive confirmation when settings are unavailable", () => {
    expect(mapUserSettingsResponse(null).confirmTaskArchive).toBe(true);
  });

  it("preserves an explicitly disabled archive confirmation preference", () => {
    const result = mapUserSettingsResponse({
      settings: {
        user_id: "default-user",
        workspace_id: toWorkspaceId(""),
        repository_ids: [],
        confirm_task_archive: false,
        updated_at: UPDATED_AT,
      },
    });

    expect(result.confirmTaskArchive).toBe(false);
  });

  it("returns null terminalFontFamily when response is null", () => {
    const result = mapUserSettingsResponse(null);
    expect(result.terminalFontFamily).toBeNull();
  });

  it("defaults changesPanelLayout to tree when response is null", () => {
    const result = mapUserSettingsResponse(null);
    expect(result.changesPanelLayout).toBe("tree");
  });

  it("maps sidebar active view and draft state", () => {
    const result = mapUserSettingsResponse({
      settings: {
        user_id: "default-user",
        workspace_id: toWorkspaceId(""),
        repository_ids: [],
        sidebar_views: [
          {
            id: "all",
            name: "All",
            filters: [],
            sort: { key: "state", direction: "asc" },
            group: "none",
            collapsed_groups: [],
          },
        ],
        sidebar_active_view_id: "all",
        sidebar_draft: {
          base_view_id: "all",
          filters: [],
          sort: { key: "updatedAt", direction: "desc" },
          group: "workflow",
        },
        updated_at: UPDATED_AT,
      },
    });

    expect(result.sidebarActiveViewId).toBe("all");
    expect(result.sidebarDraft).toEqual({
      baseViewId: "all",
      filters: [],
      sort: { key: "updatedAt", direction: "desc" },
      group: "workflow",
    });
  });
});

describe("parseChangesPanelLayout", () => {
  it('returns "tree" for "tree"', () => {
    expect(parseChangesPanelLayout("tree")).toBe("tree");
  });

  it('returns "flat" only for "flat"', () => {
    expect(parseChangesPanelLayout("flat")).toBe("flat");
  });

  it('returns "tree" for undefined or unknown values', () => {
    expect(parseChangesPanelLayout(undefined)).toBe("tree");
    expect(parseChangesPanelLayout("grid")).toBe("tree");
    expect(parseChangesPanelLayout("")).toBe("tree");
  });
});

describe("parseVoiceMode", () => {
  it("maps every field from the snake_case wire payload", () => {
    expect(
      parseVoiceMode({
        enabled: false,
        engine: "whisperWeb",
        language: "pt-PT",
        mode: "hold",
        auto_send: true,
        whisper_web_model: "small",
      }),
    ).toEqual({
      enabled: false,
      engine: "whisperWeb",
      language: "pt-PT",
      mode: "hold",
      autoSend: true,
      whisperWebModel: "small",
    });
  });

  it("returns the defaults when the payload is undefined", () => {
    expect(parseVoiceMode(undefined)).toEqual({
      enabled: true,
      engine: "auto",
      language: "auto",
      mode: "toggle",
      autoSend: false,
      whisperWebModel: "base",
    });
  });

  it("defaults enabled to true when the wire payload omits the field (old rows)", () => {
    const result = parseVoiceMode({
      engine: "auto",
      language: "auto",
      mode: "toggle",
      auto_send: false,
      whisper_web_model: "base",
    } as unknown as Parameters<typeof parseVoiceMode>[0]);
    expect(result.enabled).toBe(true);
  });

  it("fills in defaults for missing string fields and coerces auto_send to false", () => {
    const result = parseVoiceMode({
      engine: "" as unknown as "auto",
      language: "",
      mode: "" as unknown as "toggle",
      whisper_web_model: "" as unknown as "base",
    } as unknown as Parameters<typeof parseVoiceMode>[0]);
    expect(result).toEqual({
      enabled: true,
      engine: "auto",
      language: "auto",
      mode: "toggle",
      autoSend: false,
      whisperWebModel: "base",
    });
  });
});

describe("mapUserSettingsResponse voice mode", () => {
  it("defaults the whole voiceMode object when response is null", () => {
    const result = mapUserSettingsResponse(null);
    expect(result.voiceMode).toEqual({
      enabled: true,
      engine: "auto",
      language: "auto",
      mode: "toggle",
      autoSend: false,
      whisperWebModel: "base",
    });
  });
});