fix(grades/attachments): add internal genre to URL builder

examples/grades-overview.ts

@@ -1,10 +1,10 @@
 import { authenticatePronoteCredentials, PronoteApiAccountId, PronoteApiGradeType } from "../src";
 
 (async () => {
-  const pronote = await authenticatePronoteCredentials("https://demo.index-education.net/pronote", {
+  const pronote = await authenticatePronoteCredentials("https://pronote-vm.dev/pronote", {
     accountTypeID: PronoteApiAccountId.Eleve,
-    username: "demonstration",
-    password: "pronotevs",
+    username: "lisa.boulanger", // using my VM credentials here because the demo instance doesn't have any messages.
+    password: "12345678",
 
     // Because this is just an example, don't forget to change this.
     deviceUUID: "my-device-uuid"
@@ -45,7 +45,7 @@ import { authenticatePronoteCredentials, PronoteApiAccountId, PronoteApiGradeTyp
 
   gradesOverview.grades.forEach((grade) => {
     console.log(grade.subject.name, ":", grade.comment || "(no description)");
-    console.log("Registered the", grade.date.toLocaleString(), "//", grade.period.name);
+    console.log("Registered the", grade.date.toLocaleString(), "//", period.name);
 
     // If there
     if (typeof grade.outOf === "number") {
@@ -60,6 +60,8 @@ import { authenticatePronoteCredentials, PronoteApiAccountId, PronoteApiGradeTyp
       console.log("Average:", handleGradeValue(grade.average, grade.outOf, grade.coefficient));
       console.log("Minimum:", handleGradeValue(grade.min, grade.outOf, grade.coefficient));
       console.log("Maximum:", handleGradeValue(grade.max, grade.outOf, grade.coefficient));
+      if (grade.subjectFile) console.log("Subject:", grade.subjectFile.name, "=>", grade.subjectFile.url);
+      if (grade.correctionFile) console.log("Correction:", grade.correctionFile.name, "=>", grade.correctionFile.url);
     }
     else {
       console.log("Grade doesn't have a valid 'outOf', shouldn't be counted.");

src/constants/grades.ts

@@ -0,0 +1,10 @@
+/**
+ * Required when building an URL to download a file
+ * attached to a grade.
+ *
+ * @remark Shouldn't be exported as it's only used internally.
+ */
+export enum PronoteApiGradeAttachmentType {
+  CorrectionFile = "DevoirCorrige",
+  SubjectFile = "DevoirSujet"
+}

src/parser/attachment.ts

@@ -10,7 +10,8 @@ export class StudentAttachment {
 
   constructor (
     client: Pronote,
-    attachment: PronoteApiAttachment
+    attachment: PronoteApiAttachment,
+    additionalParameters = {}
   ) {
     this.name = attachment.L ?? "";
     this.type = attachment.G;
@@ -25,7 +26,9 @@ export class StudentAttachment {
       // Some magical stuff Pronote requires.
       const data = JSON.stringify({
         N: this.id,
-        Actif: true
+        Actif: true,
+        // In some cases classes, this is required.
+        ...additionalParameters
       });
 
       // Encrypt that magical stuff to add it in the URL.

src/parser/grade.ts

@@ -3,8 +3,9 @@ import type Pronote from "~/client/Pronote";
 import { StudentSubject } from "~/parser/subject";
 import { type PronoteApiGradeType, readPronoteApiGrade } from "~/pronote/grades";
 import { readPronoteApiDate } from "~/pronote/dates";
-import { StudentAttachment } from "./attachment";
-import { PronoteApiAttachmentType } from "..";
+import { StudentAttachment } from "~/parser//attachment";
+import { PronoteApiAttachmentType } from "~/constants/attachments";
+import { PronoteApiGradeAttachmentType } from "~/constants/grades";
 
 export class StudentGrade {
   readonly #id: string;
@@ -46,6 +47,8 @@ export class StudentGrade {
         G: PronoteApiAttachmentType.File,
         L: grade.libelleCorrige,
         N: this.#id
+      }, { // Additional genre.
+        G: PronoteApiGradeAttachmentType.CorrectionFile
       });
     }
 
@@ -54,6 +57,8 @@ export class StudentGrade {
         G: PronoteApiAttachmentType.File,
         L: grade.libelleSujet,
         N: this.#id
+      }, { // Additional genre.
+        G: PronoteApiGradeAttachmentType.SubjectFile
       });
     }
   }