@communecter/cocolight-api-client 1.0.200 → 1.0.202

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
      *

package/types/costum/types.d.ts

@@ -153,6 +153,10 @@ export interface CostumFieldMap {
         };
     };
     associationEkilibre: {
+        citoyens: {
+            othersTypepro?: string;
+            typepro?: string | string[];
+        };
         organizations: {
             affiliate?: string | boolean;
             affiliateTo?: string;
@@ -2040,6 +2044,10 @@ export interface CostumFieldMap {
         };
     };
     sportSanteBienetre: {
+        citoyens: {
+            othersTypepro?: string;
+            typepro?: string;
+        };
         events: {
             description?: string;
             duration?: string | number;