@communecter/cocolight-api-client 1.0.201 → 1.0.202

package/package.json

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

package/types/Api.d.ts

@@ -1,5 +1,6 @@
 import { Answer } from "./api/Answer.js";
 import { Classified } from "./api/Classified.js";
+import { Discussions } from "./api/Discussions.js";
 import EndpointApi from "./api/EndpointApi.js";
 import { Event } from "./api/Event.js";
 import { Form } from "./api/Form.js";
@@ -15,6 +16,7 @@ export default class Api {
     private _loggedUser;
     private _client;
     private _endpointApi?;
+    private _discussions?;
     /**
      * Authentifie l'utilisateur et retourne une instance d'Api.
      */
@@ -80,6 +82,11 @@ export default class Api {
      * Retourne l'instance d'EndpointApi.
      */
     get endpointApi(): EndpointApi;
+    /**
+     * Le panneau « Discussions » et l'espace de discussion d'un commun (spec « module comment » §6-§7) :
+     * `api.discussions.list()`, `markSeen()`, `space()`, `create()`. Réponses typées (voir `api/Discussions.ts`).
+     */
+    get discussions(): Discussions;
     /**
      * Recherche des tags correspondant à un mot-clé.
      *

package/types/api/BaseEntity.d.ts

@@ -1,3 +1,4 @@
+import type { Comment as CommentEntity } from "./Comment.js";
 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";
@@ -1347,6 +1348,33 @@ export declare class BaseEntity<TServerData = any> {
      * @private
      */
     _entityInstanceData<T extends keyof EntityTypeMap>(entityType: T, entityData: object, config?: BaseEntityConfig): EntityTypeMap[T];
+    /**
+     * Créer un commentaire sur cette entité — ou une RÉPONSE, quand `this` est un commentaire
+     * (`Comment._add` remonte alors à l'entité racine pour `contextId`/`contextType`).
+     * Le brouillon est renvoyé non enregistré : `save()` l'envoie (ADD_COMMENTS).
+     *
+     * @param commentData - Champs du message : `text`, `path` (le fil d'une question), `mentions`,
+     *   `mediaImg` (§5.1), `markdownActive` (§5.3)…
+     * @returns Instance de Comment (brouillon).
+     * @throws {ApiError} 401 si non connecté.
+     */
+    comment(commentData?: Record<string, any>): Promise<CommentEntity>;
+    /**
+     * Récupérer les commentaires de cette entité : tous ses fils mêlés (GET_COMMENTS), ou UN fil
+     * désigné par son `path` (GET_COMMENTS_BY_PATH — le `path` passe dans l'URL : posté dans le corps,
+     * le legacy l'ignore). Le `type` vient de `getEntityType()`.
+     *
+     * @param options.path - Le fil d'une question d'un formulaire (segments `[A-Za-z0-9_-]` séparés
+     *   par des points, 256 caractères au plus) ; absent ou `null` → tous les fils de l'élément.
+     * @returns Liste de Comment (proxy filtrant les supprimés).
+     * @throws {ApiError} 400 sur un commentaire ou un badge (pas de fil propre) ; 404 si l'entité
+     *   n'a pas d'id.
+     * @throws {ApiValidationError} avant tout appel : `type` hors des dix, `path` hors de la règle.
+     * @throws {ApiResponseError} si la réponse n'est pas une liste.
+     */
+    getComments(options?: {
+        path?: string | null;
+    }): Promise<CommentEntity[]>;
     /**
      * Crée une instance d'entité, et déclenche get() si certaines propriétés sont présentes.
      * @template keyof EntityTypeMap T

package/types/api/Comment.d.ts

@@ -19,6 +19,55 @@ export declare class Comment extends BaseEntity<CommentItemNormalized> {
     get(): Promise<never>;
     save(): Promise<Record<string, any>>;
     _add: (payload: Record<string, any>) => Promise<void>;
+    /**
+     * Identifiant 24 hex — la forme que le contrat exige partout (`^[a-f0-9]{24}$`).
+     */
+    private static _isObjectId;
+    /**
+     * Mentions, normalisées pour UPDATE_COMMENTS (spec « module comment » §5.2).
+     *
+     * Une mention RELUE porte plus que le contrat (`avatar`), un `count` en chaîne (`"1"`) que le schéma
+     * refuse, et une liste PHP à trous se relit en objet (`{ "0": …, "2": … }`). Une mention dont l'`id`
+     * n'est pas un identifiant, ou sans `slug`, est ÉCARTÉE (mentions legacy écrites de travers) : une
+     * seule mention de travers ne fait plus refuser toute l'édition. Chacune est ramenée aux six champs
+     * du contrat, tous requis.
+     *
+     * @returns la liste normalisée — vide, rien n'est envoyé et le serveur retire les mentions.
+     */
+    static _mentionsForWrite(raw: unknown): Array<{
+        id: string;
+        name: string;
+        slug: string;
+        type: string;
+        value: string;
+        count: number;
+    }>;
+    /**
+     * `mediaImg` ramené à sa forme d'ÉCRITURE (spec §5.1 / §5.2).
+     *
+     * Le brouillon d'un message relu porte la forme HYDRATÉE (des documents `{ id, imagePath, … }`) :
+     * renvoyée telle quelle, elle écrirait ces documents dans le commentaire à la place des identifiants.
+     * Chaque entrée — chaîne ou document (`id`, sinon `_id.$id`, `_id._str` ou `_id`) — donne un
+     * identifiant ; seuls les `^[a-f0-9]{24}$` restent.
+     *
+     * @returns `{ countImages, images }`, ou `null` s'il ne reste aucun identifiant — le champ est alors
+     *   OMIS et le serveur retire `mediaImg` ($unset), ce qui est voulu pour un message sans image.
+     */
+    static _mediaImgForWrite(raw: unknown): {
+        countImages: number;
+        images: string[];
+    } | null;
+    /**
+     * Corriger un message — charge construite en LISTE BLANCHE, exactement celle du schéma
+     * `UPDATE_COMMENTS` (`{ id, params }`, fermé) : spec « module comment » §5.2.
+     *
+     * Le brouillon d'un message relu porte tous les champs de la lecture (`path`, `contextId`,
+     * `mentions` hydratées…) ; laissés à la racine, ils faisaient lever `ApiValidationError`. Et les
+     * retirer ne suffit pas : le serveur fait `$unset mentions` dès que `params.mentions` manque,
+     * `$unset mediaImg` dès que `params.mediaImg` manque, et remet `markdownActive` à faux dès qu'il
+     * manque. D'où : mentions normalisées, images réduites à des identifiants, `markdownActive` repris
+     * en booléen strict (une chaîne posée au brouillon n'est pas reprise — le schéma la refuserait).
+     */
     _update: (payload: Record<string, any>) => Promise<boolean>;
     addComments(data?: Partial<AddCommentsData>): Promise<unknown>;
     updateComments(data?: Partial<UpdateCommentsData>): Promise<unknown>;
@@ -27,12 +76,6 @@ export declare class Comment extends BaseEntity<CommentItemNormalized> {
      * Constant : DELETE_COMMENT
      */
     delete(): Promise<void>;
-    /**
-     * Créer une réponse à ce commentaire (commentaire sur commentaire).
-     * @param commentData - Données du commentaire.
-     * @returns Instance de Comment.
-     */
-    comment(commentData?: Record<string, any>): Promise<Comment>;
     /**
      * Ajoute un vote sur ce commentaire
      *

package/types/api/Discussions.d.ts

@@ -0,0 +1,184 @@
+import type EndpointApi from "./EndpointApi.js";
+import type { CreateDiscussionData, GetDiscussionSpaceData, GetDiscussionsData, MarkCommentsSeenData } from "./EndpointApi.types.js";
+/** Mode d'une liste de discussions : déduit par le serveur du périmètre reçu, jamais élargi. */
+export type DiscussionDepth = "rail" | "fils" | "fil" | "all";
+/** Audience d'une discussion supplémentaire sur un commun. */
+export type DiscussionAudience = "authorAll" | "authorAdmin" | "private";
+/** Lien de la personne connectée avec un porteur : un espace où lancer une discussion, ou un espace croisé. */
+export type DiscussionMembership = "self" | "admin" | "member" | null;
+/** Référence au porteur d'un fil (`null` : fil sans porteur). */
+export interface DiscussionCarrierRef {
+    type: string;
+    id: string;
+}
+/** La fiche d'un porteur, sans compteurs (mode `fil`). Le porteur NUL a `id` et `type` à `null`. */
+export interface DiscussionCarrierCard {
+    id: string | null;
+    type: string | null;
+    name: string | null;
+    slug: string | null;
+    image: string | null;
+}
+/** Un porteur du rail : sa fiche et ses compteurs, calculés pour la session. */
+export interface DiscussionCarrier extends DiscussionCarrierCard {
+    /** Nombre de fils sous ce porteur. */
+    threads: number;
+    /** Messages en tout. */
+    total: number;
+    /** Messages non lus par la personne connectée. */
+    unread: number;
+    /** Date du dernier message, en SECONDES ; `null` si aucun. */
+    last: number | null;
+    /** La personne connectée a écrit dans l'un des fils. */
+    mine: boolean;
+    membership: DiscussionMembership;
+}
+/** Un fil : le triplet (contextType, contextId, path), ses compteurs, son porteur. */
+export interface DiscussionThread {
+    /** `type:id` ou `type:id:path`. */
+    key: string;
+    contextType: string;
+    contextId: string;
+    /** Une question d'un formulaire ; `null` partout ailleurs (fil racine). */
+    path: string | null;
+    /** Texte nu, 120 caractères au plus ; `null` quand l'écran doit nommer. */
+    title: string | null;
+    carrier: DiscussionCarrierRef | null;
+    total: number;
+    unread: number;
+    /** Secondes ; `null` si aucun message. */
+    last: number | null;
+    mine: boolean;
+    /** Un fil À LANCER, fabriqué à zéro message. */
+    virtual: boolean;
+}
+/** Un fil de l'espace d'un commun : les champs d'un fil du panneau, `carrier` toujours `null`, et sa place dans l'appel. */
+export interface DiscussionSpaceThread extends DiscussionThread {
+    carrier: null;
+    kind: "general" | "discussion" | "question" | "expense";
+    /** Nom de l'étape, pour une question ou une ligne de dépense. */
+    group: string | null;
+    /** Pour une discussion supplémentaire. */
+    audience: DiscussionAudience | null;
+    /** Clé de la ligne dans la liste des dépenses du commun. */
+    line: string | null;
+    /** Clé de l'étape où vit la question. */
+    step: string | null;
+}
+/** Réponse de `list()` en `rail`, `fils` ou `all` : les porteurs, et leurs fils sauf en `rail`. */
+export interface DiscussionsListResponse {
+    result: true;
+    depth: "rail" | "fils" | "all";
+    limit: number;
+    /** La liste a été coupée à `limit`. */
+    truncated: boolean;
+    /** Des fils manquent pour cet utilisateur : budget de lecture du serveur dépassé. */
+    scanTruncated: boolean;
+    /** Plus de porteurs vierges qu'il n'en est rendu (500). */
+    carriersTruncated: boolean;
+    /** Servi par l'index des porteurs (`true`) ou par le balayage du parc : la réponse est la même. */
+    indexed: boolean;
+    carriers: DiscussionCarrier[];
+    /** Absent en `rail`. */
+    threads?: DiscussionThread[];
+}
+/** Réponse de `list()` en `fil` : ce seul fil, la fiche de son porteur, le jugement du serveur sur l'écriture. */
+export interface DiscussionThreadResponse {
+    result: true;
+    depth: "fil";
+    thread: DiscussionThread;
+    carrier: DiscussionCarrierCard | null;
+    canComment: boolean;
+}
+/** Réponse de `list()` : discriminée par `depth`. */
+export type DiscussionsResponse = DiscussionsListResponse | DiscussionThreadResponse;
+/** Réponse de `markSeen()` : combien de messages viennent de passer en « lu » (0 n'est pas une erreur). */
+export interface MarkSeenResponse {
+    result: true;
+    marked: number;
+}
+/** Réponse de `space()` : tous les fils d'un commun, dans l'ordre du serveur. La liste fait autorité. */
+export interface DiscussionSpaceResponse {
+    result: true;
+    space: {
+        type: "answers";
+        id: string;
+        title: string | null;
+        formId: string;
+    };
+    /** Seulement : y a-t-il une session. */
+    canComment: boolean;
+    /** Les audiences que ce lecteur peut donner à une discussion qu'il crée ; vide, il n'en crée pas. */
+    creatableAudiences: DiscussionAudience[];
+    truncated: boolean;
+    threads: DiscussionSpaceThread[];
+}
+/** Réponse de `create()` : le fil créé, vide et `virtual`, avec le `path` à passer à `form.getComments({ path })`. */
+export interface CreateDiscussionResponse {
+    result: true;
+    thread: DiscussionSpaceThread;
+}
+/**
+ * `api.discussions` — le panneau « Discussions » et l'espace d'un commun.
+ *
+ * @example
+ * const rail = await api.discussions.list();                // les porteurs et leurs compteurs
+ * const fil = await api.discussions.list({ contextType: "news", contextId });
+ * if (fil.depth === "fil") console.log(fil.thread.unread, fil.canComment);
+ * await api.discussions.markSeen({ contextType: "news", contextId, ids });
+ * const espace = await api.discussions.space({ contextType: "answers", contextId: commun });
+ * const { thread } = await api.discussions.create({ contextType: "answers", contextId: commun, name, audience: "authorAll" });
+ */
+export declare class Discussions {
+    private readonly _endpointApi;
+    constructor(endpointApi: EndpointApi);
+    /**
+     * Le panneau « Discussions » de la personne connectée (`GET_DISCUSSIONS`, auth bearer).
+     *
+     * Le mode se déduit du périmètre : rien → `rail` (porteurs et compteurs, aucun titre de fil) ;
+     * `carrier` → `fils` (les fils d'UN porteur) ; `contextType` + `contextId` (+ `path`) → `fil`.
+     * `depth: "all"` seul demande tout (jamais implicite) : ne jamais le passer « pour être explicite ».
+     * Sans `path`, c'est le fil RACINE qui est rendu, jamais le premier venu.
+     *
+     * @param options - Corps POST, tous facultatifs, AUCUN défaut injecté.
+     * @throws {ApiAuthenticationError} sans jeton, avant tout appel.
+     * @throws {ApiValidationError} requête hors schéma (clé inconnue, `includeEmpty` non chaîne…), avant tout appel.
+     * @throws {ApiResponseError} refus du serveur — `error.responseData.code` ∈ `bad-request`, `hidden` (neutre : fil introuvable ou réservé).
+     */
+    list(options?: GetDiscussionsData): Promise<DiscussionsResponse>;
+    /**
+     * Marquer un fil comme LU pour la personne connectée (`MARK_COMMENTS_SEEN`, auth bearer).
+     *
+     * L'utilisateur vient de la session, jamais d'un paramètre. Le `path` absent vise le fil des
+     * messages SANS chemin (pas « tous les fils du contexte »). `ids` restreint aux messages AFFICHÉS
+     * (500 au plus) : un message arrivé depuis le chargement n'est pas marqué. Rouvrir un fil déjà lu
+     * n'écrit rien : `marked` vaut 0.
+     *
+     * @throws {ApiAuthenticationError} sans jeton, avant tout appel.
+     * @throws {ApiValidationError} `ids` vide, > 500 ou mal formé ; contexte hors schéma.
+     * @throws {ApiResponseError} refus du serveur — `code` = `bad-request`.
+     */
+    markSeen(options: MarkCommentsSeenData): Promise<MarkSeenResponse>;
+    /**
+     * L'espace de discussion d'un commun (`GET_DISCUSSION_SPACE`, auth none = session FACULTATIVE :
+     * le jeton est joint quand il existe, et ne manque à personne).
+     *
+     * Tous les fils d'une réponse à un appel : général, questions, lignes de dépense, discussions
+     * supplémentaires. Un fil rendu est lisible par ce lecteur. Sans session : `canComment: false`,
+     * `creatableAudiences: []`.
+     *
+     * @throws {ApiValidationError} `contextType` ≠ `answers`, `includeEmpty` hors `"0"`/`"1"`, id en majuscules.
+     * @throws {ApiResponseError} refus — `code` ∈ `bad-request`, `hidden` (commun ou appel introuvable).
+     */
+    space(options: GetDiscussionSpaceData): Promise<DiscussionSpaceResponse>;
+    /**
+     * Créer une discussion supplémentaire sur un commun (`CREATE_DISCUSSION`, auth bearer) — le
+     * bouton « + » de l'espace. La requête ne porte aucun chemin : clé, étape et `path` sont fabriqués
+     * par le serveur. Qui peut créer, et avec quelle audience : `creatableAudiences` de l'espace.
+     *
+     * @throws {ApiAuthenticationError} sans jeton, avant tout appel.
+     * @throws {ApiValidationError} audience hors liste, `name` vide ou > 120, clé de trop.
+     * @throws {ApiResponseError} refus — `code` ∈ `bad-request`, `hidden`, `forbidden`, `bad-name`, `too-many`, `failed`.
+     */
+    create(options: CreateDiscussionData): Promise<CreateDiscussionResponse>;
+}

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, 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";
+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, GetCommentsByPathData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, GetDiscussionsData, MarkCommentsSeenData, GetDiscussionSpaceData, CreateDiscussionData, 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
  */
@@ -356,7 +356,16 @@ export declare class EndpointApi {
      */
     getComments(data: GetCommentsData): Promise<any>;
     /**
-     * Ajouter un commentaire : Ajoute un commentaire à une actualité ou autre contexte.
+     * Récupérer les commentaires d'un fil désigné par son path : Récupère les messages d'UN fil d'un élément : ceux dont le `path` est celui demandé (une question d'un formulaire). Sans path (GET_COMMENTS), tous les fils de l'élément sont rendus mêlés. Le path passe dans l'URL : posté dans le corps, il est ignoré (liaison Yii des paramètres d'action).
+     * Constant : GET_COMMENTS_BY_PATH
+     * @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.
+     */
+    getCommentsByPath(data: GetCommentsByPathData): Promise<any>;
+    /**
+     * Ajouter un commentaire : Ajoute un commentaire à l'un des dix types commentables (actualité, organisation, projet, événement, POI, réponse, formulaire, annonce, action, personne).
      * Constant : ADD_COMMENTS
      * @param data - Données envoyées à l'API
      * @returns Les données de réponse.
@@ -385,6 +394,45 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     updateComments(data: UpdateCommentsData): Promise<any>;
+    /**
+     * Panneau Discussions : Le panneau « Discussions » de la personne connectée : les porteurs (rail) et leurs fils, ou un seul fil. Le MODE se déduit du périmètre reçu (rien → rail ; carrier → fils ; contextType+contextId → fil) et ne l'élargit jamais ; `depth:"all"` seul demande tout. Aucun texte de message ne transite : titres, compteurs, dates. Les compteurs unread/mine sont calculés pour la session, jamais pour un utilisateur passé en paramètre. Façade : Api.discussions.list().
+     * Constant : GET_DISCUSSIONS
+     * @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.
+     */
+    getDiscussions(data: GetDiscussionsData): Promise<any>;
+    /**
+     * Marquer un fil comme lu : Marque comme LUS, pour la personne connectée, les messages d'un fil (views.<userId>.date). L'utilisateur vient de la session. Rouvrir un fil déjà lu n'écrit rien (marked = 0, pas une erreur). Le path absent vise le fil des messages SANS chemin, pas tous les fils du contexte. `ids` RESTREINT aux messages affichés (le contexte et le chemin restent exigés) ; absent, tout le fil. Un fil illisible pour le lecteur rend {result:true, marked:0}. Façade : Api.discussions.markSeen().
+     * Constant : MARK_COMMENTS_SEEN
+     * @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.
+     */
+    markCommentsSeen(data: MarkCommentsSeenData): Promise<any>;
+    /**
+     * Espace de discussion d'un commun : Tous les fils d'un commun (une réponse `answers` à un appel) : fil général (answers:<commun>), questions, lignes de dépense et discussions supplémentaires (forms:<appel> avec un path dont le 3e segment est le commun). Session FACULTATIVE (auth none : le jeton est joint quand il existe) ; compteurs et audiences calculés pour la session. La liste fait autorité : un fil rendu est lisible par ce lecteur. Aucun texte de message. Façade : Api.discussions.space().
+     * Constant : GET_DISCUSSION_SPACE
+     * @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.
+     */
+    getDiscussionSpace(data: GetDiscussionSpaceData): Promise<any>;
+    /**
+     * Créer une discussion supplémentaire sur un commun : Le bouton « + » de l'espace : une discussion de plus sur un commun, nommée, réservée à une audience. La requête ne porte AUCUN chemin : clé, étape et path sont fabriqués par le serveur. Qui crée : admin de l'appel (les trois audiences), déposant du commun ou référent (authorAll, authorAdmin) — la même règle que `creatableAudiences` de l'espace. Le nom est ramené à du texte nu (1 à 120 caractères visibles, sinon refusé, jamais tronqué) ; 50 discussions au plus par commun ; aucune notification. Façade : Api.discussions.create().
+     * Constant : CREATE_DISCUSSION
+     * @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.
+     */
+    createDiscussion(data: CreateDiscussionData): Promise<any>;
     /**
      * Rechercher des tags : Recherche des tags correspondant à un mot-clé.
      * Constant : SEARCH_TAGS

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

@@ -979,9 +979,9 @@ export interface ShareNewsData {
 export interface GetCommentsData {
     pathParams?: {
         /**
-         * Type de l'élément
+         * Type (collection) de l'élément commenté — les dix types commentables
          */
-        type: "news";
+        type: "citoyens" | "organizations" | "projects" | "events" | "poi" | "news" | "answers" | "forms" | "classifieds" | "actions";
         /**
          * ID de l'élément dont on veut récupérer les commentaires
          */
@@ -990,6 +990,24 @@ export interface GetCommentsData {
     };
     [k: string]: unknown;
 }
+export interface GetCommentsByPathData {
+    pathParams?: {
+        /**
+         * Type (collection) de l'élément commenté — les dix types commentables
+         */
+        type: "citoyens" | "organizations" | "projects" | "events" | "poi" | "news" | "answers" | "forms" | "classifieds" | "actions";
+        /**
+         * ID de l'élément dont on veut récupérer les commentaires
+         */
+        id: string;
+        /**
+         * Chemin du fil (une question d'un formulaire) : segments [A-Za-z0-9_-] séparés par des points
+         */
+        path: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
 export interface AddCommentsData {
     /**
      * ID du commentaire parent (optionnel) ou chaîne vide
@@ -1004,9 +1022,9 @@ export interface AddCommentsData {
      */
     contextId: string;
     /**
-     * Type de l'élément auquel le commentaire est associé
+     * Type (collection) de l'élément auquel le commentaire est associé — requis, sans défaut (un défaut serait INJECTÉ par AJV)
      */
-    contextType: "news";
+    contextType: "citoyens" | "organizations" | "projects" | "events" | "poi" | "news" | "answers" | "forms" | "classifieds" | "actions";
     /**
      * Valeur de l'argument (optionnel)
      */
@@ -1053,6 +1071,25 @@ export interface AddCommentsData {
      * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
      */
     costumType?: string;
+    /**
+     * Images du commentaire : identifiants des documents téléversés (UPLOAD_DOCUMENT, folder `comments`). `countImages` : le legacy l'écrit en chaîne. Omis à l'update → le serveur retire les images ($unset).
+     */
+    mediaImg?: {
+        /**
+         * Nombre d'images (entier ou chaîne, parité legacy)
+         */
+        countImages?: number | string;
+        /**
+         * Identifiants des documents (24 hex)
+         *
+         * @maxItems 5
+         */
+        images: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string];
+    };
+    /**
+     * Le texte est en markdown. Recalculé par le serveur à chaque écriture : absent → faux (le legacy perd la mise en forme)
+     */
+    markdownActive?: boolean;
     [k: string]: unknown;
 }
 export interface DeleteCommentsData {
@@ -1070,6 +1107,9 @@ export interface UpdateCommentsData {
      * ID du commentaire à mettre à jour
      */
     id: string;
+    /**
+     * Liste blanche : text (requis), mentions, mediaImg, markdownActive. Le serveur RETIRE mentions et mediaImg s'ils manquent, et remet markdownActive à faux.
+     */
     params: {
         /**
          * Nouveau texte du commentaire
@@ -1101,10 +1141,109 @@ export interface UpdateCommentsData {
              */
             count: number;
         }[];
+        /**
+         * Images du commentaire : identifiants des documents téléversés (UPLOAD_DOCUMENT, folder `comments`). `countImages` : le legacy l'écrit en chaîne. Omis à l'update → le serveur retire les images ($unset).
+         */
+        mediaImg?: {
+            /**
+             * Nombre d'images (entier ou chaîne, parité legacy)
+             */
+            countImages?: number | string;
+            /**
+             * Identifiants des documents (24 hex)
+             *
+             * @maxItems 5
+             */
+            images: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string];
+        };
+        /**
+         * Le texte est en markdown. Recalculé par le serveur à chaque écriture : absent → faux (le legacy perd la mise en forme)
+         */
+        markdownActive?: boolean;
         [k: string]: unknown;
     };
     [k: string]: unknown;
 }
+export interface GetDiscussionsData {
+    /**
+     * Ne sert qu'à demander `all` (jamais implicite, charge tout le parc). Les trois autres se déduisent du périmètre ; ne pas le passer « pour être explicite »
+     */
+    depth?: "rail" | "fils" | "fil" | "all";
+    /**
+     * Porteur `type:id` (mode fils)
+     */
+    carrier?: string;
+    /**
+     * Porteur, forme éclatée (avec carrierId)
+     */
+    carrierType?: "citoyens" | "organizations" | "projects" | "events" | "cities" | "poi" | "classifieds";
+    carrierId?: string;
+    /**
+     * Un fil précis (mode fil), avec contextId
+     */
+    contextType?: "citoyens" | "organizations" | "projects" | "events" | "poi" | "news" | "answers" | "forms" | "classifieds" | "actions";
+    contextId?: string;
+    /**
+     * Le fil d'une question (mode fil) ; absent → le fil RACINE
+     */
+    path?: string;
+    /**
+     * Défaut serveur 200, borné à 1000
+     */
+    limit?: number;
+    /**
+     * Rendre les porteurs et fils VIERGES (défaut serveur 1). En chaîne : tout paramètre posté sous une autre forme est refusé (bad-request)
+     */
+    includeEmpty?: "0" | "1";
+    [k: string]: unknown;
+}
+export interface MarkCommentsSeenData {
+    contextType: "citoyens" | "organizations" | "projects" | "events" | "poi" | "news" | "answers" | "forms" | "classifieds" | "actions";
+    contextId: string;
+    /**
+     * Le fil d'une question ; absent, vide ou "0" → le fil racine. SANS défaut : un path injecté élargirait le marquage
+     */
+    path?: string;
+    /**
+     * Les messages AFFICHÉS, et eux seuls (500 au plus par appel). Un identifiant d'un autre fil ne marque rien
+     *
+     * @minItems 1
+     * @maxItems 500
+     */
+    ids?: [string, ...string[]];
+    [k: string]: unknown;
+}
+export interface GetDiscussionSpaceData {
+    /**
+     * Liste blanche : la seule nature d'espace aujourd'hui
+     */
+    contextType: "answers";
+    /**
+     * Identifiant du commun (minuscules ; le serveur accepte aussi des majuscules et les ramène)
+     */
+    contextId: string;
+    /**
+     * "0" : ne pas fabriquer les fils où personne n'a écrit (défaut serveur : rendus). En chaîne, sans défaut
+     */
+    includeEmpty?: "0" | "1";
+    [k: string]: unknown;
+}
+export interface CreateDiscussionData {
+    contextType: "answers";
+    /**
+     * Identifiant du commun
+     */
+    contextId: string;
+    /**
+     * Borne sur la saisie brute ; le serveur juge le texte nettoyé (bad-name)
+     */
+    name: string;
+    /**
+     * Publique · admins de l'appel, déposant et référents · admins de l'appel
+     */
+    audience: "authorAll" | "authorAdmin" | "private";
+    [k: string]: unknown;
+}
 export interface SearchTagsData {
     pathParams?: {
         /**
@@ -7800,9 +7939,9 @@ export interface UploadDocumentData {
     folderId?: string;
     pathParams?: {
         /**
-         * Type (collection) de l'élément porteur
+         * Type (collection) de l'élément porteur ; `comments` = image d'un commentaire, téléversée depuis la personne connectée (ownerId = me.id) AVANT le message qui la porte (mediaImg.images)
          */
-        folder: "citoyens" | "projects" | "organizations" | "events" | "poi" | "classifieds";
+        folder: "citoyens" | "projects" | "organizations" | "events" | "poi" | "classifieds" | "comments";
         /**
          * ID de l'élément porteur (doit exister)
          */

package/types/api/News.d.ts

@@ -1,5 +1,4 @@
 import { BaseEntity } from "./BaseEntity.js";
-import type { Comment } from "./Comment.js";
 import type { AddNewsData, UpdateNewsData } from "./EndpointApi.types.js";
 import type { NewsItemNormalized } from "./serverDataType/News.js";
 export declare class News extends BaseEntity<NewsItemNormalized> {
@@ -60,20 +59,6 @@ export declare class News extends BaseEntity<NewsItemNormalized> {
      * Constant : DELETE_NEWS
      */
     delete(): Promise<void>;
-    /**
-     * Créer une instance de commentaire pour cette news.
-     * @param commentData - Données du commentaire.
-     * @returns Instance de Comment.
-     */
-    comment(commentData?: Record<string, any>): Promise<Comment>;
-    /**
-     * Récupérer les commentaires : Récupère la liste de commentaires selon plusieurs critères.
-     * Constant : GET_COMMENTS
-     * @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.
-     */
-    getComments(): Promise<Comment[]>;
     /**
      * Ajoute un vote sur cette news
      *