UISACQCOMP-166: view list of donors

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 * Sort the list of countries based on the current locale. Refs UISACQCOMP-164.
 * Add `inputType` prop to `<SingleSearchForm>`. Refs UISACQCOMP-165.
+* View the list of donors. Refs UISACQCOMP-166.
 
 ## [5.0.0](https://github.com/folio-org/stripes-acq-components/tree/v5.0.0) (2023-10-12)
 [Full Changelog](https://github.com/folio-org/stripes-acq-components/compare/v4.0.2...v5.0.0)

lib/DonorsList/AddDonorButton.js

@@ -0,0 +1,60 @@
+import { map } from 'lodash';
+import PropTypes from 'prop-types';
+import { FormattedMessage } from 'react-intl';
+
+import { Pluggable } from '@folio/stripes/core';
+
+import {
+  initialFilters,
+  modalLabel,
+  pluginVisibleColumns,
+  resultsPaneTitle,
+  searchableIndexes,
+  visibleFilters,
+} from './constants';
+
+const AddDonorButton = ({ fetchDonors, fields, stripes, name }) => {
+  const addDonors = (donors = []) => {
+    const addedDonorIds = new Set(fields.value);
+    const newDonorsIds = map(donors.filter(({ id }) => !addedDonorIds.has(id)), 'id');
+
+    if (newDonorsIds.length) {
+      fetchDonors([...addedDonorIds, ...newDonorsIds]);
+      newDonorsIds.forEach(contactId => fields.push(contactId));
+    }
+  };
+
+  return (
+    <Pluggable
+      id={`${name}-plugin`}
+      aria-haspopup="true"
+      type="find-organization"
+      dataKey="organization"
+      searchLabel={<FormattedMessage id="stripes-acq-components.donors.button.addDonor" />}
+      searchButtonStyle="default"
+      disableRecordCreation
+      stripes={stripes}
+      selectVendor={addDonors}
+      modalLabel={modalLabel}
+      resultsPaneTitle={resultsPaneTitle}
+      visibleColumns={pluginVisibleColumns}
+      initialFilters={initialFilters}
+      searchableIndexes={searchableIndexes}
+      visibleFilters={visibleFilters}
+      isMultiSelect
+    >
+      <span data-test-add-donor>
+        <FormattedMessage id="stripes-acq-components.donors.noFindOrganizationPlugin" />
+      </span>
+    </Pluggable>
+  );
+};
+
+AddDonorButton.propTypes = {
+  fetchDonors: PropTypes.func.isRequired,
+  fields: PropTypes.object,
+  stripes: PropTypes.object,
+  name: PropTypes.string.isRequired,
+};
+
+export default AddDonorButton;

lib/DonorsList/DonorsContainer.js

@@ -0,0 +1,62 @@
+import React, { useCallback, useEffect, useState } from 'react';
+import PropTypes from 'prop-types';
+import { FieldArray } from 'react-final-form-arrays';
+
+import {
+  Col,
+  Loading,
+  Row,
+} from '@folio/stripes/components';
+
+import DonorsList from './DonorsList';
+import { useFetchDonors } from './hooks';
+
+function DonorsContainer({ name, donorOrganizationIds }) {
+  const [donorIds, setDonorIds] = useState(() => donorOrganizationIds);
+  const { donors, isLoading } = useFetchDonors(donorIds);
+
+  const handleFetchDonors = useCallback(ids => {
+    setDonorIds(ids);
+  }, []);
+
+  useEffect(() => {
+    if (donorOrganizationIds.length) {
+      handleFetchDonors(donorOrganizationIds);
+    }
+  }, [donorOrganizationIds, handleFetchDonors]);
+
+  const donorsMap = donors.reduce((acc, contact) => {
+    acc[contact.id] = contact;
+
+    return acc;
+  }, {});
+
+  if (isLoading) {
+    return <Loading />;
+  }
+
+  return (
+    <Row>
+      <Col xs={12}>
+        <FieldArray
+          name={name}
+          id={name}
+          component={DonorsList}
+          fetchDonors={handleFetchDonors}
+          donorsMap={donorsMap}
+        />
+      </Col>
+    </Row>
+  );
+}
+
+DonorsContainer.propTypes = {
+  name: PropTypes.string.isRequired,
+  donorOrganizationIds: PropTypes.arrayOf(PropTypes.string),
+};
+
+DonorsContainer.defaultProps = {
+  donorOrganizationIds: [],
+};
+
+export default DonorsContainer;

lib/DonorsList/DonorsContainer.test.js

@@ -0,0 +1,93 @@
+import { MemoryRouter } from 'react-router-dom';
+import { render, screen } from '@testing-library/react';
+
+import stripesFinalForm from '@folio/stripes/final-form';
+
+import DonorsContainer from './DonorsContainer';
+import { useFetchDonors } from './hooks';
+
+jest.mock('@folio/stripes/components', () => ({
+  ...jest.requireActual('@folio/stripes/components'),
+  Loading: jest.fn(() => 'Loading'),
+}));
+
+jest.mock('./DonorsList', () => jest.fn(({ donorsMap }) => {
+  if (!Object.values(donorsMap).length) {
+    return 'stripes-components.tableEmpty';
+  }
+
+  return Object.values(donorsMap).map(({ name }) => <div key={name}>{name}</div>);
+}));
+
+jest.mock('./hooks', () => ({
+  useFetchDonors: jest.fn().mockReturnValue({
+    fetchDonorsMutation: jest.fn(),
+    isLoading: false,
+  }),
+}));
+
+const defaultProps = {
+  name: 'donors',
+  donorOrganizationIds: [],
+};
+
+const renderForm = (props = {}) => (
+  <form>
+    <DonorsContainer
+      {...defaultProps}
+      {...props}
+    />
+    <button type="submit">Submit</button>
+  </form>
+);
+
+const FormCmpt = stripesFinalForm({})(renderForm);
+
+const renderComponent = (props = {}) => (render(
+  <MemoryRouter>
+    <FormCmpt onSubmit={() => { }} {...props} />
+  </MemoryRouter>,
+));
+
+describe('DonorsContainer', () => {
+  beforeEach(() => {
+    useFetchDonors.mockClear().mockReturnValue({
+      fetchDonorsMutation: jest.fn(),
+      isLoading: false,
+    });
+  });
+
+  it('should render component', () => {
+    renderComponent();
+
+    expect(screen.getByText('stripes-components.tableEmpty')).toBeDefined();
+  });
+
+  it('should render Loading component', () => {
+    useFetchDonors.mockClear().mockReturnValue({
+      fetchDonorsMutation: jest.fn(),
+      isLoading: true,
+    });
+
+    renderComponent();
+
+    expect(screen.getByText('Loading')).toBeDefined();
+  });
+
+  it('should call `fetchDonorsMutation` with `donorOrganizationIds`', () => {
+    const mockData = [{ name: 'Amazon', code: 'AMAZ', id: '1' }];
+    const fetchDonorsMutationMock = jest.fn().mockReturnValue({
+      then: (cb) => cb(mockData),
+    });
+
+    useFetchDonors.mockClear().mockReturnValue({
+      fetchDonorsMutation: fetchDonorsMutationMock,
+      isLoading: false,
+    });
+
+    renderComponent({ donorOrganizationIds: ['1'] });
+
+    expect(fetchDonorsMutationMock).toHaveBeenCalled();
+    expect(screen.getByText(mockData[0].name)).toBeDefined();
+  });
+});

lib/DonorsList/DonorsList.js

@@ -0,0 +1,101 @@
+import React, { useMemo } from 'react';
+import { sortBy } from 'lodash';
+import PropTypes from 'prop-types';
+import { useIntl } from 'react-intl';
+
+import {
+  Button,
+  Icon,
+  MultiColumnList,
+  TextLink,
+} from '@folio/stripes/components';
+import { useStripes } from '@folio/stripes/core';
+
+import AddDonorButton from './AddDonorButton';
+import {
+  alignRowProps,
+  columnMapping,
+  columnWidths,
+  visibleColumns,
+} from './constants';
+
+const getDonorUrl = (orgId) => {
+  if (orgId) {
+    return `/organizations/view/${orgId}`;
+  }
+
+  return undefined;
+};
+
+const getResultsFormatter = ({
+  canViewOrganizations,
+  fields,
+  intl,
+}) => ({
+  name: donor => <TextLink to={getDonorUrl(canViewOrganizations && donor.id)}>{donor.name}</TextLink>,
+  code: donor => donor.code,
+  unassignDonor: donor => (
+    <Button
+      align="end"
+      aria-label={intl.formatMessage({ id: 'stripes-acq-components.donors.button.unassign' })}
+      buttonStyle="fieldControl"
+      type="button"
+      onClick={(e) => {
+        e.preventDefault();
+        fields.remove(donor._index);
+      }}
+    >
+      <Icon icon="times-circle" />
+    </Button>
+  ),
+});
+
+const DonorsList = ({ fetchDonors, fields, donorsMap, id }) => {
+  const intl = useIntl();
+  const stripes = useStripes();
+  const canViewOrganizations = stripes.hasPerm('ui-organizations.view');
+  const donors = (fields.value || [])
+    .map((contactId, _index) => {
+      const contact = donorsMap?.[contactId];
+
+      return {
+        ...(contact || { isDeleted: true }),
+        _index,
+      };
+    });
+  const contentData = sortBy(donors, [({ lastName }) => lastName?.toLowerCase()]);
+
+  const resultsFormatter = useMemo(() => {
+    return getResultsFormatter({ intl, fields, canViewOrganizations });
+  }, [canViewOrganizations, fields, intl]);
+
+  return (
+    <>
+      <MultiColumnList
+        id={id}
+        columnMapping={columnMapping}
+        contentData={contentData}
+        formatter={resultsFormatter}
+        rowProps={alignRowProps}
+        visibleColumns={visibleColumns}
+        columnWidths={columnWidths}
+      />
+      <br />
+      <AddDonorButton
+        fetchDonors={fetchDonors}
+        fields={fields}
+        stripes={stripes}
+        name={id}
+      />
+    </>
+  );
+};
+
+DonorsList.propTypes = {
+  fetchDonors: PropTypes.func.isRequired,
+  fields: PropTypes.object,
+  donorsMap: PropTypes.object,
+  id: PropTypes.string.isRequired,
+};
+
+export default DonorsList;

lib/DonorsList/DonorsList.test.js

@@ -0,0 +1,53 @@
+import { MemoryRouter } from 'react-router-dom';
+import { render, screen } from '@testing-library/react';
+
+import DonorsList from './DonorsList';
+
+const mockFetchDonors = jest.fn();
+
+const defaultProps = {
+  fetchDonors: mockFetchDonors,
+  fields: {},
+  donorsMap: {},
+  id: 'donors',
+};
+
+const wrapper = ({ children }) => (
+  <MemoryRouter>
+    {children}
+  </MemoryRouter>
+);
+
+const renderComponent = (props = {}) => (render(
+  <DonorsList
+    {...defaultProps}
+    {...props}
+  />,
+  { wrapper },
+));
+
+describe('DonorsList', () => {
+  it('should render component', () => {
+    renderComponent();
+
+    expect(screen.getByText('stripes-components.tableEmpty')).toBeDefined();
+  });
+
+  it('should render the list of donor organizations', () => {
+    renderComponent({
+      fields: {
+        value: [
+          '1',
+          '2',
+        ],
+      },
+      donorsMap: {
+        1: { id: '1', name: 'Amazon' },
+        2: { id: '2', name: 'Google' },
+      },
+    });
+
+    expect(screen.getByText('Amazon')).toBeDefined();
+    expect(screen.getByText('Google')).toBeDefined();
+  });
+});