@communecter/cocolight-api-client 1.0.154 → 1.0.155

package/package.json

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

package/src/api/BaseEntity.ts

@@ -4617,6 +4617,52 @@ export class BaseEntity<TServerData = any> {
     throw new ApiError("Vous n'êtes pas abonné à cette entité.", 404);
   }
 
+  /**
+   * Invite des personnes PAR EMAIL à rejoindre CETTE entité (organisation, projet ou événement).
+   *
+   * Méthode de haut niveau à PRÉFÉRER à un appel direct `endpointApi.inviteMembers`.
+   * Wrappe INVITE_MEMBERS (POST /co2/link/multiconnect, `listInvite.invites`) : le backend
+   * crée un citoyen « pending » par email puis envoie un mail d'invitation. Les clés des
+   * invités sont des UUID v4 générés ici (le contrat l'exige).
+   *
+   * @param invites - Liste d'invités `{ name, mail, msg?, isAdmin?, roles? }` (clé `mail`,
+   *   comme le legacy `Link::invite` ; `isAdmin:"admin"` pour inviter en admin).
+   * @returns Réponse de l'API (par invité : citoyens/invites/organizations).
+   * @throws {ApiError} Si l'entité n'a pas d'id, n'est pas une orga/projet/événement, ou liste vide.
+   */
+  async inviteByEmail(
+    invites: Array<{ name: string; mail: string; msg?: string; isAdmin?: "" | "admin"; roles?: string[] }>,
+  ): Promise<unknown> {
+    if (!this.id) {
+      throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
+    }
+    const parentType = this.getEntityType();
+    if (parentType !== "organizations" && parentType !== "projects" && parentType !== "events") {
+      throw new ApiError(`L'invitation par email n'est pas supportée pour le type "${parentType}".`, 400);
+    }
+    if (!Array.isArray(invites) || invites.length === 0) {
+      throw new ApiError("Aucun invité fourni.", 400);
+    }
+    const listInvite = {
+      invites: Object.fromEntries(invites.map((inv) => [this._uuidV4(), inv])),
+    };
+    return this.callIsConnected(() =>
+      this.endpointApi.inviteMembers({ parentId: this.id as string, parentType, listInvite }),
+    );
+  }
+
+  /** UUID v4 compatible browser + Node (`crypto.randomUUID()` si dispo, sinon fallback). @private */
+  private _uuidV4(): string {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+      return crypto.randomUUID();
+    }
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const r = (Math.random() * 16) | 0;
+      const v = c === "x" ? r : (r & 0x3) | 0x8;
+      return v.toString(16);
+    });
+  }
+
 
   /**
    * Vérifie si l'utilisateur est connecté et a accès à l'entité.

package/src/api/EndpointApi.ts

@@ -2,7 +2,7 @@
 import { ApiAuthenticationError } from "../error.js";
 
 import type ApiClient from "../ApiClient.js";
-import type { DocumentListData, 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, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData } from "./EndpointApi.types.js";
+import type { DocumentListData, 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, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteMembersData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData } from "./EndpointApi.types.js";
 
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
@@ -1398,19 +1398,19 @@ export class EndpointApi {
   }
 
   /**
-   * Inviter des participants à un événement : Invite plusieurs utilisateurs ou entités à participer à un événement.
-   * Constant : INVITE_EVENT
+   * Inviter des personnes (organisation / projet / événement) : Invite des personnes à rejoindre une organisation, un projet ou un événement : nouvelles par email (`listInvite.invites` → crée des comptes citoyens « pending » + mail d'invitation) ou existantes par id (`listInvite.citoyens`/`organizations`). Membre / contributeur / participant selon le parent ; `isAdmin:"admin"` pour inviter en admin. Port de Link::invite (multiconnect).
+   * Constant : INVITE_MEMBERS
    * @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 inviteEvent(data: InviteEventData): Promise<any> {
+  async inviteMembers(data: InviteMembersData): Promise<any> {
     if (!data || typeof data !== "object") {
       throw new TypeError("Le paramètre data doit être un objet.");
     }
-    return this.callIsConnected("INVITE_EVENT", data);
+    return this.callIsConnected("INVITE_MEMBERS", data);
   }
 
   /**

package/src/api/EndpointApi.types.ts

@@ -487,7 +487,7 @@ export interface MulticonnectData {
   /**
    * Type de l'entité parente
    */
-  parentType: "citoyens" | "projects" | "organizations";
+  parentType: "citoyens" | "projects" | "organizations" | "events";
   /**
    * Liste des citoyens invités
    */
@@ -4229,7 +4229,7 @@ export interface ShareEventsData {
 }
 
 
-export interface InviteEventData {
+export interface InviteMembersData {
   /**
    * ID de l'entité parente
    */
@@ -4237,7 +4237,7 @@ export interface InviteEventData {
   /**
    * Type de l'entité parente
    */
-  parentType: "citoyens" | "projects" | "organizations";
+  parentType: "citoyens" | "projects" | "organizations" | "events";
   /**
    * Liste des citoyens invités
    */