@communecter/cocolight-api-client 1.0.115 → 1.0.117

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.115",
+    "version": "1.0.117",
     "description": "Client Axios simplifié pour l'API cocolight",
     "repository": {
         "type": "git",

package/src/api/BaseEntity.ts

@@ -250,6 +250,7 @@ interface MinimalUserLink {
   isInviting?: boolean;
   isAdminInviting?: boolean;
   isAdminPending?: boolean;
+  isAdmin?: boolean;
 }
 
 // Types pour linkEntitiesFromServerData
@@ -2557,15 +2558,11 @@ export class BaseEntity<TServerData = any> {
     // Cas : aucun lien → on demande à se connecter
     if (!userLink) {
 
-      const t = this.getEntityType();
-
       // 1) Garde runtime pour exclure les types non pris en charge par ConnectData
-      if (t === "poi" || t === "badges" || t === "news") {
-        throw new ApiError(`Le type d'entité "${t}" ne supporte pas cette connexion.`, 400);
-      }
+      this._assertNotEntityType("connect", ["poi", "badges", "news"]);
 
       // 2) Narrow de type pour TypeScript
-      const parentType = t as ConnectData["parentType"];
+      const parentType = this.getEntityType() as ConnectData["parentType"];
 
       const data: ConnectData = {
         childId: this.userId,
@@ -2617,15 +2614,11 @@ export class BaseEntity<TServerData = any> {
     // Aucun lien existant → envoie une demande avec rôle "admin"
     if (!userLink) {
 
-      const t = this.getEntityType();
-
       // 1) Garde runtime pour exclure les types non pris en charge par ConnectData
-      if (t === "poi" || t === "badges" || t === "news") {
-        throw new ApiError(`Le type d'entité "${t}" ne supporte pas cette connexion.`, 400);
-      }
+      this._assertNotEntityType("connect", ["poi", "badges", "news"]);
 
       // 2) Narrow de type pour TypeScript
-      const parentType = t as ConnectData["parentType"];
+      const parentType = this.getEntityType() as ConnectData["parentType"];
 
       const data: ConnectData = {
         childId: this.userId,
@@ -2680,15 +2673,11 @@ export class BaseEntity<TServerData = any> {
     const userLink = this._getLinkFromConnectedUser();
 
     if (userLink && (userLink.isInviting || userLink.isAdminInviting)) {
-      const t = this.getEntityType();
-
       // 1) Garde runtime pour exclure les types non pris en charge par LinkValidateData
-      if (t === "poi" || t === "badges" || t === "news") {
-        throw new ApiError(`Le type d'entité "${t}" ne supporte pas cette connexion.`, 400);
-      }
+      this._assertNotEntityType("linkValidate", ["poi", "badges", "news"]);
 
       // 2) Narrow de type pour TypeScript
-      const parentType = t as LinkValidateData["parentType"];
+      const parentType = this.getEntityType() as LinkValidateData["parentType"];
 
       const data: LinkValidateData = {
         childId: this.userId,
@@ -2731,15 +2720,11 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError("Vous n'êtes pas connecté à cette entité.", 404);
     }
 
-    const t = this.getEntityType();
-
     // 1) Garde runtime pour exclure les types non pris en charge par DisconnectData
-    if (t === "poi" || t === "badges" || t === "news") {
-      throw new ApiError(`Le type d'entité "${t}" ne supporte pas cette connexion.`, 400);
-    }
+    this._assertNotEntityType("disconnect", ["poi", "badges", "news"]);
 
     // 2) Narrow de type pour TypeScript
-    const parentType = t as DisconnectData["parentType"];
+    const parentType = this.getEntityType() as DisconnectData["parentType"];
 
     const data: DisconnectData = {
       childId: this.userId,
@@ -2791,11 +2776,8 @@ export class BaseEntity<TServerData = any> {
     }
 
     // Réduit le type de l'entité aux seuls autorisés par UpdateSettingsData
-    const t = this.getEntityType();
-    if (t === "poi" || t === "badges" || t === "news") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_SETTINGS.`, 400);
-    }
-    const typeEntity = t as UpdateSettingsData["typeEntity"];
+    this._assertNotEntityType("updateSettings", ["poi", "badges", "news"]);
+    const typeEntity = this.getEntityType() as UpdateSettingsData["typeEntity"];
 
     // Garde runtime pour s'assurer que 'type' et 'value' sont bien fournis
     const { type, value } = data;
@@ -2829,11 +2811,8 @@ export class BaseEntity<TServerData = any> {
     }
 
     // Réduit le type de l'entité aux seuls autorisés par UpdateBlockDescriptionData
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_DESCRIPTION.`, 400);
-    }
-    const typeElement = t as UpdateBlockDescriptionData["typeElement"];
+    this._assertNotEntityType("updateDescription", ["badges", "news"]);
+    const typeElement = this.getEntityType() as UpdateBlockDescriptionData["typeElement"];
 
     const payload: UpdateBlockDescriptionData = {
       block: "descriptions",
@@ -2860,12 +2839,9 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    // Réduit le type de l'entité aux seuls autorisés par UpdateBlockDescriptionData
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_INFO.`, 400);
-    }
-    const typeElement = t as UpdateBlockInfoData["typeElement"];
+    // Réduit le type de l'entité aux seuls autorisés par UpdateBlockInfoData
+    this._assertNotEntityType("updateInfo", ["badges", "news"]);
+    const typeElement = this.getEntityType() as UpdateBlockInfoData["typeElement"];
 
     const payload: UpdateBlockInfoData = {
       block: "info",
@@ -2890,12 +2866,9 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    // Réduit le type de l'entité aux seuls autorisés par UpdateBlockDescriptionData
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "poi" || t === "events") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_INFO.`, 400);
-    }
-    const typeElement = t as UpdateBlockSocialData["typeElement"];
+    // Réduit le type de l'entité aux seuls autorisés par UpdateBlockSocialData
+    this._assertNotEntityType("updateSocial", ["badges", "news", "poi", "events"]);
+    const typeElement = this.getEntityType() as UpdateBlockSocialData["typeElement"];
 
     const payload: UpdateBlockSocialData = {
       block: "network",
@@ -2960,10 +2933,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     // Réduit le type de l'entité aux seuls autorisés par UpdateBlockLocalityData
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "comments" || t === "answers") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
-    }
+    this._assertNotEntityType("updateLocality", ["badges", "news", "comments", "answers"]);
 
     // Garde runtime pour s'assurer que 'address' est bien fourni
     if (!("address" in data)) {
@@ -2979,7 +2949,7 @@ export class BaseEntity<TServerData = any> {
     const addr: UpdateBlockLocalityData["address"] = addrUnknown;
 
 
-    const typeElement: UpdateBlockLocalityData["typeElement"] = t;
+    const typeElement = this.getEntityType() as UpdateBlockLocalityData["typeElement"];
 
     const payload: UpdateBlockLocalityData = {
       block: "localities" as const,
@@ -3007,12 +2977,9 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "poi" || t === "comments") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
-    }
+    this._assertNotEntityType("updateSlug", ["badges", "news", "poi", "comments"]);
 
-    const type = t as CheckData["type"];
+    const type = this.getEntityType() as CheckData["type"];
 
     try {
       await this.endpointApi.check({ block: "info", type, id: this.id, slug });
@@ -3041,12 +3008,9 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "comments" || t === "answers") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
-    }
+    this._assertNotEntityType("updateImageProfil", ["badges", "news", "comments", "answers"]);
 
-    const folder: NonNullable<ProfilImageData["pathParams"]>["folder"] = t;
+    const folder = this.getEntityType() as NonNullable<ProfilImageData["pathParams"]>["folder"];
 
     image = await this._validateImage(image);
 
@@ -3071,12 +3035,9 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "comments" || t === "answers") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
-    }
+    this._assertNotEntityType("updateImageBanner", ["badges", "news", "comments", "answers"]);
 
-    const folder: NonNullable<ProfilBannerData["pathParams"]>["folder"] = t;
+    const folder = this.getEntityType() as NonNullable<ProfilBannerData["pathParams"]>["folder"];
 
     image = await this._validateImage(image);
 
@@ -3440,12 +3401,9 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "poi" || t === "events" || t === "comments" || t === "answers") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par GET_NEWS.`, 400);
-    }
+    this._assertNotEntityType("getNews", ["badges", "news", "poi", "events", "comments", "answers"]);
 
-    const type: NonNullable<GetNewsData["pathParams"]>["type"] = t;
+    const type = this.getEntityType() as NonNullable<GetNewsData["pathParams"]>["type"];
 
     const dateLimit = "dateLimit" in data && typeof data.dateLimit === "number" ? { dateLimit: data.dateLimit } : { dateLimit: 0 };
     const indexStep = "indexStep" in data && typeof data.indexStep === "number" ? { indexStep: data.indexStep } : { indexStep: 12 };
@@ -3482,12 +3440,9 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "poi" || t === "events" || t === "comments" || t === "answers") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
-    }
+    this._assertNotEntityType("getGallery", ["badges", "news", "poi", "events", "comments", "answers"]);
 
-    const type: NonNullable<GetGalleryData["pathParams"]>["type"] = t;
+    const type = this.getEntityType() as NonNullable<GetGalleryData["pathParams"]>["type"];
 
     const payload: GetGalleryData = {
       pathParams: { type, id: this.id, docType: data.pathParams?.docType || "image" }
@@ -3538,10 +3493,7 @@ export class BaseEntity<TServerData = any> {
       return [];
     }
 
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "poi" || t === "comments") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par searchMemberAutocomplete.`, 400);
-    }
+    this._assertNotEntityType("searchMembers", ["badges", "news", "poi", "comments"]);
 
     result.forEach(item => {
       for (const key of Object.keys(item)) {
@@ -3701,12 +3653,9 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError("Utilisateur non connecté.", 401);
     }
 
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "poi" || t === "comments") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
-    }
+    this._assertNotEntityType("follow", ["badges", "news", "poi", "comments"]);
 
-    const parentType = t as FollowData["parentType"];
+    const parentType = this.getEntityType() as FollowData["parentType"];
 
     const userLink = this.userContext?.serverData?.links?.["follows"]?.[this.id] || null;
 
@@ -3748,12 +3697,9 @@ export class BaseEntity<TServerData = any> {
 
     const userLink = this.userContext?.serverData?.links?.["follows"]?.[this.id] || null;
 
-    const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "poi") {
-      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
-    }
+    this._assertNotEntityType("unfollow", ["badges", "news", "poi"]);
 
-    const parentType = t as DisconnectData["parentType"];
+    const parentType = this.getEntityType() as DisconnectData["parentType"];
 
     if (userLink) {
       const data: DisconnectData = {
@@ -3816,6 +3762,52 @@ export class BaseEntity<TServerData = any> {
     }
   }
 
+  /**
+   * Vérifie que l'entité N'EST PAS d'un type spécifique.
+   *
+   * @param methodName - Nom de la méthode (pour le message d'erreur).
+   * @param excludedTypes - Types d'entité NON supportés (arguments individuels ou tableau).
+   * @throws {ApiError} - Si l'entité est d'un type exclu.
+   * @protected
+   * @example
+   * this._assertNotEntityType("method", "poi", "badges", "news");
+   * this._assertNotEntityType("method", ["poi", "badges", "news"]);
+   */
+  protected _assertNotEntityType(methodName: string, ...excludedTypes: (string | string[])[]): void {
+    const types = Array.isArray(excludedTypes[0]) ? excludedTypes[0] : excludedTypes as string[];
+    const t = this.getEntityType();
+    if (types.includes(t)) {
+      throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par ${methodName}.`, 400);
+    }
+  }
+
+  /**
+   * Valide les préconditions et retourne le lien utilisateur.
+   *
+   * @param methodName - Nom de la méthode appelante (pour les messages d'erreur).
+   * @param expectedTypes - Types d'entité autorisés.
+   * @param options - Options de validation.
+   * @param options.silent - Si `true`, retourne `null` au lieu de lever une exception. Par défaut `true`.
+   * @returns - Le lien de l'utilisateur connecté avec l'entité, ou `null` si validation échoue.
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
+   * @protected
+   */
+  protected _getValidatedUserLink(
+    methodName: string,
+    expectedTypes: string[],
+    options?: { silent?: boolean }
+  ): MinimalUserLink | null {
+    const silent = options?.silent ?? true;
+    try {
+      this._checkAccess(methodName);
+      this._assertEntityType(...expectedTypes);
+    } catch (e) {
+      if (silent) return null;
+      throw e;
+    }
+    return this._getLinkFromConnectedUser();
+  }
+
   /**
    * Vérifie si l'entité est liée à un type de lien spécifique.
    * 
@@ -3862,22 +3854,24 @@ export class BaseEntity<TServerData = any> {
    *
    * @param options - Options de vérification.
    * @param options.checkHierarchy - Si `true`, vérifie également si l'utilisateur est admin via la hiérarchie parent. Par défaut `false`.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur est administrateur, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isAdmin(options?: { checkHierarchy?: boolean }): boolean {
-    this._checkAccess("vérifier l'administrateur.");
-    this._assertEntityType("organizations", "projects", "events");
+  isAdmin(options?: { checkHierarchy?: boolean; silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier l'administrateur",
+      ["organizations", "projects", "events"],
+      { silent: options?.silent }
+    );
 
     // 1. Vérifier lien direct sur l'entité courante
-    const userLink = this._getLinkFromConnectedUser();
     if (this._validateUserLink(userLink) && userLink?.isAdmin === true && !userLink?.isAdminPending) {
       return true;
     }
 
     // 2. Si pas de lien direct, remonter la hiérarchie parent (si activé)
-    const checkHierarchy = options?.checkHierarchy ?? false;
-    if (checkHierarchy) {
+    if (options?.checkHierarchy) {
       return this._isAdminViaHierarchy();
     }
 
@@ -3887,131 +3881,172 @@ export class BaseEntity<TServerData = any> {
   /**
    * Vérifie si l'utilisateur est soit l'auteur, soit administrateur de l'entité.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur est l'auteur ou administrateur, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isAuthorOrAdmin(): boolean {
-    this._checkAccess("vérifier l'auteur ou l'administrateur.");
-    return this.isAuthor() || this.isAdmin();
+  isAuthorOrAdmin(options?: { silent?: boolean }): boolean {
+    return this.isAuthor() || this.isAdmin(options);
   }
 
   /**
    * Vérifie si l'utilisateur est membre de l'entité.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur est membre, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isMember(): boolean {
-    this._checkAccess("vérifier le membre.");
-    this._assertEntityType("organizations");
-    const userLink = this._getLinkFromConnectedUser();
+  isMember(options?: { silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier le membre",
+      ["organizations"],
+      { silent: options?.silent }
+    );
     return this._validateUserLink(userLink);
   }
 
   /**
    * Vérifie si l'utilisateur est contributeur de l'entité.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur est contributeur, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isContributor(): boolean {
-    this._checkAccess("vérifier le contributeur.");
-    this._assertEntityType("projects");
-    const userLink = this._getLinkFromConnectedUser();
+  isContributor(options?: { silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier le contributeur",
+      ["projects"],
+      { silent: options?.silent }
+    );
     return this._validateUserLink(userLink);
   }
 
   /**
    * Vérifie si l'utilisateur est participant de l'entité.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur est participant, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isAttendee(): boolean {
-    this._checkAccess("vérifier si vous êtes un participant.");
-    this._assertEntityType("events");
-    const userLink = this._getLinkFromConnectedUser();
+  isAttendee(options?: { silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier le participant",
+      ["events"],
+      { silent: options?.silent }
+    );
     return this._validateUserLink(userLink);
   }
 
   /**
    * Vérifie si l'utilisateur suit l'entité.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur suit l'entité, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isFollower(): boolean {
-    this._checkAccess("vérifier si il vous suit.");
-    this._assertEntityType("citoyens","organizations", "projects", "events", "poi");
+  isFollower(options?: { silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier si il vous suit",
+      ["citoyens", "organizations", "projects", "events", "poi"],
+      { silent: options?.silent }
+    );
+    if (!userLink) return false;
     return this._isLinked("followers");
   }
 
   /**
    * Vérifie si l'utilisateur est abonné à l'entité.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur est abonné, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isFollowing(): boolean {
-    this._checkAccess("vérifier si vous le suivez.");
-    this._assertEntityType("citoyens","organizations", "projects", "events", "poi");
+  isFollowing(options?: { silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier si vous le suivez",
+      ["citoyens", "organizations", "projects", "events", "poi"],
+      { silent: options?.silent }
+    );
+    if (!userLink) return false;
     return this._isLinked("follows");
   }
 
   /**
    * Vérifie si le lien de l'utilisateur connecté est en attente de validation.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si le lien est à valider, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isToBeValidated(): boolean {
-    this._checkAccess("vérifier si il est à validé.");
-    this._assertEntityType("citoyens","organizations", "projects", "events");
-    const userLink = this._getLinkFromConnectedUser();
+  isToBeValidated(options?: { silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier si il est à valider",
+      ["citoyens", "organizations", "projects", "events"],
+      { silent: options?.silent }
+    );
     if (!userLink) return false;
-    return userLink?.toBeValidated === true;
+    return userLink.toBeValidated === true;
   }
 
   /**
    * Vérifie si l'utilisateur connecté a été invité à rejoindre l'entité.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur est invité, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isInviting(): boolean {
-    this._checkAccess("vérifier si il est invité.");
-    this._assertEntityType("citoyens","organizations", "projects", "events");
-    const userLink = this._getLinkFromConnectedUser();
+  isInviting(options?: { silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier si il est invité",
+      ["citoyens", "organizations", "projects", "events"],
+      { silent: options?.silent }
+    );
     if (!userLink) return false;
-    return userLink?.isInviting === true;
+    return userLink.isInviting === true;
   }
 
   /**
    * Vérifie si l'utilisateur connecté a été invité en tant qu'administrateur.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur est invité admin, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isInvitingAdmin(): boolean {
-    this._checkAccess("vérifier si il est invité admin.");
-    this._assertEntityType("organizations", "projects", "events");
-    const userLink = this._getLinkFromConnectedUser();
+  isInvitingAdmin(options?: { silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier si il est invité admin",
+      ["organizations", "projects", "events"],
+      { silent: options?.silent }
+    );
     if (!userLink) return false;
-    return (userLink?.isAdminInviting === true || userLink?.isInviting === true) && userLink?.isAdmin === true;
+    return (userLink.isAdminInviting === true || userLink.isInviting === true) && userLink.isAdmin === true;
   }
 
   /**
    * Vérifie si l'utilisateur connecté est administrateur en attente de confirmation.
    *
+   * @param options - Options de vérification.
+   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
    * @returns - `true` si l'utilisateur est admin en attente, `false` sinon.
-   * @throws {ApiError}
+   * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
-  isAdminPending(): boolean {
-    this._checkAccess("vérifier si il est en attente admin.");
-    this._assertEntityType("organizations", "projects", "events");
-    const userLink = this._getLinkFromConnectedUser();
+  isAdminPending(options?: { silent?: boolean }): boolean {
+    const userLink = this._getValidatedUserLink(
+      "vérifier si il est en attente admin",
+      ["organizations", "projects", "events"],
+      { silent: options?.silent }
+    );
     if (!userLink) return false;
-    return userLink?.isAdmin === true && userLink?.isAdminPending === true;
+    return userLink.isAdmin === true && userLink.isAdminPending === true;
   }
 
   /**

package/src/api/Event.ts

@@ -14,10 +14,6 @@ export class Event extends BaseEntity<EventItemNormalized> {
 
   static override SCHEMA_CONSTANTS: string[] = [
     "ADD_EVENT",
-    // "UPDATE_BLOCK_DESCRIPTION",
-    // "UPDATE_BLOCK_INFO",
-    // "UPDATE_BLOCK_SOCIAL",
-    // "UPDATE_BLOCK_LOCALITY",
     "UPDATE_BLOCK_SLUG",
     "PROFIL_IMAGE"
   ];
@@ -28,10 +24,6 @@ export class Event extends BaseEntity<EventItemNormalized> {
   ] as const);
 
   static UPDATE_BLOCKS = new Map([
-    // ["UPDATE_BLOCK_DESCRIPTION", "updateDescription"],
-    // ["UPDATE_BLOCK_SOCIAL", "updateSocial"],
-    // ["UPDATE_BLOCK_LOCALITY", "updateLocality"],
-    // ["UPDATE_BLOCK_INFO", "updateInfo"],
     ["UPDATE_BLOCK_SLUG", "updateSlug"],
     ["PROFIL_IMAGE", "updateImageProfil"]
   ] as const);

package/src/api/Organization.ts

@@ -500,6 +500,16 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
     return super.acceptInvitation();
   }
 
+  /**
+   * {@inheritDoc BaseEntity#requestPromoteToAdmin}
+   *
+   * Envoie une demande de promotion en tant qu'administrateur de l'organisation.
+   * L'utilisateur doit déjà être membre de l'organisation.
+   */
+  override requestPromoteToAdmin() {
+    return super.requestPromoteToAdmin();
+  }
+
   /**
    * {@inheritDoc BaseEntity#leave}
    *

package/src/api/Project.ts

@@ -378,6 +378,16 @@ export class Project extends BaseEntity<ProjectItemNormalized> {
     return super.acceptInvitation();
   }
 
+  /**
+   * {@inheritDoc BaseEntity#requestPromoteToAdmin}
+   *
+   * Envoie une demande de promotion en tant qu'administrateur du projet.
+   * L'utilisateur doit déjà être contributeur du projet.
+   */
+  override requestPromoteToAdmin() {
+    return super.requestPromoteToAdmin();
+  }
+
   /**
    * {@inheritDoc BaseEntity#leave}
    *