dataUtils.js

/**
 * Calculates the completion status based on completion percentage
 * @param {number} completion - Completion percentage (0-1)
 * @returns {Object} Object containing status and percent
 */
export const calculateCompletionStatus = (completion) => {
  const percent = completion || 0;
  let status = 'In progress';
  if (percent <= 0.0) {
    status = 'Not started';
  } else if (percent >= 1.0) {
    status = 'Completed';
  }
  return { status, percent };
};

/**
 * Adds completion status to a course
 * @param {Object} course - Course object
 * @param {Object} completionsMap - Map of course IDs to completion data
 * @param {string} courseId - Course ID
 * @returns {Object} Course object with completion status
 */
export const addCompletionStatus = (course, completionsMap, courseId) => {
  const completionData = completionsMap[courseId];
  const completion = completionData?.completion?.percent || 0;
  const { status, percent } = calculateCompletionStatus(completion);
  const optionalPossible = completionData?.optionalCompletion?.possible ?? 0;
  const optionalEarned = completionData?.optionalCompletion?.earned ?? 0;
  const hasOptionalCompletion = optionalPossible > 0;
  const hasUnearnedOptionalCompletion = optionalPossible > optionalEarned;
  return {
    ...course,
    status,
    percent,
    hasOptionalCompletion,
    hasUnearnedOptionalCompletion,
  };
};

/**
 * Creates a completions map from completions data
 * @param {Array} completions - Array of completion data
 * @returns {Object} Map of item keys to completion data
 */
export const createCompletionsMap = (completions) => {
  const completionsMap = {};
  completions?.forEach?.(item => {
    completionsMap[item.courseKey] = {
      completion: item.completion,
      optionalCompletion: item.optionalCompletion,
    };
  });
  return completionsMap;
};

/**
 * Creates a map of course keys to learning path data
 * @param {Array} learningPaths - Array of learning path data
 * @returns {Object} Map of course keys to an array of learning path objects with name and key
 */
export const createCourseToLearningPathsMap = (learningPaths) => {
  const courseToLearningPathsMap = {};

  if (!learningPaths || !Array.isArray(learningPaths)) {
    return courseToLearningPathsMap;
  }

  learningPaths.forEach(path => {
    if (path.steps && Array.isArray(path.steps)) {
      path.steps.forEach(step => {
        if (!courseToLearningPathsMap[step.courseKey]) {
          courseToLearningPathsMap[step.courseKey] = [];
        }

        courseToLearningPathsMap[step.courseKey].push({
          name: path.displayName,
          key: path.key,
        });
      });
    }
  });

  return courseToLearningPathsMap;
};

/**
 * Adds learning path data to a course
 * @param {Object} course - Course object
 * @param {Object} courseToLearningPathMap - Map of course keys to an array of learning path objects with name and key
 * @returns {Object} Course object with learning path data
 */
export const addLearningPaths = (course, courseToLearningPathMap) => ({
  ...course,
  learningPaths: courseToLearningPathMap[course.id],
});