@communecter/cocolight-api-client 1.0.182 → 1.0.184

package/package.json

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

package/types/api/Answer.d.ts

@@ -1,6 +1,5 @@
 import { BaseEntity } from "./BaseEntity.js";
 import type { AnswerItemNormalized } from "./serverDataType/Answer.js";
-import type { CommunInfo } from "./serverDataType/CommunInfo.js";
 import type { FormItemNormalized } from "./serverDataType/Form.js";
 type UploadInput = File | Blob | Buffer | import("stream").Readable;
 /**
@@ -244,19 +243,6 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
      */
     private _autoFormIdFromParent;
     form(): Promise<never>;
-    /**
-     * Fiche du **commun** rattaché à un outil : cette Answer EST la réponse AAP du commun
-     * (`communId = this.id`). `opts.formId` = **verrou de périmètre** (le serveur vérifie
-     * `answer.form === formId`, endpoint `auth: none`) : sans lui, la requête n'a pas de sens (le
-     * front ne l'émet pas). Fail-closed → **`null`** en HTTP 200 (jamais de 500) sur entrée invalide.
-     *
-     * @example
-     * const answer = await api.answer({ id: communId });
-     * const commun = await answer.getCommunInfo({ formId: communFormId }); // CommunInfo | null
-     */
-    getCommunInfo(opts?: {
-        formId?: string;
-    }): Promise<CommunInfo | null>;
     /**
      * Supprime cette Answer côté serveur via `DELETE_ELEMENT`
      * (`type=answers`, `id=this.id`).

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/Form.d.ts

@@ -2,6 +2,7 @@ import { BaseEntity } from "./BaseEntity.js";
 import type { Answer } from "./Answer.js";
 import type { PaginatorPage, PaginatorState } from "./BaseEntity.js";
 import type { CoformAnswersSearchData, DirectoryProposalCountData, DirectoryProposalData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
+import type { CommunInfo } from "./serverDataType/CommunInfo.js";
 import type { CoformCommonTableContributor, FormItemNormalized } from "./serverDataType/Form.js";
 import type { ToolsCatalogPage, ToolsCatalogParams, ToolUser, ToolUsersParams } from "./serverDataType/ToolsCatalog.js";
 /**
@@ -137,6 +138,24 @@ export declare class Form extends BaseEntity<FormItemNormalized> {
      * sont sérialisés en JSON (le fil attend une string `string[]` sérialisée).
      */
     getToolUsers(params: ToolUsersParams): Promise<ToolUser[]>;
+    /**
+     * Fiche du **commun** rattaché à un outil — `communinfo` (`auth: none`). `this.id` = le form AAP des
+     * communs (verrou de périmètre serveur : `answer.form === formId`) ; `communId` = l'`_id` de la
+     * réponse AAP du commun. Le serveur ne renvoie qu'une **projection minimale publique** (jamais le
+     * `financer[]` nominatif). Fail-closed → **`null`** en HTTP 200 sur entrée invalide (jamais de 500).
+     *
+     * Placée sur `Form` (et NON `Answer`) À DESSEIN : `api.answer({ id })` déclenche un `get()`
+     * (findanswered, auth none) qui télécharge le doc AAP COMPLET — `financer[]` nominatif inclus —
+     * dans le navigateur du visiteur, la fuite que `communinfo` est faite pour éviter. `api.form({ id })`
+     * ne charge que la définition (publique) du formulaire.
+     *
+     * @example
+     * const form = await api.form({ id: communFormId });
+     * const commun = await form.communInfo({ communId }); // CommunInfo | null
+     */
+    communInfo(params: {
+        communId: string;
+    }): Promise<CommunInfo | null>;
     /**
      * {@inheritDoc BaseEntity#answer}
      *

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;
 }