chore: import upstream snapshot with attribution

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

@@ -0,0 +1,48 @@
+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);
+}