@communecter/cocolight-api-client 1.0.200 → 1.0.202

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@communecter/cocolight-api-client",
-  "version": "1.0.200",
+  "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/ApiClient.d.ts

@@ -1,4 +1,6 @@
 import { EventEmitter } from "events";
+import { type ApiClientLogger } from "./utils/logger.js";
+export type { ApiClientLogger } from "./utils/logger.js";
 import { type TokenStorageStrategy } from "./utils/TokenStorage.js";
 /**
  * Résultat retourné quand une requête est **mise en file** (offline ou breaker).
@@ -19,7 +21,17 @@ export interface ApiClientOptions {
     refreshUrl?: string;
     endpoints?: any[];
     timeout?: number;
+    /**
+     * Niveau `debug` (sinon `info`) du logger de CE client, sans effet sur les autres. Avec un `logger`
+     * fourni : appliqué s'il sait faire des enfants (pino → enfant au niveau `debug`), ignoré sinon.
+     */
     debug?: boolean;
+    /**
+     * Logger à utiliser à la place de celui de la lib (pino ou tout objet à `debug/info/warn/error`) :
+     * un serveur peut passer le sien, ou un logger muet. Par défaut, un enfant du logger pino partagé
+     * du processus (un seul transport par processus, cf. utils/logger.ts).
+     */
+    logger?: ApiClientLogger | null;
     maxRetries?: number;
     circuitBreakerThreshold?: number;
     circuitBreakerResetTime?: number;
@@ -108,7 +120,7 @@ export default class ApiClient extends EventEmitter {
     private _offlineClientManager;
     private _ajv;
     private _ajvNoDefaults;
-    _logger: any;
+    _logger: ApiClientLogger;
     private _client;
     private readonly _breakerThreshold;
     private readonly _breakerResetTime;
@@ -121,7 +133,7 @@ export default class ApiClient extends EventEmitter {
     private _mode;
     /** Contexte costum du SITE appelant, injecté sur les endpoints qui le déclarent (cf. setSiteCostum). */
     private _siteCostum;
-    constructor({ baseURL, accessToken, refreshToken, refreshUrl, endpoints, timeout, debug, maxRetries, circuitBreakerThreshold, circuitBreakerResetTime, fromJSONValue, mode, tokenStorageStrategy, costumForceLive, siteCostum }: ApiClientOptions);
+    constructor({ baseURL, accessToken, refreshToken, refreshUrl, endpoints, timeout, debug, logger, maxRetries, circuitBreakerThreshold, circuitBreakerResetTime, fromJSONValue, mode, tokenStorageStrategy, costumForceLive, siteCostum }: ApiClientOptions);
     /**
      * Déclare l'identité costum du SITE APPELANT — l'entité au nom de laquelle ce front agit.
      *
@@ -217,6 +229,7 @@ export default class ApiClient extends EventEmitter {
     private _resetCircuitBreakerSuccess;
     static stripNullsInPlace(obj: any): any;
     private _resolveSpecialValuesInPlace;
+    /** Nettoyage « anonyme » d'un schéma (alias `@xxx`), mémoïsé par schéma source — cf. utils/validators.ts. */
     private _cleanSchemaLeftoverAlias;
     /**
      * Safely calls an asynchronous function and handles any errors that occur.
@@ -458,7 +471,6 @@ export default class ApiClient extends EventEmitter {
    * @returns La donnée normalisée.
    */
     private _normalizeRecursively;
-    private _startBeforeEndValidate;
     /**
      * Récupère le schéma de requête pour un endpoint donné.
      * @param constant - Le nom de l'endpoint.

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