@communecter/cocolight-api-client 1.0.6 → 1.0.7

package/src/ApiClient.js

@@ -190,6 +190,16 @@ export default class ApiClient extends EventEmitter {
     return this._refreshToken;
   }
 
+  /**
+   * Indique si le client est connecté.
+   * On considère que le client est connecté si un token d'accès (_accessToken) est défini.
+   *
+   * @returns {boolean} True si connecté, false sinon.
+   */
+  get isConnected() {
+    return !!this._accessToken;
+  }
+
   /**
  * Extrait l'identifiant depuis un JWT.
  *
@@ -202,10 +212,10 @@ export default class ApiClient extends EventEmitter {
       // Décodage du token grâce à jwt-decode
       const payload = jwtDecode(token);
       // L'identifiant peut être dans "id" ou "userId"
-      this._logger.log("[ApiClient] Payload décodé :", payload);
+      this._logger.debug("[ApiClient] Payload décodé :", payload);
       return payload.id || payload.userId || null;
     } catch (err) {
-      this._logger.error("[ApiClient] Erreur lors du décodage du token :", err.message);
+      this._logger.error("[ApiClient] Erreur lors du décodage du token :", err);
       return null;
     }
   }
@@ -232,6 +242,8 @@ export default class ApiClient extends EventEmitter {
       }
       return false;
     } catch (err) {
+      // Si on a une erreur, on reset la session
+      this.resetSession();
       this._logger.error(`[ApiClient] Refresh Error : ${err.message}`);
       return false;
     }
@@ -458,6 +470,14 @@ export default class ApiClient extends EventEmitter {
     return obj;
   }
   
+  async safeCall(fn, ...args) {
+    try {
+      return await fn(...args);
+    } catch (error) {
+      this._logger.error(`[ApiClient.safeCall] Erreur: ${error.message}`);
+      throw error;
+    }
+  }
 
   /**
    * Calls an API endpoint with the specified parameters.
@@ -645,7 +665,12 @@ export default class ApiClient extends EventEmitter {
       return response;
     } catch (error) {
       this._updateCircuitBreakerError();
-      throw error;
+      this._logger.error(`[ApiClient] Erreur lors de l'appel de ${constant}: ${error.message}`);
+      throw new ApiClientError(
+        `Erreur lors de l'appel de l'API : ${error.message}`,
+        error.response ? error.response.status : 500,
+        error.response ? error.response.data : null
+      );
     }
   }
   

package/src/api/EntityMixin.js

@@ -0,0 +1,43 @@
+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) {
+    return this.apiClient.safeCall(async () => {
+      if (!this.id && this.slug) {
+        const response = await this.apiClient.callEndpoint("GET_ELEMENTS_KEY", {
+          pathParams:{
+            slug: this.slug
+          }
+        });
+        if(response?.data?.result === true) {
+          if(response?.data?.contextId && response?.data?.contextType === type) {
+            this.id = response.data.contextId;
+          } else {
+            throw new ApiResponseError(`Le slug ${this.slug} ne correspond pas à un ${type}`, response.status, response.data);
+          }
+        } else {
+          throw new ApiResponseError(`Impossible de récupérer l'identifiant pour le slug ${this.slug}`, response.status, response.data);
+        }
+      }
+      return this.id;
+    });
+  },
+  
+  /**
+     * Récupère le profil public de l'entité.
+     * @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 } });
+    });
+  }
+};
+  

package/src/api/Organization.js

@@ -0,0 +1,79 @@
+import { EntityMixin } from "./EntityMixin.js";
+
+// Organization.js
+export class Organization {
+  // Champs privés pour protéger l'état
+  #id;
+  #slug;
+  #data = null;
+
+  /**
+   * Crée une instance de Organization.
+   * @param {ApiClient} apiClient - L'instance d'ApiClient.
+   * @param {Object} identifier - Objet contenant { id } ou { slug }.
+   */
+
+  constructor(apiClient, { id, slug } = {}) {
+    if (!id && !slug) {
+      throw new Error("Vous devez fournir un id ou un slug pour créer un User.");
+    }
+    this.apiClient = apiClient;
+    this.#id = id || null;
+    this.#slug = slug || null;
+  }
+  
+  // Getters en lecture seule pour chaque propriété
+  get id() {
+    return this.#id;
+  }
+      
+  get slug() {
+    return this.#slug;
+  }
+
+  _slug(newSlug) {
+    this.#slug = newSlug;
+  }
+      
+  get isConnected() {
+    return this.apiClient.isConnected;
+  }
+
+  get data() {
+    return this.#data;
+  }
+
+  _setData(newData) {
+    this.#data = newData;
+  }
+
+  get userId() {
+    return this.apiClient.userId;
+  }
+  
+  get isMe() {
+    return this.isConnected && this.userId === this.id;
+  }
+
+  getEntityType() {
+    return "organizations";
+  }
+
+  /**
+     * Récupère le profil complet de l'organisation.
+     *
+     * @returns {Promise<Object>} Le profil complet.
+     */
+  async getProfile() {
+    return this.apiClient.safeCall(async () => {
+      const response = await this.getPublicProfile();
+      this._setData(response.data);
+      return response.data;
+    });
+  }
+  
+}
+
+// Incorporation du mixin dans Organization
+Object.assign(Organization.prototype, EntityMixin);
+  

package/src/api/Project.js

@@ -0,0 +1,79 @@
+import { EntityMixin } from "./EntityMixin.js";
+
+// Project.js
+export class Project {
+  // Champs privés pour protéger l'état
+  #id;
+  #slug;
+  #data = null;
+
+  /**
+   * Crée une instance de Project.
+   * @param {ApiClient} apiClient - L'instance d'ApiClient.
+   * @param {Object} identifier - Objet contenant { id } ou { slug }.
+   */
+
+  constructor(apiClient, { id, slug } = {}) {
+    if (!id && !slug) {
+      throw new Error("Vous devez fournir un id ou un slug pour créer un User.");
+    }
+    this.apiClient = apiClient;
+    this.#id = id || null;
+    this.#slug = slug || null;
+  }
+  
+  // Getters en lecture seule pour chaque propriété
+  get id() {
+    return this.#id;
+  }
+      
+  get slug() {
+    return this.#slug;
+  }
+
+  _slug(newSlug) {
+    this.#slug = newSlug;
+  }
+      
+  get isConnected() {
+    return this.apiClient.isConnected;
+  }
+
+  get data() {
+    return this.#data;
+  }
+
+  _setData(newData) {
+    this.#data = newData;
+  }
+
+  get userId() {
+    return this.apiClient.userId;
+  }
+  
+  get isMe() {
+    return this.isConnected && this.userId === this.id;
+  }
+
+  getEntityType() {
+    return "projects";
+  }
+
+  /**
+     * Récupère le profil complet de l'organisation.
+     *
+     * @returns {Promise<Object>} Le profil complet.
+     */
+  async getProfile() {
+    return this.apiClient.safeCall(async () => {
+      const response = await this.getPublicProfile();
+      this._setData(response.data);
+      return response.data;
+    });
+  }
+  
+}
+
+// Incorporation du mixin dans Project
+Object.assign(Project.prototype, EntityMixin);
+  

package/src/api/User.js

@@ -0,0 +1,89 @@
+import { EntityMixin } from "./EntityMixin.js";
+
+// User.js
+export class User {
+  // Champs privés pour protéger l'état
+  #id;
+  #slug;
+  #data;
+
+  /**
+   * Crée une instance de User.
+   * @param {ApiClient} apiClient - L'instance d'ApiClient.
+   * @param {Object} identifier - Objet contenant { id } ou { slug }.
+   * @param {Object} [data={}] - Données supplémentaires.
+   */
+
+  constructor(apiClient, { id, slug } = {}, data = {}) {
+    if (!id && !slug) {
+      throw new Error("Vous devez fournir un id ou un slug pour créer un User.");
+    }
+    this.apiClient = apiClient;
+    this.#id = id || null;
+    this.#slug = slug || null;
+    this.#data = data;
+  }
+  
+  // Getters en lecture seule pour chaque propriété
+  get id() {
+    return this.#id;
+  }
+  
+  get slug() {
+    return this.#slug;
+  }
+
+  _slug(newSlug) {
+    this.#slug = newSlug;
+  }
+  
+  get isConnected() {
+    return this.apiClient.isConnected;
+  }
+
+  // Getter pour accéder aux données
+  get data() {
+    return this.#data;
+  }
+
+  // Méthode interne qui permet de mettre à jour les données
+  _setData(newData) {
+    this.#data = newData;
+  }
+
+  getEntityType() {
+    return "citoyens";
+  }
+
+  get userId() {
+    return this.apiClient.userId;
+  }
+  
+  get isMe() {
+    return this.isConnected && this.userId === this.id;
+  }
+
+  /**
+     * Récupère le profil complet de l'utilisateur.
+     * Si l'utilisateur est connecté, on appelle le endpoint ME_INFO_URL,
+     * sinon, on peut imaginer appeler un endpoint public.
+     *
+     * @returns {Promise<Object>} Le profil complet.
+     */
+  async getProfile() {
+    return this.apiClient.safeCall(async () => {
+      if (this.isMe) {
+        const response = await this.apiClient.callEndpoint("ME_INFO_URL", {});
+        return response.data;
+      } else {
+        const response = await this.getPublicProfile();
+        return response.data;
+      }
+    });
+  }
+  
+}
+
+// Incorporation du mixin dans User
+Object.assign(User.prototype, EntityMixin);
+  

package/src/api/UserApi.js

@@ -0,0 +1,48 @@
+// UserApi.js
+import ApiClient from "../ApiClient.js";
+import { ApiResponseError } from "../error.js";
+import { User } from "./User.js";
+
+export class UserApi {
+  constructor(options) {
+    // Injection de dépendance : ApiClient est créé à partir des options
+    this.client = new ApiClient(options);
+    this.loggedUser = null;
+  }
+  // Méthode d'authentification : récupère les données utilisateur depuis un endpoint
+  async login(email, password) {
+    return this.client.safeCall(async () => {
+    // Appel à un endpoint d'authentification
+      const response = await this.client.callEndpoint("AUTHENTICATE_URL", { email, password });
+      // Création d'une instance de LoggedInUser à partir des données reçues
+      this.loggedUser = new User(this.client, { id: response.data.user.id }, response.data.user);
+      return this.loggedUser;
+    });
+  }
+
+  async register({
+    name,
+    username,
+    email,
+    pwd,
+  } = {}) {
+    return this.client.safeCall(async () => {
+      const response = await this.client.callEndpoint("PERSON_REGISTER", { name, username, email, pwd });
+      if(response?.data?.result === false) {
+        throw new ApiResponseError(response.data.msg, response.status, response.data);
+      }
+      return response.data;
+    });
+  }
+
+
+  async recoverPassword(email) {
+    return this.client.safeCall(async () => {
+      const response = await this.client.callEndpoint("PASSWORD_RECOVERY", { email });
+      if(response?.data?.result === false) {
+        throw new ApiResponseError(response.data.msg, response.status, response.data);
+      }
+      return response.data;
+    });
+  }
+}