kandev/apps/web/e2e/tests/system/message-queue-settings.spec.ts

import { test, expect } from "../../fixtures/test-base";
import type { ApiClient } from "../../helpers/api-client";
import type {
  MessageQueueSettingsPatch,
  MessageQueueSettingsResponse,
} from "../../../lib/types/system";

const SETTINGS_PATH = "/api/v1/system/message-queue/settings";

async function requestSettings(
  apiClient: ApiClient,
  method: "GET" | "PATCH",
  patch?: MessageQueueSettingsPatch,
): Promise<MessageQueueSettingsResponse> {
  const response = await apiClient.rawRequest(method, SETTINGS_PATH, patch);
  if (!response.ok) {
    throw new Error(
      `${method} ${SETTINGS_PATH} failed (${response.status}): ${await response.text()}`,
    );
  }
  return response.json() as Promise<MessageQueueSettingsResponse>;
}

test.describe.serial("Message Queue general settings", () => {
  let baseline: number | undefined;
  let mergeBaseline: boolean | undefined;

  test.beforeEach(async ({ apiClient }) => {
    const current = (await requestSettings(apiClient, "GET")).settings;
    baseline = current.max_per_session;
    mergeBaseline = current.merge_enabled;
  });

  test.afterEach(async ({ apiClient }) => {
    if (baseline === undefined || mergeBaseline === undefined) return;
    await requestSettings(apiClient, "PATCH", {
      max_per_session: baseline,
      merge_enabled: mergeBaseline,
    });
    baseline = undefined;
    mergeBaseline = undefined;
  });

  test("admin navigates to Task behavior, saves, and reloads the live setting", async ({
    testPage,
  }) => {
    const updated = baseline === 17 ? 18 : 17;
    await testPage.goto("/settings/preferences/appearance");
    const settingsNav = testPage.getByTestId("app-sidebar-settings-mode");
    await settingsNav.getByRole("link", { name: /^Task Behavior/ }).click();

    await expect(testPage).toHaveURL(
      (url) => new URL(url).pathname === "/settings/preferences/task-behavior",
    );
    await expect(testPage.getByText("Message Queue").first()).toBeVisible();

    // The Message Queue box spans the full settings column like every other
    // settings box; it must not be width-restricted.
    const queueCard = testPage.getByTestId("message-queue-settings");
    const siblingCard = testPage.getByTestId("voice-enable-card");
    await expect(queueCard).toBeVisible();
    await expect(siblingCard).toBeVisible();
    expect((await queueCard.boundingBox())?.width ?? 0).toBeCloseTo(
      (await siblingCard.boundingBox())?.width ?? 0,
      0,
    );

    const input = testPage.getByTestId("message-queue-max-per-session");
    await expect(input).toHaveValue(String(baseline));
    await input.fill(String(updated));
    await expect(testPage.getByTestId("settings-floating-save")).toBeVisible();

    const saveResponse = testPage.waitForResponse(
      (response) =>
        response.request().method() === "PATCH" &&
        new URL(response.url()).pathname === SETTINGS_PATH,
    );
    await testPage.getByRole("button", { name: "Save changes" }).click();
    expect((await saveResponse).status()).toBe(200);
    await expect(testPage.getByTestId("message-queue-effective-value")).toHaveText(String(updated));
    await expect(testPage.getByTestId("message-queue-source")).toHaveText("Saved setting");

    await testPage.reload();
    await expect(input).toHaveValue(String(updated));
    await expect(testPage.getByTestId("message-queue-effective-value")).toHaveText(String(updated));
  });

  test("admin toggles queued message merging without touching the session limit", async ({
    testPage,
  }) => {
    await testPage.goto("/settings/general/message-queue");
    const toggle = testPage.getByTestId("message-queue-merge-enabled");
    await expect(toggle).toBeVisible();
    const wasEnabled = mergeBaseline === true;
    await expect(toggle).toHaveAttribute("aria-checked", String(wasEnabled));
    await expect(
      testPage.getByText(/Only adjacent messages from the same sender can be merged/),
    ).toBeVisible();
    await expect(
      testPage.getByText(/combined, deduplicated entity references would exceed 100/),
    ).toBeVisible();

    const saveResponse = testPage.waitForResponse(
      (response) =>
        response.request().method() === "PATCH" &&
        new URL(response.url()).pathname === SETTINGS_PATH,
    );
    await toggle.click();
    await expect(testPage.getByTestId("settings-floating-save")).toBeVisible();
    await testPage.getByRole("button", { name: "Save changes" }).click();
    const response = await saveResponse;
    expect(response.status()).toBe(200);
    expect(response.request().postDataJSON()).toEqual({ merge_enabled: !wasEnabled });
    await expect(toggle).toHaveAttribute("aria-checked", String(!wasEnabled));

    await testPage.reload();
    await expect(testPage.getByTestId("message-queue-merge-enabled")).toHaveAttribute(
      "aria-checked",
      String(!wasEnabled),
    );
  });

  test("environment override is visible and read-only", async ({ testPage }) => {
    await testPage.route(`**${SETTINGS_PATH}`, async (route) => {
      await route.fulfill({
        status: 200,
        contentType: "application/json",
        body: JSON.stringify({
          settings: { max_per_session: baseline, merge_enabled: true },
          effective: {
            max_per_session: 41,
            source: "environment",
            locked: true,
            merge_enabled: true,
          },
        } satisfies MessageQueueSettingsResponse),
      });
    });

    await testPage.goto("/settings/preferences/task-behavior");
    await expect(testPage.getByTestId("message-queue-max-per-session")).toBeDisabled();
    await expect(testPage.getByTestId("message-queue-effective-value")).toHaveText("41");
    await expect(testPage.getByTestId("message-queue-source")).toHaveText("Environment");
    await expect(testPage.getByText(/KANDEV_QUEUE_MAX_PER_SESSION/).first()).toBeVisible();
    await expect(testPage.getByTestId("settings-floating-save")).toHaveCount(0);
    // The environment lock only governs max_per_session; merging stays editable.
    await expect(testPage.getByTestId("message-queue-merge-enabled")).toBeEnabled();
  });

  test("member can navigate to the setting but cannot edit it", async ({ testPage }) => {
    await testPage.goto("/settings/preferences/appearance");
    await testPage.waitForFunction(() => Boolean(window.__KANDEV_E2E_STORE__));
    await testPage.evaluate(() => {
      const store = window.__KANDEV_E2E_STORE__;
      if (!store) throw new Error("E2E store bridge is unavailable");
      store.getState().setAuthState({
        mode: "enabled",
        authenticated: true,
        user: {
          id: "e2e-member",
          email: "member@e2e.dev",
          display_name: "E2E Member",
          role: "member",
          status: "active",
        },
        ssoProviders: [],
      });
    });
    const settingsNav = testPage.getByTestId("app-sidebar-settings-mode");
    await settingsNav.getByRole("link", { name: /^Task Behavior/ }).click();

    await expect(testPage.getByTestId("message-queue-max-per-session")).toBeDisabled();
    await expect(testPage.getByTestId("message-queue-merge-enabled")).toBeDisabled();
    await expect(testPage.getByText("Only administrators can change this setting.")).toBeVisible();
    await expect(testPage.getByTestId("settings-floating-save")).toHaveCount(0);
  });
});