@communecter/cocolight-api-client 1.0.78 → 1.0.79

package/package.json

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

package/src/api/BaseEntity.ts

@@ -230,6 +230,8 @@ type LinkFilters = Record<string, FilterValue>;
 interface MinimalUserLink {
   toBeValidated?: boolean;
   isInviting?: boolean;
+  isAdminInviting?: boolean;
+  isAdminPending?: boolean;
 }
 
 // Types pour linkEntitiesFromServerData
@@ -2406,7 +2408,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     // Invitation reçue → accepte automatiquement
-    if (userLink.isInviting) {
+    if (userLink.isInviting || userLink.isAdminInviting) {
       return this._acceptLinkRequest();
     }
 
@@ -2443,7 +2445,7 @@ export class BaseEntity<TServerData = any> {
 
     const userLink = this._getLinkFromConnectedUser();
 
-    if (userLink && userLink.isInviting) {
+    if (userLink && (userLink.isInviting || userLink.isAdminInviting)) {
       const t = this.getEntityType();
 
       // 1) Garde runtime pour exclure les types non pris en charge par LinkValidateData
@@ -3382,8 +3384,8 @@ export class BaseEntity<TServerData = any> {
    */
   protected _validateUserLink(userLink: MinimalUserLink | null | undefined): boolean {
     if (!userLink) return false;
-    const { toBeValidated, isInviting } = userLink;
-    return !toBeValidated && !isInviting;
+    const { toBeValidated, isInviting, isAdminInviting, isAdminPending } = userLink;
+    return !toBeValidated && !isInviting && !isAdminInviting && !isAdminPending;
   }
 
   /**

package/src/api/EndpointApi.ts

@@ -2,7 +2,7 @@
 import { ApiAuthenticationError } from "../error.js";
 
 import type ApiClient from "../ApiClient.js";
-import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData } from "./EndpointApi.types.js";
+import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DemoteAdminData } from "./EndpointApi.types.js";
 
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
@@ -1704,6 +1704,22 @@ export class EndpointApi {
     return this.callIsConnected("DELETE_DOCUMENT_BY_CONTEXT", data);
   }
     
+  /**
+   * Rétirer les droits d’administrateur d’un membre : Rétirer les droits d’administrateur d’un membre d’une organisation ou d’un projet
+   * Constant : DEMOTE_ADMIN
+   * @param data - Données envoyées à l'API
+   * @returns Les données de réponse.
+   * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+   * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async demoteAdmin(data: DemoteAdminData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("DEMOTE_ADMIN", data);
+  }
+    
 }
 
 export default EndpointApi;

package/src/api/EndpointApi.types.ts

@@ -4899,3 +4899,17 @@ export interface DeleteDocumentByContextData {
   };
   [k: string]: unknown;
 }
+
+
+export interface DemoteAdminData {
+  parentId: string;
+  /**
+   * Type de contexte de l’entité
+   */
+  parentType: "organizations" | "projects";
+  childId: string;
+  childType: "citoyens";
+  connect: "members" | "contributors";
+  isAdmin: false;
+  [k: string]: unknown;
+}

package/src/api/User.ts

@@ -15,7 +15,8 @@ import type {
   GetSubscriptionsData,
   GetOrganizationsNoAdminData,
   GetOrganizationsAdminData,
-  GetFriendsAdminData
+  GetFriendsAdminData,
+  DemoteAdminData
 } from "./EndpointApi.types.js";
 import type { Organization } from "./Organization.js";
 import type { EntityTypes } from "@/types/entities.js";
@@ -922,16 +923,18 @@ export class User extends BaseEntity<UserItemNormalized> {
     }
   }
 
+
   /**
-   * Récupère le lien utilisateur pour l'entité parente.
+   * Récupère le lien parent pour l'utilisateur actuel.
+   *
+   * @returns Le lien parent de l'utilisateur ou `null` s'il n'existe pas.
    * @private
-   * @returns Le lien utilisateur ou null.
    */
-  private _getUserLinkForParent(): any {
-    const { linkType } = this.parent!._getLinkMeta();
-    const parentId = this.parent!.id;
-    if (!parentId) return null;
-    return this?.serverData?.links?.[linkType]?.[parentId] || null;
+  private _getParentLinkForUser(): any {
+    const { connectTypeDisconnect } = this.parent!._getLinkMeta();
+    const userId = this!.id;
+    if (!userId) return null;
+    return this.parent?.serverData?.links?.[connectTypeDisconnect]?.[userId] || null;
   }
 
   /**
@@ -976,8 +979,8 @@ export class User extends BaseEntity<UserItemNormalized> {
    */
   override isAdmin(): boolean {
     this._validateRoleCheckPreconditions("isAdmin", ["organizations", "projects"]);
-    const userLink = this._getUserLinkForParent();
-    return this._validateUserLink(userLink) && userLink?.isAdmin === true && !userLink?.isAdminPending;
+    const parentLink = this._getParentLinkForUser();
+    return this._validateUserLink(parentLink) && parentLink?.isAdmin === true;
   }
 
   /**
@@ -1007,8 +1010,8 @@ export class User extends BaseEntity<UserItemNormalized> {
    */
   override isMember(): boolean {
     this._validateRoleCheckPreconditions("isMember", ["organizations"]);
-    const userLink = this._getUserLinkForParent();
-    return this._validateUserLink(userLink);
+    const parentLink = this._getParentLinkForUser();
+    return this._validateUserLink(parentLink);
   }
 
   /**
@@ -1038,8 +1041,8 @@ export class User extends BaseEntity<UserItemNormalized> {
    */
   override isContributor(): boolean {
     this._validateRoleCheckPreconditions("isContributor", ["projects"]);
-    const userLink = this._getUserLinkForParent();
-    return this._validateUserLink(userLink);
+    const parentLink = this._getParentLinkForUser();
+    return this._validateUserLink(parentLink);
   }
 
   /**
@@ -1069,8 +1072,483 @@ export class User extends BaseEntity<UserItemNormalized> {
    */
   override isAttendee(): boolean {
     this._validateRoleCheckPreconditions("isAttendee", ["events"]);
-    const userLink = this._getUserLinkForParent();
-    return this._validateUserLink(userLink);
+    const parentLink = this._getParentLinkForUser();
+    return this._validateUserLink(parentLink);
+  }
+
+  /**
+   * Vérifie si l'utilisateur a une invitation en attente d'acceptation pour l'entité parente.
+   *
+   * Cette méthode vérifie si l'utilisateur a été invité à rejoindre l'organisation, le projet
+   * ou l'événement parent, mais n'a pas encore accepté l'invitation (`isInviting: true`).
+   *
+   * @returns {boolean} `true` si l'utilisateur a une invitation en attente, `false` sinon
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin du parent, ou si le parent n'est pas défini
+   *
+   * @example
+   * ```typescript
+   * const org = await me.organization({ slug: "myOrg" });
+   * const members = await org.getMembers();
+   * const invitedUser = members.results.find(m => m.isInviting());
+   * console.log("Invitation en attente:", invitedUser?.data.name);
+   * ```
+   */
+  isInviting(): boolean {
+    this._validateRoleCheckPreconditions("isInviting", ["organizations", "projects", "events"]);
+    const parentLink = this._getParentLinkForUser();
+    if (!parentLink) return false;
+    return parentLink?.isInviting === true;
+  }
+
+  /**
+   * Vérifie si l'utilisateur a une invitation en attente avec des droits d'admin.
+   *
+   * Cette méthode vérifie si l'utilisateur a été invité à rejoindre l'organisation ou le projet
+   * parent en tant qu'administrateur, mais n'a pas encore accepté (`isInviting: true` et `isAdmin: true`).
+   *
+   * @returns {boolean} `true` si l'utilisateur a une invitation admin en attente, `false` sinon
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin du parent, ou si le parent n'est pas défini
+   *
+   * @example
+   * ```typescript
+   * const org = await me.organization({ slug: "myOrg" });
+   * const members = await org.getMembers();
+   * const invitedAdmin = members.results.find(m => m.isInvitingAdmin());
+   * console.log("Invitation admin en attente:", invitedAdmin?.data.name);
+   * ```
+   */
+  isInvitingAdmin(): boolean {
+    this._validateRoleCheckPreconditions("isInvitingAdmin", ["organizations", "projects"]);
+    const parentLink = this._getParentLinkForUser();
+    if (!parentLink) return false;
+    return parentLink?.isAdminInviting === true && parentLink?.isAdmin === true;
+  }
+
+  /**
+   * Vérifie si l'utilisateur a une demande de promotion admin en attente de validation.
+   *
+   * Cette méthode vérifie si l'utilisateur a demandé ou a été proposé pour devenir administrateur
+   * de l'organisation ou du projet parent, mais la demande n'a pas encore été validée (`isAdminPending: true`).
+   *
+   * @returns {boolean} `true` si l'utilisateur a une demande admin en attente, `false` sinon
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin du parent, ou si le parent n'est pas défini
+   *
+   * @example
+   * ```typescript
+   * const org = await me.organization({ slug: "myOrg" });
+   * const members = await org.getMembers();
+   * const pendingAdmin = members.results.find(m => m.isAdminPending());
+   * if (pendingAdmin) {
+   *   await pendingAdmin.validateAdminRequest();
+   * }
+   * ```
+   */
+  isAdminPending(): boolean {
+    this._validateRoleCheckPreconditions("isAdminPending", ["organizations", "projects"]);
+    const parentLink = this._getParentLinkForUser();
+    return parentLink?.isAdmin === true && parentLink?.isAdminPending === true;
+  }
+
+  /**
+   * Vérifie si l'utilisateur a une demande d'adhésion en attente de validation.
+   *
+   * Cette méthode vérifie si l'utilisateur a demandé à rejoindre l'organisation, le projet
+   * ou l'événement parent, mais la demande n'a pas encore été validée par un administrateur (`toBeValidated: true`).
+   *
+   * @returns {boolean} `true` si l'utilisateur a une demande en attente, `false` sinon
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin du parent, ou si le parent n'est pas défini
+   *
+   * @example
+   * ```typescript
+   * const org = await me.organization({ slug: "myOrg" });
+   * const members = await org.getMembers();
+   * const pendingUser = members.results.find(m => m.isToBeValidated());
+   * if (pendingUser) {
+   *   await pendingUser.validateMemberRequest();
+   * }
+   * ```
+   */
+  isToBeValidated(): boolean {
+    this._validateRoleCheckPreconditions("isToBeValidated", ["organizations", "projects", "events"]);
+    const parentLink = this._getParentLinkForUser();
+    return parentLink?.toBeValidated === true;
+  }
+
+
+  // ────────────────────────────────
+  //  Actions d'admin sur l'utilisateur par rapport à l'entité parente
+  // ────────────────────────────────
+
+  /**
+   * Envoie une demande pour rejoindre l'entité parente.
+   *
+   * Cette méthode permet à un admin de créer une demande de connexion pour un utilisateur
+   * vers l'organisation ou le projet parent. Si l'utilisateur n'a pas encore de lien,
+   * une demande de connexion est créée.
+   *
+   * @returns {Promise<unknown>} La réponse de l'API après création de la demande
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin, ou si le parent n'est pas défini
+   * @throws {ApiError} Si l'utilisateur est déjà en attente de validation
+   * @throws {ApiError} Si l'utilisateur est déjà connecté à l'entité
+   *
+   * @example
+   * ```typescript
+   * // Un admin récupère les membres et envoie une invitation
+   * const org = await me.organization({ slug: "myOrg" });
+   * const users = await org.getMembers();
+   * const user = users.results[0];
+   * await user.sendRequestToJoinParent();
+   * ```
+   */
+  async sendRequestToJoinParent(): Promise<unknown> {
+    this._validateRoleCheckPreconditions("sendRequestToJoinParent", ["organizations", "projects"]);
+
+    const { connectTypeConnect } = this.parent!._getLinkMeta();
+
+    const parentLink = this._getParentLinkForUser();
+
+    // Cas : aucun lien → on demande à se connecter
+    if (!parentLink) {
+
+      const t = this.parent!.getEntityType();
+
+      // 2) Narrow de type pour TypeScript
+      const parentType = t as ConnectData["parentType"];
+
+      const data: ConnectData = {
+        childId: this.id!,
+        childType: "citoyens",
+        parentType,
+        parentId: this.parent!.id!,
+        connectType: connectTypeConnect
+      };
+
+      const retour = await this.callIsConnected(() => this.endpointApi.connect(data));
+      // Refresh l'utilisateur membre et l'entité parente
+      await this.refresh();
+      if (this.parent) {
+        await this.parent.refresh();
+      }
+      return retour;
+    }
+
+    // Cas : déjà en attente
+    if (parentLink.toBeValidated) {
+      throw new ApiError("Vous êtes déjà en attente de validation.", 400);
+    }
+
+    // Cas par défaut : rien à faire
+    throw new ApiError("Vous êtes déjà connecté à cette entité.", 400);
+  }
+
+  /**
+   * Valide une demande de membre en attente de validation.
+   *
+   * Cette méthode permet à un admin de valider une demande d'adhésion d'un utilisateur
+   * qui est en attente (`toBeValidated: true`). Après validation, l'utilisateur devient
+   * membre actif de l'entité parente.
+   *
+   * @returns {Promise<unknown>} La réponse de l'API après validation
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin, ou si le parent n'est pas défini
+   * @throws {ApiError} Si l'utilisateur n'a pas de demande en attente
+   *
+   * @example
+   * ```typescript
+   * // Un admin valide une demande en attente
+   * const org = await me.organization({ slug: "myOrg" });
+   * const members = await org.getMembers();
+   * const pendingUser = members.results.find(u => u.serverData.links?.memberOf?.[org.id]?.toBeValidated);
+   * await pendingUser.validateMemberRequest();
+   * ```
+   */
+  async validateMemberRequest(): Promise<unknown> {
+    this._validateRoleCheckPreconditions("validateMemberRequest", ["organizations", "projects"]);
+
+    const parentLink = this._getParentLinkForUser();
+
+    if (!parentLink?.toBeValidated) {
+      throw new ApiError("Cet utilisateur n'a pas de demande en attente de validation.", 400);
+    }
+
+    const t = this.parent!.getEntityType();
+
+    const parentType = t as LinkValidateData["parentType"];
+
+    const data: LinkValidateData = {
+      childId: this.id!,
+      childType: "citoyens",
+      parentType,
+      parentId: this.parent!.id!,
+      linkOption: "toBeValidated"
+    };
+
+    const retour = await this.callIsConnected(() => this.endpointApi.linkValidate(data));
+    // Refresh l'utilisateur membre et l'entité parente
+    await this.refresh();
+    if (this.parent) {
+      await this.parent.refresh();
+    }
+    return retour;
+  }
+
+  /**
+   * Valide une invitation en attente d'acceptation.
+   *
+   * Cette méthode permet à un admin de valider une invitation envoyée à un utilisateur
+   * qui est en attente (`isInviting: true`). Après validation, l'utilisateur devient
+   * membre actif de l'entité parente.
+   *
+   * @returns {Promise<unknown>} La réponse de l'API après validation
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin, ou si le parent n'est pas défini
+   * @throws {ApiError} Si l'utilisateur n'a pas d'invitation en attente
+   *
+   * @example
+   * ```typescript
+   * // Un admin valide une invitation en attente
+   * const org = await me.organization({ slug: "myOrg" });
+   * const members = await org.getMembers();
+   * const invitedUser = members.results.find(u => u.serverData.links?.memberOf?.[org.id]?.isInviting);
+   * await invitedUser.validateInvitation();
+   * ```
+   */
+  // async validateInvitation(): Promise<unknown> {
+  //   this._validateRoleCheckPreconditions("validateInvitation", ["organizations", "projects"]);
+
+  //   const parentLink = this._getParentLinkForUser();
+
+  //   if (!parentLink?.isInviting) {
+  //     throw new ApiError("Cet utilisateur n'a pas d'invitation en attente.", 400);
+  //   }
+
+  //   const t = this.parent!.getEntityType();
+
+  //   const parentType = t as LinkValidateData["parentType"];
+
+  //   const data: LinkValidateData = {
+  //     childId: this.id!,
+  //     childType: "citoyens",
+  //     parentType,
+  //     parentId: this.parent!.id!,
+  //     linkOption: "isInviting"
+  //   };
+
+  //   const retour = await this.callIsConnected(() => this.endpointApi.linkValidate(data));
+  //   // Refresh l'utilisateur membre et l'entité parente
+  //   await this.refresh();
+  //   if (this.parent) {
+  //     await this.parent.refresh();
+  //   }
+  //   return retour;
+  // }
+
+  /**
+   * Valide une demande d'admin en attente.
+   *
+   * Cette méthode permet à un admin de valider une demande de promotion au statut d'admin
+   * pour un utilisateur qui est en attente (`isAdminPending: true`). Après validation,
+   * l'utilisateur devient admin de l'entité parente.
+   *
+   * @returns {Promise<unknown>} La réponse de l'API après validation
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin, ou si le parent n'est pas défini
+   * @throws {ApiError} Si l'utilisateur n'a pas de demande d'admin en attente
+   *
+   * @example
+   * ```typescript
+   * // Un admin valide une demande de promotion à admin
+   * const org = await me.organization({ slug: "myOrg" });
+   * const members = await org.getMembers();
+   * const pendingAdmin = members.results.find(u => u.serverData.links?.memberOf?.[org.id]?.isAdminPending);
+   * await pendingAdmin.validateAdminRequest();
+   * ```
+   */
+  async validateAdminRequest(): Promise<unknown> {
+    this._validateRoleCheckPreconditions("validateAdminRequest", ["organizations", "projects"]);
+
+    const parentLink = this._getParentLinkForUser();
+
+    if (!parentLink?.isAdminPending) {
+      throw new ApiError("Cet utilisateur n'a pas de demande d'admin en attente.", 400);
+    }
+
+    const t = this.parent!.getEntityType();
+
+    const parentType = t as LinkValidateData["parentType"];
+
+    const data: LinkValidateData = {
+      childId: this.id!,
+      childType: "citoyens",
+      parentType,
+      parentId: this.parent!.id!,
+      linkOption: "isAdminPending"
+    };
+
+    const retour = await this.callIsConnected(() => this.endpointApi.linkValidate(data));
+    // Refresh l'utilisateur membre et l'entité parente
+    await this.refresh();
+    if (this.parent) {
+      await this.parent.refresh();
+    }
+    return retour;
+  }
+
+  /**
+   * Retire un utilisateur de l'entité parente.
+   *
+   * Cette méthode permet à un admin de déconnecter un membre de l'organisation ou du projet parent.
+   * L'utilisateur perd tous ses liens avec l'entité (membre, admin, etc.).
+   *
+   * @returns {Promise<unknown>} La réponse de l'API après déconnexion
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin, ou si le parent n'est pas défini
+   * @throws {ApiError} Si l'utilisateur n'est pas membre de l'entité
+   *
+   * @example
+   * ```typescript
+   * // Un admin retire un membre
+   * const org = await me.organization({ slug: "myOrg" });
+   * const members = await org.getMembers();
+   * const userToRemove = members.results[0];
+   * await userToRemove.removeFromParent();
+   * ```
+   */
+  async removeFromParent(): Promise<unknown> {
+    this._validateRoleCheckPreconditions("removeFromParent", ["organizations", "projects"]);
+
+    const parentLink = this._getParentLinkForUser();
+
+    if (!parentLink) {
+      throw new ApiError("Cet utilisateur n'est pas connecté à cette entité.", 400);
+    }
+
+    const t = this.parent!.getEntityType();
+
+    const parentType = t as DisconnectData["parentType"];
+
+    const { connectTypeDisconnect } = this.parent!._getLinkMeta();
+
+    const data: DisconnectData = {
+      childId: this.id!,
+      childType: "citoyens",
+      parentType,
+      parentId: this.parent!.id!,
+      connectType: connectTypeDisconnect
+    };
+
+    const retour = await this.callIsConnected(() => this.endpointApi.disconnect(data));
+    // Refresh l'utilisateur membre et l'entité parente
+    await this.refresh();
+    if (this.parent) {
+      await this.parent.refresh();
+    }
+    return retour;
+  }
+
+  /**
+   * Promeut un utilisateur au statut d'admin de l'entité parente.
+   *
+   * Cette méthode permet à un admin de promouvoir un membre ordinaire au statut d'admin
+   * de l'organisation ou du projet parent.
+   *
+   * @returns {Promise<unknown>} La réponse de l'API après promotion
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin, ou si le parent n'est pas défini
+   * @throws {ApiError} Si l'utilisateur n'est pas membre de l'entité
+   * @throws {ApiError} Si l'utilisateur est déjà admin
+   *
+   * @example
+   * ```typescript
+   * // Un admin promeut un membre au statut d'admin
+   * const org = await me.organization({ slug: "myOrg" });
+   * const members = await org.getMembers();
+   * const userToPromote = members.results.find(u => !u.isAdmin());
+   * await userToPromote.promoteToAdmin();
+   * ```
+   */
+  async promoteToAdmin(): Promise<unknown> {
+    this._validateRoleCheckPreconditions("promoteToAdmin", ["organizations", "projects"]);
+
+    const parentLink = this._getParentLinkForUser();
+
+    if (!parentLink) {
+      throw new ApiError("Cet utilisateur n'est pas membre de cette entité.", 400);
+    }
+
+    if (parentLink.isAdmin && !parentLink.isAdminPending) {
+      throw new ApiError("Cet utilisateur est déjà admin.", 400);
+    }
+
+    const t = this.parent!.getEntityType();
+
+    const parentType = t as ConnectData["parentType"];
+
+    const data: ConnectData = {
+      childId: this.id!,
+      childType: "citoyens",
+      parentType,
+      parentId: this.parent!.id!,
+      connectType: "admin"
+    };
+
+    const retour = await this.callIsConnected(() => this.endpointApi.connect(data));
+    // Refresh l'utilisateur membre et l'entité parente
+    await this.refresh();
+    if (this.parent) {
+      await this.parent.refresh();
+    }
+    return retour;
+  }
+
+  /**
+   * Rétrograde un admin au statut de membre ordinaire.
+   *
+   * Cette méthode permet à un admin de rétrograder un autre admin au statut de membre
+   * ordinaire de l'organisation ou du projet parent. L'utilisateur perd ses privilèges d'admin
+   * mais reste membre de l'entité.
+   *
+   * @returns {Promise<unknown>} La réponse de l'API après rétrogradation
+   * @throws {ApiError} Si l'utilisateur n'est pas connecté, pas admin, ou si le parent n'est pas défini
+   * @throws {ApiError} Si l'utilisateur n'est pas admin de l'entité
+   *
+   * @example
+   * ```typescript
+   * // Un admin rétrograde un autre admin
+   * const org = await me.organization({ slug: "myOrg" });
+   * const admins = await org.getMembers({}, { isAdmin: true });
+   * const adminToDemote = admins.results.find(u => u.isAdmin());
+   * await adminToDemote.demoteFromAdmin();
+   * ```
+   */
+  async demoteFromAdmin(): Promise<unknown> {
+    this._validateRoleCheckPreconditions("demoteFromAdmin", ["organizations", "projects"]);
+
+    const parentLink = this._getParentLinkForUser();
+
+    if (!parentLink?.isAdmin || parentLink.isAdminPending) {
+      throw new ApiError("Cet utilisateur n'est pas admin de cette entité.", 400);
+    }
+
+    const t = this.parent!.getEntityType();
+
+    const { connectTypeDisconnect } = this.parent!._getLinkMeta();
+
+    const parentType = t as DemoteAdminData["parentType"];
+
+    // Pour rétrograder un admin, on déconnecte le lien "admin"
+    // L'utilisateur garde son lien "member"
+    const data: DemoteAdminData = {
+      childId: this.id!,
+      childType: "citoyens",
+      parentType,
+      parentId: this.parent!.id!,
+      connect: connectTypeDisconnect as DemoteAdminData["connect"],
+      isAdmin: false
+    };
+
+    const retour = await this.callIsConnected(() => this.endpointApi.demoteAdmin(data));
+    // Refresh l'utilisateur membre et l'entité parente
+    await this.refresh();
+    if (this.parent) {
+      await this.parent.refresh();
+    }
+    return retour;
   }
 
 }

package/src/api/serverDataType/common.ts

@@ -18,6 +18,7 @@ export interface LinkRef<TType extends string = string> {
   isAdmin?: boolean;
   isAdminPending?: boolean;
   isInviting?: boolean;
+  isAdminInviting?: boolean;
   invitorId?: string;
   invitorName?: string;
   toBeValidated?: boolean;