@communecter/cocolight-api-client 1.0.114 → 1.0.115

package/package.json

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

package/src/api/BaseEntity.ts

@@ -3585,6 +3585,73 @@ export class BaseEntity<TServerData = any> {
     return this._submitLinkRequestAdmin();
   }
 
+  /**
+   * Envoie une demande de promotion en tant qu'administrateur pour l'utilisateur connecté.
+   *
+   * L'utilisateur doit déjà être membre de l'entité (organisation, projet, événement).
+   * Cette méthode envoie une demande pour obtenir les droits d'administration.
+   *
+   * @returns - Résultat de l'API.
+   * @throws {ApiError} 401 - Si l'utilisateur n'est pas connecté.
+   * @throws {ApiError} 404 - Si l'entité n'est pas enregistrée.
+   * @throws {ApiError} 400 - Si l'utilisateur n'est pas membre de l'entité.
+   * @throws {ApiError} 400 - Si l'utilisateur est déjà en cours d'invitation admin.
+   * @throws {ApiError} 400 - Si l'utilisateur est déjà administrateur.
+   * @throws {ApiError} 400 - Si le type d'entité ne supporte pas cette opération.
+   */
+  async requestPromoteToAdmin(): Promise<unknown> {
+    if (!this.isMe) {
+      throw new ApiError("Vous devez être connecté pour envoyer une demande de participation.", 401);
+    }
+
+    this._checkLinkableEntity();
+    
+    if (!this.id) {
+      throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
+    }
+
+    if (!this.userId) {
+      throw new ApiError("L'utilisateur connecté n'est pas défini.", 400);
+    }
+
+    const userLink = this._getLinkFromConnectedUser();
+
+    if (!userLink) {
+      throw new ApiError("vous n'êtes pas membre de cette entité.", 400);
+    }
+
+    if (userLink?.isAdmin && (userLink?.isInviting || userLink?.isAdminInviting)) {
+      throw new ApiError("Cet utilisateur est déjà en cours d'invitation en tant qu'admin.", 400);
+    }
+
+    if (userLink?.isAdmin && !userLink?.isInviting && !userLink?.isAdminInviting) {
+      throw new ApiError("Cet utilisateur est déjà admin.", 400);
+    }
+
+    const t = this.getEntityType();
+
+    const expectedTypes = ["organizations", "projects"];
+
+    if (!expectedTypes.includes(t)) {
+      throw new ApiError(`L'entité doit être de type : ${expectedTypes.join(", ")}, reçu : ${t}`, 400);
+    }
+
+    // 2) Narrow de type pour TypeScript
+    const parentType = t as ConnectData["parentType"];
+
+    const data: ConnectData = {
+      childId: this.userId,
+      childType: "citoyens",
+      parentType,
+      parentId: this.id,
+      connectType: "admin"
+    };
+
+    const retour = await this.callIsMe(() => this.endpointApi.connect(data));
+    await this.userContext?.refresh();
+    return retour;
+  }
+
   /**
    * Accepte une invitation à rejoindre l'entité courante.
    * Ne fonctionne que si un lien avec `isInviting` est détecté.

package/types/api/BaseEntity.d.ts

@@ -1205,6 +1205,21 @@ export declare class BaseEntity<TServerData = any> {
      * @throws {ApiError} - Si l'entité ne supporte pas l'action ou si une demande est déjà en cours.
      */
     requestToJoinAdmin(): Promise<unknown>;
+    /**
+     * Envoie une demande de promotion en tant qu'administrateur pour l'utilisateur connecté.
+     *
+     * L'utilisateur doit déjà être membre de l'entité (organisation, projet, événement).
+     * Cette méthode envoie une demande pour obtenir les droits d'administration.
+     *
+     * @returns - Résultat de l'API.
+     * @throws {ApiError} 401 - Si l'utilisateur n'est pas connecté.
+     * @throws {ApiError} 404 - Si l'entité n'est pas enregistrée.
+     * @throws {ApiError} 400 - Si l'utilisateur n'est pas membre de l'entité.
+     * @throws {ApiError} 400 - Si l'utilisateur est déjà en cours d'invitation admin.
+     * @throws {ApiError} 400 - Si l'utilisateur est déjà administrateur.
+     * @throws {ApiError} 400 - Si le type d'entité ne supporte pas cette opération.
+     */
+    requestPromoteToAdmin(): Promise<unknown>;
     /**
      * Accepte une invitation à rejoindre l'entité courante.
      * Ne fonctionne que si un lien avec `isInviting` est détecté.