Release 0.40.0

RELEASE.rst

@@ -1,6 +1,16 @@
 Release Notes
 =============
 
+Version 0.40.0
+--------------
+
+- Append UTM query params (#2430)
+- Ability to group ContentFile vector search results  (#2426)
+- better bad data handling for the org dashboard (#2427)
+- org dashboard design updates (#2425)
+- Assign urls to edx contentfiles when possible (#2420)
+- add mitxonline certificate api (#2410)
+
 Version 0.39.3 (Released August 11, 2025)
 --------------
 

frontends/api/package.json

@@ -30,7 +30,7 @@
     "ol-test-utilities": "0.0.0"
   },
   "dependencies": {
-    "@mitodl/mitxonline-api-axios": "2025.7.28",
+    "@mitodl/mitxonline-api-axios": "2025.8.6",
     "@tanstack/react-query": "^5.66.0",
     "axios": "^1.6.3"
   }

frontends/api/src/mitxonline/clients.ts

@@ -1,11 +1,13 @@
 import {
   B2bApi,
   CoursesApi,
+  CourseCertificatesApi,
   EnrollmentsApi,
   ProgramCollectionsApi,
   ProgramsApi,
+  ProgramCertificatesApi,
   UsersApi,
-} from "@mitodl/mitxonline-api-axios/v1"
+} from "@mitodl/mitxonline-api-axios/v2"
 import axios from "axios"
 
 const axiosInstance = axios.create({
@@ -22,21 +24,41 @@ const BASE_PATH =
 
 const usersApi = new UsersApi(undefined, BASE_PATH, axiosInstance)
 const b2bApi = new B2bApi(undefined, BASE_PATH, axiosInstance)
-const enrollmentsApi = new EnrollmentsApi(undefined, BASE_PATH, axiosInstance)
 const programsApi = new ProgramsApi(undefined, BASE_PATH, axiosInstance)
 const programCollectionsApi = new ProgramCollectionsApi(
   undefined,
   BASE_PATH,
   axiosInstance,
 )
+
+const programCertificatesApi = new ProgramCertificatesApi(
+  undefined,
+  BASE_PATH,
+  axiosInstance,
+)
+
 const coursesApi = new CoursesApi(undefined, BASE_PATH, axiosInstance)
 
+const courseCertificatesApi = new CourseCertificatesApi(
+  undefined,
+  BASE_PATH,
+  axiosInstance,
+)
+
+const courseRunEnrollmentsApi = new EnrollmentsApi(
+  undefined,
+  BASE_PATH,
+  axiosInstance,
+)
+
 export {
   usersApi,
   b2bApi,
-  enrollmentsApi,
+  courseRunEnrollmentsApi,
   programsApi,
   programCollectionsApi,
   coursesApi,
+  programCertificatesApi,
+  courseCertificatesApi,
   axiosInstance,
 }

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

@@ -0,0 +1,3 @@
+import { certificateQueries } from "./queries"
+
+export { certificateQueries }

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

@@ -0,0 +1,46 @@
+import { queryOptions } from "@tanstack/react-query"
+import type {
+  CourseCertificatesApiCourseCertificatesRetrieveRequest,
+  ProgramCertificatesApiProgramCertificatesRetrieveRequest,
+  V2CourseRunCertificate,
+  V2ProgramCertificate,
+} from "@mitodl/mitxonline-api-axios/v2"
+import { courseCertificatesApi, programCertificatesApi } from "../../clients"
+
+const certificateKeys = {
+  root: ["mitxonline", "certificates"],
+  courseCertificatesRetrieve: (
+    opts?: CourseCertificatesApiCourseCertificatesRetrieveRequest,
+  ) => [...certificateKeys.root, "retrieve", opts],
+  programCertificatesRetrieve: (
+    opts?: ProgramCertificatesApiProgramCertificatesRetrieveRequest,
+  ) => [...certificateKeys.root, "retrieve", opts],
+}
+
+const certificateQueries = {
+  courseCertificatesRetrieve: (
+    opts: CourseCertificatesApiCourseCertificatesRetrieveRequest,
+  ) =>
+    queryOptions({
+      queryKey: certificateKeys.courseCertificatesRetrieve(opts),
+      queryFn: async (): Promise<V2CourseRunCertificate> => {
+        return courseCertificatesApi
+          .courseCertificatesRetrieve(opts)
+          .then((res) => res.data)
+      },
+      enabled: !!opts.cert_uuid,
+    }),
+  programCertificatesRetrieve: (
+    opts: ProgramCertificatesApiProgramCertificatesRetrieveRequest,
+  ) =>
+    queryOptions({
+      queryKey: certificateKeys.programCertificatesRetrieve(opts),
+      queryFn: async (): Promise<V2ProgramCertificate> => {
+        return programCertificatesApi
+          .programCertificatesRetrieve(opts)
+          .then((res) => res.data)
+      },
+    }),
+}
+
+export { certificateQueries, certificateKeys }

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

@@ -2,7 +2,7 @@ import { queryOptions } from "@tanstack/react-query"
 import type {
   CoursesApiApiV2CoursesListRequest,
   PaginatedV2CourseWithCourseRunsList,
-} from "@mitodl/mitxonline-api-axios/v1"
+} from "@mitodl/mitxonline-api-axios/v2"
 import { coursesApi } from "../../clients"
 
 const coursesKeys = {

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

@@ -1,18 +1,18 @@
 import { enrollmentQueries, enrollmentKeys } from "./queries"
 import { useMutation, useQueryClient } from "@tanstack/react-query"
-import { b2bApi, enrollmentsApi } from "../../clients"
+import { b2bApi, courseRunEnrollmentsApi } from "../../clients"
 import {
   B2bApiB2bEnrollCreateRequest,
   EnrollmentsApiEnrollmentsPartialUpdateRequest,
-} from "@mitodl/mitxonline-api-axios/v1"
+} from "@mitodl/mitxonline-api-axios/v2"
 
 const useCreateEnrollment = (opts: B2bApiB2bEnrollCreateRequest) => {
   const queryClient = useQueryClient()
   return useMutation({
     mutationFn: () => b2bApi.b2bEnrollCreate(opts),
     onSuccess: () => {
       queryClient.invalidateQueries({
-        queryKey: enrollmentKeys.enrollmentsList(),
+        queryKey: enrollmentKeys.courseRunEnrollmentsList(),
       })
     },
   })
@@ -23,10 +23,10 @@ const useUpdateEnrollment = (
 ) => {
   const queryClient = useQueryClient()
   return useMutation({
-    mutationFn: () => enrollmentsApi.enrollmentsPartialUpdate(opts),
+    mutationFn: () => courseRunEnrollmentsApi.enrollmentsPartialUpdate(opts),
     onSuccess: () => {
       queryClient.invalidateQueries({
-        queryKey: enrollmentKeys.enrollmentsList(),
+        queryKey: enrollmentKeys.courseRunEnrollmentsList(),
       })
     },
   })
@@ -35,10 +35,11 @@ const useUpdateEnrollment = (
 const useDestroyEnrollment = (enrollmentId: number) => {
   const queryClient = useQueryClient()
   return useMutation({
-    mutationFn: () => enrollmentsApi.enrollmentsDestroy({ id: enrollmentId }),
+    mutationFn: () =>
+      courseRunEnrollmentsApi.enrollmentsDestroy({ id: enrollmentId }),
     onSuccess: () => {
       queryClient.invalidateQueries({
-        queryKey: enrollmentKeys.enrollmentsList(),
+        queryKey: enrollmentKeys.courseRunEnrollmentsList(),
       })
     },
   })

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

@@ -1,19 +1,28 @@
 import { queryOptions } from "@tanstack/react-query"
-import type { CourseRunEnrollment } from "@mitodl/mitxonline-api-axios/v1"
+import type { CourseRunEnrollment } from "@mitodl/mitxonline-api-axios/v2"
 
-import { enrollmentsApi } from "../../clients"
+import { courseRunEnrollmentsApi } from "../../clients"
 
 const enrollmentKeys = {
   root: ["mitxonline", "enrollments"],
-  enrollmentsList: () => [...enrollmentKeys.root, "programEnrollments", "list"],
+  courseRunEnrollmentsList: () => [
+    ...enrollmentKeys.root,
+    "courseRunEnrollments",
+    "list",
+  ],
+  programEnrollmentsList: () => [
+    ...enrollmentKeys.root,
+    "programEnrollments",
+    "list",
+  ],
 }
 
 const enrollmentQueries = {
-  enrollmentsList: () =>
+  courseRunEnrollmentsList: () =>
     queryOptions({
-      queryKey: enrollmentKeys.enrollmentsList(),
+      queryKey: enrollmentKeys.courseRunEnrollmentsList(),
       queryFn: async (): Promise<CourseRunEnrollment[]> => {
-        return enrollmentsApi.enrollmentsList().then((res) => res.data)
+        return courseRunEnrollmentsApi.enrollmentsList().then((res) => res.data)
       },
     }),
 }

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

@@ -1,5 +1,5 @@
 import { B2bApiB2bOrganizationsRetrieveRequest } from "@mitodl/mitxonline-api-axios/v0"
-import { OrganizationPage } from "@mitodl/mitxonline-api-axios/v1"
+import { OrganizationPage } from "@mitodl/mitxonline-api-axios/v2"
 import { queryOptions } from "@tanstack/react-query"
 import { b2bApi } from "../../clients"
 

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

@@ -6,7 +6,7 @@ import type {
   ProgramsApiProgramsListV2Request,
   ProgramsApiProgramsRetrieveV2Request,
   V2Program,
-} from "@mitodl/mitxonline-api-axios/v1"
+} from "@mitodl/mitxonline-api-axios/v2"
 import { programCollectionsApi, programsApi } from "../../clients"
 
 const programsKeys = {

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

@@ -1,6 +1,6 @@
 import { useQuery } from "@tanstack/react-query"
 import { usersApi } from "../../clients"
-import type { User } from "@mitodl/mitxonline-api-axios/v1"
+import type { User } from "@mitodl/mitxonline-api-axios/v2"
 
 const useMitxOnlineCurrentUser = (opts: { enabled?: boolean } = {}) =>
   useQuery({

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

@@ -1,6 +1,6 @@
 import { mergeOverrides, makePaginatedFactory } from "ol-test-utilities"
 import type { PartialFactory } from "ol-test-utilities"
-import type { V2CourseWithCourseRuns } from "@mitodl/mitxonline-api-axios/v1"
+import type { V2CourseWithCourseRuns } from "@mitodl/mitxonline-api-axios/v2"
 import { faker } from "@faker-js/faker/locale/en"
 import { UniqueEnforcer } from "enforce-unique"
 

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

@@ -4,7 +4,7 @@ import type { PartialFactory } from "ol-test-utilities"
 import type {
   CourseRunEnrollment,
   CourseRunGrade,
-} from "@mitodl/mitxonline-api-axios/v1"
+} from "@mitodl/mitxonline-api-axios/v2"
 import { UniqueEnforcer } from "enforce-unique"
 
 const uniqueEnrollmentId = new UniqueEnforcer()
@@ -34,7 +34,10 @@ const courseEnrollment: PartialFactory<CourseRunEnrollment> = (
 
   const defaults: CourseRunEnrollment = {
     id: uniqueEnrollmentId.enforce(() => faker.number.int()),
-    certificate: null,
+    certificate: {
+      uuid: faker.string.uuid(),
+      link: faker.internet.url(),
+    },
     approved_flexible_price_exists: faker.datatype.boolean(),
     grades: [],
     enrollment_mode: faker.helpers.arrayElement(["audit", "verified"]),

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

@@ -1,5 +1,5 @@
 import { faker } from "@faker-js/faker/locale/en"
-import { OrganizationPage } from "@mitodl/mitxonline-api-axios/v1"
+import { OrganizationPage } from "@mitodl/mitxonline-api-axios/v2"
 import { mergeOverrides } from "ol-test-utilities"
 
 const organization = (

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

@@ -3,7 +3,7 @@ import type { PartialFactory } from "ol-test-utilities"
 import type {
   V2Program,
   V2ProgramCollection,
-} from "@mitodl/mitxonline-api-axios/v1"
+} from "@mitodl/mitxonline-api-axios/v2"
 import { faker } from "@faker-js/faker/locale/en"
 import { UniqueEnforcer } from "enforce-unique"