@communecter/cocolight-api-client 1.0.19 → 1.0.20

package/package.json

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

package/src/api/BaseEntity.js

@@ -15,7 +15,7 @@ export class BaseEntity {
     this.__entityTag = config.entityTag || this.constructor.name || "BaseEntity";
     this.deps = deps;
 
-    this.EndpointApiClass = deps.EndpointApi;
+    // this.EndpointApiClass = deps.EndpointApi;
 
     if (parent?.__entityTag === "ApiClient") {
       this.apiClient = parent;
@@ -27,9 +27,18 @@ export class BaseEntity {
       throw new ApiError("Parent invalide ou ApiClient manquant.");
     }
 
-    this.endpointApi = typeof deps.EndpointApi === "function"
-      ? new deps.EndpointApi(this.apiClient)
-      : deps.EndpointApi;
+    // this.endpointApi = typeof deps.EndpointApi === "function"
+    //   ? new deps.EndpointApi(this.apiClient)
+    //   : deps.EndpointApi;
+
+    // Gérer les deux cas : fonction constructeur ou instance
+    if (typeof deps.EndpointApi === "function") {
+      this.endpointApi = new deps.EndpointApi(this.apiClient);
+    } else if (typeof deps.EndpointApi === "object") {
+      this.endpointApi = deps.EndpointApi;
+    } else {
+      throw new ApiError("deps.EndpointApi doit être une classe ou une instance valide.");
+    }
 
     this._serverData = null;
 

package/src/api/User.js

@@ -1,15 +1,9 @@
 import { ApiError, ApiResponseError } from "../error.js";
-import { DraftStateMixin } from "../mixin/DraftStateMixin.js";
-import { MutualEntityMixin } from "../mixin/MutualEntityMixin.js";
+import BaseEntity from "./BaseEntity.js";
 import { UserMixin } from "../mixin/UserMixin.js";
-import { UtilMixin } from "../mixin/UtilMixin.js";
 
 // User.js
-export class User {
-  _draftData = {};
-  _initialDraftData = {};
-  _serverData = null;
-  _calledFromSave = false;
+export class User extends BaseEntity {
 
   static entityType = "citoyens";
 
@@ -31,6 +25,41 @@ export class User {
     ["PROFIL_IMAGE", "updateImageProfil"]
   ]);
 
+  /**
+   * Champs par défaut pour les schemas json ou l'on extrait les fields. (pour les if/else/then)
+   * 
+   * @property {Object} defaultFields - Un objet contenant les propriétés par défaut pour l'entité User.
+   */
+  defaultFields = {
+    typeElement: this.getEntityType(), 
+  };
+    
+  /**
+       * Champs à supprimer de draft lors de la construction du proxy.
+       * 
+       * @property {Array<string>} removeFields - Un tableau de chaînes représentant les champs à supprimer.
+       */
+  removeFields = [
+    "typeElement",
+  ];
+      
+  /**
+       * Transformateurs appliqués lors de la lecture du draft.
+       *
+       * @type {Object<string, function>}
+       */
+  transforms = {
+    github: (val, full) => full?.socialNetwork?.github,
+    gitlab: (val, full) => full?.socialNetwork?.gitlab,
+    facebook: (val, full) => full?.socialNetwork?.facebook,
+    twitter: (val, full) => full?.socialNetwork?.twitter,
+    instagram: (val, full) => full?.socialNetwork?.instagram,
+    diaspora: (val, full) => full?.socialNetwork?.diaspora,
+    mastodon: (val, full) => full?.socialNetwork?.mastodon,
+    telegram: (val, full) => full?.socialNetwork?.telegram,
+    signal: (val, full) => full?.socialNetwork?.signal
+  };
+      
   /**
    * Crée une instance de User.
    *
@@ -51,120 +80,33 @@ export class User {
    */
 
   constructor(parent, data = {}, deps = {}) {
-    this.__entityTag = "User";
-
     if(!deps.EndpointApi){
       throw new ApiError("EndpointApi class must be injected to avoid circular dependency.");
     }
     if (!data?.id && !data?.slug) {
       throw new ApiError("Vous devez fournir un id ou un slug pour créer un User.");
     }
-
+  
     if (!deps.Organization) throw new ApiError("Organization class must be injected.");
     if (!deps.Project) throw new ApiError("Project class must be injected.");
     if (!deps.Event) throw new ApiError("Event class must be injected.");
     if (!deps.Poi) throw new ApiError("Poi class must be injected.");
     if (!deps.Badge) throw new ApiError("Badge class must be injected.");
     if (!deps.News) throw new ApiError("News class must be injected.");
+      
+    super(parent, data, deps);
 
-    if (parent?.__entityTag === "ApiClient") {
-      this.apiClient = parent;
-      this.parent = null;
-    } else if (parent?.apiClient) {
-      this.apiClient = parent.apiClient;
-      this.parent = parent;
-    } else {
-      throw new ApiError("Parent invalide ou ApiClient manquant.");
-    }
-
-    this.deps = deps;
-
-    // Gérer les deux cas : fonction constructeur ou instance
-    if (typeof deps.EndpointApi === "function") {
-      this.endpointApi = new deps.EndpointApi(this.apiClient);
-    } else if (typeof deps.EndpointApi === "object") {
-      this.endpointApi = deps.EndpointApi;
-    } else {
-      throw new ApiError("deps.EndpointApi doit être une classe ou une instance valide.");
-    }
-
-    this._serverData = null;
-    
-    const { draft, proxy } = this._buildDraftAndProxy({
-      data: { ...data, ...this.defaultFields },
-      serverData: this._serverData,
-      constant: User.SCHEMA_CONSTANTS,
-      apiClient: this.apiClient,
-      transforms: this.transforms,
-      removeFields: this.removeFields
-    });
-    
-    this._initialDraftData = JSON.parse(JSON.stringify(draft)); // snapshot propre
-    this._draftData = draft;
-    this.data = proxy;
-  }
-
-  get id() {
-    return this._draftData.id || null;
-  }
-
-  _id(newId) {
-    this._draftData.id = newId;
+    // this.__entityTag = "User";
   }
       
   get slug() {
     return this._draftData.slug || null;
   }
   
-  get isConnected() {
-    return this.apiClient.isConnected;
-  }
-
-  _setData(newData) {
-    this._serverData = { ...newData };
-
-    const { draft, proxy } = this._buildDraftAndProxy({
-      data: { ...newData, ...this.defaultFields },
-      serverData: this._serverData,
-      constant: User.SCHEMA_CONSTANTS,
-      apiClient: this.apiClient,
-      transforms: this.transforms,
-      removeFields: this.removeFields
-    });
-    this._initialDraftData = JSON.parse(JSON.stringify(draft));
-    this._draftData = draft;
-    this.data = proxy;
-  }
-
-  getEntityType() {
-    return User.entityType;
-  }
-
-  get userId() {
-    return this.apiClient.userId;
-  }
-  
   get isMe() {
     return this.isConnected && this.userId === this.id;
   }
 
-  get draftData() {
-    return this._draftData;
-  }
-
-  get initialDraftData() {
-    return this._initialDraftData;
-  }
-  
-  get serverData() {
-    return this._serverData;
-  }
-
-  async refresh() {
-    if (!this.id) throw new ApiError("Impossible de rafraîchir sans ID.");
-    return this.get();
-  }
-
   /**
      * Récupère le profil complet de l'utilisateur.
      * Si l'utilisateur est connecté, on appelle le endpoint ME_INFO_URL,
@@ -210,26 +152,14 @@ export class User {
    * @throws {ApiError} - Si l'utilisateur n'est pas autorisé.
    */
   async save() {
-
     if(!this.isMe){
       throw new ApiError("Vous devez être connecté et être l'utilisateur pour sauvegarder.");
     }
-    this._calledFromSave = true;
-    try{
-      const payload = { ...this._draftData };
-  
-      if (this.id) {
-        const hasChanged = await this._update(payload);
-        if (hasChanged) {
-        // this._updateInitialDraftSnapshot();
-          await this.refresh();
-        }
-        return this._serverData;
-      }
-    } finally {
-      this._calledFromSave = false;
-    }
-  
+    await super.save();
+  }
+
+  async _add() {
+    throw new ApiError("Vous ne pouvez pas ajouter un utilisateur par ce moyen.");
   }
 
   /**
@@ -296,7 +226,10 @@ export class User {
    * @returns {Promise<void>} - Résultat de la mise à jour.
    */
   async updateSettings(data = {}) {
-    await this.callIsMe(() => this.endpointApi.updateSettings(data));
+    if(!this.isMe){
+      throw new ApiError("Vous devez être connecté et être l'utilisateur pour mettre à jour les paramètres.");
+    }
+    await super.updateSettings(data);
     await this.refresh();
   }
 
@@ -305,7 +238,10 @@ export class User {
    * Constant : UPDATE_BLOCK_DESCRIPTION
    */
   async updateDescription(data = {}) {
-    return this.callIsMe(() => this.endpointApi.updateBlockDescription(data));
+    if(!this.isMe){
+      throw new ApiError("Vous devez être connecté et être l'utilisateur pour mettre à jour la description.");
+    }
+    return super.updateDescription(data);
   }
   
   /**
@@ -313,7 +249,10 @@ export class User {
      * Constant : UPDATE_BLOCK_INFO
      */
   async updateInfo(data = {}) {
-    return this.callIsMe(() => this.endpointApi.updateBlockInfo(data));
+    if(!this.isMe){
+      throw new ApiError("Vous devez être connecté et être l'utilisateur pour mettre à jour les informations.");
+    }
+    return super.updateInfo(data);
   }
   
   /**
@@ -321,7 +260,10 @@ export class User {
      * Constant : UPDATE_BLOCK_SOCIAL
      */
   async updateSocial(data = {}) {
-    return this.callIsMe(() => this.endpointApi.updateBlockSocial(data));
+    if(!this.isMe){
+      throw new ApiError("Vous devez être connecté et être l'utilisateur pour mettre à jour les réseaux sociaux.");
+    }
+    return super.updateSocial(data);
   }
   
   /**
@@ -329,7 +271,10 @@ export class User {
      * Constant : UPDATE_BLOCK_LOCALITY
      */
   async updateLocality(data = {}) {
-    return this.callIsMe(() => this.endpointApi.updateBlockLocality(data));
+    if(!this.isMe){
+      throw new ApiError("Vous devez être connecté et être l'utilisateur pour mettre à jour la localité.");
+    }
+    return super.updateLocality(data);
   }
   
   /**
@@ -337,15 +282,10 @@ export class User {
      * Constant : UPDATE_BLOCK_SLUG
      */
   async updateSlug({ slug }) {
-    try {
-      await this.endpointApi.check({ slug });
-    } catch (error) {
-      if(error instanceof ApiResponseError) {
-        throw new ApiResponseError("Erreur lors de la vérification du slug.", error.status, error.data);
-      }
-      throw error;
+    if(!this.isMe){
+      throw new ApiError("Vous devez être connecté et être l'utilisateur pour mettre à jour le slug.");
     }
-    return this.callIsMe(() => this.endpointApi.updateBlockSlug({ slug }));
+    return super.updateSlug({ slug });
   }
 
   /**
@@ -353,8 +293,10 @@ export class User {
    * Constant : PROFIL_IMAGE
    */
   async updateImageProfil({ profil_avatar: image  }) {
-    image = await this._validateImage(image);
-    return this.callIsMe(() => this.endpointApi.profilImage({ profil_avatar: image }));
+    if(!this.isMe){
+      throw new ApiError("Vous devez être connecté et être l'utilisateur pour mettre à jour l'image de profil.");
+    }
+    return super.updateImageProfil({ profil_avatar: image });
   }
   
   /**
@@ -404,37 +346,7 @@ export class User {
    * Constant : GET_PROJECTS_ADMIN | GET_PROJECTS_NO_ADMIN
    */
   async getProjects(data = {}) {
-    delete data?.pathParams;
-  
-    const fetchFn = this.isMe
-      ? () => this.callIsMe(() => this.endpointApi.getProjectsAdmin(data))
-      : () => this.endpointApi.getProjectsNoAdmin(data);
-  
-    if (!this.isMe && !data.filters) {
-      data.filters = {
-        "$or": {
-          [`links.contributors.${this.id}`]: { "$exists": true },
-          [`parent.${this.id}`]: { "$exists": true }
-        },
-        [`links.contributors.${this.id}`]: { "$exists": true }
-        // TODO : revoir les filtres pour harmoniser avec orga (schema pris de cocolight)
-      };
-    }
-  
-    const arrayObjetProjects = await fetchFn();
-  
-    if (!Array.isArray(arrayObjetProjects.results)) {
-      throw new ApiResponseError("Erreur lors de la récupération des projets.", 500, arrayObjetProjects.results);
-    }
-
-    const rawProjectsList = arrayObjetProjects.results.map(
-      (d) => this.linkEntity?.(d.collection, d) ?? d
-    );
-  
-    return {
-      count: arrayObjetProjects?.count?.projects ?? 0,
-      results: rawProjectsList
-    };
+    return super.getProjects(data);
   }
 
   /**
@@ -442,33 +354,7 @@ export class User {
    * Constant : GET_POIS_NO_ADMIN / GET_POIS_ADMIN
    */
   async getPois(data = {}) {
-    delete data?.pathParams;
-  
-    const fetchFn = this.isMe
-      ? () => this.callIsMe(() => this.endpointApi.getPoisAdmin(data))
-      : () => this.endpointApi.getPoisNoAdmin(data);
-  
-    
-    if (!this.isMe && !data.filters) {
-      data.filters = {
-        [`parent.${this.id}`]: { "$exists": true },
-      };
-    }
-  
-    const arrayObjetPois = await fetchFn();
-    if (!Array.isArray(arrayObjetPois.results)) {
-      throw new ApiResponseError("Erreur lors de la récupération des POIs.", 500, arrayObjetPois.results);
-    }
-
-    // lier les entités au objets
-    const rawPoisList = arrayObjetPois.results.map(
-      (d) => this.linkEntity?.(d.collection, d) ?? d
-    );
-
-    return {
-      count: arrayObjetPois.count?.poi ?? 0,
-      results: rawPoisList
-    };
+    return super.getPois(data);
   }
 
   /**
@@ -476,23 +362,7 @@ export class User {
    * Constant : GET_NEWS
    */
   async getNews(data = {}) {
-    if (data.pathParams) {
-      delete data.pathParams;
-    }
-    if (!this.isMe){
-      // is not me add id
-      data.pathParams = { id: this.id };
-    }
-    const arrayObjetNews =  await this.endpointApi.getNews(data);
-    if(!Array.isArray(arrayObjetNews)){
-      throw new ApiResponseError("Erreur lors de la récupération des actualités.", 500, arrayObjetNews);
-    }
-
-    const rawNewsList = arrayObjetNews.map(
-      (d) => this.linkEntity?.(d.collection, d) ?? d
-    );
-
-    return this._createFilteredProxy(rawNewsList);
+    return super.getNews(data);
   }
 
   /**
@@ -563,28 +433,7 @@ export class User {
    * Constant : GET_SUBSCRIBERS
    */
   async getSubscribers(data = {}) {
-    delete data?.pathParams;
-  
-    if (!this.isMe && !data.filters) {
-      data.filters = {
-        [`links.follows.${this.id}`]: { "$exists": true },
-      };
-    }
-  
-    const arrayObjetSubscribers = await  this.endpointApi.getSubscribers(data);
-    if (!Array.isArray(arrayObjetSubscribers.results)) {
-      throw new ApiResponseError("Erreur lors de la récupération des abonnés.", 500, arrayObjetSubscribers.results);
-    }
-
-    // lier les entités au objets
-    const rawSubscribersList = arrayObjetSubscribers.results.map(
-      (d) => this.linkEntity?.(d.collection, d) ?? d
-    );
-
-    return {
-      count: arrayObjetSubscribers.count,
-      results: rawSubscribersList
-    };
+    return super.getSubscribers(data);
   }
 
   /**
@@ -598,26 +447,7 @@ export class User {
    * Constant : GET_BADGES
    */
   async getBadgesIssuer(data = {}) {
-    delete data?.pathParams;
-  
-    data.filters = data.filters || {};
-    data.filters["$or"] = {};
-    data.filters["$or"][`issuer.${this.id}`] = { "$exists": true };
-
-    const arrayObjetBadges = await this.endpointApi.getBadges(data);
-    if (!Array.isArray(arrayObjetBadges.results)) {
-      throw new ApiResponseError("Erreur lors de la récupération des badges.", 500, arrayObjetBadges.results);
-    }
-
-    // lier les entités au objets
-    const rawBadgesList = arrayObjetBadges.results.map(
-      (d) => this.linkEntity?.(d.collection, d) ?? d
-    );
-
-    return {
-      count: arrayObjetBadges.count?.badges ?? 0,
-      results: rawBadgesList
-    };
+    return super.getBadgesIssuer(data);
   }
 
   /**
@@ -655,7 +485,7 @@ export class User {
     if(!this.isMe){
       throw new ApiError("Vous devez être connecté et être l'utilisateur pour créer une organisation.");
     }
-    return this.entity("organizations", organizationData);
+    return super.organization(organizationData);
   }
 
   /**
@@ -669,7 +499,7 @@ export class User {
     if(!this.isMe){
       throw new ApiError("Vous devez être connecté et être l'utilisateur pour créer un projet.");
     }
-    return this.entity("projects", projectData);
+    return super.project(projectData);
   }
 
   /**
@@ -683,7 +513,7 @@ export class User {
     if(!this.isMe){
       throw new ApiError("Vous devez être connecté et être l'utilisateur pour créer une actualité.");
     }
-    return this.entity("news", newsData);
+    return super.news(newsData);
   }
 
   /**
@@ -697,7 +527,7 @@ export class User {
     if(!this.isMe){
       throw new ApiError("Vous devez être connecté et être l'utilisateur pour créer un POI.");
     }
-    return this.entity("poi", poiData);
+    return super.poi(poiData);
   }
 
   /**
@@ -711,7 +541,7 @@ export class User {
     if(!this.isMe){
       throw new ApiError("Vous devez être connecté et être l'utilisateur pour créer un événement.");
     }
-    return this.entity("events", eventData);
+    return super.event(eventData);
   }
 
   /**
@@ -725,54 +555,11 @@ export class User {
     if(!this.isMe){
       throw new ApiError("Vous devez être connecté et être l'utilisateur pour créer un badge.");
     }
-    return this.entity("badges", badgeData);
-  }
-
-  _updateInitialDraftSnapshot() {
-    this._initialDraftData = JSON.parse(JSON.stringify(this._draftData));
+    return super.badge(badgeData);
   }
 
-  // TODO: ne fonctionne pas
-  hasChanges() {
-    return JSON.stringify(this._draftData) !== JSON.stringify(this._initialDraftData);
-  }
-
-  /**
-   * Champs par défaut pour les schemas json ou l'on extrait les fields. (pour les if/else/then)
-   * 
-   * @property {Object} defaultFields - Un objet contenant les propriétés par défaut pour l'entité User.
-   */
-  defaultFields = {
-    typeElement: this.getEntityType(), 
-  };
-
-  /**
-   * Champs à supprimer de draft lors de la construction du proxy.
-   * 
-   * @property {Array<string>} removeFields - Un tableau de chaînes représentant les champs à supprimer.
-   */
-  removeFields = [
-    "typeElement",
-  ];
-  
-  /**
-   * Transformateurs appliqués lors de la lecture du draft.
-   *
-   * @type {Object<string, function>}
-   */
-  transforms = {
-    github: (val, full) => full?.socialNetwork?.github,
-    gitlab: (val, full) => full?.socialNetwork?.gitlab,
-    facebook: (val, full) => full?.socialNetwork?.facebook,
-    twitter: (val, full) => full?.socialNetwork?.twitter,
-    instagram: (val, full) => full?.socialNetwork?.instagram,
-    diaspora: (val, full) => full?.socialNetwork?.diaspora,
-    mastodon: (val, full) => full?.socialNetwork?.mastodon,
-    telegram: (val, full) => full?.socialNetwork?.telegram,
-    signal: (val, full) => full?.socialNetwork?.signal
-  };
 }
 
 // Incorporation des mixins dans User
-Object.assign(User.prototype, MutualEntityMixin, UtilMixin, UserMixin, DraftStateMixin);
+Object.assign(User.prototype, UserMixin);