@communecter/cocolight-api-client 1.0.46 → 1.0.48

package/package.json

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

package/src/ApiClient.js

@@ -1074,7 +1074,7 @@ export default class ApiClient extends EventEmitter {
         data.results = Object.keys(data.results).map((key) => {
           return this._normalizeJsonData({ id: key, ...data.results[key] });
         });
-      } else if (Array.isArray(data.results)) {
+      } else if (Array.isArray(data.results) && data.results.length > 0) {
         data.results = data.results.map((item) => this._normalizeJsonData(item));
       } else if (data.news && Array.isArray(data.news) && data.news.length === 0) {
         data = data.news;
@@ -1441,7 +1441,9 @@ export default class ApiClient extends EventEmitter {
     "profilRealBannerUrl",
     "imagePath",
     "imageThumbPath",
-    "docPath"
+    "docPath",
+    "imageThumb",
+    "imageMediumPath"
   ];
 
   /**

package/src/api/BaseEntity.js

@@ -1080,6 +1080,57 @@ export class BaseEntity {
     return Object.keys(changed).length > 0 ? changed : null;
   }
 
+  /**
+   * Extrait tous les champs valides selon le schéma, et retourne uniquement ceux qui ont changé par rapport au draft initial.
+   * Contrairement à `_extractChangedFieldsFromSchema`, cette méthode retourne l'ensemble des champs valides (`updated`)
+   * uniquement s'il y a au moins un champ modifié (`changed`).
+   *
+   * ⚠️ Les champs sont filtrés en fonction :
+   * - des champs définis comme modifiables dans le schéma (`writeable`)
+   * - des champs non exclus dans `removeFields`
+   * - des champs définis dans `data` (les `undefined` sont ignorés)
+   *
+   * @param {ApiClient} apiClient - L’instance de client API contenant les schémas.
+   * @param {string} constant - Le nom de la constante de schéma (ex: "ADD_EVENT").
+   * @param {Object} data - Les nouvelles données à comparer avec le draft initial.
+   * @param {() => Object} getInitialDraft - Fonction qui retourne le draft initial (souvent `this.initialDraftData`).
+   * @param {string[]} [removeFields=[]] - Champs à ignorer même s’ils sont valides.
+   * @returns {Object|null} - Un objet `updated` avec les champs valides si au moins un champ a changé, sinon `null`.
+   * @private
+   */
+  _extractAllValidFieldsFromSchema(apiClient, constant, data = {}, getInitialDraft, removeFields = []) {
+    const schema = apiClient.getRequestSchema(constant);
+    let allowed = this._extractWritableFields(schema, data);
+    const changed = {};
+    const updated = {};
+    const initialDraft = getInitialDraft?.() || {};
+  
+    // on enlève les champs qui ne sont pas dans le draft
+    // ou qui sont dans removeFields
+    allowed = allowed.filter(k => !removeFields.includes(k));
+
+    for (const key of allowed) {
+      // on verifie que le champ existe dans le draft
+      // sinon on ne le prend pas en compte
+
+      if (data[key] === undefined) continue;
+  
+      const current = data[key];
+      const initial = initialDraft[key];
+  
+      const changedValue =
+        JSON.stringify(current) !== JSON.stringify(initial);
+  
+      if (changedValue) {
+        changed[key] = current;
+      }
+
+      updated[key] = current;
+    }
+  
+    return Object.keys(changed).length > 0 ? updated : null;
+  }
+
   /**
    * ───────────────────────────────
    * MutualEntityMixin
@@ -2120,6 +2171,24 @@ export class BaseEntity {
     return this._createFilteredProxy(rawList);
   }
 
+  /**
+   * Récupérer la galerie d'une entité.
+   * Constant : GET_GALLERY
+   * @param {Object} data - Les données à envoyer.
+   * @param {string} data.pathParams.docType - Type de document (default: "image")
+   * @param {string} data.contentKey - Clé de contenu pour la galerie (default: "null")
+   * @param {string} data.folderId - ID du dossier pour la galerie (default: "null")
+   * @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 getGallery(data = {}) {
+    data.pathParams = { type: this.getEntityType(), id: this.id, docType: data.pathParams?.docType || "image" };
+    const arrayObjet =  await this.endpointApi.getGallery(data);
+
+    return arrayObjet;
+  }
+
   /**
    * Soumet une demande pour rejoindre l'entité courante (ex. organisation, projet, événement...).
    * Si une invitation est en attente, elle est automatiquement acceptée.

package/src/api/EndpointApi.js

@@ -1513,6 +1513,21 @@ class EndpointApi {
     return this.call("COSTUM_EVENT_REQUEST_LOAD_CONTEXT_TAG", data);
   }
     
+  /**
+   * Récupération de la galerie : Renvoie soit la liste d’albums associés à une entité, soit les images d’un album spécifique.
+   * Constant : GET_GALLERY
+   * @param {import("./EndpointApi.types").GetGalleryData} data - Données envoyées à l'API
+   * @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 getGallery(data) {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("GET_GALLERY", data);
+  }
+    
 }
 
 export default EndpointApi;

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

@@ -131,9 +131,9 @@ export interface UpdateSettingsData {
   type: string;
   value: unknown;
   /**
-   * Type d'élément (citoyens, projects, organizations)
+   * Type d'élément (citoyens, projects, organizations, events)
    */
-  typeEntity: "citoyens" | "projects" | "organizations";
+  typeEntity: "citoyens" | "projects" | "organizations" | "events";
   /**
    * Id de l'élément
    */
@@ -148,9 +148,9 @@ export interface UpdateBlockDescriptionData {
    */
   block: "descriptions";
   /**
-   * Type d'élément (citoyens, projects, organizations, poi)
+   * Type d'élément (citoyens, projects, organizations, poi, events)
    */
-  typeElement: "citoyens" | "projects" | "organizations" | "poi";
+  typeElement: "citoyens" | "projects" | "organizations" | "poi" | "events";
   /**
    * ID de l'élément concerné
    */
@@ -181,9 +181,9 @@ export interface UpdateBlockInfoData {
    */
   block: "info";
   /**
-   * Type d'élément (citoyens, projects, organizations, poi)
+   * Type d'élément (citoyens, projects, organizations, poi, events)
    */
-  typeElement: "citoyens" | "projects" | "organizations" | "poi";
+  typeElement: "citoyens" | "projects" | "organizations" | "poi" | "events";
   /**
    * ID de l'élément concerné
    */
@@ -274,7 +274,7 @@ export interface UpdateBlockLocalityData {
   /**
    * Type d'élément
    */
-  typeElement: "citoyens" | "projects" | "organizations" | "poi";
+  typeElement: "citoyens" | "projects" | "organizations" | "poi" | "events";
   /**
    * ID de l'élément concerné
    */
@@ -349,9 +349,9 @@ export interface UpdateBlockSlugData {
    */
   block: "info";
   /**
-   * Type d'élément (citoyens, projects, organizations, poi)
+   * Type d'élément (citoyens, projects, organizations, poi, events)
    */
-  typeElement: "citoyens" | "projects" | "organizations" | "poi";
+  typeElement: "citoyens" | "projects" | "organizations" | "poi" | "events";
   /**
    * ID de l'élément concerné
    */
@@ -377,7 +377,7 @@ export interface CheckData {
   /**
    * Type d'élément
    */
-  type: "citoyens" | "projects" | "organizations";
+  type: "citoyens" | "projects" | "organizations" | "events";
   /**
    * Slug à vérifier
    */
@@ -4412,3 +4412,31 @@ export interface CostumEventRequestLoadContextTagData {
   };
   [k: string]: unknown;
 }
+
+
+export interface GetGalleryData {
+  /**
+   * Clé de contenu pour correspondre à l'album ou aux images
+   */
+  contentKey?: string;
+  /**
+   * ID du dossier à récupérer (pour les images d'un album)
+   */
+  folderId?: string;
+  pathParams?: {
+    /**
+     * ID de l'entité
+     */
+    id: string;
+    /**
+     * Type d'entité
+     */
+    type: "citoyens" | "organizations" | "projects";
+    /**
+     * Type de document
+     */
+    docType: "image" | "file" | "bookmarks";
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}

package/src/api/Event.js

@@ -12,31 +12,59 @@ export class Event extends BaseEntity {
     // "UPDATE_BLOCK_INFO",
     // "UPDATE_BLOCK_SOCIAL",
     // "UPDATE_BLOCK_LOCALITY",
-    // "UPDATE_BLOCK_SLUG",
-    // "PROFIL_IMAGE"
+    "UPDATE_BLOCK_SLUG",
+    "PROFIL_IMAGE"
   ];
 
   static ADD_BLOCKS = new Map([
-    ["ADD_EVENT", "addEvent"]
+    ["ADD_EVENT", "addEvent"],
+    ["PROFIL_IMAGE", "updateImageProfil"]
   ]);
 
   static UPDATE_BLOCKS = new Map([
     // ["UPDATE_BLOCK_DESCRIPTION", "updateDescription"],
-    // ["UPDATE_BLOCK_INFO", "updateInfo"],
     // ["UPDATE_BLOCK_SOCIAL", "updateSocial"],
     // ["UPDATE_BLOCK_LOCALITY", "updateLocality"],
-    // ["UPDATE_BLOCK_SLUG", "updateSlug"],
-    // ["PROFIL_IMAGE", "updateImageProfil"]
+    // ["UPDATE_BLOCK_INFO", "updateInfo"],
+    ["UPDATE_BLOCK_SLUG", "updateSlug"],
+    ["PROFIL_IMAGE", "updateImageProfil"]
   ]);
 
   defaultFields = {
-
+    typeElement: this.getEntityType()
   };
 
-  removeFields = ["typeElement"];
+  removeFields = [
+    "typeElement"
+  ];
 
   transforms = {
-
+    parent: (val) => {
+      if (!val || typeof val !== "object") return null;
+    
+      return Object.fromEntries(
+        Object.entries(val).map(([key, obj]) => [
+          key,
+          {
+            type: obj?.type ?? null,
+            name: obj?.name ?? null
+          }
+        ])
+      );
+    },
+    organizer: (val) => {
+      if (!val || typeof val !== "object") return null;
+    
+      return Object.fromEntries(
+        Object.entries(val).map(([key, obj]) => [
+          key,
+          {
+            type: obj?.type ?? null,
+            name: obj?.name ?? null
+          }
+        ])
+      );
+    }
   };
 
   async _add(payload) {
@@ -73,9 +101,22 @@ export class Event extends BaseEntity {
       throw new ApiError("utilisation invalide de _update, utilisez save");
     }
 
-    if (payload.id) delete payload.id;
     let hasChanged = false;
 
+    const blockData = this._extractAllValidFieldsFromSchema(
+      this.apiClient,
+      "ADD_EVENT",
+      { ...payload, ...this.defaultFields },
+      () => this.initialDraftData,
+      this.removeFields
+    );
+    if (blockData && Object.keys(blockData).length > 0) {
+      await this["addEvent"](blockData);
+      hasChanged = true;
+    }
+
+    if (payload.id) delete payload.id;
+
     for (const [constant, methodName] of Event.UPDATE_BLOCKS) {
       const blockData = this._extractChangedFieldsFromSchema(
         this.apiClient,

package/src/api/Organization.js

@@ -214,6 +214,18 @@ export class Organization extends BaseEntity {
     return paginator.next();
   }
 
+  /**
+   * Récupère la galerie de l'organisation.
+   *
+   * @param {Object} data - Les données de requête.
+   * @returns {Promise<Object>} - Un objet contenant les éléments de la galerie.
+   * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async getGallery(data = {}) {
+    return super.getGallery(data);
+  }
+
   /**
    * Crée une instance de projet et récupère son profil si nécessaire.
    *

package/src/api/Project.js

@@ -225,6 +225,18 @@ export class Project extends BaseEntity {
     return paginator.next();
   }
 
+  /**
+   * Récupère la galerie d'un projet.
+   * 
+   * @param {Object} data - Les données de requête pour la galerie.
+   * @returns {Promise<Object>} - Un objet contenant les images de la galerie.
+   * @throws {ApiResponseError} - Si une erreur se produit lors de la récupération de la galerie.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async getGallery(data = {}) {
+    return super.getGallery(data);
+  }
+
   /**
    * Crée une instance de projet et récupère son profil si nécessaire.
    *

package/src/api/User.js

@@ -441,6 +441,14 @@ export class User extends BaseEntity {
     return filteredBadges;
   }
 
+  /**
+   * Récupérer la galerie de l'utilisateur
+   * Constant : GET_GALLERY
+   */
+  async getGallery(data = {}) {
+    return super.getGallery(data);
+  }
+
   async user(userData) {
     if(!this.isMe){
       throw new ApiError("Vous devez être connecté et être l'utilisateur");