richie-education 3.2.1-dev9 → 3.2.2-dev26

package/js/components/SaleTunnel/index.full-process-b2b.spec.tsx

@@ -0,0 +1,356 @@
+import { screen, within } from '@testing-library/react';
+import fetchMock from 'fetch-mock';
+import queryString from 'query-string';
+import userEvent from '@testing-library/user-event';
+import {
+  RichieContextFactory as mockRichieContextFactory,
+  PacedCourseFactory,
+  UserFactory,
+} from 'utils/test/factories/richie';
+import { render } from 'utils/test/render';
+import { setupJoanieSession } from 'utils/test/wrappers/JoanieAppWrapper';
+import CourseProductItem from 'widgets/SyllabusCourseRunsList/components/CourseProductItem';
+import {
+  OfferingFactory,
+  PaymentPlanFactory,
+  ProductFactory,
+  OfferingBatchOrderFactory,
+  BatchOrderReadFactory,
+  CredentialOrderFactory,
+} from 'utils/test/factories/joanie';
+import { CourseRun, NOT_CANCELED_ORDER_STATES, OrderState } from 'types/Joanie';
+import { Priority } from 'types';
+import { expectMenuToBeClosed, expectMenuToBeOpen } from 'utils/test/Cunningham';
+import { OpenEdxApiProfileFactory } from 'utils/test/factories/openEdx';
+import { User } from 'types/User';
+import { OpenEdxApiProfile } from 'types/openEdx';
+import { createTestQueryClient } from 'utils/test/createTestQueryClient';
+
+jest.mock('utils/context', () => ({
+  __esModule: true,
+  default: mockRichieContextFactory({
+    authentication: { backend: 'fonzie', endpoint: 'https://auth.test' },
+    joanie_backend: { endpoint: 'https://joanie.endpoint' },
+  }).one(),
+}));
+
+jest.mock('utils/indirection/window', () => ({
+  matchMedia: () => ({
+    matches: true,
+    addListener: jest.fn(),
+    removeListener: jest.fn(),
+  }),
+}));
+
+jest.mock('../PaymentInterfaces');
+
+describe('SaleTunnel', () => {
+  let richieUser: User;
+  let openApiEdxProfile: OpenEdxApiProfile;
+  setupJoanieSession();
+
+  const formatPrice = (currency: string, price: number) =>
+    new Intl.NumberFormat('en', { currency, style: 'currency' })
+      .format(price)
+      .replace(/(\u202F|\u00a0)/g, ' ');
+
+  beforeEach(() => {
+    richieUser = UserFactory().one();
+    openApiEdxProfile = OpenEdxApiProfileFactory({
+      username: richieUser.username,
+      email: richieUser.email,
+      name: richieUser.full_name,
+    }).one();
+
+    const { 'pref-lang': prefLang, ...openEdxAccount } = openApiEdxProfile;
+
+    fetchMock.get(`https://auth.test/api/user/v1/accounts/${richieUser.username}`, openEdxAccount);
+    fetchMock.patch(
+      `https://auth.test/api/user/v1/accounts/${richieUser.username}`,
+      openEdxAccount,
+    );
+    fetchMock.get(`https://auth.test/api/user/v1/preferences/${richieUser.username}`, {
+      'pref-lang': prefLang,
+    });
+    fetchMock.get(`https://auth.test/api/v1.0/user/me`, richieUser);
+  });
+
+  afterEach(() => fetchMock.reset());
+
+  it('tests the entire process of subscribing to a batch order', async () => {
+    const course = PacedCourseFactory().one();
+    const product = ProductFactory().one();
+    const offering = OfferingFactory({ course, product, is_withdrawable: false }).one();
+    const paymentPlan = PaymentPlanFactory().one();
+    const offeringOrganization = OfferingBatchOrderFactory({
+      product: { id: product.id, title: product.title },
+    }).one();
+
+    fetchMock.get(
+      `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/`,
+      offering,
+    );
+    fetchMock.get(
+      `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/payment-plan/`,
+      paymentPlan,
+    );
+    fetchMock.get(`https://joanie.endpoint/api/v1.0/enrollments/`, []);
+    fetchMock.get(
+      `https://joanie.endpoint/api/v1.0/orders/?${queryString.stringify({
+        product_id: product.id,
+        course_code: course.code,
+        state: NOT_CANCELED_ORDER_STATES,
+      })}`,
+      [],
+    );
+    fetchMock.get(
+      `https://joanie.endpoint/api/v1.0/offerings/${offering.id}/get-organizations/`,
+      offeringOrganization,
+    );
+
+    render(<CourseProductItem productId={product.id} course={course} />, {
+      queryOptions: { client: createTestQueryClient({ user: richieUser }) },
+    });
+
+    // Verify product info
+    await screen.findByRole('heading', { level: 3, name: product.title });
+    await screen.findByText(formatPrice(product.price_currency, product.price));
+    expect(screen.queryByText('Purchased')).not.toBeInTheDocument();
+
+    const user = userEvent.setup();
+    const buyButton = screen.getByRole('button', { name: product.call_to_action });
+
+    expect(screen.queryByTestId('generic-sale-tunnel-payment-step')).not.toBeInTheDocument();
+    await user.click(buyButton);
+    await screen.findByTestId('generic-sale-tunnel-payment-step');
+
+    // Verify learning path
+    await screen.findByText('Your learning path');
+    const targetCourses = await screen.findAllByTestId('product-target-course');
+    expect(targetCourses).toHaveLength(product.target_courses.length);
+    targetCourses.forEach((targetCourse, index) => {
+      const courseItem = product.target_courses[index];
+      const courseDetail = within(targetCourse).getByTestId(
+        `target-course-detail-${courseItem.code}`,
+      );
+      const summary = courseDetail.querySelector('summary')!;
+      expect(summary).toHaveTextContent(courseItem.title);
+
+      const courseRuns = targetCourse.querySelectorAll(
+        '.product-detail-row__course-run-dates__item',
+      );
+      const openedCourseRuns = courseItem.course_runs.filter(
+        (cr: CourseRun) => cr.state.priority <= Priority.FUTURE_NOT_YET_OPEN,
+      );
+      expect(courseRuns).toHaveLength(openedCourseRuns.length);
+    });
+
+    // Select group buy form
+    await screen.findByText('Purchase type');
+    const formTypeSelect = screen.getByRole('combobox', { name: 'Purchase type' });
+    const menu: HTMLDivElement = screen.getByRole('listbox', { name: 'Purchase type' });
+    expectMenuToBeClosed(menu);
+    await user.click(formTypeSelect);
+    expectMenuToBeOpen(menu);
+    await user.click(screen.getByText('Group purchase (B2B)'));
+
+    // Company step
+    const $companyName = await screen.findByRole('textbox', { name: 'Company name' });
+    const $idNumber = screen.getByRole('textbox', { name: /Identification number/ });
+    const $address = screen.getByRole('textbox', { name: 'Address' });
+    const $postCode = screen.getByRole('textbox', { name: 'Post code' });
+    const $city = screen.getByRole('textbox', { name: 'City' });
+    const $country = screen.getByRole('combobox', { name: 'Country' });
+
+    await user.type($companyName, 'GIP-FUN');
+    await user.type($idNumber, '789 242 229 01694');
+    await user.type($address, '61 Bis Rue de la Glaciere');
+    await user.type($postCode, '75013');
+    await user.type($city, 'Paris');
+
+    const countryMenu: HTMLDivElement = screen.getByRole('listbox', { name: 'Country' });
+    await user.click($country);
+    expectMenuToBeOpen(countryMenu);
+    await user.click(screen.getByText('France'));
+
+    expect($companyName).toHaveValue('GIP-FUN');
+    const visibleValue = $country.querySelector('.c__select__inner__value span');
+    expect(visibleValue!.textContent).toBe('France');
+
+    // Follow-up step
+    await user.click(screen.getByRole('button', { name: 'Next' }));
+    const $lastName = await screen.findByRole('textbox', { name: 'Last name' });
+    const $firstName = screen.getByRole('textbox', { name: 'First name' });
+    const $role = screen.getByRole('textbox', { name: 'Role' });
+    const $email = screen.getByRole('textbox', { name: 'Email' });
+    const $phone = screen.getByRole('textbox', { name: 'Phone' });
+
+    await user.type($lastName, 'Doe');
+    await user.type($firstName, 'John');
+    await user.type($role, 'HR');
+    await user.type($email, 'john.doe@fun-mooc.com');
+    await user.type($phone, '+338203920103');
+
+    expect($lastName).toHaveValue('Doe');
+    expect($email).toHaveValue('john.doe@fun-mooc.com');
+
+    // Signatory step
+    await user.click(screen.getByRole('button', { name: 'Next' }));
+    const $signatoryLastName = await screen.findByRole('textbox', { name: 'Last name' });
+    const $signatoryFirstName = screen.getByRole('textbox', { name: 'First name' });
+    const $signatoryRole = screen.getByRole('textbox', { name: 'Role' });
+    const $signatoryEmail = screen.getByRole('textbox', { name: 'Email' });
+    const $signatoryPhone = screen.getByRole('textbox', { name: 'Phone' });
+
+    await user.type($signatoryLastName, 'Doe');
+    await user.type($signatoryFirstName, 'John');
+    await user.type($signatoryRole, 'CEO');
+    await user.type($signatoryEmail, 'john.doe@fun-mooc.com');
+    await user.type($signatoryPhone, '+338203920103');
+
+    // Participants step
+    await user.click(screen.getByRole('button', { name: 'Next' }));
+    const $nbParticipants = await screen.findByLabelText('How many participants ?');
+    await user.type($nbParticipants, '13');
+    expect($nbParticipants).toHaveValue(13);
+
+    // Submit the batch order
+    const batchOrderRead = BatchOrderReadFactory().one();
+    fetchMock.post('https://joanie.endpoint/api/v1.0/batch-orders/', batchOrderRead);
+    const $subscribebutton = screen.getByRole('button', {
+      name: `Subscribe`,
+    }) as HTMLButtonElement;
+    await user.click($subscribebutton);
+    await screen.findByTestId('generic-sale-tunnel-success-step');
+    screen.getByText('Subscription confirmed!');
+    screen.getByText('Your order has been successfully registered.');
+    const $dashboardLink = screen.getByRole('link', { name: 'Close' });
+    expect($dashboardLink).toHaveAttribute(
+      'href',
+      `/en/dashboard/batch-orders/${batchOrderRead.id}`,
+    );
+  }, 30000);
+
+  it('tests the entire process of subscribing with a voucher from a batch order', async () => {
+    /**
+     * Initialization.
+     */
+    const course = PacedCourseFactory().one();
+    const product = ProductFactory().one();
+    const offering = OfferingFactory({
+      course,
+      product,
+      is_withdrawable: false,
+    }).one();
+    const paymentPlan = PaymentPlanFactory().one();
+
+    fetchMock.get(
+      `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/`,
+      offering,
+    );
+    fetchMock.get(
+      `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/payment-plan/`,
+      paymentPlan,
+    );
+    fetchMock.get(`https://joanie.endpoint/api/v1.0/enrollments/`, []);
+    const orderQueryParameters = {
+      product_id: product.id,
+      course_code: course.code,
+      state: NOT_CANCELED_ORDER_STATES,
+    };
+    fetchMock.get(
+      `https://joanie.endpoint/api/v1.0/orders/?${queryString.stringify(orderQueryParameters)}`,
+      [],
+    );
+
+    render(<CourseProductItem productId={product.id} course={course} />, {
+      queryOptions: { client: createTestQueryClient({ user: richieUser }) },
+    });
+
+    // Wait for product information to be fetched
+    await screen.findByRole('heading', { level: 3, name: product.title });
+    // Price is displayed, meaning the product is not bought yet.
+    screen.getByText(
+      // the price formatter generates non-breaking spaces and getByText doesn't seem to handle that well, replace it
+      // with a regular space. We replace NNBSP (\u202F) and NBSP (\u00a0) with a regular space
+      formatPrice(product.price_currency, product.price),
+    );
+    expect(screen.queryByText('Purchased')).not.toBeInTheDocument();
+
+    /**
+     * Purchase.
+     */
+    const user = userEvent.setup();
+    const buyButton = screen.getByRole('button', { name: product.call_to_action });
+
+    // The SaleTunnel should not be displayed.
+    expect(screen.queryByTestId('generic-sale-tunnel-payment-step')).not.toBeInTheDocument();
+
+    await user.click(buyButton);
+
+    // The SaleTunnel should be displayed.
+    screen.getByTestId('generic-sale-tunnel-payment-step');
+
+    /**
+     * Submit voucher and check price
+     */
+    const paymentPlanVoucher = PaymentPlanFactory({
+      discounted_price: 0,
+      discount: '-100%',
+      payment_schedule: undefined,
+      from_batch_order: true,
+    }).one();
+    fetchMock.get(
+      `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/payment-plan/?voucher_code=DISCOUNT100`,
+      paymentPlanVoucher,
+      { overwriteRoutes: true },
+    );
+    await user.type(screen.getByLabelText('Voucher code'), 'DISCOUNT100');
+    await user.click(screen.getByRole('button', { name: 'Validate' }));
+    expect(screen.queryByRole('heading', { name: 'Payment schedule' })).not.toBeInTheDocument();
+    await screen.findByTestId('sale-tunnel__total__amount');
+    const $totalAmountVoucher = screen.getByTestId('sale-tunnel__total__amount');
+    expect($totalAmountVoucher).toHaveTextContent(
+      'Total' +
+        formatPrice(product.price_currency, paymentPlanVoucher.price!) +
+        formatPrice(product.price_currency, paymentPlanVoucher.discounted_price!),
+    );
+
+    /**
+     * Make sure the checkbox to waive withdrawal right is not displayed
+     */
+    expect(screen.queryByTestId('withdraw-right-checkbox')).not.toBeInTheDocument();
+
+    /**
+     * Subscribe
+     */
+    const order = CredentialOrderFactory({
+      state: OrderState.COMPLETED,
+      payment_schedule: undefined,
+    }).one();
+    fetchMock
+      .post('https://joanie.endpoint/api/v1.0/orders/', order)
+      .get(
+        `https://joanie.endpoint/api/v1.0/orders/?${queryString.stringify(orderQueryParameters)}`,
+        [order],
+        { overwriteRoutes: true },
+      );
+
+    const $button = screen.getByRole('button', {
+      name: `Subscribe`,
+    }) as HTMLButtonElement;
+    await user.click($button);
+
+    /**
+     * No withdrawal error should be displayed.
+     */
+    expect(
+      await screen.queryByText('You must waive your withdrawal right.'),
+    ).not.toBeInTheDocument();
+
+    // // Make sure the success step is shown.
+    await screen.findByTestId('generic-sale-tunnel-success-step');
+
+    screen.getByText('Subscription confirmed!');
+  }, 10000);
+});

package/js/components/SaleTunnel/{index.full-process.spec.tsx → index.full-process-b2c.spec.tsx}

@@ -394,6 +394,9 @@ describe('SaleTunnel', () => {
     // Make sure the success step is shown.
     await screen.findByTestId('generic-sale-tunnel-success-step');
     screen.getByText('Subscription confirmed!');
+    screen.getByText(
+      /your order has been successfully registered\.you will be able to start your training once the first installment will be paid\./i,
+    );
     screen.getByRole('link', { name: 'Close' });
 
     /**
@@ -403,5 +406,5 @@ describe('SaleTunnel', () => {
     // This way we make sure the cache is updated.
     await screen.findByText('Purchased');
     expect(screen.queryByRole('button', { name: product.call_to_action })).not.toBeInTheDocument();
-  }, 15000);
+  }, 30000);
 });

package/js/components/SaleTunnel/index.spec.tsx

@@ -690,9 +690,13 @@ describe.each([
     });
   });
 
-  it('should show an error when submit an invalid voucher', async () => {
+  it('should show appropriate error messages for invalid vouchers', async () => {
     const user = userEvent.setup({ delay: null });
     const paymentPlan = PaymentPlanFactory().one();
+    const paymentPlanVoucher = PaymentPlanFactory({
+      discounted_price: 70,
+      discount: '-30%',
+    }).one();
     const product = ProductFactory().one();
     fetchMock
       .get(
@@ -711,6 +715,19 @@ describe.each([
             detail: 'No Voucher matches the given query.',
           },
         },
+      )
+      .get(
+        `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/payment-plan/?voucher_code=DISCOUNT29`,
+        {
+          status: 429,
+          body: {
+            detail: 'Too many attempts. Please try again later.',
+          },
+        },
+      )
+      .get(
+        `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/payment-plan/?voucher_code=DISCOUNT10`,
+        paymentPlanVoucher,
       );
     render(<Wrapper paymentPlan={paymentPlan} product={product} isWithdrawable={true} />, {
       queryOptions: { client: createTestQueryClient({ user: richieUser }) },
@@ -719,5 +736,117 @@ describe.each([
     await user.type(screen.getByLabelText('Voucher code'), 'DISCOUNT30');
     await user.click(screen.getByRole('button', { name: 'Validate' }));
     expect(await screen.findByText('The submitted voucher code is not valid.')).toBeInTheDocument();
+    await user.type(screen.getByLabelText('Voucher code'), 'DISCOUNT29');
+    await user.click(screen.getByRole('button', { name: 'Validate' }));
+    expect(
+      await screen.findByText('Too many attempts. Please try again later.'),
+    ).toBeInTheDocument();
+    await user.type(screen.getByLabelText('Voucher code'), 'DISCOUNT10');
+    await user.click(screen.getByRole('button', { name: 'Validate' }));
+    expect(await screen.findByText('Discount applied')).toBeInTheDocument();
+  });
+
+  it('should hide billing informations for a voucher from a batch order', async () => {
+    const user = userEvent.setup({ delay: null });
+    const paymentPlan = PaymentPlanFactory().one();
+    const paymentPlanVoucher = PaymentPlanFactory({
+      discounted_price: 0.0,
+      discount: '-100%',
+      from_batch_order: true,
+    }).one();
+    const product = ProductFactory().one();
+    fetchMock
+      .get(
+        `https://joanie.endpoint/api/v1.0/orders/?${queryString.stringify(getFetchOrderQueryParams(product))}`,
+        [],
+      )
+      .get(
+        `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/payment-plan/`,
+        paymentPlan,
+      )
+      .get(
+        `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/payment-plan/?voucher_code=DISCOUNT100`,
+        paymentPlanVoucher,
+      );
+    render(<Wrapper paymentPlan={paymentPlan} product={product} isWithdrawable={true} />, {
+      queryOptions: { client: createTestQueryClient({ user: richieUser }) },
+    });
+    expect(
+      await screen.queryByText('Those information will be used for billing'),
+    ).toBeInTheDocument();
+
+    await user.type(screen.getByLabelText('Voucher code'), 'DISCOUNT100');
+    await user.click(screen.getByRole('button', { name: 'Validate' }));
+
+    expect(await screen.findByText('Discount applied')).toBeInTheDocument();
+    await waitFor(async () =>
+      expect(
+        await screen.queryByText('Those information will be used for billing'),
+      ).not.toBeInTheDocument(),
+    );
+    expect(await screen.queryByTestId('withdraw-right-checkbox')).not.toBeInTheDocument();
+  });
+
+  it('should hide voucher code input when one is already used', async () => {
+    const user = userEvent.setup({ delay: null });
+    const paymentPlan = PaymentPlanFactory().one();
+    const paymentPlanVoucher = PaymentPlanFactory({
+      discounted_price: 70,
+      discount: '-30%',
+    }).one();
+    const product = ProductFactory().one();
+    fetchMock
+      .get(
+        `https://joanie.endpoint/api/v1.0/orders/?${queryString.stringify(getFetchOrderQueryParams(product))}`,
+        [],
+      )
+      .get(
+        `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/payment-plan/`,
+        paymentPlan,
+      )
+      .get(
+        `https://joanie.endpoint/api/v1.0/courses/${course.code}/products/${product.id}/payment-plan/?voucher_code=DISCOUNT30`,
+        paymentPlanVoucher,
+      );
+    render(<Wrapper paymentPlan={paymentPlan} product={product} isWithdrawable={true} />, {
+      queryOptions: { client: createTestQueryClient({ user: richieUser }) },
+    });
+
+    // Initially, voucher input should be visible
+    expect(screen.getByLabelText('Voucher code')).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: 'Validate' })).toBeInTheDocument();
+    expect(
+      screen.getByText('If you have a voucher code, please enter it in the field below.'),
+    ).toBeInTheDocument();
+
+    // Apply a voucher code
+    await user.type(screen.getByLabelText('Voucher code'), 'DISCOUNT30');
+    await user.click(screen.getByRole('button', { name: 'Validate' }));
+
+    // Wait for voucher to be applied
+    expect(await screen.findByText('Discount applied')).toBeInTheDocument();
+
+    // Voucher input should be hidden
+    expect(screen.queryByLabelText('Voucher code')).not.toBeInTheDocument();
+    expect(screen.queryByRole('button', { name: 'Validate' })).not.toBeInTheDocument();
+    expect(
+      screen.queryByText('If you have a voucher code, please enter it in the field below.'),
+    ).not.toBeInTheDocument();
+
+    // Voucher tag should be visible with the applied code
+    expect(screen.getByText('DISCOUNT30')).toBeInTheDocument();
+
+    // Remove the voucher
+    await user.click(screen.getByTitle('Delete this voucher'));
+
+    // Voucher input should be visible again
+    expect(screen.getByLabelText('Voucher code')).toBeInTheDocument();
+    expect(screen.getByRole('button', { name: 'Validate' })).toBeInTheDocument();
+    expect(
+      screen.getByText('If you have a voucher code, please enter it in the field below.'),
+    ).toBeInTheDocument();
+
+    // Voucher tag should be hidden
+    expect(screen.queryByText('DISCOUNT30')).not.toBeInTheDocument();
   });
 });

package/js/hooks/useBatchOrder/index.tsx

@@ -0,0 +1,36 @@
+import { defineMessages } from 'react-intl';
+import { useJoanieApi } from 'contexts/JoanieApiContext';
+import { ResourcesQuery, useResource, useResources, UseResourcesProps } from 'hooks/useResources';
+import { API, BatchOrderQueryFilters, BatchOrderRead } from 'types/Joanie';
+
+const messages = defineMessages({
+  errorCreate: {
+    id: 'hooks.useBatchOrders.errorCreate',
+    defaultMessage: 'An error occurred while creating the batch order.',
+    description: 'Error message shown when batch order creation fails.',
+  },
+});
+
+const props: UseResourcesProps<BatchOrderRead, BatchOrderQueryFilters, API['user']['batchOrders']> =
+  {
+    queryKey: ['batchOrders'],
+    apiInterface: () => useJoanieApi().user.batchOrders,
+    session: true,
+    messages,
+  };
+
+export const useBatchOrders = useResources<BatchOrderRead, BatchOrderQueryFilters>(props);
+export const useBatchOrder = useResource<BatchOrderRead, BatchOrderQueryFilters>(props);
+
+export const useBatchOrdersActions = () => {
+  const { user } = useJoanieApi();
+  const api = user.batchOrders;
+
+  const submitForPayment = async (filters: ResourcesQuery) => {
+    return api.submit_for_payment.create(filters);
+  };
+
+  return {
+    submitForPayment,
+  };
+};

package/js/hooks/useContractArchive/index.ts

@@ -54,10 +54,12 @@ const useContractArchive = () => {
       create: async (
         organizationId?: Organization['id'],
         offeringId?: Offering['id'],
+        fromBatchOrder?: boolean,
       ): Promise<string> => {
         const response = await api.user.contracts.zip_archive.create({
           organization_id: organizationId,
           offering_id: offeringId,
+          from_batch_order: fromBatchOrder,
         });
 
         return extractArchiveId(response.url);

package/js/hooks/useOfferingOrganizations/index.tsx

@@ -0,0 +1,38 @@
+import { defineMessages } from 'react-intl';
+
+import { API, Organization, OrganizationResourceQuery } from 'types/Joanie';
+import { useJoanieApi } from 'contexts/JoanieApiContext';
+import { useResource, useResources, UseResourcesProps } from '../useResources';
+
+const messages = defineMessages({
+  errorGet: {
+    id: 'hooks.useOfferingOrganizations.errorSelect',
+    description: 'Error message shown to the user when organizations fetch request fails.',
+    defaultMessage: 'An error occurred while fetching organizations. Please retry later.',
+  },
+  errorNotFound: {
+    id: 'hooks.useOfferingOrganizations.errorNotFound',
+    description: 'Error message shown to the user when no organizations matches.',
+    defaultMessage: 'Cannot find the organization',
+  },
+});
+
+/**
+ * Joanie Api hook to retrieve organizations
+ * owned by the authenticated user.
+ */
+const props: UseResourcesProps<
+  Organization,
+  OrganizationResourceQuery,
+  API['offerings']['organizations']
+> = {
+  queryKey: ['offeringOrganizations'],
+  apiInterface: () => useJoanieApi().offerings.organizations,
+  session: true,
+  messages,
+};
+
+export const useOfferingOrganizations = useResources<Organization, OrganizationResourceQuery>(
+  props,
+);
+export const useOfferingOrganization = useResource<Organization, OrganizationResourceQuery>(props);

package/js/hooks/useOrganizationAgreements.tsx/index.tsx

@@ -0,0 +1,66 @@
+import { defineMessages } from 'react-intl';
+import { useJoanieApi } from 'contexts/JoanieApiContext';
+import { QueryOptions, useResource, useResources, UseResourcesProps } from 'hooks/useResources';
+import { Agreement, API, ContractResourceQuery } from 'types/Joanie';
+
+const messages = defineMessages({
+  errorGet: {
+    id: 'hooks.useContracts.errorSelect',
+    description: 'Error message shown to the user when contracts fetch request fails.',
+    defaultMessage: 'An error occurred while fetching contracts. Please retry later.',
+  },
+  errorNotFound: {
+    id: 'hooks.useContracts.errorNotFound',
+    description: 'Error message shown to the user when no contract matches.',
+    defaultMessage: 'Cannot find the contract',
+  },
+});
+
+const props: UseResourcesProps<
+  Agreement,
+  ContractResourceQuery,
+  API['organizations']['agreements']
+> = {
+  queryKey: ['organizationAgreements'],
+  apiInterface: () => useJoanieApi().organizations.agreements,
+  session: true,
+  messages,
+};
+
+/**
+ * Joanie Api hook to retrieve/update a contracts related to a course.
+ */
+const organizationProps: UseResourcesProps<
+  Agreement,
+  ContractResourceQuery,
+  API['organizations']['agreements']
+> = {
+  ...props,
+  queryKey: ['organizationAgreements'],
+  apiInterface: () => useJoanieApi().organizations.agreements,
+};
+
+export const useOrganizationAgreement = (
+  id: string,
+  filters: ContractResourceQuery,
+  queryOptions?: QueryOptions<Agreement>,
+) => {
+  return useResource(organizationProps)(id, filters, {
+    ...queryOptions,
+    enabled:
+      !!id &&
+      !!filters?.organization_id &&
+      (queryOptions?.enabled === undefined || queryOptions.enabled),
+  });
+};
+
+export const useOrganizationAgreements = (
+  filters: ContractResourceQuery,
+  queryOptions?: QueryOptions<Agreement>,
+) => {
+  return useResources(organizationProps)(filters, {
+    ...queryOptions,
+    enabled:
+      !!filters?.organization_id && (queryOptions?.enabled === undefined || queryOptions.enabled),
+  });
+};