feat: server-side pagination and search for contract codes

frontends/api/package.json

@@ -31,7 +31,7 @@
     "ol-test-utilities": "0.0.0"
   },
   "dependencies": {
-    "@mitodl/mitxonline-api-axios": "2026.6.17",
+    "@mitodl/mitxonline-api-axios": "2026.6.30-1",
     "@tanstack/react-query": "^5.66.0",
     "axios": "^1.12.2",
     "tiny-invariant": "^1.3.3"

frontends/api/src/mitxonline/hooks/organizations/index.ts

@@ -39,10 +39,10 @@ const useBulkAssignSeats = () => {
     ) => b2bApi.b2bManagerOrganizationsContractsCodesBulkAssignCreate(opts),
     onSettled: (_data, _err, vars) => {
       queryClient.invalidateQueries({
-        queryKey: managerOrganizationKeys.contractCodes({
-          id: vars.id,
-          parent_lookup_organization: vars.parent_lookup_organization,
-        }),
+        queryKey: managerOrganizationKeys.contractCodesForContract(
+          vars.id,
+          vars.parent_lookup_organization,
+        ),
       })
     },
   })
@@ -57,10 +57,10 @@ const useRemindCode = () => {
     ) => b2bApi.b2bManagerOrganizationsContractsCodesRemindCreate(opts),
     onSettled: (_data, _err, vars) => {
       queryClient.invalidateQueries({
-        queryKey: managerOrganizationKeys.contractCodes({
-          id: vars.id,
-          parent_lookup_organization: vars.parent_lookup_organization,
-        }),
+        queryKey: managerOrganizationKeys.contractCodesForContract(
+          vars.id,
+          vars.parent_lookup_organization,
+        ),
       })
     },
   })
@@ -75,10 +75,10 @@ const useRevokeCode = () => {
     ) => b2bApi.b2bManagerOrganizationsContractsCodesRevokeDestroy(opts),
     onSettled: (_data, _err, vars) => {
       queryClient.invalidateQueries({
-        queryKey: managerOrganizationKeys.contractCodes({
-          id: vars.id,
-          parent_lookup_organization: vars.parent_lookup_organization,
-        }),
+        queryKey: managerOrganizationKeys.contractCodesForContract(
+          vars.id,
+          vars.parent_lookup_organization,
+        ),
       })
     },
   })
@@ -97,10 +97,10 @@ const useReassignCode = () => {
     ) => b2bApi.b2bManagerOrganizationsContractsCodesReassignUpdate(opts),
     onSettled: (_data, _err, vars) => {
       queryClient.invalidateQueries({
-        queryKey: managerOrganizationKeys.contractCodes({
-          id: vars.id,
-          parent_lookup_organization: vars.parent_lookup_organization,
-        }),
+        queryKey: managerOrganizationKeys.contractCodesForContract(
+          vars.id,
+          vars.parent_lookup_organization,
+        ),
       })
     },
   })
@@ -115,4 +115,7 @@ export {
   useRemindCode,
   useRevokeCode,
 }
-export type { ContractCode } from "./queries"
+export type {
+  ManagerEnrollmentCode,
+  PaginatedManagerEnrollmentCodeList,
+} from "@mitodl/mitxonline-api-axios/v2"

frontends/api/src/mitxonline/hooks/organizations/queries.ts

@@ -3,16 +3,12 @@ import { b2bApi } from "../../clients"
 import {
   OrganizationPage,
   ManagerContractDetail,
-  ManagerEnrollmentCode,
+  PaginatedManagerEnrollmentCodeList,
   B2bApiB2bOrganizationsRetrieveRequest,
   B2bApiB2bManagerOrganizationsContractsRetrieveRequest,
   B2bApiB2bManagerOrganizationsContractsCodesListRequest,
 } from "@mitodl/mitxonline-api-axios/v2"
 
-type ContractCode = ManagerEnrollmentCode & {
-  redemption_status: "unassigned" | "assigned" | "redeemed"
-}
-
 const organizationKeys = {
   root: ["mitxonline", "organizations"],
   organizationsRetrieve: (opts?: B2bApiB2bOrganizationsRetrieveRequest) => [
@@ -50,14 +46,20 @@ const managerOrganizationKeys = {
   contractCodes: (
     opts: B2bApiB2bManagerOrganizationsContractsCodesListRequest,
   ) => [...managerOrganizationKeys.contractCodesRoot(), opts] as const,
+  // Prefix key used for invalidation — matches all pages/search states for one contract
+  contractCodesForContract: (id: number, orgId: number) =>
+    managerOrganizationKeys.contractCodes({
+      id,
+      parent_lookup_organization: orgId,
+    }),
 }
 
 const managerOrganizationQueries = {
   managerOrganizationsList: () =>
     queryOptions({
       queryKey: managerOrganizationKeys.list(),
       queryFn: async (): Promise<OrganizationPage[]> =>
-        b2bApi.b2bManagerOrganizationsList().then((res) => res.data),
+        b2bApi.b2bManagerOrganizationsList().then((res) => res.data.results),
     }),
   managerContractDetail: (
     opts: B2bApiB2bManagerOrganizationsContractsRetrieveRequest,
@@ -74,10 +76,10 @@ const managerOrganizationQueries = {
   ) =>
     queryOptions({
       queryKey: managerOrganizationKeys.contractCodes(opts),
-      queryFn: async (): Promise<ContractCode[]> =>
+      queryFn: async (): Promise<PaginatedManagerEnrollmentCodeList> =>
         b2bApi
           .b2bManagerOrganizationsContractsCodesList(opts)
-          .then((res) => res.data as ContractCode[]),
+          .then((res) => res.data),
     }),
 }
 
@@ -87,5 +89,3 @@ export {
   managerOrganizationQueries,
   managerOrganizationKeys,
 }
-
-export type { ContractCode }

frontends/api/src/mitxonline/test-utils/factories/contracts.ts

@@ -3,16 +3,16 @@ import type {
   BulkAssignError,
   BulkAssignResult,
   ContractPage,
+  ManagerEnrollmentCode,
+  PaginatedManagerEnrollmentCodeList,
 } from "@mitodl/mitxonline-api-axios/v2"
 import { makePaginatedFactory } from "ol-test-utilities"
-import type { ContractCode } from "../../hooks/organizations"
 
 const contract = (overrides: Partial<ContractPage> = {}): ContractPage => ({
   id: faker.number.int(),
   contract_end: faker.date.future().toISOString(),
   contract_start: faker.date.past().toISOString(),
   description: faker.lorem.sentence(),
-  integration_type: "non-sso" as const,
   name: faker.company.name(),
   organization: faker.number.int(),
   slug: faker.lorem.slug(),
@@ -26,7 +26,19 @@ const contract = (overrides: Partial<ContractPage> = {}): ContractPage => ({
 
 const contracts = makePaginatedFactory(contract)
 
-const contractCode = (overrides: Partial<ContractCode> = {}): ContractCode => {
+const paginatedContractCodes = (
+  results: ManagerEnrollmentCode[],
+  opts: { count?: number; next?: string | null; previous?: string | null } = {},
+): PaginatedManagerEnrollmentCodeList => ({
+  count: opts.count ?? results.length,
+  next: opts.next ?? null,
+  previous: opts.previous ?? null,
+  results,
+})
+
+const contractCode = (
+  overrides: Partial<ManagerEnrollmentCode> = {},
+): ManagerEnrollmentCode => {
   const status = overrides.redemption_status ?? "assigned"
   const isAssigned = status !== "unassigned"
   const isRedeemed = status === "redeemed"
@@ -61,4 +73,11 @@ const bulkAssignResult = (
   ...overrides,
 })
 
-export { contract, contracts, contractCode, bulkAssignError, bulkAssignResult }
+export {
+  contract,
+  contracts,
+  contractCode,
+  paginatedContractCodes,
+  bulkAssignError,
+  bulkAssignResult,
+}

frontends/api/src/mitxonline/test-utils/urls.ts

@@ -90,8 +90,24 @@ const contracts = {
   contractsList: () => `${getApiBaseUrl()}/api/v0/b2b/contracts/`,
   managerContractDetail: (orgId: number, contractId: number) =>
     `${getApiBaseUrl()}/api/v0/b2b/manager/organizations/${orgId}/contracts/${contractId}/`,
-  managerContractCodes: (orgId: number, contractId: number) =>
-    `${getApiBaseUrl()}/api/v0/b2b/manager/organizations/${orgId}/contracts/${contractId}/codes/`,
+  managerContractCodes: (
+    orgId: number,
+    contractId: number,
+    params?: {
+      page?: number
+      page_size?: number
+      search_term?: string
+      status?: string
+    },
+  ) => {
+    // queryify does not filter undefined values, so strip them first to avoid e.g. search_term=undefined in the URL
+    const clean = params
+      ? Object.fromEntries(
+          Object.entries(params).filter(([, v]) => v !== undefined),
+        )
+      : undefined
+    return `${getApiBaseUrl()}/api/v0/b2b/manager/organizations/${orgId}/contracts/${contractId}/codes/${queryify(clean)}`
+  },
   managerContractBulkAssign: (orgId: number, contractId: number) =>
     `${getApiBaseUrl()}/api/v0/b2b/manager/organizations/${orgId}/contracts/${contractId}/codes/bulk_assign/`,
   managerContractCodeRemind: (

frontends/main/package.json

@@ -16,7 +16,7 @@
     "@floating-ui/react": "^0.27.16",
     "@mitodl/arithmix": "^0.2.2",
     "@mitodl/course-search-utils": "^3.5.2",
-    "@mitodl/mitxonline-api-axios": "2026.6.17",
+    "@mitodl/mitxonline-api-axios": "2026.6.30-1",
     "@mitodl/smoot-design": "^6.27.0",
     "@mui/base": "5.0.0-beta.70",
     "@mui/material": "^6.4.5",

frontends/main/public/sample-seat-assignments.csv

@@ -0,0 +1,6 @@
+email
+testuser1@example.com
+testuser2@example.com
+testuser3@example.com
+testuser4@example.com
+testuser5@example.com