@communecter/cocolight-api-client 1.0.81 → 1.0.83

package/types/api/User.d.ts

@@ -342,17 +342,30 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      */
     entityBySlug(slug: string): Promise<EntityTypes>;
     /**
-     * Valide les préconditions communes pour les méthodes de vérification de rôle.
+     * Valide les préconditions pour les méthodes nécessitant d'être membre.
+     * @private
+     * @param methodName - Nom de la méthode appelante (pour les messages d'erreur).
+     * @param expectedTypes - Types d'entité parent autorisés.
+     * @throws {ApiError} 401 - Si l'utilisateur n'est pas connecté.
+     * @throws {ApiError} 404 - Si l'utilisateur n'est pas enregistré.
+     * @throws {ApiError} 404 - Si l'entité parente n'est pas enregistrée.
+     * @throws {ApiError} 401 - Si l'utilisateur connecté n'est pas membre de l'entité parente.
+     * @throws {ApiError} 400 - Si le type d'entité parent n'est pas valide.
+     */
+    private _validateMemberPreconditions;
+    /**
+     * Valide les préconditions pour les méthodes nécessitant d'être administrateur.
      * @private
      * @param methodName - Nom de la méthode appelante (pour les messages d'erreur).
      * @param expectedTypes - Types d'entité parent autorisés.
      * @throws {ApiError} 401 - Si l'utilisateur n'est pas connecté.
-     * @throws {ApiError} 401 - Si l'utilisateur connecté n'est pas administrateur de l'entité parente.
      * @throws {ApiError} 404 - Si l'utilisateur n'est pas enregistré.
      * @throws {ApiError} 404 - Si l'entité parente n'est pas enregistrée.
+     * @throws {ApiError} 401 - Si l'utilisateur connecté n'est pas membre de l'entité parente.
+     * @throws {ApiError} 401 - Si l'utilisateur connecté n'est pas administrateur de l'entité parente.
      * @throws {ApiError} 400 - Si le type d'entité parent n'est pas valide.
      */
-    private _validateRoleCheckPreconditions;
+    private _validateAdminPreconditions;
     /**
      * Récupère le lien parent pour l'utilisateur actuel.
      *
@@ -360,6 +373,11 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * @private
      */
     private _getParentLinkForUser;
+    /**
+     * Rafraîchit l'utilisateur et l'entité parente après une action.
+     * @private
+     */
+    private _refreshWithParent;
     /**
      * Vérifie si l'utilisateur est administrateur de l'entité parente.
      *
@@ -562,6 +580,8 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * vers l'organisation ou le projet parent. Si l'utilisateur n'a pas encore de lien,
      * une demande de connexion est créée.
      *
+     * @param {Object} [options] - Options de la méthode
+     * @param {boolean} [options.admin=false] - Si true, utilise "admin" comme connectType au lieu du type par défaut (connectTypeConnect)
      * @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
@@ -569,14 +589,19 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      *
      * @example
      * ```typescript
-     * // Un admin récupère les membres et envoie une invitation
+     * // Un admin récupère les membres et envoie une invitation (type par défaut)
      * const org = await me.organization({ slug: "myOrg" });
      * const users = await org.getMembers();
      * const user = users.results[0];
      * await user.sendRequestToJoinParent();
+     *
+     * // Avec le type admin explicite
+     * await user.sendRequestToJoinParent({ admin: true });
      * ```
      */
-    sendRequestToJoinParent(): Promise<unknown>;
+    sendRequestToJoinParent({ admin }?: {
+        admin: boolean;
+    }): Promise<unknown>;
     /**
      * Valide une demande de membre en attente de validation.
      *
@@ -598,26 +623,6 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * ```
      */
     validateMemberRequest(): Promise<unknown>;
-    /**
-     * 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();
-     * ```
-     */
     /**
      * Valide une demande d'admin en attente.
      *