@communecter/cocolight-api-client 1.0.114 → 1.0.116

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.114",
+    "version": "1.0.116",
     "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/src/api/User.ts

@@ -1222,15 +1222,25 @@ export class User extends BaseEntity<UserItemNormalized> {
     } catch{
       return false;
     }
-    if(this.getEntityType() === "citoyens"){
-      const userLink = this._getLinkFromConnectedUser();
-      if (!userLink) return false;
-      return userLink?.isInviting === true;
-    } else {
-      const parentLink = this._getParentLinkForUser();
-      if (!parentLink) return false;
-      return parentLink?.isInviting === true;
+    const parentLink = this._getParentLinkForUser();
+    if (!parentLink) return false;
+    return parentLink?.isInviting === true;
+  }
+
+  /**
+   * Vérifie si l'utilisateur connecté a envoyé une invitation d'ami à cet utilisateur.
+   *
+   * @returns - `true` si une invitation d'ami est en attente, `false` sinon.
+   */
+  isInvitingFriend(): boolean {
+    try {
+      this._validateBasePreconditions("isInviting", ["citoyens", "organizations", "projects", "events"]);
+    } catch{
+      return false;
     }
+    const userLink = this._getLinkFromConnectedUser();
+    if (!userLink) return false;
+    return userLink?.isInviting === true;
   }
 
   /**
@@ -1315,15 +1325,25 @@ export class User extends BaseEntity<UserItemNormalized> {
     } catch{
       return false;
     }
-    if(this.getEntityType() === "citoyens"){
-      const userLink = this._getLinkFromConnectedUser();
-      if (!userLink) return false;
-      return userLink?.toBeValidated === true;
-    } else {
-      const parentLink = this._getParentLinkForUser();
-      if (!parentLink) return false;
-      return parentLink?.toBeValidated === true;
+    const parentLink = this._getParentLinkForUser();
+    if (!parentLink) return false;
+    return parentLink?.toBeValidated === true;
+  }
+
+  /**
+   * Vérifie si cet utilisateur a envoyé une demande d'ami en attente de validation.
+   *
+   * @returns - `true` si une demande d'ami est en attente de validation, `false` sinon.
+   */
+  isToBeValidatedFriend(): boolean {
+    try {
+      this._validateBasePreconditions("isToBeValidated", ["citoyens", "organizations", "projects", "events"]);
+    } catch{
+      return false;
     }
+    const userLink = this._getLinkFromConnectedUser();
+    if (!userLink) return false;
+    return userLink?.toBeValidated === true;
   }
 
   /**

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é.

package/types/api/User.d.ts

@@ -528,6 +528,12 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * ```
      */
     isInviting(): boolean;
+    /**
+     * Vérifie si l'utilisateur connecté a envoyé une invitation d'ami à cet utilisateur.
+     *
+     * @returns - `true` si une invitation d'ami est en attente, `false` sinon.
+     */
+    isInvitingFriend(): boolean;
     /**
      * Vérifie si l'utilisateur a une invitation en attente avec des droits d'admin.
      *
@@ -586,6 +592,12 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * ```
      */
     isToBeValidated(): boolean;
+    /**
+     * Vérifie si cet utilisateur a envoyé une demande d'ami en attente de validation.
+     *
+     * @returns - `true` si une demande d'ami est en attente de validation, `false` sinon.
+     */
+    isToBeValidatedFriend(): boolean;
     /**
      * Envoie une demande pour rejoindre l'entité parente.
      *