feat(client): add homepage and partner URL constants and wrappers

src/client/Pronote.ts

@@ -56,6 +56,9 @@ import { PronoteApiResourceType } from "~/constants/resources";
 import { callApiUserCreateDiscussion } from "~/api/user/createDiscussion";
 import { callApiUserCreateDiscussionMessage } from "~/api/user/createDiscussionMessage";
 import { getPronoteMessageButtonType } from "~/pronote/messages";
+import { callApiUserHomepage } from "~/api/user/homepage";
+import { Partner } from "~/parser/partner";
+import { callApiUserPartnerURL } from "~/api/user/partnerURL";
 
 export default class Pronote {
   /**
@@ -95,6 +98,8 @@ export default class Pronote {
    */
   public nextTimeToken: string;
 
+  public nextOpenDate: Date;
+
   /**
    * Root URL of the Pronote instance.
    */
@@ -158,6 +163,7 @@ export default class Pronote {
 
     this.username = credentials.username;
     this.nextTimeToken = credentials.token;
+    this.nextOpenDate = readPronoteApiDate(loginInformations.donnees.General.JourOuvre.V);
     this.pronoteRootURL = session.instance.pronote_url;
     this.accountTypeID = session.instance.account_type_id;
     this.sessionID = session.instance.session_id;
@@ -696,4 +702,35 @@ export default class Pronote {
       });
     });
   }
+
+  public async getHomePage (nextOpenDate = this.nextOpenDate) {
+    return this.queue.push(async () => {
+      const response = await callApiUserHomepage(this.fetcher, {
+        session: this.session,
+        nextDateOpened: nextOpenDate,
+        weekNumber: translateToPronoteWeekNumber(nextOpenDate, this.firstMonday)
+      });
+
+      const ardSSO = response.data.donnees.partenaireARD?.SSO;
+
+      return {
+        ard: ardSSO ? new Partner(this, ardSSO) : null
+      };
+    });
+  }
+
+  public async getPartnerURL (partner: Partner): Promise<string> {
+    return this.queue.push(async () => {
+      const response = await callApiUserPartnerURL(this.fetcher, {
+        session: this.session,
+        sso: {
+          code: partner.code,
+          linkLabel: partner.linkLabel,
+          description: partner.description
+        }
+      });
+
+      return response.url;
+    });
+  }
 }

src/constants/functions.ts

@@ -19,5 +19,7 @@ export enum PronoteApiFunctions {
   MessageRecipients = "SaisiePublicMessage",
   PatchNews = "SaisieActualites",
   CreateDiscussionRecipients = "ListeRessourcesPourCommunication",
-  CreateMessage = "SaisieMessage"
+  CreateMessage = "SaisieMessage",
+  HomePage = "PageAccueil",
+  PartnerURL = "SaisieURLPartenaire"
 }

src/constants/partner.ts

@@ -0,0 +1,5 @@
+export interface PronoteSSO {
+  codePartenaire: string
+  intituleLien: string
+  description: string
+}

src/parser/partner.ts

@@ -0,0 +1,32 @@
+import { PronoteSSO } from "~/constants/partner";
+import Pronote from "~/client/Pronote";
+
+export class Partner {
+  readonly #client: Pronote;
+  readonly #code: string;
+  readonly #description: string;
+  readonly #linkLabel: string;
+
+  public constructor (client: Pronote, sso: PronoteSSO) {
+    this.#client = client;
+    this.#code = sso.codePartenaire;
+    this.#description = sso.description;
+    this.#linkLabel = sso.intituleLien;
+  }
+
+  public async fetchURL (): Promise<string> {
+    return this.#client.getPartnerURL(this);
+  }
+
+  public get code (): string {
+    return this.#code;
+  }
+
+  public get description (): string {
+    return this.#description;
+  }
+
+  public get linkLabel (): string {
+    return this.#linkLabel;
+  }
+}