@thepalaceproject/circulation-admin 1.43.0 → 1.44.0-post.4

package/tests/jest/components/PairedMenus.test.tsx

@@ -0,0 +1,220 @@
+import * as React from "react";
+import { render, screen, within, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import PairedMenus from "../../../src/components/PairedMenus";
+import { SettingData, LibraryData } from "../../../src/interfaces";
+
+describe("PairedMenus", () => {
+  const inputListSetting: SettingData = {
+    key: "input",
+    label: "Input List",
+    default: ["a", "b", "c"],
+    options: [
+      { key: "a", label: "A" },
+      { key: "b", label: "B" },
+      { key: "c", label: "C" },
+      { key: "d", label: "D" },
+      { key: "e", label: "E" },
+    ],
+    paired: "dropdown",
+  };
+  const dropdownSetting: SettingData = {
+    key: "dropdown",
+    label: "Dropdown",
+    default: "b",
+    options: [
+      { key: "a", label: "A" },
+      { key: "b", label: "B" },
+      { key: "c", label: "C" },
+      { key: "d", label: "D" },
+      { key: "e", label: "E" },
+    ],
+    type: "select",
+  };
+
+  const renderPairedMenus = (props = {}) =>
+    render(
+      <PairedMenus
+        inputListSetting={inputListSetting}
+        dropdownSetting={dropdownSetting}
+        disabled={false}
+        {...props}
+      />
+    );
+
+  // The current InputList items are rendered as read-only text inputs inside the
+  // `.input-list-ul` list; return their displayed values.
+  const listItemValues = (container: HTMLElement): string[] =>
+    within(container.querySelector<HTMLElement>(".input-list-ul")!)
+      .getAllByRole("textbox")
+      .map((input) => (input as HTMLInputElement).value);
+
+  const dropdown = (container: HTMLElement): HTMLSelectElement =>
+    container.querySelector<HTMLSelectElement>('select[name="dropdown"]')!;
+
+  it("renders a fieldset with an InputList and a dropdown", () => {
+    const { container } = renderPairedMenus();
+    expect(
+      container.querySelector("fieldset.paired-menus")
+    ).toBeInTheDocument();
+    expect(container.querySelector(".input-list")).toBeInTheDocument();
+    expect(dropdown(container)).toBeInTheDocument();
+  });
+
+  it("renders the InputList items as read-only fields", () => {
+    const { container } = renderPairedMenus();
+    const listItems = within(
+      container.querySelector<HTMLElement>(".input-list-ul")!
+    ).getAllByRole("textbox");
+    expect(listItems).toHaveLength(3);
+    listItems.forEach((input) =>
+      expect((input as HTMLInputElement).readOnly).toBe(true)
+    );
+    expect(listItemValues(container)).toEqual(["A", "B", "C"]);
+  });
+
+  it("renders the dropdown with its default value and available options", () => {
+    const { container } = renderPairedMenus();
+    const select = dropdown(container);
+    expect(select).toHaveValue("b");
+    const options = within(select).getAllByRole("option");
+    expect(options.map((o) => o.textContent)).toEqual(["A", "B", "C"]);
+    expect(options.map((o) => (o as HTMLOptionElement).value)).toEqual([
+      "a",
+      "b",
+      "c",
+    ]);
+  });
+
+  it("optionally disables the InputList's button", () => {
+    const { rerender } = renderPairedMenus();
+    expect(screen.getByRole("button", { name: "Add" })).toBeEnabled();
+
+    rerender(
+      <PairedMenus
+        inputListSetting={inputListSetting}
+        dropdownSetting={dropdownSetting}
+        disabled={false}
+        readOnly={true}
+      />
+    );
+    expect(screen.getByRole("button", { name: "Add" })).toBeDisabled();
+  });
+
+  it("reflects the default InputList values and dropdown value", () => {
+    const { container } = renderPairedMenus();
+    expect(listItemValues(container)).toEqual(["A", "B", "C"]);
+    expect(dropdown(container)).toHaveValue("b");
+  });
+
+  it("takes an optional item prop", () => {
+    const item: LibraryData = {
+      name: "Library",
+      short_name: "lib",
+      uuid: "123",
+      settings: {
+        input: ["c", "d", "e"],
+        dropdown: "d",
+      },
+    };
+    const { container } = renderPairedMenus({ item });
+
+    const listItems = within(
+      container.querySelector<HTMLElement>(".input-list-ul")!
+    ).getAllByRole("textbox");
+    expect(listItems.map((i) => (i as HTMLInputElement).value)).toEqual([
+      "C",
+      "D",
+      "E",
+    ]);
+    expect(listItems.map((i) => (i as HTMLInputElement).name)).toEqual([
+      "input_c",
+      "input_d",
+      "input_e",
+    ]);
+
+    const select = dropdown(container);
+    expect(select).toHaveValue("d");
+    expect(
+      within(select)
+        .getAllByRole("option")
+        .map((o) => o.textContent)
+    ).toEqual(["C", "D", "E"]);
+  });
+
+  it("updates the InputList when an item is removed", async () => {
+    const user = userEvent.setup();
+    const { container } = renderPairedMenus();
+    expect(listItemValues(container)).toEqual(["A", "B", "C"]);
+
+    // Remove the first list item ("A").
+    await user.click(screen.getAllByRole("button", { name: /Delete/ })[0]);
+
+    await waitFor(() =>
+      expect(
+        within(
+          container.querySelector<HTMLElement>(".input-list-ul")!
+        ).getAllByRole("textbox")
+      ).toHaveLength(2)
+    );
+    expect(listItemValues(container)).toEqual(["B", "C"]);
+  });
+
+  it("recalculates the dropdown options based on the InputList values", async () => {
+    const user = userEvent.setup();
+    const { container } = renderPairedMenus();
+    expect(
+      within(dropdown(container))
+        .getAllByRole("option")
+        .map((o) => o.textContent)
+    ).toEqual(["A", "B", "C"]);
+
+    // Removing "A" leaves the InputList holding [b, c], so the dropdown may only
+    // offer B and C.
+    await user.click(screen.getAllByRole("button", { name: /Delete/ })[0]);
+
+    await waitFor(() =>
+      expect(
+        within(dropdown(container))
+          .getAllByRole("option")
+          .map((o) => o.textContent)
+      ).toEqual(["B", "C"])
+    );
+  });
+
+  it("updates the dropdown selection", async () => {
+    const user = userEvent.setup();
+    const { container } = renderPairedMenus();
+    const select = dropdown(container);
+    expect(select).toHaveValue("b");
+
+    await user.selectOptions(select, "c");
+    expect(select).toHaveValue("c");
+  });
+
+  it("displays a message when the dropdown has no available values", async () => {
+    const user = userEvent.setup();
+    const { container } = renderPairedMenus();
+
+    // Remove every item from the InputList.
+    for (let remaining = 3; remaining > 0; remaining--) {
+      const removeButtons = screen.getAllByRole("button", { name: /Delete/ });
+      expect(removeButtons).toHaveLength(remaining);
+      await user.click(removeButtons[0]);
+      await waitFor(() =>
+        expect(
+          screen.queryAllByRole("button", { name: /Delete/ })
+        ).toHaveLength(remaining - 1)
+      );
+    }
+
+    const message =
+      "In order to set this value, you must add at least one option from the menu above.";
+    expect(screen.getByText(message)).toBeInTheDocument();
+    expect(container.querySelector(".bg-warning")).toHaveTextContent(message);
+
+    // The dropdown select is replaced by the warning; only the add menu remains.
+    expect(dropdown(container)).not.toBeInTheDocument();
+    expect(container.querySelectorAll("select")).toHaveLength(1);
+  });
+});

package/tests/jest/components/PatronAuthServices.test.tsx

@@ -0,0 +1,114 @@
+import * as React from "react";
+import { screen, waitFor } from "@testing-library/react";
+
+import { renderWithProviders } from "../testUtils/withProviders";
+import buildStore from "../../../src/store";
+// Render the CONNECTED default export so that mapStateToProps / mapDispatchToProps
+// are exercised: the panel fetches its data on mount, the fetch populates the
+// Redux store, and mapStateToProps feeds it back in as props.
+import PatronAuthServices from "../../../src/components/PatronAuthServices";
+
+const listData = {
+  patron_auth_services: [
+    {
+      id: 2,
+      protocol: "test protocol",
+      settings: { test_setting: "test setting" },
+      libraries: [
+        { short_name: "nypl", test_library_setting: "test library setting" },
+      ],
+      name: "nypl protocol",
+    },
+  ],
+  protocols: [
+    { name: "test protocol", label: "test protocol label", settings: [] },
+  ],
+  allLibraries: [{ short_name: "nypl" }],
+};
+
+/**
+ * Stub `fetch` so the panel's on-mount fetch resolves with `body`. Returning a
+ * fresh Response per call avoids "body already used" when several fetches run.
+ */
+const stubFetch = (body: unknown) =>
+  jest.spyOn(globalThis, "fetch").mockImplementation(
+    async () =>
+      new Response(JSON.stringify(body), {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+      })
+  );
+
+// A fresh store per test keeps the fetched data isolated between tests.
+const renderConnected = (element: React.ReactElement) =>
+  renderWithProviders(element, {
+    reduxProviderProps: { store: buildStore() },
+  });
+
+describe("PatronAuthServices", () => {
+  afterEach(() => {
+    jest.restoreAllMocks();
+  });
+
+  it("shows the patron auth service list", async () => {
+    stubFetch(listData);
+    const { container } = renderConnected(
+      <PatronAuthServices csrfToken="token" />
+    );
+
+    // The list appears once the connected component's on-mount fetch resolves.
+    // Its heading is the protocol-aware label built by PatronAuthServices.label().
+    expect(
+      await screen.findByRole("heading", {
+        level: 3,
+        name: /nypl protocol: test protocol label/,
+      })
+    ).toBeInTheDocument();
+
+    const editLink = container.querySelector("a.edit-item");
+    expect(editLink).not.toBeNull();
+    expect(editLink.getAttribute("href")).toBe(
+      "/admin/web/config/patronAuth/edit/2"
+    );
+
+    // No neighborhood analytics panel is shown in list mode.
+    expect(
+      screen.queryByText("Patron Neighborhood Analytics: Disabled")
+    ).not.toBeInTheDocument();
+  });
+
+  it("shows the neighborhood analytics panel when creating a service whose protocol has a neighborhood_mode setting", async () => {
+    const neighborhoodSetting = {
+      key: "neighborhood_mode",
+      label: "Neighborhood Mode",
+      description: "",
+      options: [],
+    };
+    const createData = {
+      patron_auth_services: [],
+      protocols: [
+        {
+          name: "test protocol",
+          label: "test protocol label",
+          settings: [neighborhoodSetting],
+        },
+      ],
+      allLibraries: [{ short_name: "nypl" }],
+    };
+    stubFetch(createData);
+
+    const { container } = renderConnected(
+      <PatronAuthServices csrfToken="token" editOrCreate="create" />
+    );
+
+    // Once the protocol data loads, the create form's extra section (the
+    // NeighborhoodAnalyticsForm) renders because the selected protocol carries a
+    // "neighborhood_mode" setting.
+    await waitFor(() =>
+      expect(container.querySelector("#neighborhood-panel")).toBeInTheDocument()
+    );
+    expect(
+      screen.getByText("Patron Neighborhood Analytics: Disabled")
+    ).toBeInTheDocument();
+  });
+});

package/tests/jest/components/PatronBlockingRulesEditor.test.tsx

@@ -612,7 +612,9 @@ describe("PatronBlockingRulesEditor", () => {
   });
 
   it("disables all editing inputs and buttons when disabled prop is true", () => {
-    renderEditor(<PatronBlockingRulesEditor value={existingRules} disabled={true} />);
+    renderEditor(
+      <PatronBlockingRulesEditor value={existingRules} disabled={true} />
+    );
 
     // The Help button stays enabled even in disabled mode (read-only affordance).
     const editingButtons = screen

package/tests/jest/components/PatronInfo.test.tsx

@@ -0,0 +1,54 @@
+import * as React from "react";
+import { render } from "@testing-library/react";
+
+import PatronInfo from "../../../src/components/PatronInfo";
+import { PatronData } from "../../../src/interfaces";
+
+const patrons: PatronData[] = [
+  {
+    authorization_expires: "",
+    username: "User Name",
+    personal_name: "Personal Name",
+    email_address: "user@email.com",
+    authorization_identifier: "1234",
+    authorization_identifiers: [""],
+    block_reason: "",
+    external_type: "",
+    fines: "",
+    permanent_id: "",
+  },
+  {
+    authorization_expires: "",
+    personal_name: "Personal Name2",
+    authorization_identifier: "5678",
+    authorization_identifiers: [""],
+    block_reason: "",
+    external_type: "",
+    fines: "",
+    permanent_id: "",
+  },
+];
+
+describe("PatronInfo", () => {
+  it("should display the patron's information", () => {
+    const { container } = render(<PatronInfo patron={patrons[0]} />);
+
+    const items = container.querySelectorAll("ul.patron-data-list > li");
+    expect(items).toHaveLength(4);
+    expect(items[0]).toHaveTextContent("Username:User Name");
+    expect(items[1]).toHaveTextContent("Personal Name:Personal Name");
+    expect(items[2]).toHaveTextContent("Email Address:user@email.com");
+    expect(items[3]).toHaveTextContent("Identifier:1234");
+  });
+
+  it("should update the patron's information if a new patron was searched and found", () => {
+    const { container, rerender } = render(<PatronInfo patron={patrons[0]} />);
+
+    rerender(<PatronInfo patron={patrons[1]} />);
+
+    const items = container.querySelectorAll("ul.patron-data-list > li");
+    expect(items).toHaveLength(2);
+    expect(items[0]).toHaveTextContent("Personal Name:Personal Name2");
+    expect(items[1]).toHaveTextContent("Identifier:5678");
+  });
+});