feat: bring assement weighting to engage

src/plugins/built-in/assessmentsAverage/engage.ts

@@ -0,0 +1,55 @@
+const ENGAGE_STUDENT_STORAGE_KEY = () =>
+  `bsplus.engageTimetable.student.${location.origin}`;
+
+/** Engage assessments URLs: /#?page=/assessments/{studentId}/{programme}:{metaclass}:{studentId} */
+export function getEngageAssessmentStudentId(): string | null {
+  const hashMatch = window.location.hash.match(/\/assessments\/(\d+)/);
+  if (hashMatch?.[1]) return hashMatch[1];
+
+  return localStorage.getItem(ENGAGE_STUDENT_STORAGE_KEY());
+}
+
+function randomEngagePdfFileName(): string {
+  const token = Math.random().toString(36).slice(2, 10);
+  return `${token}.pdf`;
+}
+
+export async function requestEngageAssessmentPdf(params: {
+  assessmentID: string | number;
+  metaclassID: string | number;
+  studentID: string | number;
+}): Promise<string> {
+  const fileName = randomEngagePdfFileName();
+  const cacheBuster = Math.random().toString(36).slice(2, 10);
+
+  const response = await fetch(
+    `${location.origin}/seqta/parent/print/assessment?${cacheBuster}`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json; charset=utf-8" },
+      credentials: "include",
+      body: JSON.stringify({
+        id: params.assessmentID,
+        metaclass: params.metaclassID,
+        student: Number(params.studentID),
+        fileName,
+      }),
+    },
+  );
+
+  if (!response.ok) {
+    throw new Error(
+      `Failed to generate PDF: ${response.status} ${response.statusText}`,
+    );
+  }
+
+  const data = (await response.json()) as {
+    payload?: { file?: string };
+  };
+
+  return data.payload?.file ?? fileName;
+}
+
+export function getEngageAssessmentReportUrl(fileName: string): string {
+  return `${location.origin}/seqta/parent/report/get?file=${encodeURIComponent(fileName)}`;
+}