freecodecamp--freecodecamp/api/src/routes/helpers/certificate-utils.ts

import { Prisma } from '@prisma/client';
import {
  certSlugTypeMap,
  certToIdMap,
  Certification
} from '@freecodecamp/shared/config/certification-settings';
import { normalizeDate } from '../../utils/normalize.js';

const fullStackCertificateIds = [
  certToIdMap[Certification.RespWebDesign],
  certToIdMap[Certification.JsAlgoDataStruct],
  certToIdMap[Certification.FrontEndDevLibs],
  certToIdMap[Certification.DataVis],
  certToIdMap[Certification.BackEndDevApis],
  certToIdMap[Certification.LegacyInfoSecQa]
];

/**
 * Checks if the given certification slug is known.
 *
 * @param certSlug - The certification slug to check.
 * @returns True if the certification slug is known, otherwise false.
 */
export function isKnownCertSlug(certSlug: string): certSlug is Certification {
  return certSlug in certSlugTypeMap;
}

/**
 * Retrieves the completion date for the full stack certification, if it exists.
 *
 * @param completedChallenges - The array of completed challenges.
 * @param completedDate - The fallback completed date.
 * @returns The latest certification date or the completed date if no certification is found.
 */
export function getFallbackFullStackDate(
  completedChallenges: { id: string; completedDate: Prisma.JsonValue }[],
  completedDate: Prisma.JsonValue
): number {
  const latestCertDate = completedChallenges
    .filter(chal => fullStackCertificateIds.includes(chal.id))
    .map(chal => ({
      ...chal,
      completedDate: normalizeDate(chal.completedDate)
    }))
    .sort((a, b) => b.completedDate - a.completedDate)[0]?.completedDate;

  return latestCertDate ?? normalizeDate(completedDate);
}