@communecter/cocolight-api-client 1.0.196 → 1.0.198

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@communecter/cocolight-api-client",
-  "version": "1.0.196",
+  "version": "1.0.198",
   "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";
@@ -533,9 +534,22 @@ export declare class BaseEntity<TServerData = any> {
      *
      * L'univers des champs éditables = `_allowedFieldsCache` (union writable des SCHEMA_CONSTANTS + schéma costum,
      * calculée au build du draft) ∪ champs DATA costum déclarés (robuste si le cache est antérieur au costum).
+     *
+     * `opts.onlyKeys` (chemin HYBRIDE, cf. `User._update`) : restreint l'univers à CES clés — l'`element/save`
+     * ne porte alors que les champs costum, les blocs `updateblock` standards gardant les leurs. L'image
+     * (`profil_avatar`) suit la même règle : elle n'est traitée ici que si elle fait partie des clés demandées.
      * @returns true si au moins un champ a été envoyé (donc refresh ensuite).
      */
-    protected _saveCostumViaElementSave(payload: Record<string, any>): Promise<boolean>;
+    protected _saveCostumViaElementSave(payload: Record<string, any>, opts?: {
+        onlyKeys?: Iterable<string>;
+    }): Promise<boolean>;
+    /**
+     * Clés WRITABLE d'une constante de schéma (contrat, ⊕ `VIRTUAL_SCHEMAS` de l'entité), évaluées pour
+     * `data` (les branches `if/then` sur `typeElement` sont résolues comme au build du draft). Sert au
+     * chemin hybride (`User._update`) à séparer ce que les blocs standards savent envoyer de ce qui ne
+     * peut partir que par `element/save`. Constante inconnue → `[]`.
+     */
+    protected _writableFieldsOf(constant: string, data?: Record<string, unknown>): string[];
     /** Recherche le schéma d'une propriété dans un schéma combiné `{ allOf: [...] }` (1er match). */
     private _lookupPropSchema;
     /**
@@ -2692,6 +2706,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, SaveCitoyenData, 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
  */
@@ -57,7 +57,7 @@ export declare class EndpointApi {
      */
     documentList(data: DocumentListData): Promise<any>;
     /**
-     * Enregistrement d'un utilisateur : Permet d’enregistrer un nouvel utilisateur avec ses informations personnelles.
+     * Enregistrement d'un utilisateur : Permet d’enregistrer un nouvel utilisateur avec ses informations personnelles. Accepte des champs supplémentaires validés côté serveur (règle costum citoyens, cf. $comment de la requête) et le mode `single_step_register` (compte actif d'emblée).
      * Constant : PERSON_REGISTER
      * @param data - Données envoyées à l'API
      * @returns Les données de réponse.
@@ -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.
@@ -719,6 +719,16 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     addOrganization(data: AddOrganizationData): Promise<any>;
+    /**
+     * Sauvegarder un citoyen (profil + champs costum) : Met à jour un citoyen EXISTANT via element/save (collection=citoyens) : le SEUL chemin legacy qui accepte les champs costum d'une personne (DataValidator::validate étend Person::$dataBinding avec typeObj person/persons/citoyens du costum posté). Droit : soi-même ou super-admin (jamais un admin de costum : Authorisation.php:271). JAMAIS de création : `id` est requis (la lib refuse User._add). Les champs sont écrits à la RACINE du citoyen. cf. cocolight-backend docs/33.
+     * Constant : SAVE_CITOYEN
+     * @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.
+     */
+    saveCitoyen(data: SaveCitoyenData): Promise<any>;
     /**
      * Créer un projet : Crée un nouveau projet avec des informations de base et des options supplémentaires.
      * Constant : ADD_PROJECT
@@ -1201,7 +1211,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 +1826,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

@@ -38,9 +38,9 @@ export interface PersonRegisterData {
      */
     pendingUserId?: string;
     /**
-     * Mode d’enregistrement
+     * Mode d'inscription (Person::REGISTER_MODE_*). `normal` (défaut) : le compte est créé avec `roles.tobeactivated` et ne peut se connecter qu'après validation de l'e-mail. `single_step_register` : compte ACTIF immédiatement (pas de tobeactivated ; un username déjà pris est suffixé d'un nombre au lieu d'être refusé) ; le mail de confirmation d'adresse part quand même (variante « compte déjà actif »). Les autres modes legacy (two_steps_register, email, service, minimal) ne sont pas exposés.
      */
-    mode?: string;
+    mode?: "normal" | "single_step_register";
     /**
      * Indique s’il s’agit d’une invitation (facultatif)
      */
@@ -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
          */
@@ -3436,6 +3436,48 @@ export interface AddOrganizationData {
     };
     [k: string]: unknown;
 }
+export interface SaveCitoyenData {
+    /**
+     * ID du citoyen (requis : mise à jour seule)
+     */
+    id: string;
+    collection: "citoyens";
+    key?: "person";
+    name?: string;
+    username?: string;
+    email?: string;
+    shortDescription?: string;
+    description?: string;
+    url?: string;
+    tags?: "" | string[];
+    birthDate?: string;
+    mobile?: string;
+    fixe?: string;
+    telephone?: {
+        [k: string]: unknown;
+    };
+    address?: {
+        [k: string]: unknown;
+    } | string;
+    geo?: {
+        [k: string]: unknown;
+    };
+    geoPosition?: {
+        [k: string]: unknown;
+    };
+    /**
+     * Type de professionnel (champ du modèle Person, cf. docs/33)
+     */
+    typepro?: string;
+    /**
+     * Précision quand typepro vaut « autres »
+     */
+    othersTypepro?: string;
+    costumSlug?: string;
+    costumId?: string;
+    costumType?: string;
+    [k: string]: unknown;
+}
 export interface AddProjectData {
     /**
      * ID
@@ -6203,20 +6245,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 +8165,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/User.d.ts

@@ -13,6 +13,14 @@ type UserItemNormalized = import("./serverDataType/User.js").UserItemNormalized;
 export declare class User extends BaseEntity<UserItemNormalized> {
     static entityType: "citoyens";
     static entityTag: string;
+    /**
+     * UN SEUL chemin d'écriture pour les champs COSTUM d'un citoyen : `element/save` collection=citoyens
+     * (`SAVE_CITOYEN`, mise à jour seule) — le seul que le legacy fasse passer par `DataValidator::validate`
+     * avec le costum posté (`updateblock`/`updatefield` rejettent ou ignorent). Mise à jour UNIQUEMENT :
+     * `_add` reste 403, aucune création de citoyen par la lib (docs/33 backend §2). Lu par
+     * `_saveCostumViaElementSave` (appelée par `_update` en HYBRIDE, pas pour tout l'update).
+     */
+    static COSTUM_ADD_CONSTANT: string;
     static SCHEMA_CONSTANTS: string[];
     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>;
@@ -128,7 +136,23 @@ export declare class User extends BaseEntity<UserItemNormalized> {
     save(): Promise<Record<string, any>>;
     _add: () => Promise<never>;
     /**
-     * Met à jour les blocs modifiés de l'utilisateur via les constantes de schéma définies.
+     * Clés que SEUL le costum sait écrire : les champs déclarés par le contexte costum (`_costumCtx.schema.
+     * properties` ∪ `fields`) MOINS ceux qu'un bloc `updateblock` standard porte déjà (`UPDATE_BLOCKS`,
+     * évalués pour `typeElement:"citoyens"`). Un costum legacy redéclare volontiers `name`/`email`/`tags`
+     * (widget du form) : ces clés restent aux blocs standards, dont la sémantique est propre. Vide sans
+     * contexte costum à champs.
+     */
+    private _costumOnlyKeys;
+    /**
+     * Met à jour l'utilisateur — chemin HYBRIDE (docs/33 backend) :
+     *  1. les champs COSTUM modifiés (`_costumOnlyKeys`) partent en UN `element/save` collection=citoyens
+     *     (`SAVE_CITOYEN`, enveloppe costum `isUpdate`, même règle d'effacement → `""` que
+     *     `_saveCostumViaElementSave`, dont c'est l'appel filtré) ;
+     *  2. PUIS les blocs `updateblock` standards (description, social, locality, info, slug, image) portent
+     *     les champs standards, en EXCLUANT les clés costum.
+     * Contrairement à `Organization`, l'update entier n'est PAS routé vers `element/save` : les blocs du
+     * citoyen (slug, locality, social, image) ont une sémantique propre. Sans contexte costum, comportement
+     * historique inchangé (blocs seuls).
      *
      * @param payload - Données courantes à comparer et envoyer.
      * @returns - Indique s'il y a eu une modification réelle.

package/types/api/UserApi.d.ts

@@ -47,10 +47,23 @@ export declare class UserApi {
      * @param params.costumSlug - (option) slug du costum de déploiement → estampille `source.key` du citoyen
      *   côté backend (port Person::insert). `costumId`/`costumType` = entité porteuse (requis si le slug n'est
      *   pas un doc `costum`, ex. un site porté par une org).
+     * @param params.fields - (option) champs SUPPLÉMENTAIRES du citoyen, envoyés À PLAT dans le body (le legacy
+     *   lit `$_POST` à la racine, pas un sous-objet). La règle d'acceptation vit côté SERVEUR et n'est pas
+     *   rejouée ici. L'inscription étant anonyme, c'est une LISTE BLANCHE : champs déclarés pour les personnes
+     *   par le costum posté (`typeObj` citoyens/person/alias `sameAs:"person"`), ou champs du modèle créés pour
+     *   les inscriptions costum (`typepro`, `othersTypepro`, `profession`…) ; valeur simple (scalaire ou liste de
+     *   scalaires). Tout autre champ fait ÉCHOUER l'inscription (`{result:false, msg:"Contenu Invalide <clé> :
+     *   Person"}` → `ApiResponseError`). Aucun schéma de champ
+     *   n'est rejoué côté client (le contrat PERSON_REGISTER est `additionalProperties:true`) : le schéma digéré
+     *   d'un champ costum (objet pour un finder/une adresse, date…) refuserait une valeur que le serveur
+     *   accepte. Le serveur seul tranche. cf. cocolight-backend docs/33.
+     * @param params.mode - (option) `"normal"` (défaut legacy : compte à activer par e-mail) ou
+     *   `"single_step_register"` : activation IMMÉDIATE (`roles.tobeactivated` retiré, `username` suffixé s'il
+     *   est pris) — l'e-mail de validation part quand même (texte « déjà actif »).
      * @returns Réponse brute de l'API.
      * @throws {ApiResponseError} Si l'API retourne un échec (`result === false`).
      */
-    register({ name, username, email, pwd, costumSlug, costumId, costumType }: {
+    register({ name, username, email, pwd, costumSlug, costumId, costumType, fields, mode }: {
         name: string;
         username: string;
         email: string;
@@ -58,6 +71,8 @@ export declare class UserApi {
         costumSlug?: string;
         costumId?: string;
         costumType?: string;
+        fields?: Record<string, unknown>;
+        mode?: "normal" | "single_step_register";
     }): Promise<any>;
     /**
      * Lance une procédure de récupération de mot de passe.