@openedx/frontend-app-instructor-dashboard 1.0.0-alpha.3 → 1.0.0-alpha.31

package/dist/certificates/data/api.js

@@ -0,0 +1,115 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { camelCaseObject, getAuthenticatedHttpClient } from '@openedx/frontend-base';
+import { getApiBaseUrl } from '../../data/api';
+export const getIssuedCertificates = (courseId, params) => __awaiter(void 0, void 0, void 0, function* () {
+    const { data } = yield getAuthenticatedHttpClient().get(`${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/issued`, {
+        params: {
+            page: params.page + 1,
+            page_size: params.pageSize,
+            filter: params.filter,
+            search: params.search,
+        },
+    });
+    return camelCaseObject(data);
+});
+export const getInstructorTasks = (courseId, params) => __awaiter(void 0, void 0, void 0, function* () {
+    const { data } = yield getAuthenticatedHttpClient().get(`${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/instructor_tasks`, {
+        params: {
+            page: params.page + 1,
+            page_size: params.pageSize,
+        },
+    });
+    return camelCaseObject(data);
+});
+export const grantBulkExceptions = (courseId, request) => __awaiter(void 0, void 0, void 0, function* () {
+    const { data } = yield getAuthenticatedHttpClient().post(`${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/exceptions`, {
+        learners: request.learners,
+        notes: request.notes,
+    });
+    return camelCaseObject(data);
+});
+export const invalidateCertificate = (courseId, request) => __awaiter(void 0, void 0, void 0, function* () {
+    const { data } = yield getAuthenticatedHttpClient().post(`${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/invalidations`, {
+        learners: request.learners,
+        notes: request.notes,
+    });
+    return camelCaseObject(data);
+});
+export const removeException = (courseId, request) => __awaiter(void 0, void 0, void 0, function* () {
+    yield getAuthenticatedHttpClient().delete(`${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/exceptions`, {
+        data: {
+            username: request.username,
+        },
+    });
+});
+export const removeInvalidation = (courseId, request) => __awaiter(void 0, void 0, void 0, function* () {
+    const httpClient = getAuthenticatedHttpClient();
+    const url = `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/invalidations`;
+    const payload = {
+        username: request.username,
+    };
+    yield httpClient.delete(url, {
+        data: payload,
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    });
+});
+export const toggleCertificateGeneration = (courseId, enable) => __awaiter(void 0, void 0, void 0, function* () {
+    yield getAuthenticatedHttpClient().post(`${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/toggle_generation`, {
+        enabled: enable,
+    });
+});
+export const regenerateCertificates = (courseId, filter) => __awaiter(void 0, void 0, void 0, function* () {
+    const body = {};
+    // Map filter to backend parameters (must match backend filter logic)
+    switch (filter) {
+        case 'all':
+            body.student_set = 'all';
+            break;
+        case 'received':
+            body.statuses = ['downloadable'];
+            break;
+        case 'not_received':
+            // Match backend filter: notpassing or unavailable
+            body.statuses = ['notpassing', 'unavailable'];
+            break;
+        case 'audit_passing':
+            body.statuses = ['audit_passing'];
+            break;
+        case 'audit_not_passing':
+            body.statuses = ['audit_notpassing'];
+            break;
+        case 'error':
+            body.statuses = ['error'];
+            break;
+        case 'granted_exceptions':
+            body.student_set = 'allowlisted';
+            break;
+        case 'invalidated':
+            // Invalidated certificates have unavailable status
+            body.statuses = ['unavailable'];
+            break;
+        default:
+            body.student_set = 'all';
+    }
+    yield getAuthenticatedHttpClient().post(`${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/regenerate`, body);
+});
+export const getCertificateGenerationHistory = (courseId, params) => __awaiter(void 0, void 0, void 0, function* () {
+    const { data } = yield getAuthenticatedHttpClient().get(`${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/generation_history`, {
+        params: {
+            page: params.page + 1,
+            page_size: params.pageSize,
+        },
+    });
+    return camelCaseObject(data);
+});
+//# sourceMappingURL=api.js.map

package/dist/certificates/data/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/certificates/data/api.ts"],"names":[],"mappings":"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","sourcesContent":["import { camelCaseObject, getAuthenticatedHttpClient } from '@openedx/frontend-base';\nimport { getApiBaseUrl } from '@src/data/api';\nimport type { DataList, PaginationParams } from '@src/types';\nimport type {\n  CertificateData,\n  CertificateGenerationHistory,\n  CertificateQueryParams,\n  GrantExceptionRequest,\n  InstructorTask,\n  InvalidateCertificateRequest,\n  RemoveExceptionRequest,\n  RemoveInvalidationRequest,\n} from '@src/certificates/types';\n\nexport const getIssuedCertificates = async (\n  courseId: string,\n  params: CertificateQueryParams,\n): Promise<DataList<CertificateData>> => {\n  const { data } = await getAuthenticatedHttpClient().get(\n    `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/issued`,\n    {\n      params: {\n        page: params.page + 1,\n        page_size: params.pageSize,\n        filter: params.filter,\n        search: params.search,\n      },\n    },\n  );\n  return camelCaseObject(data);\n};\n\nexport const getInstructorTasks = async (\n  courseId: string,\n  params: PaginationParams,\n): Promise<DataList<InstructorTask>> => {\n  const { data } = await getAuthenticatedHttpClient().get(\n    `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/instructor_tasks`,\n    {\n      params: {\n        page: params.page + 1,\n        page_size: params.pageSize,\n      },\n    },\n  );\n  return camelCaseObject(data);\n};\n\nexport const grantBulkExceptions = async (\n  courseId: string,\n  request: GrantExceptionRequest,\n): Promise<{ success: string[], errors: { learner: string, message: string }[] }> => {\n  const { data } = await getAuthenticatedHttpClient().post(\n    `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/exceptions`,\n    {\n      learners: request.learners,\n      notes: request.notes,\n    },\n  );\n  return camelCaseObject(data);\n};\n\nexport const invalidateCertificate = async (\n  courseId: string,\n  request: InvalidateCertificateRequest,\n): Promise<{ success: string[], errors: { learner: string, message: string }[] }> => {\n  const { data } = await getAuthenticatedHttpClient().post(\n    `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/invalidations`,\n    {\n      learners: request.learners,\n      notes: request.notes,\n    },\n  );\n  return camelCaseObject(data);\n};\n\nexport const removeException = async (\n  courseId: string,\n  request: RemoveExceptionRequest,\n): Promise<void> => {\n  await getAuthenticatedHttpClient().delete(\n    `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/exceptions`,\n    {\n      data: {\n        username: request.username,\n      },\n    },\n  );\n};\n\nexport const removeInvalidation = async (\n  courseId: string,\n  request: RemoveInvalidationRequest,\n): Promise<void> => {\n  const httpClient = getAuthenticatedHttpClient();\n  const url = `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/invalidations`;\n  const payload = {\n    username: request.username,\n  };\n\n  await httpClient.delete(url, {\n    data: payload,\n    headers: {\n      'Content-Type': 'application/json',\n    },\n  });\n};\n\nexport const toggleCertificateGeneration = async (\n  courseId: string,\n  enable: boolean,\n): Promise<void> => {\n  await getAuthenticatedHttpClient().post(\n    `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/toggle_generation`,\n    {\n      enabled: enable,\n    },\n  );\n};\n\nexport const regenerateCertificates = async (\n  courseId: string,\n  filter: string,\n): Promise<void> => {\n  const body: { statuses?: string[], student_set?: string } = {};\n\n  // Map filter to backend parameters (must match backend filter logic)\n  switch (filter) {\n    case 'all':\n      body.student_set = 'all';\n      break;\n    case 'received':\n      body.statuses = ['downloadable'];\n      break;\n    case 'not_received':\n      // Match backend filter: notpassing or unavailable\n      body.statuses = ['notpassing', 'unavailable'];\n      break;\n    case 'audit_passing':\n      body.statuses = ['audit_passing'];\n      break;\n    case 'audit_not_passing':\n      body.statuses = ['audit_notpassing'];\n      break;\n    case 'error':\n      body.statuses = ['error'];\n      break;\n    case 'granted_exceptions':\n      body.student_set = 'allowlisted';\n      break;\n    case 'invalidated':\n      // Invalidated certificates have unavailable status\n      body.statuses = ['unavailable'];\n      break;\n    default:\n      body.student_set = 'all';\n  }\n\n  await getAuthenticatedHttpClient().post(\n    `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/regenerate`,\n    body,\n  );\n};\n\nexport const getCertificateGenerationHistory = async (\n  courseId: string,\n  params: PaginationParams,\n): Promise<DataList<CertificateGenerationHistory>> => {\n  const { data } = await getAuthenticatedHttpClient().get(\n    `${getApiBaseUrl()}/api/instructor/v2/courses/${courseId}/certificates/generation_history`,\n    {\n      params: {\n        page: params.page + 1,\n        page_size: params.pageSize,\n      },\n    },\n  );\n  return camelCaseObject(data);\n};\n"]}

package/dist/certificates/data/apiHook.d.ts

@@ -0,0 +1,50 @@
+import type { PaginationParams } from '../../types';
+import type { CertificateQueryParams, GrantExceptionRequest, InvalidateCertificateRequest, RemoveExceptionRequest, RemoveInvalidationRequest } from '../../certificates/types';
+/**
+ * Hook to fetch issued certificates
+ */
+export declare const useIssuedCertificates: (courseId: string, params: CertificateQueryParams) => import("@tanstack/react-query").UseQueryResult<import("../../types").DataList<import("../../certificates/types").CertificateData>, Error>;
+/**
+ * Hook to fetch instructor tasks
+ */
+export declare const useInstructorTasks: (courseId: string, params: PaginationParams) => import("@tanstack/react-query").UseQueryResult<import("../../types").DataList<import("../../certificates/types").InstructorTask>, Error>;
+/**
+ * Hook to fetch certificate generation history
+ */
+export declare const useCertificateGenerationHistory: (courseId: string, params: PaginationParams) => import("@tanstack/react-query").UseQueryResult<import("../../types").DataList<import("../../certificates/types").CertificateGenerationHistory>, Error>;
+/**
+ * Hook to grant bulk certificate exceptions
+ */
+export declare const useGrantBulkExceptions: (courseId: string) => import("@tanstack/react-query").UseMutationResult<{
+    success: string[];
+    errors: {
+        learner: string;
+        message: string;
+    }[];
+}, Error, GrantExceptionRequest, unknown>;
+/**
+ * Hook to invalidate certificate
+ */
+export declare const useInvalidateCertificate: (courseId: string) => import("@tanstack/react-query").UseMutationResult<{
+    success: string[];
+    errors: {
+        learner: string;
+        message: string;
+    }[];
+}, Error, InvalidateCertificateRequest, unknown>;
+/**
+ * Hook to remove certificate exception
+ */
+export declare const useRemoveException: (courseId: string) => import("@tanstack/react-query").UseMutationResult<void, Error, RemoveExceptionRequest, unknown>;
+/**
+ * Hook to remove certificate invalidation
+ */
+export declare const useRemoveInvalidation: (courseId: string) => import("@tanstack/react-query").UseMutationResult<void, Error, RemoveInvalidationRequest, unknown>;
+/**
+ * Hook to toggle certificate generation
+ */
+export declare const useToggleCertificateGeneration: (courseId: string) => import("@tanstack/react-query").UseMutationResult<void, Error, boolean, unknown>;
+/**
+ * Hook to regenerate certificates
+ */
+export declare const useRegenerateCertificates: (courseId: string) => import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;

package/dist/certificates/data/apiHook.js

@@ -0,0 +1,118 @@
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { getCertificateGenerationHistory, getInstructorTasks, getIssuedCertificates, grantBulkExceptions, invalidateCertificate, regenerateCertificates, removeException, removeInvalidation, toggleCertificateGeneration, } from '../../certificates/data/api';
+import { certificatesQueryKeys } from '../../certificates/data/queryKeys';
+/**
+ * Hook to fetch issued certificates
+ */
+export const useIssuedCertificates = (courseId, params) => useQuery({
+    queryKey: certificatesQueryKeys.issued(courseId, params),
+    queryFn: () => getIssuedCertificates(courseId, params),
+    enabled: !!courseId,
+});
+/**
+ * Hook to fetch instructor tasks
+ */
+export const useInstructorTasks = (courseId, params) => useQuery({
+    queryKey: certificatesQueryKeys.tasks(courseId, params),
+    queryFn: () => getInstructorTasks(courseId, params),
+    enabled: !!courseId,
+});
+/**
+ * Hook to fetch certificate generation history
+ */
+export const useCertificateGenerationHistory = (courseId, params) => useQuery({
+    queryKey: certificatesQueryKeys.generationHistory(courseId, params),
+    queryFn: () => getCertificateGenerationHistory(courseId, params),
+    enabled: !!courseId,
+});
+/**
+ * Hook to grant bulk certificate exceptions
+ */
+export const useGrantBulkExceptions = (courseId) => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => grantBulkExceptions(courseId, request),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: certificatesQueryKeys.byCourse(courseId),
+                exact: false,
+            });
+        },
+    });
+};
+/**
+ * Hook to invalidate certificate
+ */
+export const useInvalidateCertificate = (courseId) => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => invalidateCertificate(courseId, request),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: certificatesQueryKeys.byCourse(courseId),
+                exact: false,
+            });
+        },
+    });
+};
+/**
+ * Hook to remove certificate exception
+ */
+export const useRemoveException = (courseId) => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => removeException(courseId, request),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: certificatesQueryKeys.byCourse(courseId),
+                exact: false,
+            });
+        },
+    });
+};
+/**
+ * Hook to remove certificate invalidation
+ */
+export const useRemoveInvalidation = (courseId) => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => removeInvalidation(courseId, request),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: certificatesQueryKeys.byCourse(courseId),
+                exact: false,
+            });
+        },
+    });
+};
+/**
+ * Hook to toggle certificate generation
+ */
+export const useToggleCertificateGeneration = (courseId) => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (enable) => toggleCertificateGeneration(courseId, enable),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: certificatesQueryKeys.byCourse(courseId),
+                exact: false,
+            });
+        },
+    });
+};
+/**
+ * Hook to regenerate certificates
+ */
+export const useRegenerateCertificates = (courseId) => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (filter) => regenerateCertificates(courseId, filter),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: certificatesQueryKeys.byCourse(courseId),
+                exact: false,
+            });
+        },
+    });
+};
+//# sourceMappingURL=apiHook.js.map

package/dist/certificates/data/apiHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiHook.js","sourceRoot":"","sources":["../../../src/certificates/data/apiHook.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\nimport type { PaginationParams } from '@src/types';\nimport type {\n  CertificateQueryParams,\n  GrantExceptionRequest,\n  InvalidateCertificateRequest,\n  RemoveExceptionRequest,\n  RemoveInvalidationRequest,\n} from '@src/certificates/types';\nimport {\n  getCertificateGenerationHistory,\n  getInstructorTasks,\n  getIssuedCertificates,\n  grantBulkExceptions,\n  invalidateCertificate,\n  regenerateCertificates,\n  removeException,\n  removeInvalidation,\n  toggleCertificateGeneration,\n} from '@src/certificates/data/api';\nimport { certificatesQueryKeys } from '@src/certificates/data/queryKeys';\n\n/**\n * Hook to fetch issued certificates\n */\nexport const useIssuedCertificates = (courseId: string, params: CertificateQueryParams) =>\n  useQuery({\n    queryKey: certificatesQueryKeys.issued(courseId, params),\n    queryFn: () => getIssuedCertificates(courseId, params),\n    enabled: !!courseId,\n  });\n\n/**\n * Hook to fetch instructor tasks\n */\nexport const useInstructorTasks = (courseId: string, params: PaginationParams) =>\n  useQuery({\n    queryKey: certificatesQueryKeys.tasks(courseId, params),\n    queryFn: () => getInstructorTasks(courseId, params),\n    enabled: !!courseId,\n  });\n\n/**\n * Hook to fetch certificate generation history\n */\nexport const useCertificateGenerationHistory = (courseId: string, params: PaginationParams) =>\n  useQuery({\n    queryKey: certificatesQueryKeys.generationHistory(courseId, params),\n    queryFn: () => getCertificateGenerationHistory(courseId, params),\n    enabled: !!courseId,\n  });\n\n/**\n * Hook to grant bulk certificate exceptions\n */\nexport const useGrantBulkExceptions = (courseId: string) => {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: (request: GrantExceptionRequest) => grantBulkExceptions(courseId, request),\n    onSuccess: () => {\n      queryClient.invalidateQueries({\n        queryKey: certificatesQueryKeys.byCourse(courseId),\n        exact: false,\n      });\n    },\n  });\n};\n\n/**\n * Hook to invalidate certificate\n */\nexport const useInvalidateCertificate = (courseId: string) => {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: (request: InvalidateCertificateRequest) => invalidateCertificate(courseId, request),\n    onSuccess: () => {\n      queryClient.invalidateQueries({\n        queryKey: certificatesQueryKeys.byCourse(courseId),\n        exact: false,\n      });\n    },\n  });\n};\n\n/**\n * Hook to remove certificate exception\n */\nexport const useRemoveException = (courseId: string) => {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: (request: RemoveExceptionRequest) => removeException(courseId, request),\n    onSuccess: () => {\n      queryClient.invalidateQueries({\n        queryKey: certificatesQueryKeys.byCourse(courseId),\n        exact: false,\n      });\n    },\n  });\n};\n\n/**\n * Hook to remove certificate invalidation\n */\nexport const useRemoveInvalidation = (courseId: string) => {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: (request: RemoveInvalidationRequest) => removeInvalidation(courseId, request),\n    onSuccess: () => {\n      queryClient.invalidateQueries({\n        queryKey: certificatesQueryKeys.byCourse(courseId),\n        exact: false,\n      });\n    },\n  });\n};\n\n/**\n * Hook to toggle certificate generation\n */\nexport const useToggleCertificateGeneration = (courseId: string) => {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: (enable: boolean) => toggleCertificateGeneration(courseId, enable),\n    onSuccess: () => {\n      queryClient.invalidateQueries({\n        queryKey: certificatesQueryKeys.byCourse(courseId),\n        exact: false,\n      });\n    },\n  });\n};\n\n/**\n * Hook to regenerate certificates\n */\nexport const useRegenerateCertificates = (courseId: string) => {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: (filter: string) => regenerateCertificates(courseId, filter),\n    onSuccess: () => {\n      queryClient.invalidateQueries({\n        queryKey: certificatesQueryKeys.byCourse(courseId),\n        exact: false,\n      });\n    },\n  });\n};\n"]}

package/dist/certificates/data/queryKeys.d.ts

@@ -0,0 +1,9 @@
+import type { PaginationParams } from '../../types';
+import type { CertificateQueryParams } from '../../certificates/types';
+export declare const certificatesQueryKeys: {
+    all: readonly ["org.openedx.frontend.app.instructorDashboard", "certificates"];
+    byCourse: (courseId: string) => readonly ["org.openedx.frontend.app.instructorDashboard", "certificates", string];
+    issued: (courseId: string, params: CertificateQueryParams) => readonly ["org.openedx.frontend.app.instructorDashboard", "certificates", string, "issued", CertificateQueryParams];
+    tasks: (courseId: string, params: PaginationParams) => readonly ["org.openedx.frontend.app.instructorDashboard", "certificates", string, "tasks", PaginationParams];
+    generationHistory: (courseId: string, params: PaginationParams) => readonly ["org.openedx.frontend.app.instructorDashboard", "certificates", string, "generationHistory", PaginationParams];
+};

package/dist/certificates/data/queryKeys.js

@@ -0,0 +1,9 @@
+import { appId } from '../../constants';
+export const certificatesQueryKeys = {
+    all: [appId, 'certificates'],
+    byCourse: (courseId) => [...certificatesQueryKeys.all, courseId],
+    issued: (courseId, params) => [...certificatesQueryKeys.byCourse(courseId), 'issued', params],
+    tasks: (courseId, params) => [...certificatesQueryKeys.byCourse(courseId), 'tasks', params],
+    generationHistory: (courseId, params) => [...certificatesQueryKeys.byCourse(courseId), 'generationHistory', params],
+};
+//# sourceMappingURL=queryKeys.js.map

package/dist/certificates/data/queryKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryKeys.js","sourceRoot":"","sources":["../../../src/certificates/data/queryKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,CAAC,KAAK,EAAE,cAAc,CAAU;IACrC,QAAQ,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC,GAAG,qBAAqB,CAAC,GAAG,EAAE,QAAQ,CAAU;IACjF,MAAM,EAAE,CAAC,QAAgB,EAAE,MAA8B,EAAE,EAAE,CAC3D,CAAC,GAAG,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAU;IAC1E,KAAK,EAAE,CAAC,QAAgB,EAAE,MAAwB,EAAE,EAAE,CACpD,CAAC,GAAG,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,CAAU;IACzE,iBAAiB,EAAE,CAAC,QAAgB,EAAE,MAAwB,EAAE,EAAE,CAChE,CAAC,GAAG,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAU;CACtF,CAAC","sourcesContent":["import { appId } from '@src/constants';\nimport type { PaginationParams } from '@src/types';\nimport type { CertificateQueryParams } from '@src/certificates/types';\n\nexport const certificatesQueryKeys = {\n  all: [appId, 'certificates'] as const,\n  byCourse: (courseId: string) => [...certificatesQueryKeys.all, courseId] as const,\n  issued: (courseId: string, params: CertificateQueryParams) =>\n    [...certificatesQueryKeys.byCourse(courseId), 'issued', params] as const,\n  tasks: (courseId: string, params: PaginationParams) =>\n    [...certificatesQueryKeys.byCourse(courseId), 'tasks', params] as const,\n  generationHistory: (courseId: string, params: PaginationParams) =>\n    [...certificatesQueryKeys.byCourse(courseId), 'generationHistory', params] as const,\n};\n"]}