@communecter/cocolight-api-client 1.0.7 → 1.0.8

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.7",
+    "version": "1.0.8",
     "description": "Client Axios simplifié pour l'API cocolight",
     "repository": {
         "type": "git",
@@ -29,7 +29,10 @@
         "generate:module:publish": "node ./scripts/transform-json-module.publish.js",
         "generate:doc": "node ./scripts/generate-doc.js",
         "generate:test": "node ./scripts/generate-tests.js",
-        "generate:testdata": "node ./scripts/generate-test-data.js"
+        "generate:testdata": "node ./scripts/generate-test-data.js",
+        "generate:reponses": "node ./scripts/generate-constant-response-200.js",
+        "generate:methodeapi": "node ./scripts/generate-methode-api.js",
+        "generate:ajv-standalone": "node ./scripts/generate-validate-function-ajv.js"
     },
     "keywords": [
         "communecter",
@@ -47,25 +50,28 @@
         "README.md"
     ],
     "peerDependencies": {
+        "@segment/ajv-human-errors": "^2.15.0",
         "ajv": "^8.17.1",
         "ajv-formats": "^3.0.1",
         "axios": "^1.4.0",
         "axios-retry": "^4.5.0",
         "ejson": "^2.2.3",
         "events": "^3.3.0",
+        "jwt-decode": "^4.0.0",
         "pino": "^9.6.0",
         "pino-pretty": "^13.0.0",
-        "jwt-decode": "^4.0.0"
+        "file-type": "^20.4.1"
     },
     "devDependencies": {
         "@babel/core": "^7.26.10",
         "@babel/preset-env": "^7.26.9",
         "@eslint/js": "^9.23.0",
+        "@segment/ajv-human-errors": "^2.15.0",
         "ajv": "^8.17.1",
         "ajv-formats": "^3.0.1",
         "axios": "^1.4.0",
         "axios-retry": "^4.5.0",
-        "jwt-decode": "^4.0.0",
+        "file-type": "^20.4.1",
         "babel-jest": "^29.7.0",
         "babel-loader": "^10.0.0",
         "ejson": "^2.2.3",
@@ -74,6 +80,7 @@
         "events": "^3.3.0",
         "globals": "^16.0.0",
         "jest": "^29.7.0",
+        "jwt-decode": "^4.0.0",
         "nodemon": "^3.1.9",
         "pino": "^9.6.0",
         "pino-pretty": "^13.0.0",

package/src/Api.js

@@ -55,10 +55,9 @@ export default class Api {
       if(error instanceof ApiClientError) {
         if(error?.details?.error) {
           throw new ApiAuthenticationError(error.details.error, error.status, error.details);
-        } else {
-          throw error;
         }
       }
+      throw error;
     }
   }
     
@@ -80,7 +79,7 @@ export default class Api {
    */
   me() {
     if (!this._loggedUser) {
-      throw new Error("Accès refusé : utilisateur non authentifié.");
+      throw new ApiAuthenticationError("Accès refusé : utilisateur non authentifié.");
     }
     return this._loggedUser;
   }
@@ -114,7 +113,7 @@ export default class Api {
     try {
       const oraganization = new Organization(this._client, organizationData);
       if (options.getProfile) {
-        await oraganization.getProfile();
+        await oraganization.getProfil();
       }
       return oraganization;
     } catch (error) {
@@ -136,7 +135,7 @@ export default class Api {
     try {
       const project = new Project(this._client, projectData);
       if (options.getProfile) {
-        await project.getProfile();
+        await project.getProfil();
       }
       return project;
     } catch (error) {

package/src/ApiClient.js

@@ -1,5 +1,6 @@
 import { EventEmitter } from "events";
 
+import { AggregateAjvError } from "@segment/ajv-human-errors";
 import Ajv from "ajv";
 import addFormats from "ajv-formats";
 import axios from "axios";
@@ -10,7 +11,7 @@ import pino from "pino";
 
 import MongoID from "./EJSONType.js";
 import endpointsJson from "./endpoints.module.js";
-import { ApiClientError, CircuitBreakerError } from "./error.js";
+import { ApiClientError, ApiResponseError, ApiValidationError, CircuitBreakerError } from "./error.js";
 
 EJSON.addType("oid", value => {
   return new MongoID.ObjectID(value);
@@ -74,7 +75,7 @@ export default class ApiClient extends EventEmitter {
     };
 
     // AJV
-    this._ajv = new Ajv({ strict: false, useDefaults: true });
+    this._ajv = new Ajv({ strict: false, useDefaults: true, allErrors: true, verbose: true });
     addFormats(this._ajv);
 
     // Pino logger
@@ -470,6 +471,15 @@ export default class ApiClient extends EventEmitter {
     return obj;
   }
   
+  /**
+   * Safely calls an asynchronous function and handles any errors that occur.
+   * Logs the error message using the instance's logger before re-throwing the error.
+   *
+   * @param {Function} fn - The asynchronous function to be called.
+   * @param {...any} args - The arguments to pass to the function.
+   * @returns {Promise<any>} The result of the asynchronous function.
+   * @throws {Error} Re-throws any error that occurs during the function execution.
+   */
   async safeCall(fn, ...args) {
     try {
       return await fn(...args);
@@ -543,8 +553,9 @@ export default class ApiClient extends EventEmitter {
       const valid = validatePathParams(pathParams);
   
       if (!valid) {
+        const errorMessages = this._ajvErrorHuman(validatePathParams.errors);
         this.emit("validationError", { stage: "pathParams", errors: validatePathParams.errors });
-        throw new ApiClientError("Path parameter validation failed.", 400, validatePathParams.errors);
+        throw new ApiValidationError("Path parameter validation failed.", 400, errorMessages, validatePathParams.errors);
       }
   
       resolvedParams = this._resolveSpecialValuesInPlace(pathParams);
@@ -571,8 +582,9 @@ export default class ApiClient extends EventEmitter {
       const validateRequest = this._ajv.compile(schemaToCompile);
       const valid = validateRequest(cleanedData);
       if (!valid) {
+        const errorMessages = this._ajvErrorHuman(validateRequest.errors);
         this.emit("validationError", { stage: "request", errors: validateRequest.errors });
-        throw new ApiClientError("Request validation failed.", 400, validateRequest.errors);
+        throw new ApiValidationError("Request validation failed.", 400, errorMessages, validateRequest.errors);
       }
 
       data = this._resolveSpecialValuesInPlace(cleanedData, resolvedParams);
@@ -603,8 +615,9 @@ export default class ApiClient extends EventEmitter {
           const validateResponse = this._ajv.compile(schema);
           const valid = validateResponse(response.data);
           if (!valid) {
+            const errorMessages = this._ajvErrorHuman(validateResponse.errors);
             this.emit("validationError", { stage: "response", errors: validateResponse.errors });
-            throw new ApiClientError("Response validation failed.", status, validateResponse.errors);
+            throw new ApiValidationError("Response validation failed.", status, errorMessages, validateResponse.errors);
           }
         }
       }
@@ -674,6 +687,65 @@ export default class ApiClient extends EventEmitter {
     }
   }
   
+  /**
+   * Converts AJV (Another JSON Schema Validator) errors into human-readable messages.
+   *
+   * @param {Array} errors - An array of AJV validation error objects.
+   * @returns {Array<string>} An array of human-readable error messages extracted from the AJV errors.
+   */
+  _ajvErrorHuman(errors){
+    const errorsMessages = new AggregateAjvError(errors);
+    const messages = errorsMessages.errors.map(({ message }) => message);
+    return messages;
+  }
+
+  /**
+   * Checks the API response for errors and throws an `ApiResponseError` if any are found.
+   *
+   * This method examines the `response.data` object to determine if it contains
+   * error information. It handles both standard and nested error cases:
+   * 
+   * - Standard case: If `data.result` is a boolean and is `false`, an error is thrown.
+   * - Nested case: If `data.resultErrors` exists and contains a `result` property
+   *   that is a boolean and is `false`, an error is thrown.
+   *
+   * If no errors are found, the original `response` is returned.
+   *
+   * @param {Object} response - The API response object to check.
+   * @param {Object} response.data - The data payload of the response.
+   * @param {number} response.status - The HTTP status code of the response.
+   * @throws {ApiResponseError} If an error is detected in the response data.
+   * @returns {Object} The original `response` object if no errors are found.
+   */
+  checkAndThrowApiResponseError(response) {
+    const data = response.data;
+    if (!data || typeof data !== "object") {
+      return response;
+    }
+  
+    // Cas standard : vérifie si data.result vaut false
+    if (typeof data.result === "boolean" && data.result === false) {
+      throw new ApiResponseError(
+        data.msg || "Erreur inconnue",
+        response.status,
+        data
+      );
+    }
+  
+    // Cas imbriqué : vérifie si data.resultErrors existe et contient une erreur
+    if (data.resultErrors && typeof data.resultErrors === "object") {
+      if (typeof data.resultErrors.result === "boolean" && data.resultErrors.result === false) {
+        throw new ApiResponseError(
+          data.resultErrors.msg || "Erreur inconnue",
+          response.status,
+          data
+        );
+      }
+    }
+  
+    return response;
+  }
+    
   /**
  * Réinitialise complètement la session de l'utilisateur :
  * - Token d'accès

package/src/api/EntityMixin.js

@@ -8,25 +8,31 @@ export const EntityMixin = {
      * @returns {Promise<string>} L'identifiant résolu.
      */
   async resolveId(type) {
-    return this.apiClient.safeCall(async () => {
-      if (!this.id && this.slug) {
-        const response = await this.apiClient.callEndpoint("GET_ELEMENTS_KEY", {
+    if (!this.id && this.slug) {
+      try {
+        const data = await this._getElementsKey({
           pathParams:{
             slug: this.slug
           }
         });
-        if(response?.data?.result === true) {
-          if(response?.data?.contextId && response?.data?.contextType === type) {
-            this.id = response.data.contextId;
+        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(`Le slug ${this.slug} ne correspond pas à un ${type}`, response.status, response.data);
+            throw new ApiResponseError(`Impossible de récupérer l'identifiant pour le slug ${this.slug}`, error.status, error.responseData);
           }
         } else {
-          throw new ApiResponseError(`Impossible de récupérer l'identifiant pour le slug ${this.slug}`, response.status, response.data);
+          throw error;
         }
       }
-      return this.id;
-    });
+    }
+    return this.id;
   },
   
   /**
@@ -34,10 +40,210 @@ export const EntityMixin = {
      * @returns {Promise<Object>} Les données du profil public.
      */
   async getPublicProfile() {
-    return this.apiClient.safeCall(async () => {
-      await this.resolveId(this.getEntityType());
-      return this.apiClient.callEndpoint("GET_ELEMENTS_ABOUT", { pathParams: { id: this.id } });
-    });
+    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

@@ -0,0 +1,168 @@
+// 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);
+  }
+
+};
+