@communecter/cocolight-api-client 1.0.8 → 1.0.9

package/src/mixin/UtilMixin.js

@@ -0,0 +1,246 @@
+import { fileTypeFromBuffer } from "file-type";
+
+import { ApiAuthenticationError, ApiValidationError } from "../error.js";
+
+// UtilMixin.js
+export const UtilMixin = {
+
+  async call(constant, data = {}) {
+    return this.apiClient.safeCall(async () => {
+      const response = await this.apiClient.callEndpoint(constant, data);
+      this.apiClient.checkAndThrowApiResponseError(response);
+      return response.data;
+    });
+  },
+
+  async callNoConnected(constant, data = {}) {
+    if(this.isConnected) {
+      throw new ApiAuthenticationError("Vous devez ne devez pas être connecté pour faire cette action.");
+    }
+    return this.call(constant, data);
+  },
+
+  async callIsConnected(param, data = {}) {
+    if(!this.isConnected) {
+      throw new ApiAuthenticationError("Vous devez être connecté pour faire cette action.");
+    }
+    // Si le premier paramètre est une fonction, on l'exécute en tant que callback
+    if (typeof param === "function") {
+      return await param();
+    }
+    return this.call(param, data);
+  },
+
+  async callIsMe(param, data = {}) {
+    if (!this.isMe) {
+      throw new ApiAuthenticationError("Vous devez être vous-même pour faire cette action.");
+    }
+    // Si le premier paramètre est une fonction, on l'exécute en tant que callback
+    if (typeof param === "function") {
+      return await param();
+    }
+    // Sinon, on considère qu'il s'agit d'un constant et on appelle la méthode par défaut
+    return await this.callIsConnected(param, data);
+  },
+
+  async validateImage(imageInput){
+    const image = await this._validateUploadInput(imageInput, {
+      allowedMimeTypes: ["image/jpeg", "image/png", "image/jpg"],
+      expectedType: "image"
+    });
+    return image;
+  },
+
+  async validateFile(fileInput){
+    const file = await this._validateUploadInput(fileInput, {
+      allowedMimeTypes: ["application/pdf", "text/plain", "text/csv"],
+      expectedType: "file"
+    });
+    return file;
+  },
+
+  async _validateUploadInput(input, { allowedMimeTypes = [], expectedType = "any" }) {
+    if (!input) {
+      throw new ApiValidationError("Le fichier est requis.");
+    }
+  
+    const isNode = typeof window === "undefined" && typeof process !== "undefined";
+    let mimeType = "";
+    let output = input;
+  
+    // Navigateur : File
+    if (typeof File !== "undefined" && input instanceof File) {
+      mimeType = input.type;
+      if (!allowedMimeTypes.includes(mimeType)) {
+        throw new ApiValidationError("Le type du fichier est invalide.");
+      }
+    }
+  
+    // Navigateur : Blob
+    else if (typeof Blob !== "undefined" && input instanceof Blob) {
+      mimeType = input.type;
+      if (!allowedMimeTypes.includes(mimeType)) {
+        throw new ApiValidationError("Le type du fichier est invalide.");
+      }
+  
+      const ext = mimeType.split("/")[1] || "bin";
+      const fileName = `${Date.now()}.${ext}`;
+      output = new File([input], fileName, { type: mimeType });
+    }
+  
+    // Node.js : Buffer
+    else if (isNode && Buffer.isBuffer(input)) {
+      const fileTypeResult = await fileTypeFromBuffer(input);
+      mimeType = fileTypeResult?.mime;
+  
+      if (!fileTypeResult || !allowedMimeTypes.includes(mimeType)) {
+        throw new ApiValidationError("Le type du fichier est invalide.");
+      }
+  
+      // Pour un fichier image, on transforme en stream
+      if (expectedType === "image") {
+        const ext = fileTypeResult.ext;
+        const filename = `${Date.now()}.${ext}`;
+        output = await this._createReadStreamFromBuffer(input, filename, mimeType);
+      }
+    }
+  
+    // Node.js : ReadableStream
+    else if (isNode && input?.readable && typeof input._read === "function") {
+      const previewChunks = [];
+      const tee = await this._passThrough();
+      const resultStream = await this._passThrough();
+  
+      const MAX_BYTES = 4100;
+      let bytesRead = 0;
+  
+      input.on("data", (chunk) => {
+        if (bytesRead < MAX_BYTES) {
+          previewChunks.push(chunk);
+          bytesRead += chunk.length;
+        }
+      });
+  
+      input.pipe(tee).pipe(resultStream);
+      await new Promise((resolve) => setTimeout(resolve, 10));
+  
+      const previewBuffer = Buffer.concat(previewChunks);
+      const fileTypeResult = await fileTypeFromBuffer(previewBuffer);
+      mimeType = fileTypeResult?.mime;
+  
+      if (!fileTypeResult || !allowedMimeTypes.includes(mimeType)) {
+        throw new ApiValidationError("Le type du fichier est invalide.");
+      }
+  
+      resultStream.path = `${Date.now()}.${fileTypeResult.ext}`;
+      resultStream.mimeType = mimeType;
+      output = resultStream;
+    }
+  
+    else {
+      throw new ApiValidationError("Type de fichier non reconnu.");
+    }
+  
+    return output;
+  },
+
+  /**
+ * Transforme un Buffer en ReadableStream équivalent à fs.createReadStream
+ * @param {Buffer} buffer - Le buffer contenant les données binaires
+ * @param {string} filename - Nom de fichier (utilisé dans FormData)
+ * @param {string} mimeType - Type MIME (utilisé dans FormData)
+ * @returns {Object} - { stream, filename, mimeType }
+ */
+  async _createReadStreamFromBuffer(buffer, filename = "file.bin", mimeType = "application/octet-stream") {
+    const stream = await this._bufferToReadable(buffer);
+    stream.path = filename; // 👈 hack pour simuler un vrai fichier ReadStream
+    stream.mimeType = mimeType;
+    return stream;
+  },
+
+  async _bufferToReadable(buffer) {
+    if (typeof window === "undefined") {
+      const { bufferToReadable } = await import("../utils/stream-utils.node.js");
+      return bufferToReadable(buffer);
+    } else {
+      throw new Error("bufferToReadable ne doit pas être appelé dans le navigateur");
+    }
+  },
+  
+  async _passThrough() {
+    if (typeof window === "undefined") {
+      const { createPassThrough } = await import("../utils/stream-utils.node.js");
+      return createPassThrough();
+    } else {
+      throw new Error("passThrough ne doit pas être appelé dans le navigateur");
+    }
+  },
+
+  // async _bufferToReadable(buffer) {
+  //   if (typeof window === "undefined") {
+  //     const { Readable } = await import("stream");
+  //     return Readable.from(buffer);
+  //   } else {
+  //     throw new Error("bufferToReadable ne doit pas être appelé dans le navigateur");
+  //   }
+  // },
+
+  // async _passThrough() {
+  //   if (typeof window === "undefined") {
+  //     const { PassThrough } = await import("stream");
+  //     return new PassThrough();
+  //   } else {
+  //     throw new Error("passThrough ne doit pas être appelé dans le navigateur");
+  //   }
+  // },
+
+  _omitProps(obj, propsToRemove) {
+    if (!obj || typeof obj !== "object") return {};
+  
+    const result = { ...obj };
+    for (const prop of propsToRemove) {
+      delete result[prop];
+    }
+    return result;
+  },
+
+  _pickProps(obj, keys, transforms = {}) {
+    if (!obj || typeof obj !== "object") return {};
+
+    const result = {};
+
+    for (const key of keys) {
+      if (key in obj) {
+        const value = obj[key];
+        if (typeof transforms[key] === "function") {
+          result[key] = transforms[key](value, obj); // (valeur, objet source)
+        } else {
+          result[key] = value;
+        }
+      }
+    }
+
+    return result;
+  },
+
+  _createFilteredProxy(list) {
+    return new Proxy(list, {
+      get(target, prop, receiver) {
+        if (typeof prop === "string" && !isNaN(prop)) {
+          const active = target.filter(n => !n._isDeleted);
+          return active[prop];
+        }
+        if (prop === "length") {
+          return target.filter(n => !n._isDeleted).length;
+        }
+        if (typeof target[prop] === "function") {
+          return (...args) => target.filter(n => !n._isDeleted)[prop](...args);
+        }
+        return Reflect.get(target, prop, receiver);
+      }
+    });
+  }
+  
+  
+};
+  

package/src/utils/stream-utils.node.js

@@ -0,0 +1,10 @@
+// utils/stream-utils.node.js
+export async function bufferToReadable(buffer) {
+  const { Readable } = await import("stream");
+  return Readable.from(buffer);
+}
+  
+export async function createPassThrough() {
+  const { PassThrough } = await import("stream");
+  return new PassThrough();
+}

package/dist/cocolight-api-client.cjs.LICENSE.txt

@@ -1 +0,0 @@
-/*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */

package/dist/cocolight-api-client.mjs.js.LICENSE.txt

@@ -1 +0,0 @@
-/*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */

package/src/api/EntityMixin.js

@@ -1,249 +0,0 @@
-import { ApiResponseError } from "../error.js";
-
-// EntityMixin.js
-export const EntityMixin = {
-  /**
-     * Résout l'identifiant de l'entité si seul le slug est fourni.
-     * @param {string} type - Le type d'entité (ex : "citoyens", "organizations", "projects").
-     * @returns {Promise<string>} L'identifiant résolu.
-     */
-  async resolveId(type) {
-    if (!this.id && this.slug) {
-      try {
-        const data = await this._getElementsKey({
-          pathParams:{
-            slug: this.slug
-          }
-        });
-        if(data?.contextId && data?.contextType === type) {
-          this._id(data.contextId);
-        } else {
-          throw new ApiResponseError(`Le slug ${this.slug} ne correspond pas à un ${type}`, 200, data);
-        }
-      } catch (error) {
-        if(error instanceof ApiResponseError) {
-          if(error?.responseData?.contextType !== type) {
-            throw error;
-          } else {
-            throw new ApiResponseError(`Impossible de récupérer l'identifiant pour le slug ${this.slug}`, error.status, error.responseData);
-          }
-        } else {
-          throw error;
-        }
-      }
-    }
-    return this.id;
-  },
-  
-  /**
-     * Récupère le profil public de l'entité.
-     * @returns {Promise<Object>} Les données du profil public.
-     */
-  async getPublicProfile() {
-    await this.resolveId(this.getEntityType());
-    return this._getElementsAbout({ pathParams: { id: this.id, type: this.getEntityType() } });
-  },
-
-  /**
-   * Obtenir les éléments liés : Récupère les informations détaillées d'un élément et de ses éléments liés.
-   * Constant : GET_ELEMENTS_ABOUT
-   * @param {Object} data - Les données à envoyer.
-   * @param {string} data.tpl - Template utilisé (ex: ficheInfoElement) (default: "ficheInfoElement")
-   * @param {Object} data.pathParams - Les paramètres de chemin.
-   * @param {string} data.pathParams.type - Type d'entité (default: "citoyens")
-   * @param {string} data.pathParams.id - ID de l'utilisateur ou de l'entité
-   * @returns {Promise<Object>} - 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.
-   */
-  async _getElementsAbout(data = {}) {
-    return this.call("GET_ELEMENTS_ABOUT", data);
-  },
-
-  /**
-   * Récuperer l'id et la collection d'un element en fonction du slug : Récuperer l'id et la collection d'un element en fonction du slug
-   * Constant : GET_ELEMENTS_KEY
-   * @param {Object} data.pathParams - Les paramètres de chemin.
-   * @param {string} data.pathParams.slug - Slug de l'élément à récupérer
-   * @returns {Promise<Object>} - 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.
-   */
-  async _getElementsKey(data = {}) {
-    return this.call("GET_ELEMENTS_KEY", data);
-  },
-
-  /**
-   * Mettre à jour l'image de profil : Permet de mettre à jour l'image de profil d'un utilisateur ou d'une entité.
-   * Constant : PROFIL_IMAGE
-   * @param {Object} data - Les données à envoyer.
-   * @param {undefined} data.profil_avatar - Fichier image de profil au format binaire
-   * @param {Object} data.pathParams - Les paramètres de chemin.
-   * @param {string} data.pathParams.folder - Type d'entité (default: "citoyens")
-   * @param {string} data.pathParams.ownerId - ID de l'utilisateur ou de l'entité
-   * @returns {Promise<Object>} - 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.
-   */
-  async _profilImage(data = {}) {
-    return this.callIsConnected("PROFIL_IMAGE", data);
-  },
-
-  /**
-   * Mettre à jour les paramètres d'un élément : Mise à jour des paramètres spécifiques d'un élément.
-   * Constant : UPDATE_SETTINGS
-   * @param {Object} data - Les données à envoyer.
-   * @param {string} data.type - data.type
-   * @param {undefined} data.value - data.value
-   * @param {string} data.typeEntity - Type d'élément (citoyens, projects, organizations) (default: "citoyens")
-   * @param {string} data.idEntity - Id de l'élément
-   * @returns {Promise<Object>} - 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.
-   */
-  async _updateSettings(data = {}) {
-    return this.callIsConnected("UPDATE_SETTINGS", data);
-  },
-
-  /**
-   * Mettre à jour la description d'un élément : Permet de mettre à jour la description courte et complète d'un élément.
-   * Constant : UPDATE_BLOCK_DESCRIPTION
-   * @param {Object} data - Les données à envoyer.
-   * @param {string} data.block - Nom du bloc à mettre à jour (doit être 'descriptions') (default: "descriptions")
-   * @param {string} data.typeElement - Type d'élément (citoyens, projects, organizations) (default: "citoyens")
-   * @param {string} data.id - ID de l'élément concerné
-   * @param {string | null} data.scope - Périmètre de mise à jour (default: "")
-   * @param {string} data.descMentions - Mentions dans la description (default: "")
-   * @param {string} data.shortDescription - Courte description
-   * @param {string} data.description - Description complète
-   * @returns {Promise<Object>} - 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.
-   */
-  async _updateBlockDescription(data = {}) {
-    return this.callIsConnected("UPDATE_BLOCK_DESCRIPTION", data);
-  },
-  
-  /**
-     * Mettre à jour les informations d'un élément : Permet de mettre à jour les informations générales d'un élément (nom, contacts, etc.).
-     * Constant : UPDATE_BLOCK_INFO
-     * @param {Object} data - Les données à envoyer.
-     * @param {string} data.block - Nom du bloc à mettre à jour (doit être 'info') (default: "info")
-     * @param {string} data.typeElement - Type d'élément (citoyens, projects, organizations) (default: "citoyens")
-     * @param {string} data.id - ID de l'élément concerné
-     * @param {string} data.scope - Périmètre de mise à jour (default: "")
-     * @returns {Promise<Object>} - 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.
-     */
-  async _updateBlockInfo(data = {}) {
-    return this.callIsConnected("UPDATE_BLOCK_INFO", data);
-  },
-  
-  /**
-     * Mettre à jour les réseaux sociaux d'un élément : Permet de mettre à jour les liens vers les réseaux sociaux d'un élément.
-     * Constant : UPDATE_BLOCK_SOCIAL
-     * @param {Object} data - Les données à envoyer.
-     * @param {string} data.block - Nom du bloc à mettre à jour (doit être 'network') (default: "network")
-     * @param {string} data.typeElement - Type d'élément (citoyens, projects, organizations) (default: "citoyens")
-     * @param {string} data.id - ID de l'élément concerné
-     * @param {string} data.scope - Périmètre de mise à jour (default: "")
-     * @param {string} data.gitlab - Compte Gitlab
-     * @param {string} data.github - Compte Github
-     * @param {string} data.twitter - Compte Twitter
-     * @param {string} data.facebook - Compte Facebook
-     * @param {string} data.instagram - Compte Instagram
-     * @param {string} data.diaspora - Compte Diaspora
-     * @param {string} data.mastodon - Compte Mastodon
-     * @param {string} data.telegram - Compte Telegram
-     * @param {string} data.signal - Compte Signal
-     * @returns {Promise<Object>} - 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.
-     */
-  async _updateBlockSocial(data = {}) {
-    return this.callIsConnected("UPDATE_BLOCK_SOCIAL", data);
-  },
-  
-  /**
-     * Mettre à jour les localités d'un élément : Permet de mettre à jour l'adresse et les informations géographiques d'un élément.
-     * Constant : UPDATE_BLOCK_LOCALITY
-     * @param {Object} data - Les données à envoyer.
-     * @param {string} data.block - Nom du bloc à mettre à jour (doit être 'localities') (default: "localities")
-     * @param {string} data.typeElement - Type d'élément (default: "citoyens")
-     * @param {string} data.id - ID de l'élément concerné
-     * @param {string} data.scope - Périmètre de mise à jour (default: "")
-     * @param {object} data.geo - Coordonnées géographiques
-     * @param {string} data.geo.@type - data.geo.@type
-     * @param {string | number} data.geo.latitude - data.geo.latitude
-     * @param {string | number} data.geo.longitude - data.geo.longitude
-     * @param {object} data.geoPosition - Position géographique GeoJSON
-     * @param {string} data.geoPosition.type - Type GeoJSON (doit être 'Point')
-     * @param {Array<number>} data.geoPosition.coordinates - Tableau contenant [longitude, latitude]
-     * @param {boolean} data.geoPosition.float - Indicateur pour forcer la conversion en float côté serveur (default: true)
-     * @param {object} data.address - data.address
-     * @param {string} data.address.@type - data.address.@type
-     * @param {string} data.address.addressCountry - data.address.addressCountry
-     * @param {string} data.address.codeInsee - data.address.codeInsee
-     * @param {string} data.address.addressLocality - data.address.addressLocality
-     * @param {string} data.address.localityId - data.address.localityId
-     * @param {string} data.address.level1 - data.address.level1
-     * @param {string} data.address.level1Name - data.address.level1Name
-     * @param {string} data.address.level3 - ID du département. Peut être vide pour les pays étrangers.
-     * @param {string} data.address.level3Name - Nom du département. Peut être vide pour les pays étrangers.
-     * @param {string} data.address.level4 - ID de la commune. Peut être vide pour les pays étrangers.
-     * @param {string} data.address.level4Name - Nom de la commune. Peut être vide pour les pays étrangers.
-     * @param {string} data.address.postalCode - data.address.postalCode
-     * @param {string} data.address.streetAddress - data.address.streetAddress
-     * @returns {Promise<Object>} - 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.
-     */
-  async _updateBlockLocality(data = {}) {
-    return this.callIsConnected("UPDATE_BLOCK_LOCALITY", data);
-  },
-  
-  /**
-     * Mettre à jour le slug d'un élément : Permet de mettre à jour le slug pour une URL simplifiée.
-     * Constant : UPDATE_BLOCK_SLUG
-     * @param {Object} data - Les données à envoyer.
-     * @param {string} data.block - Nom du bloc à mettre à jour (doit être 'info') (default: "info")
-     * @param {string} data.typeElement - Type d'élément (citoyens, projects, organizations) (default: "citoyens")
-     * @param {string} data.id - ID de l'élément concerné
-     * @param {string} data.scope - data.scope (default: "")
-     * @param {string} data.slug - Slug simplifié pour URL
-     * @returns {Promise<Object>} - 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.
-     */
-  async _updateBlockSlug(data = {}) {
-    return this.callIsConnected("UPDATE_BLOCK_SLUG", data);
-  },
-  
-  /**
-     * Vérifier l'état d'une URL : Vérifie si une URL (slug) est valide ou disponible.
-     * Constant : CHECK
-     * @param {Object} data - Les données à envoyer.
-     * @param {string} data.block - Nom du bloc (default: "info")
-     * @param {string} data.id - ID de l'élément
-     * @param {string} data.type - Type d'élément (default: "citoyens")
-     * @param {string} data.slug - Slug à vérifier
-     * @returns {Promise<Object>} - 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.
-     */
-  async _check(data = {}) {
-    return this.callIsConnected("CHECK", data);
-  }
-  
-
-};
-  

package/src/api/NewsMixin.js

@@ -1,168 +0,0 @@
-// eslint-disable-next-line no-unused-vars
-import { ApiResponseError } from "../error.js";
-
-// NewsMixin.js
-export const NewsMixin = {
-
-  /**
-   * Récupérer les actualités : Récupère la liste d’actualités selon plusieurs critères.
-   * Constant : GET_NEWS
-   * @param {Object} data - Les données à envoyer.
-   * @param {number} data.dateLimit - Limite de date timestamp ou 0 (default: 0)
-   * @param {object} data.search - data.search
-   * @param {string} data.search.name - Nom ou terme recherché (default: "")
-   * @param {number} data.indexStep - Nombre de résultats par page (default: 12)
-   * @param {Object} data.pathParams - Les paramètres de chemin.
-   * @param {boolean} data.pathParams.isLive - Indique si l'actualité est en direct (default: true)
-   * @param {string} data.pathParams.type - Type d'actualité (ex: 'citoyens', 'projects', 'organizations') (default: "citoyens")
-   * @param {string} data.pathParams.id - ID de l'élément (ex: ID d'un utilisateur, d'un projet ou d'une organisation)
-   * @returns {Promise<Object>} - 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.
-   */
-  async _getNews(data = {}) {
-    return this.call("GET_NEWS", data);
-  },
-
-  /**
-   * Récupérer des actualités par IDs : Récupère des actualités à partir d’une liste d’identifiants.
-   * Constant : GET_NEWS_BY_ID
-   * @param {Object} data - Les données à envoyer.
-   * @param {Array<string>} data.ids - Liste des IDs d’actualités à récupérer
-   * @returns {Promise<Object>} - 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.
-   */
-  async _getNewsById(data = {}) {
-    return this.call("GET_NEWS_BY_ID", data);
-  },
-
-  /**
-   * Ajouter une actualité : Ajoute une nouvelle actualité.
-   * Constant : ADD_NEWS
-   * @param {Object} data - Les données à envoyer.
-   * @param {string} data.text - Contenu de l’actualité
-   * @param {string} data.scope - Portée de l'actualité (ex: public, privé...) (default: "public")
-   * @param {boolean} data.markdownActive - Markdown activé (true/false) (default: true)
-   * @param {string} data.parentId - ID de l'entité parente
-   * @param {string} data.parentType - Type de l'entité parente (default: "citoyens")
-   * @param {string} data.type - Type de l'objet, toujours 'news'. (default: "news")
-   * @param {boolean} data.json - Indique que la réponse est au format JSON. (default: true)
-   * @param {array | string} data.tags - Tags : "" pour effacer tous les tags, ou tableau de mots-clés.
-   * @param {object} data.mediaImg - Optionnel. Informations sur les images associées à la news.
-   * @param {number} data.mediaImg.countImages - Nombre d'images.
-   * @param {Array<string>} data.mediaImg.images - Liste des identifiants ou chemins d'images.
-   * @param {object} data.mediaFile - Optionnel. Informations sur les fichiers associés à la news.
-   * @param {number} data.mediaFile.countFiles - Nombre de fichiers.
-   * @param {Array<string>} data.mediaFile.files - Liste des identifiants ou chemins de fichiers.
-   * @param {object} data.mentions - Liste des mentions sous forme d'objet avec des clés dynamiques représentant l'indice de la mention.
-   * @param {Object.<string, object>} data.mentions - Objet dont les clés keys matching ^[0-9]+$
-   * @returns {Promise<Object>} - 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.
-   */
-  async _addNews(data = {}) {
-    return this.callIsConnected("ADD_NEWS", data);
-  },
-
-  /**
-   * Ajouter une image à une actualité : Ajoute une images à une actualité.
-   * Constant : ADD_IMAGE_NEWS
-   * @param {Object} data - Les données à envoyer.
-   * @param {undefined} data.newsImage - Fichier image à télécharger
-   * @param {Object} data.pathParams - Les paramètres de chemin.
-   * @param {string} data.pathParams.folder - Type de l'entité parente (ex: 'citoyens', 'projects', 'organizations') (default: "citoyens")
-   * @param {string} data.pathParams.ownerId - ID de l'utilisateur ou de l'entité parente
-   * @returns {Promise<Object>} - 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.
-   */
-  async _addImageNews(data = {}) {
-    return this.callIsConnected("ADD_IMAGE_NEWS", data);
-  },
-
-  /**
-   * Ajouter un fichier à une actualité : Ajoute un fichier à une actualité.
-   * Constant : ADD_FILE_NEWS
-   * @param {Object} data - Les données à envoyer.
-   * @param {undefined} data.newsFile - Fichier image à télécharger
-   * @param {Object} data.pathParams - Les paramètres de chemin.
-   * @param {string} data.pathParams.folder - Type de l'entité parente (ex: 'citoyens', 'projects', 'organizations') (default: "citoyens")
-   * @param {string} data.pathParams.ownerId - ID de l'utilisateur ou de l'entité parente
-   * @returns {Promise<Object>} - 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.
-   */
-  async _addFileNews(data = {}) {
-    return this.callIsConnected("ADD_FILE_NEWS", data);
-  },
-
-  /**
-   * Supprimer une actualité : Supprime une actualité existante.
-   * Constant : DELETE_NEWS
-   * @param {Object} data - Les données à envoyer.
-   * @param {boolean} data.isLive - data.isLive (default: false)
-   * @param {Object} data.pathParams - Les paramètres de chemin.
-   * @param {string} data.pathParams.id - ID de l'actualité à supprimer
-   * @returns {Promise<Object>} - 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.
-   */
-  async _deleteNews(data = {}) {
-    return this.callIsConnected("DELETE_NEWS", data);
-  },
-
-  /**
-   * Mettre à jour une actualité : Met à jour le contenu d’une actualité existante.
-   * Constant : UPDATE_NEWS
-   * @param {Object} data - Les données à envoyer.
-   * @param {string} data.idNews - ID de l'actualité à mettre à jour
-   * @param {string} data.text - Contenu de l’actualité
-   * @param {string} data.scope - Portée de l'actualité (ex: public, privé...) (default: "public")
-   * @param {boolean} data.markdownActive - Markdown activé (true/false) (default: true)
-   * @param {string} data.parentId - ID de l'entité parente
-   * @param {string} data.parentType - Type de l'entité parente (default: "citoyens")
-   * @param {string} data.type - Type de l'objet, toujours 'news'. (default: "news")
-   * @param {array | string} data.tags - Tags : "" pour effacer tous les tags, ou tableau de mots-clés.
-   * @param {object} data.mediaImg - Optionnel. Informations sur les images associées à la news.
-   * @param {number} data.mediaImg.countImages - Nombre d'images.
-   * @param {Array<string>} data.mediaImg.images - Liste des identifiants ou chemins d'images.
-   * @param {object} data.mediaFile - Optionnel. Informations sur les fichiers associés à la news.
-   * @param {number} data.mediaFile.countFiles - Nombre de fichiers.
-   * @param {Array<string>} data.mediaFile.files - Liste des identifiants ou chemins de fichiers.
-   * @param {object} data.mentions - Liste des mentions sous forme d'objet avec des clés dynamiques représentant l'indice de la mention.
-   * @param {Object.<string, object>} data.mentions - Objet dont les clés keys matching ^[0-9]+$
-   * @returns {Promise<Object>} - 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.
-   */
-  async _updateNews(data = {}) {
-    return this.callIsConnected("UPDATE_NEWS", data);
-  },
-
-  /**
-   * Partager une actualité : Partage une actualité avec une entité ou un utilisateur.
-   * Constant : SHARE_NEWS
-   * @param {Object} data - Les données à envoyer.
-   * @param {string} data.parentId - ID de l'actualité à partager
-   * @param {string} data.parentType - Type de l'objet, toujours 'news'. (default: "news")
-   * @param {string} data.childId - ID de l'entité partageante
-   * @param {string} data.childType - Type de l'entité partageante (default: "citoyens")
-   * @param {string} data.connectType - Type de connexion, toujours 'share'. (default: "share")
-   * @param {string} data.comment - Commentaire de partage
-   * @returns {Promise<Object>} - 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.
-   */
-  async _shareNews(data = {}) {
-    return this.callIsConnected("SHARE_NEWS", data);
-  }
-
-};
-