@communecter/cocolight-api-client 1.0.196 → 1.0.197

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@communecter/cocolight-api-client",
-  "version": "1.0.196",
+  "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, 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 } 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.
@@ -1201,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.
@@ -1816,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
          */
@@ -6203,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;
     };
@@ -8123,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/serverDataType/Ampli.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Types de l'**ampli** — l'espace de propositions d'un costum.
+ *
+ * Source de vérité : les actions legacy du module costum
+ * `controllers/actions/ampli/{CreateAmpliAction,RemoveAmpliAction}.php`, routées par
+ * `CostumizeController` sur `/costum/costumize/{createampli,removeampli}`.
+ *
+ * Un ampli n'est **pas une entité** : c'est une entrée de la carte `costum.ampli`, portée par
+ * l'élément hôte du costum (organisation, projet, citoyen ou événement) et indexée par son
+ * **slug**. D'où le placement des deux méthodes sur `BaseEntity` plutôt qu'une classe dédiée :
+ * elles s'appliquent à l'hôte, exactement comme `saveToolEnrichment`.
+ */
+/** Collections pouvant porter un costum, donc un ampli (`parentType` des deux actions). */
+export declare const AMPLI_PARENT_TYPES: readonly ["organizations", "projects", "citoyens", "events"];
+export type AmpliParentType = (typeof AMPLI_PARENT_TYPES)[number];
+/**
+ * Chemins des questions du formulaire de dépôt, forme `<idSousFormulaire>.<idQuestion>`
+ * (**sans** le préfixe `answers.`). Chaîne vide quand la question n'existe pas — `finder` l'est
+ * toujours pour un formulaire généré par le serveur.
+ */
+export interface AmpliPaths {
+    name: string;
+    description: string;
+    address: string;
+    tags: string;
+    image: string;
+    finder: string;
+}
+/**
+ * Une entrée de `costum.ampli`, telle que relue via `element/about` — quelle que soit son époque.
+ *
+ * Deux formes coexistent en base :
+ *  - les entrées écrites par `CreateAmpliAction` AVANT modules/costum@3ef97ef28 n'ont que
+ *    `{ name, description, tags, pages, home }`, et leur clé vient de `strtolower` + espace → tiret
+ *    (« Idées d'été » → `idées-d'été`) ;
+ *  - les entrées écrites depuis portent en plus `slug`, `coform` et `path` ({@link CreatedAmpliEntry}).
+ *
+ * La CLÉ de la carte `costum.ampli` reste la seule référence fiable d'un ampli existant.
+ */
+export interface AmpliEntry {
+    name: string;
+    /** Markdown, `""` si non fourni. */
+    description: string;
+    /** `null` sur une entrée ancienne créée avec des tags en tableau (`explode` d'un tableau). */
+    tags: string[] | null;
+    /** Pages Co de l'ampli (`#<page>`). Toujours vide pour une création depuis site-json. */
+    pages: string[];
+    /** Ancre de la page d'accueil Co. Toujours vide pour une création depuis site-json. */
+    home: string;
+    /** Clé de l'entrée dans `costum.ampli` — absente des entrées anciennes. */
+    slug?: string;
+    /** ObjectId du `Form` de dépôt — absent des entrées anciennes. */
+    coform?: string;
+    /** Chemins des questions du formulaire de dépôt — absents des entrées anciennes. */
+    path?: AmpliPaths;
+}
+/**
+ * L'entrée que {@link BaseEntity#createAmpli} vient d'écrire : la forme actuelle, complète.
+ */
+export interface CreatedAmpliEntry extends AmpliEntry {
+    slug: string;
+    tags: string[];
+    coform: string;
+    path: AmpliPaths;
+}
+/** Champs communs aux deux modes de {@link BaseEntity#createAmpli}. */
+interface CreateAmpliInputCommon {
+    /**
+     * Nom affiché. Le serveur en dérive la **clé** de l'entrée (`ampliSlug`) : « Idées d'été » donne
+     * `idees-d-ete`. Un nom qui ne produit aucun slug exploitable est refusé.
+     */
+    name: string;
+    /** Markdown, stocké tel quel. */
+    description?: string;
+    /** Vides et doublons sont retirés côté serveur. */
+    tags?: string[];
+}
+/**
+ * Mode A (défaut) — le **serveur crée le formulaire** : un `Form` et son sous-formulaire à cinq
+ * questions (titre, description, adresse, mots-clés, image), dont les chemins reviennent dans
+ * {@link CreatedAmpliEntry.path}. C'est le mode du parcours de création depuis site-json.
+ */
+export type CreateAmpliInputGeneratedForm = CreateAmpliInputCommon;
+/**
+ * Mode B — **rattachement à un formulaire existant** : `coform` désigne le `Form`, `namePath` et
+ * `addressPath` sont exigés par le serveur, les autres chemins sont facultatifs.
+ */
+export interface CreateAmpliInputExistingForm extends CreateAmpliInputCommon {
+    /** ObjectId du `Form` à rattacher. Sa présence bascule l'appel en mode B. */
+    coform: string;
+    namePath: string;
+    addressPath: string;
+    descriptionPath?: string;
+    tagsPath?: string;
+    imagePath?: string;
+    finderPath?: string;
+}
+/** Entrée de {@link BaseEntity#createAmpli} — le mode se lit à la présence de `coform`. */
+export type CreateAmpliInput = CreateAmpliInputGeneratedForm | CreateAmpliInputExistingForm;
+/**
+ * Retour de {@link BaseEntity#createAmpli}.
+ *
+ * `data`, `app` et `blockCms` ne servent qu'à l'interface Co (boutons de menu, carte des pages,
+ * blocs CMS) et arrivent **vides** pour un appel site-json. Ils restent au contrat pour garder une
+ * seule forme de réponse ; un appelant site-json les ignore.
+ */
+export interface CreateAmpliResult {
+    result: true;
+    /** Clé de l'entrée : permet de naviguer vers `/ampli/<slug>` sans attendre un rechargement. */
+    slug: string;
+    ampli: CreatedAmpliEntry;
+    data: unknown[];
+    app: unknown[];
+    blockCms: unknown[];
+}
+/** Retour de {@link BaseEntity#removeAmpli} — `msg` vaut `"Ampli removed"`. */
+export interface RemoveAmpliResult {
+    result: true;
+    msg: string;
+}
+export {};