@communecter/cocolight-api-client 1.0.195 → 1.0.197

package/package.json

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

package/types/api/Answer.d.ts

@@ -22,6 +22,45 @@ export interface AnswerChange {
     mutationType: "create" | "update" | "";
     changedFields: string[];
 }
+/**
+ * Résultat d'un {@link Answer#addVote} — le backend BASCULE : re-poster le
+ * MÊME statut RETIRE la réaction au lieu d'en poser une seconde.
+ *
+ * Distinguer les deux cas se lit sur `inc` (`+1` ajout / `-1` retrait) ou, de
+ * façon non ambiguë, sur la présence de `removedVoteStatus` — `msg` ne sert à
+ * rien pour ça : il vaut `"Reaction succesfully saved"` à l'ajout mais la
+ * chaîne VIDE au retrait.
+ */
+export interface AnswerVoteResult {
+    result: boolean;
+    userActionSaved?: boolean;
+    /** `+1` réaction posée, `-1` réaction retirée. */
+    inc?: number;
+    /** `""` au retrait, message traduit à l'ajout. */
+    msg?: string;
+    /** Présent UNIQUEMENT au retrait : le statut qui vient d'être enlevé. */
+    removedVoteStatus?: string;
+    user?: Record<string, unknown>;
+    element?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Résultat d'un {@link Answer#getVotes} — document projeté `{_id, vote, voteCount}`.
+ * Chaque entrée de `vote` est enrichie du profil du votant (`name`, `slug`,
+ * `profilThumbImageUrl`), ou vaut `null` si l'élément référencé est introuvable.
+ */
+export interface AnswerVotesResult {
+    vote?: Record<string, {
+        status?: string;
+        date?: unknown;
+        name?: string;
+        slug?: string;
+        profilThumbImageUrl?: string;
+        [key: string]: unknown;
+    } | null>;
+    voteCount?: Record<string, number>;
+    [key: string]: unknown;
+}
 /** Options de `Answer.generateProject()` — équivalent `costum.contextId`/`costum.contextType` legacy. */
 export interface GenerateProjectOptions {
     /** ID de l'entité parente (org/site porteur de l'appel). */
@@ -374,6 +413,56 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
      * await answer.delete();
      */
     delete(reason?: string): Promise<void>;
+    /**
+     * Ajoute OU retire une réaction sur cette réponse (`co2/action/addaction`,
+     * `collection: "answers"`).
+     *
+     * **Un seul appel pour les deux sens** : le backend bascule. Poster un statut
+     * que l'utilisateur n'a pas encore posé l'ajoute (`inc: +1`) ; re-poster le
+     * MÊME statut le retire (`inc: -1` + `removedVoteStatus`). Poster un statut
+     * DIFFÉRENT remplace le précédent. Il n'existe donc pas d'endpoint de
+     * suppression distinct — cf. {@link AnswerVoteResult}.
+     *
+     * Les compteurs vivent dans `serverData.voteCount` (map `statut → entier`) et
+     * le détail par utilisateur dans `serverData.vote` (map `userId → {status, date}`) ;
+     * ni l'un ni l'autre n'est renvoyé au serveur au save (`removeFields`).
+     * Cette instance n'est PAS resynchronisée : relire via {@link Answer#getVotes}.
+     *
+     * Droits : le serveur ne vérifie QUE la session (`AddActionAction`). N'importe quel utilisateur
+     * connecté peut réagir sur n'importe quelle réponse, y compris d'un formulaire auquel il n'a pas
+     * accès — c'est à l'appelant de n'offrir la réaction que là où elle a du sens.
+     *
+     * @param status - Statut de la réaction (`"like"`, `"love"`, `"sad"`…). Libre côté backend, mais
+     *        non vide : il devient un nom de champ (`voteCount.<status>`), et un nom vide fait
+     *        échouer l'écriture Mongo.
+     * @returns Réponse API, dont `inc` et `removedVoteStatus` disent le sens de la bascule.
+     * @throws {ApiError} 404 si la réponse n'a pas d'id (jamais sauvegardée) ; 400 statut vide.
+     *
+     * @example
+     * const res = await answer.addVote("like");
+     * const retiree = res.removedVoteStatus !== undefined;   // true = réaction ENLEVÉE
+     */
+    addVote(status: string): Promise<AnswerVoteResult>;
+    /**
+     * Récupère les réactions posées sur cette réponse.
+     *
+     * Wrap de `SHOW_VOTE` avec auto-injection du `type` (`"answers"`) et de
+     * `this.id` dans `pathParams`. Le retour contient `vote` (réactions
+     * individuelles indexées par userId, enrichies du profil du votant) et
+     * `voteCount` (compteurs par statut).
+     *
+     * Endpoint PUBLIC : les réactions et le profil des votants se lisent sans session.
+     *
+     * @returns Réponse API : `{ _id, vote, voteCount }` ou variante d'erreur — ou `null` quand l'id ne
+     *          désigne aucune réponse (le legacy renvoie le `findOne` tel quel).
+     * @throws {ApiError} 404 si la réponse n'a pas d'id (jamais sauvegardée).
+     *
+     * @example
+     * const votes = await answer.getVotes();
+     * votes?.voteCount?.like;                      // nombre de "like"
+     * votes?.vote?.[userId]?.status === "like";    // l'utilisateur a-t-il réagi ?
+     */
+    getVotes(): Promise<AnswerVotesResult | null>;
     /**
      * {@inheritDoc BaseEntity#deleteFile}
      *

package/types/api/BaseEntity.d.ts

@@ -1,6 +1,7 @@
 import type { UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, GetNewsData, GetGalleryData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestDatesData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetOrganizationsAdminData, GetOrganizationsNoAdminData, GetProjectsAdminData, GetProjectsNoAdminData, GetPoisAdminData, GetPoisNoAdminData, GetSubscribersData, GetBadgesData, CoformAnswersSearchData, SearchMemberAutocompleteData, GetEventsData, SearchEventsCostumData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, ZoneGetShapeData, ZoneGetZonirisData, CoformAnswersByFormsData, FundingEnvelopeData, CoremuOperationData, UpdatePathValueData } from "./EndpointApi.types.js";
 import type { CostumRuntimeContext } from "../costum/runtime.js";
 import type { TransformsMap } from "../types/entities.js";
+import type { AmpliParentType, CreateAmpliInput, CreateAmpliResult, RemoveAmpliResult } from "./serverDataType/Ampli.js";
 import type { CountryItem } from "./serverDataType/Country.js";
 import type { ToolEnrichmentInput, ToolEnrichmentResult, CommunListItem } from "./serverDataType/ToolsCatalog.js";
 import type { ZoneItemNormalized, ZoneShapeItem, ZonirisShapeItem } from "./serverDataType/Zone.js";
@@ -2692,6 +2693,75 @@ export declare class BaseEntity<TServerData = any> {
      * costum peut être un projet). `formId` en argument positionnel. Retourne le tableau NU.
      */
     getCommunList(formId: string): Promise<CommunListItem[]>;
+    /**
+     * Contexte de l'élément PORTEUR du costum, tel que les deux actions ampli l'exigent.
+     *
+     * Volontairement PAS `_withCostumContext` : ces actions ne lisent ni `contextId` ni `sourceKey`,
+     * elles nomment les mêmes valeurs `parentId`/`parentType`/`parentName`, et leur contrat est en
+     * `additionalProperties:false` — les alias historiques injectés par le helper y seraient rejetés
+     * par l'AJV du client avant même l'envoi.
+     *
+     * Lit `serverData` et non le brouillon : le serveur relit l'élément en base (`PHDB::findOne`),
+     * un slug modifié mais non sauvegardé désignerait un costum qui n'existe pas.
+     */
+    protected _requireAmpliHost(): {
+        id: string;
+        type: AmpliParentType;
+        slug: string;
+    };
+    /**
+     * Crée un **ampli** sur cette entité : une entrée de `costum.ampli`, l'espace de propositions du
+     * costum qu'elle porte.
+     *
+     * BEARER + gate admin serveur (`isInterfaceAdmin`). Porté par `BaseEntity` — comme
+     * {@link saveToolEnrichment} — parce que l'hôte d'un costum peut être une organisation, un
+     * projet, un citoyen ou un événement, et qu'un ampli n'est pas une entité mais une clé de costum.
+     *
+     * DEUX MODES, exclusifs, distingués par la présence de `coform` :
+     *  - sans `coform` (défaut) : le serveur crée le `Form` de dépôt et ses cinq questions, et renvoie
+     *    les chemins obtenus dans `ampli.path` ;
+     *  - avec `coform` : rattachement à un formulaire existant, `namePath` et `addressPath` exigés.
+     *
+     * ⚠ Le serveur dérive la CLÉ de l'entrée du `name` et **écrase** une entrée de même clé, sans
+     * garde. Un appelant qui a déjà la liste des amplis doit tester la collision avec le helper `ampliSlug`.
+     *
+     * Le cache costum est réinitialisé côté serveur après écriture : `element/about` renvoie le nouvel
+     * ampli immédiatement, sans `resetcache`.
+     *
+     * Exige `CreateAmpliAction` de modules/costum@3ef97ef28 ou postérieur (lecture de `source`, clé
+     * `slugifyLikeJS`, réponse `{slug, ampli}`). Face à une version antérieure, l'action écrit tout le
+     * parcours Co et répond sans `slug` : la méthode lève alors au lieu de rendre un résultat incomplet.
+     *
+     * @param input - Nom, description, mots-clés, et le formulaire en mode B.
+     * @returns `{ result, slug, ampli, … }` — `slug` permet d'atteindre `/ampli/<slug>` sans recharger.
+     * @throws {ApiError} 404 entité non enregistrée ; 400 slug manquant, hôte de type impossible,
+     *         nom inexploitable, ou mode B incomplet.
+     * @throws {ApiResponseError} Refus métier du serveur (droits, paramètre manquant) — il arrive en
+     *         HTTP 200 `{result:false}`, que `checkAndThrowApiResponseError` convertit en exception —, ou
+     *         réponse sans `slug` (action legacy antérieure au patch).
+     *
+     * @example
+     * const { slug } = await orga.createAmpli({ name: "Idées d'été", tags: ["proposition"] });
+     * // → navigation vers `/ampli/idees-d-ete`
+     */
+    createAmpli(input: CreateAmpliInput): Promise<CreateAmpliResult>;
+    /**
+     * Supprime un ampli de `costum.ampli`, avec ses pages CMS et son bouton de menu s'il en a.
+     *
+     * ⚠ DEUX EFFETS DE BORD du legacy, non corrigés ici :
+     *  - le `Form` de dépôt et ses réponses **survivent** : un ampli créé en mode A puis supprimé
+     *    laisse son formulaire derrière lui ;
+     *  - l'action réécrit `costum.app` et le `buttonList` du menu à partir du costum **résolu en
+     *    cache** (`Costum::init`), pas du sous-document en base. Pour un costum dont la config vient
+     *    d'un fichier JSON, la suppression matérialise donc cette config dans le document de l'hôte.
+     *
+     * @param ampliId - La CLÉ de l'entrée, lue dans `costum.ampli` ou renvoyée par `createAmpli` — pas
+     *        un ObjectId, et jamais un slug recalculé depuis le nom : les entrées anciennes ont une clé
+     *        d'une autre forme (`idées-d'été`), que `ampliSlug` ne reproduit pas.
+     * @throws {ApiError} 404 entité non enregistrée ; 400 slug manquant ou hôte de type impossible.
+     * @throws {ApiResponseError} `Ampli not found`, `ampliId is required`, ou refus de droits.
+     */
+    removeAmpli(ampliId: string): Promise<RemoveAmpliResult>;
     /**
      * @param data
      *        Paramètres de recherche (partiels — les valeurs manquantes sont complétées

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, ContactSendData, 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, NavigatorGetRessourceTlData, 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, GenerateProjectFromAnswerData, GenerateMilestoneFromDepenseData, FundingEnvelopeData, CoremuOperationData, CoremuAddFinancerData, CoremuPayFinancerData, CoremuValidateFinancerPaymentData, CoremuDeleteFinancerData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, PersonValidateInvitationData, ValidateInvitationByMailData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, TransferSourceCheckData, TransferSourceApplyData, TransferSourceRollbackData, TransferSourceHistoryData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, CostumResolvedData, 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, ContactSendData, 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, LinkSetRolesData, 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, NavigatorGetRessourceTlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, AgendaGetPdfData, 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, GenerateProjectFromAnswerData, GenerateMilestoneFromDepenseData, FundingEnvelopeData, CoremuOperationData, CoremuAddFinancerData, CoremuPayFinancerData, CoremuValidateFinancerPaymentData, CoremuDeleteFinancerData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, PersonValidateInvitationData, ValidateInvitationByMailData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, TransferSourceCheckData, TransferSourceApplyData, TransferSourceRollbackData, TransferSourceHistoryData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, CostumResolvedData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData, CostumCreateAmpliData, CostumRemoveAmpliData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -395,7 +395,7 @@ export declare class EndpointApi {
      */
     searchTags(data: SearchTagsData): Promise<any>;
     /**
-     * Afficher les votes d'une actualité/commentaire : Récupère la liste des votes (like, love, etc.) sur une actualité/commentaire.
+     * Afficher les votes d'une actualité, d'un commentaire ou d'une réponse de formulaire : Récupère la liste des votes (like, love, etc.) sur une actualité, un commentaire ou une réponse de formulaire (coform).
      * Constant : SHOW_VOTE
      * @param data - Données envoyées à l'API
      * @returns Les données de réponse.
@@ -630,6 +630,16 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     connect(data: ConnectData): Promise<any>;
+    /**
+     * Définir les rôles d'un lien : Remplace INTÉGRALEMENT les rôles d'un lien existant (ou en pose un premier), des deux côtés : `links.<connectType>.<childId>.roles` sur le contexte et `links.<memberOf|projects|events>.<contextId>.roles` sur l'enfant. Malgré le nom du chemin legacy (Link::removeRole, citizenToolKit/models/Link.php:866-917), ce n'est PAS un retrait sélectif : `roles` non vide → `$set` du tableau envoyé ; `roles` vide ou absent → `$unset` (tous les rôles effacés). L'appelant envoie donc la liste COMPLÈTE voulue. Réservé aux admins du contexte au sens d'Authorisation::isElementAdmin — lien admin, admin du parent (ou de l'organisateur d'un événement), super-admin, admin du costum transmis (sinon {result:false, msg:"You are not admin of the Organization : <id>"}, HTTP 200). Le lien doit EXISTER : le backend Node refuse sinon ({result:false, msg:"The actor (<id> / <type>) is not linked to this element"}), le legacy l'écrirait (BUG-L-267).
+     * Constant : LINK_SET_ROLES
+     * @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.
+     */
+    linkSetRoles(data: LinkSetRolesData): Promise<any>;
     /**
      * Générer un lien d'invitation partageable : Génère une URL d'invitation partageable /co2/link/connect/ref/<ref> vers un élément (organizations/projects/events). Tout citoyen connecté qui suit le lien rejoint l'élément IMMÉDIATEMENT (member, ou admin si isAdmin). L'appelant doit être ADMIN de la cible (ou super-admin). ⚠ Durcissements vs legacy : whitelist stricte des champs (pas de mass-assignment du body), ref cryptographique (le legacy dérivait uniqid()). Deux appels (isAdmin=true / false) alimentent costum.invitationLink / costum.invitationLinkAsMember côté UI.
      * Constant : CREATE_INVITATION_LINK
@@ -1048,6 +1058,15 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     costumEventRequestLoadContextTag(data: CostumEventRequestLoadContextTagData): Promise<any>;
+    /**
+     * PDF imprimable de l'agenda d'un costum : Édition imprimable (PDF binaire, application/pdf) de l'agenda d'un costum : sous-événements de l'entité PORTEUSE du costum (id/type de l'entité, pas d'un événement), triés par date d'occurrence. Port de costum/controllers/actions/coevent/pdf/GetPdfAction.php. Tout paramètre GET non réservé (id, type, costum_slug, startDate, vue, rest, tab) filtre les sous-événements sur le champ top-level du même nom, en `$in` insensible à la casse sur une liste séparée par des virgules — d'où `additionalProperties` ouvert : les facettes propres à un site (ex. territoires/publics/thèmes de parent62) n'ont pas à être nommées ici.
+     * Constant : AGENDA_GET_PDF
+     * @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.
+     */
+    agendaGetPdf(data: AgendaGetPdfData): Promise<any>;
     /**
      * Récupération de la galerie : Renvoie soit la liste d’albums associés à une entité, soit les images d’un album spécifique.
      * Constant : GET_GALLERY
@@ -1182,7 +1201,7 @@ export declare class EndpointApi {
      */
     getCoformCommontableContributors(data: GetCoformCommontableContributorsData): Promise<any>;
     /**
-     * Voter sur un élément (commentaire ou news) : Permet de voter sur un commentaire ou une news en spécifiant un statut de vote
+     * Voter sur un élément (commentaire, news ou réponse de formulaire) : Permet de voter sur un commentaire, une news ou une réponse de formulaire (coform) en spécifiant un statut de vote. Re-poster le MÊME statut retire le vote (bascule) : la réponse porte alors removedVoteStatus et inc:-1.
      * Constant : ADD_VOTE
      * @param data - Données envoyées à l'API
      * @returns Les données de réponse.
@@ -1797,5 +1816,25 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     directoryProposalNewCounter(data: DirectoryProposalNewCounterData): Promise<any>;
+    /**
+     * Créer un ampli : Crée une entrée dans costum.ampli de l'élément porteur du costum. Avec source=site-json aucune page CMS, aucun bloc cms ni bouton de menu n'est écrit. Gate isInterfaceAdmin, résolu par costumSlug (refus en HTTP 200 result:false). Le cache costum est réinitialisé après écriture : element/about renvoie le nouvel ampli immédiatement.
+     * Constant : COSTUM_CREATE_AMPLI
+     * @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.
+     */
+    costumCreateAmpli(data: CostumCreateAmpliData): Promise<any>;
+    /**
+     * Supprimer un ampli : Retire une entrée de costum.ampli, ses pages CMS et son bouton de menu s'il en a. Ne supprime NI le Form NI ses réponses. Gate isInterfaceAdmin (refus en HTTP 200 result:false).
+     * Constant : COSTUM_REMOVE_AMPLI
+     * @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.
+     */
+    costumRemoveAmpli(data: CostumRemoveAmpliData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -1118,9 +1118,9 @@ export interface SearchTagsData {
 export interface ShowVoteData {
     pathParams?: {
         /**
-         * Type de l'élément
+         * Type de l'élément (collection Mongo)
          */
-        type: "news" | "comments";
+        type: "news" | "comments" | "answers";
         /**
          * ID de l'élément dont on veut récupérer les votes
          */
@@ -2928,6 +2928,49 @@ export interface ConnectData {
      * Type de connexion
      */
     connectType: "admin" | "member" | "contributor" | "attendee" | "friend" | "connect";
+    /**
+     * Rôles à poser sur le lien (`links.<connectType>.<childId>.roles`, des deux côtés). Lu par ConnectAction ($_POST["roles"]) : fusionné AVANT les rôles déjà portés par le lien côté enfant (array_merge), puis écrit par Link::connect. Effectif à la CRÉATION d'un lien, et lors d'une promotion admin (connectType=admin sur un membre non admin : rôles fusionnés puis écrits). Sur un lien déjà établi du même statut, Link::connectParentToChild répond « already member » avant toute écriture — pour modifier les rôles d'un lien établi, utiliser LINK_SET_ROLES.
+     */
+    roles?: string[];
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
+    [k: string]: unknown;
+}
+export interface LinkSetRolesData {
+    /**
+     * ID de l'entité porteuse du lien (organisation, projet, événement)
+     */
+    contextId: string;
+    /**
+     * Type de l'entité porteuse
+     */
+    contextType: "organizations" | "projects" | "events";
+    /**
+     * ID du membre / contributeur / participant
+     */
+    childId: string;
+    /**
+     * Type du membre
+     */
+    childType: "citoyens" | "organizations";
+    /**
+     * Clé du lien côté contexte
+     */
+    connectType: "members" | "contributors" | "attendees";
+    /**
+     * Liste COMPLÈTE des rôles voulus. Vide → efface tous les rôles du lien ($unset). Valeurs écrites telles quelles (pas de trim côté legacy pour un tableau).
+     */
+    roles?: string[];
     /**
      * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
      */
@@ -5621,6 +5664,29 @@ export interface CostumEventRequestLoadContextTagData {
     };
     [k: string]: unknown;
 }
+export interface AgendaGetPdfData {
+    /**
+     * ID de l'entité porteuse du costum
+     */
+    id: string;
+    /**
+     * Collection de l'entité porteuse
+     */
+    type: "organizations" | "projects" | "events" | "citoyens";
+    /**
+     * Slug du costum (réchauffe le cache costum legacy avant le rendu)
+     */
+    costum_slug: string;
+    /**
+     * Borne basse temporelle (interprétée par strtotime côté legacy, ex. 2026-10-01) : startDate >= cette date.
+     */
+    startDate?: string;
+    /**
+     * Tags séparés par des virgules. ⚠️ Passe par le filtre GET générique : sémantique OU (`$in`, insensible à la casse), pas ET — le filtre ET (`$all`) du legacy n'est lu que dans un corps JSON, absent en GET.
+     */
+    tags?: string;
+    [k: string]: unknown;
+}
 export interface GetGalleryData {
     /**
      * Clé de contenu pour correspondre à l'album ou aux images
@@ -6137,20 +6203,20 @@ export interface GetCoformCommontableContributorsData {
 }
 export interface AddVoteData {
     /**
-     * ID de l'élément (commentaire ou news) sur lequel voter
+     * ID de l'élément (commentaire, news ou réponse de formulaire) sur lequel voter
      */
     id: string;
     /**
-     * Type de collection concernée
+     * Type de collection concernée. `answers` = réponse de formulaire coform (Action.php lit la collection sans liste blanche : seule l'action est restreinte).
      */
-    collection: "comments" | "news";
+    collection: "comments" | "news" | "answers";
     /**
      * Type d'action à effectuer (vote)
      */
     action: "vote";
     details: {
         /**
-         * Statut du vote (ex: 'like', 'dislike', etc.)
+         * Statut du vote (ex: 'like', 'dislike', etc.). Non vide : il devient un nom de champ (voteCount.<status>), un nom vide fait échouer l'écriture Mongo (legacy comme Node).
          */
         status: string;
     };
@@ -8057,3 +8123,89 @@ export interface DirectoryProposalNewCounterData {
     };
     [k: string]: unknown;
 }
+export interface CostumCreateAmpliData {
+    /**
+     * Origine de l'appel, matérialisée par AJV (useDefaults) : l'appelant n'a pas à la poser. Seules 'co' (interface Communecter) et 'site-json' sont acceptées serveur ; 'co' n'est PAS au contrat car elle génère les pages CMS du parcours Co.
+     */
+    source: "site-json";
+    /**
+     * Nom affiché. Le serveur en dérive la CLÉ de l'entrée (InflectorHelper::slugifyLikeJS : accents retirés, non-alphanumériques en tirets, minuscules). Un nom qui ne produit aucun slug exploitable ('' ou 'n-a') est refusé. ATTENTION : un slug déjà pris ÉCRASE l'entrée existante, aucune garde serveur.
+     */
+    name: string;
+    /**
+     * Markdown, stocké tel quel.
+     */
+    description?: string;
+    /**
+     * Sérialisé tags[]=a&tags[]=b, relu en tableau par PHP. Vides et doublons retirés côté serveur.
+     */
+    tags?: string[];
+    /**
+     * ObjectId de l'élément porteur du costum.
+     */
+    parentId: string;
+    /**
+     * Collection de l'élément porteur du costum.
+     */
+    parentType: "organizations" | "projects" | "citoyens" | "events";
+    /**
+     * Slug de l'élément porteur : préfixe des identifiants du formulaire généré en MODE A, et nom du parent du Form créé.
+     */
+    parentName: string;
+    /**
+     * Slug de l'élément porteur du costum. REQUIS pour le gate : isInterfaceAdmin() est appelé sans id ni type, il n'accepte qu'un super-admin ou un admin du costum RÉSOLU — et beforeAction → costumCacheParams() ne résout le costum que si $_POST[costumSlug] est présent. Sans lui, un admin de costum ordinaire reçoit « You don't have the right to access this feature ».
+     */
+    costumSlug: string;
+    /**
+     * MODE A : le serveur crée le Form et son sous-formulaire (titre, description, adresse, mots-clés, image) et renvoie les chemins obtenus. Exclusif de coform/*Path. Durci serveur par filter_var(FILTER_VALIDATE_BOOLEAN) : la chaîne 'false' du fil form-urlencoded est bien lue comme faux.
+     */
+    new?: boolean;
+    /**
+     * MODE B : ObjectId du Form existant à rattacher. Exige namePath et addressPath non vides.
+     */
+    coform?: string;
+    /**
+     * MODE B, requis : chemin <idSousFormulaire>.<idQuestion> (SANS le préfixe answers.) de la question titre.
+     */
+    namePath?: string;
+    /**
+     * MODE B : chemin de la question description.
+     */
+    descriptionPath?: string;
+    /**
+     * MODE B, requis : chemin de la question adresse.
+     */
+    addressPath?: string;
+    /**
+     * MODE B : chemin de la question mots-clés.
+     */
+    tagsPath?: string;
+    /**
+     * MODE B : chemin de la question image.
+     */
+    imagePath?: string;
+    /**
+     * MODE B : chemin du finder. Toujours '' en MODE A.
+     */
+    finderPath?: string;
+    [k: string]: unknown;
+}
+export interface CostumRemoveAmpliData {
+    /**
+     * CLÉ de l'entrée dans costum.ampli, c'est-à-dire le slug renvoyé à la création (PAS un ObjectId).
+     */
+    ampliId: string;
+    /**
+     * ObjectId de l'élément porteur du costum.
+     */
+    parentId: string;
+    /**
+     * Collection de l'élément porteur du costum.
+     */
+    parentType: "organizations" | "projects" | "citoyens" | "events";
+    /**
+     * Slug de l'élément porteur. REQUIS, et pas décoratif : l'action appelle CacheHelper::getCostum($parentType, $parentId) alors que la signature est ($id, $type, $slug) — arguments inversés — et la résolution retombe en pratique sur $_POST[costumSlug]. L'interface Co l'envoie sans le savoir (ajaxPost l'injecte dans tout POST du module costum) ; un client externe doit le fournir explicitement. Inversion non corrigée : antérieure, et elle touche l'appelant Co.
+     */
+    costumSlug: string;
+    [k: string]: unknown;
+}

package/types/api/Event.d.ts

@@ -9,7 +9,7 @@ export declare class Event extends BaseEntity<EventItemNormalized> {
     /** Bloc de création où injecter les champs costum (CostumScope). */
     static COSTUM_ADD_CONSTANT: string;
     static SCHEMA_CONSTANTS: string[];
-    static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "ADD_EVENT", "updateImageProfil" | "addEvent">;
+    static ADD_BLOCKS: Map<"ADD_EVENT" | "PROFIL_IMAGE", "addEvent" | "updateImageProfil">;
     static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateSlug">;
     defaultFields: Record<string, any>;
     removeFields: string[];

package/types/api/Organization.d.ts

@@ -95,8 +95,8 @@ export declare class Organization extends BaseEntity<OrganizationItemNormalized>
         readonly updateMethod: "updateVideo";
         readonly schemaConstant: "VIRTUAL_ORG_BASE_FIELDS";
     }>;
-    static ADD_BLOCKS: Map<"UPDATE_BLOCK_SOCIAL" | "PROFIL_IMAGE" | "ADD_ORGANIZATION", "updateImageProfil" | "updateSocial" | "addOrganization">;
-    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_SOCIAL" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateDescription" | "updateSocial" | "updateLocality" | "updateInfo" | "updateSlug">;
+    static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "UPDATE_BLOCK_SOCIAL" | "ADD_ORGANIZATION", "updateImageProfil" | "updateSocial" | "addOrganization">;
+    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE" | "UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SOCIAL", "updateImageProfil" | "updateSlug" | "updateDescription" | "updateLocality" | "updateInfo" | "updateSocial">;
     defaultFields: Record<string, any>;
     removeFields: string[];
     transforms: Record<string, (val: any, full: any) => any>;

package/types/api/Poi.d.ts

@@ -8,7 +8,7 @@ export declare class Poi extends BaseEntity<PoiItemNormalized> {
     static COSTUM_ADD_CONSTANT: string;
     static SCHEMA_CONSTANTS: string[];
     static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "ADD_POI", "updateImageProfil" | "addPoi">;
-    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateDescription" | "updateLocality" | "updateInfo" | "updateSlug">;
+    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE" | "UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_LOCALITY", "updateImageProfil" | "updateSlug" | "updateDescription" | "updateLocality" | "updateInfo">;
     defaultFields: Record<string, any>;
     removeFields: string[];
     transforms: Record<string, (val: any, full?: any) => any>;

package/types/api/Project.d.ts

@@ -12,8 +12,8 @@ export declare class Project extends BaseEntity<ProjectItemNormalized> {
     /** Bloc de création où injecter les champs costum (CostumScope). */
     static COSTUM_ADD_CONSTANT: string;
     static SCHEMA_CONSTANTS: string[];
-    static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "ADD_PROJECT", "addProject" | "updateImageProfil">;
-    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_SOCIAL" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateDescription" | "updateSocial" | "updateLocality" | "updateInfo" | "updateSlug">;
+    static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "ADD_PROJECT", "updateImageProfil" | "addProject">;
+    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE" | "UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SOCIAL", "updateImageProfil" | "updateSlug" | "updateDescription" | "updateLocality" | "updateInfo" | "updateSocial">;
     defaultFields: Record<string, any>;
     removeFields: string[];
     transforms: ProjectTransforms;

package/types/api/User.d.ts

@@ -14,7 +14,7 @@ export declare class User extends BaseEntity<UserItemNormalized> {
     static entityType: "citoyens";
     static entityTag: string;
     static SCHEMA_CONSTANTS: string[];
-    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_SOCIAL" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateDescription" | "updateSocial" | "updateLocality" | "updateInfo" | "updateSlug">;
+    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE" | "UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SOCIAL", "updateImageProfil" | "updateSlug" | "updateDescription" | "updateLocality" | "updateInfo" | "updateSocial">;
     defaultFields: Record<string, any>;
     removeFields: string[];
     transforms: Record<string, (val: any, full: any) => any>;
@@ -742,6 +742,9 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      *
      * @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)
+     * @param {string[]} [options.roles] - Rôles à poser sur le lien CRÉÉ (transmis à `CONNECT`, écrits des deux
+     *   côtés). Omis ou vide → corps inchangé. Ne sert qu'à la création : pour corriger les rôles d'un lien
+     *   déjà établi, utiliser {@link User.setRoles}.
      * @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
@@ -757,10 +760,14 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      *
      * // Avec le type admin explicite
      * await user.sendRequestToJoinParent({ admin: true });
+     *
+     * // Avec des rôles posés dès l'invitation
+     * await user.sendRequestToJoinParent({ roles: ["Coordonnatrice parentalité Arrageois"] });
      * ```
      */
-    sendRequestToJoinParent({ admin }?: {
-        admin: boolean;
+    sendRequestToJoinParent({ admin, roles }?: {
+        admin?: boolean;
+        roles?: string[];
     }): Promise<unknown>;
     /**
      * Valide une demande de membre en attente de validation.
@@ -845,6 +852,35 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * ```
      */
     promoteToAdmin(): Promise<unknown>;
+    /**
+     * Définit les rôles de cet utilisateur sur son lien avec l'entité parente (`LINK_SET_ROLES`).
+     *
+     * ⚠️ REMPLACEMENT INTÉGRAL, pas un ajout/retrait : le tableau envoyé devient la liste des rôles du lien,
+     * des deux côtés (contexte et citoyen). Pour ajouter un rôle, envoyer les rôles actuels + le nouveau ;
+     * pour en retirer un, les rôles actuels privés de celui-ci. **`setRoles([])` efface TOUS les rôles**
+     * (`$unset` côté backend).
+     *
+     * Réservé aux admins de l'entité parente (organisation, projet ou événement). Le lien doit exister.
+     * Le backend répond HTTP 200 avec `{result:false}` en cas de refus : l'erreur est levée en `ApiResponseError`.
+     * Le contexte costum du PARENT est transmis (droit d'admin du costum, comme les autres actions de lien).
+     *
+     * @param roles - Liste COMPLÈTE des rôles voulus (vide = tout effacer).
+     * @returns La réponse de l'API (`{result, msg, memberOfid, memberid, roles}`).
+     * @throws {ApiError} Si le parent n'est pas défini, si l'appelant n'en est pas admin, ou si l'utilisateur
+     *   n'a aucun lien avec le parent.
+     * @throws {ApiResponseError} Si le backend refuse (ex. non admin côté serveur).
+     *
+     * @example
+     * ```typescript
+     * const org = await me.organization({ slug: "parent62" });
+     * const { results } = await org.getMembers();
+     * const membre = results[0];
+     * // Source fiable des rôles actuels : le lien côté ORGANISATION (links.members.<id>.roles).
+     * const actuels = org.serverData.links?.members?.[membre.id!]?.roles ?? [];
+     * await membre.setRoles([...actuels, "Coordonnatrice parentalité Arrageois"]);
+     * ```
+     */
+    setRoles(roles: string[]): Promise<unknown>;
     /**
      * Rétrograde un admin au statut de membre ordinaire.
      *