@communecter/cocolight-api-client 1.0.78 → 1.0.80

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 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
  */
@@ -1049,5 +1049,15 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     deleteDocumentByContext(data: DeleteDocumentByContextData): Promise<any>;
+    /**
+     * 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.
+     */
+    demoteAdmin(data: DemoteAdminData): Promise<any>;
 }
 export default EndpointApi;

package/types/api/EndpointApi.types.d.ts

@@ -4507,3 +4507,15 @@ 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/types/api/User.d.ts

@@ -354,11 +354,12 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      */
     private _validateRoleCheckPreconditions;
     /**
-     * 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;
+    private _getParentLinkForUser;
     /**
      * Vérifie si l'utilisateur est administrateur de l'entité parente.
      *
@@ -478,5 +479,227 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * }
      */
     isAttendee(): boolean;
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * 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();
+     * ```
+     */
+    sendRequestToJoinParent(): Promise<unknown>;
+    /**
+     * 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();
+     * ```
+     */
+    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.
+     *
+     * 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();
+     * ```
+     */
+    validateAdminRequest(): Promise<unknown>;
+    /**
+     * 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();
+     * ```
+     */
+    removeFromParent(): Promise<unknown>;
+    /**
+     * 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();
+     * ```
+     */
+    promoteToAdmin(): Promise<unknown>;
+    /**
+     * 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();
+     * ```
+     */
+    demoteFromAdmin(): Promise<unknown>;
 }
 export {};

package/types/api/serverDataType/common.d.ts

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