@communecter/cocolight-api-client 1.0.183 → 1.0.184

package/package.json

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

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GlobalAutocompleteAdminCostumData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, CreateInvitationLinkData, ConnectByRefData, 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, DeleteCoformAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, CostumToolsCatalogData, CostumToolUsersData, CostumCommunInfoData, CostumSaveToolEnrichmentData, CostumCommunListData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
+import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GlobalAutocompleteAdminCostumData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, CreateInvitationLinkData, ConnectByRefData, 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, DeleteCoformAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, CostumToolsCatalogData, CostumToolUsersData, CostumCommunInfoData, CostumSaveToolEnrichmentData, CostumCommunListData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, PersonValidateInvitationData, ValidateInvitationByMailData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1499,6 +1499,24 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     personActivate(data: PersonActivateData): Promise<any>;
+    /**
+     * Valider une invitation (lien email) — passerelle vers l'inscription : Vérifie la clé d'invitation (sha256(user+email)) et renvoie de quoi ouvrir le bon panneau : REGISTER pré-rempli si l'invité est `pending` (il pose son mot de passe à l'inscription — ≠ activate qui valide un compte existant), LOGIN si le compte est déjà finalisé. PASSERELLE : n'écrit RIEN (port ValidateInvitationAction). Divergence T1 : le legacy répond 302 vers #panel.box-register|login avec les params en query, ici JSON.
+     * Constant : PERSON_VALIDATE_INVITATION
+     * @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 {Error} - En cas d'erreur inattendue.
+     */
+    personValidateInvitation(data: PersonValidateInvitationData): Promise<any>;
+    /**
+     * Répondre à une invitation par e-mail (Accepter / Refuser) : Répond à une invitation depuis le lien Accepter/Refuser d'un e-mail (l'invité n'est PAS connecté). answer='true' → confirme l'adhésion (retire le flag isInviting des DEUX liens) ; answer='false' → déconnecte les deux liens. Renvoie {result,msg,next?} où next = la cible de redirection legacy : validateinvitation/.../invitation/1 si l'invité est encore tobeactivated (il pose son mot de passe à l'inscription), sinon le deep-link #page.type.<targetType>.id.<targetId>. Port ValidateInvitationByMailAction. Divergence T1 : le legacy répond 302, ici JSON. answer comparé en CHAÎNE. SÉCURITÉ : aucune validationKey sur ce lien (faiblesse legacy, versée au registre sécurité).
+     * Constant : VALIDATE_INVITATION_BY_MAIL
+     * @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 {Error} - En cas d'erreur inattendue.
+     */
+    validateInvitationByMail(data: ValidateInvitationByMailData): Promise<any>;
     /**
      * Prévisualiser un import (table de contrôle) : Construit la table d'affichage [name, address, warnings, msgError] d'une liste d'éléments déjà vérifiés (Import::createArrayList), pour prévisualiser un import avant insertion.
      * Constant : IMPORT_PREVIEW

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

@@ -6001,6 +6001,10 @@ export interface CostumToolUsersData {
      * JSON string[] serialise (optionnel)
      */
     inputKeys?: string;
+    /**
+     * Nom normalise de l'outil (normalizeToolName, la meme fonction que ToolsCatalogListAction utilise pour grouper). Filtre INDISPENSABLE en pratique : un criteriaId identifie une ligne du catalogue de BESOINS partagee par toutes les reponses, pas la saisie d'un lieu. Sans lui, le serveur remonte aussi les lieux ayant repondu au meme besoin avec un TOUT AUTRE outil. Optionnel au contrat (absent => comportement inchange, retrocompatible) ; cle-absente != chaine-vide (chaine vide desactive le filtre).
+     */
+    normalizedName?: string;
     /**
      * Slug du costum
      */
@@ -6544,6 +6548,36 @@ export interface PersonActivateData {
     validationKey: string;
     [k: string]: unknown;
 }
+export interface PersonValidateInvitationData {
+    /**
+     * Identifiant (_id) de l'invité
+     */
+    user: string;
+    /**
+     * Clé = sha256(user + email)
+     */
+    validationKey: string;
+    [k: string]: unknown;
+}
+export interface ValidateInvitationByMailData {
+    /**
+     * Identifiant (_id) de l'invité
+     */
+    userId: string;
+    /**
+     * Type de l'élément cible (organizations/projects/events)
+     */
+    targetType: string;
+    /**
+     * Identifiant (_id) de l'élément cible
+     */
+    targetId: string;
+    /**
+     * Réponse en CHAÎNE : 'true' (accepter) / 'false' (refuser)
+     */
+    answer: "true" | "false";
+    [k: string]: unknown;
+}
 export interface ImportPreviewData {
     /**
      * Liste d'éléments vérifiés à prévisualiser.

package/types/api/UserApi.d.ts

@@ -85,4 +85,48 @@ export declare class UserApi {
         user: string;
         validationKey: string;
     }): Promise<any>;
+    /**
+     * Valide un lien d'INVITATION reçu par e-mail — PASSERELLE vers l'inscription (ne modifie RIEN,
+     * ≠ {@link activateAccount} qui valide un compte existant).
+     *
+     * Endpoint public (`PERSON_VALIDATE_INVITATION`, aucune auth). Vérifie la clé `sha256(user+email)`
+     * puis indique le panneau à ouvrir : `panel:"register"` (invité `pending` — pré-rempli
+     * `email`/`name`/`pendingUserId`, il pose son mot de passe à l'inscription) ; `panel:"login"` +
+     * `error:"accountAlreadyExists"` (compte déjà finalisé) ; clé fausse → `panel:"register"`,
+     * `error:"somethingWrong"`. `error:"unknwonInvitor"` si l'invitant est introuvable.
+     *
+     * @param params.user - `_id` de l'invité.
+     * @param params.validationKey - `sha256(user + email)`.
+     * @returns `{ result, panel?, email?, name?, userValidated?, pendingUserId?, invitor?, error?, msg? }`.
+     * @throws {ApiResponseError} Si `result === false` (paramètres manquants).
+     */
+    validateInvitation({ user, validationKey }: {
+        user: string;
+        validationKey: string;
+    }): Promise<any>;
+    /**
+     * Répond à une invitation depuis le lien Accepter/Refuser d'un e-mail (l'invité n'est PAS connecté).
+     *
+     * Endpoint public (`VALIDATE_INVITATION_BY_MAIL`, aucune auth). `answer:"true"` confirme l'adhésion
+     * (retire le flag `isInviting` des deux liens), `answer:"false"` déconnecte. Renvoie
+     * `{ result, msg, next? }` où `next` = la cible de redirection legacy : le lien `validateinvitation`
+     * (→ {@link validateInvitation}) si l'invité est encore à activer (il pose alors son mot de passe),
+     * sinon le deep-link `#page.type.<targetType>.id.<targetId>`.
+     *
+     * ⚠️ Contrairement à {@link validateInvitation}, `result:false` n'est PAS levé en erreur : c'est un
+     * cas NORMAL (idempotence — un 2ᵉ « Accepter » ne retrouve plus le flag). L'appelant lit
+     * `{ result, msg, next }` uniformément et dégrade en « déjà répondu » sur `result:false`.
+     *
+     * @param params.userId - `_id` de l'invité.
+     * @param params.targetType - type de l'élément cible (organizations/projects/events).
+     * @param params.targetId - `_id` de l'élément cible.
+     * @param params.answer - `"true"` (accepter) / `"false"` (refuser), en CHAÎNE.
+     * @returns `{ result: boolean, msg: string, next?: string }`.
+     */
+    validateInvitationByMail({ userId, targetType, targetId, answer }: {
+        userId: string;
+        targetType: string;
+        targetId: string;
+        answer: "true" | "false";
+    }): Promise<any>;
 }

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

@@ -127,4 +127,11 @@ export interface ToolUsersParams {
     /** tableau brut ou déjà sérialisé — la méthode le sérialise en JSON si tableau */
     criteriaIds: string | string[];
     inputKeys?: string | string[];
+    /**
+     * Nom normalisé de l'outil (`ToolCatalogItem.normalizedName`) — à TOUJOURS transmettre en pratique :
+     * un `criteriaId` désigne une ligne du catalogue de BESOINS partagée par toutes les réponses, pas la
+     * saisie d'un lieu. Sans lui, le serveur remonte aussi les lieux ayant répondu au même besoin avec un
+     * TOUT AUTRE outil. Optionnel au contrat (rétrocompatible) ; clé-absente ≠ chaîne-vide.
+     */
+    normalizedName?: string;
 }