Chore: homepage tests (#6278)

src/widgets/komga/component.test.jsx

@@ -0,0 +1,67 @@
+// @vitest-environment jsdom
+
+import { screen } from "@testing-library/react";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+import { renderWithProviders } from "test-utils/render-with-providers";
+import { findServiceBlockByLabel } from "test-utils/widget-assertions";
+
+const { useWidgetAPI } = vi.hoisted(() => ({ useWidgetAPI: vi.fn() }));
+vi.mock("utils/proxy/use-widget-api", () => ({ default: useWidgetAPI }));
+
+import Component from "./component";
+
+function expectBlockValue(container, label, value) {
+  const block = findServiceBlockByLabel(container, label);
+  expect(block, `missing block for ${label}`).toBeTruthy();
+  expect(block.textContent).toContain(String(value));
+}
+
+describe("widgets/komga/component", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("renders placeholders while loading", () => {
+    useWidgetAPI.mockReturnValue({ data: undefined, error: undefined });
+
+    const { container } = renderWithProviders(<Component service={{ widget: { type: "komga", url: "http://x" } }} />, {
+      settings: { hideErrors: false },
+    });
+
+    expect(container.querySelectorAll(".service-block")).toHaveLength(3);
+    expect(screen.getByText("komga.libraries")).toBeInTheDocument();
+    expect(screen.getByText("komga.series")).toBeInTheDocument();
+    expect(screen.getByText("komga.books")).toBeInTheDocument();
+  });
+
+  it("renders error UI when widget API errors", () => {
+    useWidgetAPI.mockReturnValue({ data: undefined, error: { message: "nope" } });
+
+    renderWithProviders(<Component service={{ widget: { type: "komga", url: "http://x" } }} />, {
+      settings: { hideErrors: false },
+    });
+
+    expect(screen.getAllByText(/widget\.api_error/i).length).toBeGreaterThan(0);
+    expect(screen.getByText("nope")).toBeInTheDocument();
+  });
+
+  it("renders library/series/book totals when loaded", () => {
+    useWidgetAPI.mockReturnValue({
+      data: {
+        libraries: [{ id: 1 }, { id: 2 }],
+        series: { totalElements: 10 },
+        books: { totalElements: 20 },
+      },
+      error: undefined,
+    });
+
+    const { container } = renderWithProviders(<Component service={{ widget: { type: "komga", url: "http://x" } }} />, {
+      settings: { hideErrors: false },
+    });
+
+    expectBlockValue(container, "komga.libraries", 2);
+    expectBlockValue(container, "komga.series", 10);
+    expectBlockValue(container, "komga.books", 20);
+  });
+});

src/widgets/komga/proxy.test.js

@@ -0,0 +1,76 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+import createMockRes from "test-utils/create-mock-res";
+
+const { httpProxy, getServiceWidget, logger } = vi.hoisted(() => ({
+  httpProxy: vi.fn(),
+  getServiceWidget: vi.fn(),
+  logger: {
+    error: vi.fn(),
+  },
+}));
+
+vi.mock("utils/logger", () => ({
+  default: () => logger,
+}));
+
+vi.mock("utils/config/service-helpers", () => ({
+  default: getServiceWidget,
+}));
+
+vi.mock("utils/proxy/http", () => ({
+  httpProxy,
+}));
+
+vi.mock("widgets/widgets", () => ({
+  default: {
+    komga: {
+      api: "{url}/{endpoint}",
+      mappings: {
+        series: { endpoint: "series" },
+        books: { endpoint: "books" },
+        seriesv2: { endpoint: "series/v2" },
+        booksv2: { endpoint: "books/v2" },
+      },
+    },
+  },
+}));
+
+import komgaProxyHandler from "./proxy";
+
+describe("widgets/komga/proxy", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("fetches libraries, series, and books and returns aggregated data", async () => {
+    getServiceWidget.mockResolvedValue({ type: "komga", url: "http://kg", key: "k" });
+
+    httpProxy
+      .mockResolvedValueOnce([
+        200,
+        "application/json",
+        Buffer.from(
+          JSON.stringify([
+            { id: 1, unavailable: false },
+            { id: 2, unavailable: true },
+          ]),
+        ),
+      ])
+      .mockResolvedValueOnce([200, "application/json", Buffer.from(JSON.stringify([{ id: "s1" }]))])
+      .mockResolvedValueOnce([200, "application/json", Buffer.from(JSON.stringify([{ id: "b1" }]))]);
+
+    const req = { query: { group: "g", service: "svc", index: "0" } };
+    const res = createMockRes();
+
+    await komgaProxyHandler(req, res);
+
+    expect(httpProxy).toHaveBeenCalledTimes(3);
+    expect(httpProxy.mock.calls[0][1].headers["X-API-Key"]).toBe("k");
+    expect(res.body).toEqual({
+      libraries: [{ id: 1, unavailable: false }],
+      series: [{ id: "s1" }],
+      books: [{ id: "b1" }],
+    });
+  });
+});

src/widgets/komga/widget.test.js

@@ -0,0 +1,11 @@
+import { describe, it } from "vitest";
+
+import { expectWidgetConfigShape } from "test-utils/widget-config";
+
+import widget from "./widget";
+
+describe("komga widget config", () => {
+  it("exports a valid widget config", () => {
+    expectWidgetConfigShape(widget);
+  });
+});