@communecter/cocolight-api-client 1.0.54 → 1.0.56

package/src/api/EntityRegistry.js

@@ -1,152 +0,0 @@
-export const EntityRegistry = new Map();
-
-/**
- * Enregistre une entité dans la registry.
- * @param {string} tag - ex: "User", "Organization"
- * @param {Function} EntityClass - la classe constructeur
- */
-export function registerEntity(tag, EntityClass) {
-  EntityRegistry.set(tag, EntityClass);
-}
-
-/**
- * Récupère une instance depuis un JSON générique.
- * @param {Object} json - doit contenir __entityTag
- * @param {Object} parent - ApiClient ou entité parent
- * @param {Object} deps - dépendances (comme dans le constructeur)
- * @returns {BaseEntity|null}
- */
-export function fromEntityJSON(json, parent = null) {
-  if (!json?.__entityTag) return null;
-  if (!json.serverData?.collection) return json;
-  const meta = _getEntityMeta(json.serverData.collection, json.__entityTag);
-  if (!meta) return json;
-  if (!meta?.entityClass?.fromJSON) throw new Error(`Classe inconnue ou fromJSON manquant pour ${json.__entityTag}`);
-  return meta.entityClass.fromJSON(json, parent, meta.deps);
-}
-
-/**
-   * Récupère la classe d'entité et ses dépendances à partir du type d'entité.
-   * 
-   * @param {string} entityType - Le type d'entité.
-   * @param {string} __entityTag - Le tag de l'entité.
-   * @returns {Object|null} - Un objet contenant la classe d'entité et ses dépendances, ou null si le type d'entité n'est pas trouvé.
-   */
-function _getEntityMeta(entityType, __entityTag) {
-  const selfClass = EntityRegistry.get(__entityTag);
-  const selfTag = __entityTag;
-  
-  const commonDeps = {
-    EndpointApi: EntityRegistry.get("EndpointApi"),
-    User: selfTag === "User" ? selfClass : EntityRegistry.get("User"),
-    Organization: selfTag === "Organization" ? selfClass : EntityRegistry.get("Organization"),
-    Project: selfTag === "Project" ? selfClass : EntityRegistry.get("Project"),
-    Event: selfTag === "Event" ? selfClass : EntityRegistry.get("Event"),
-    Poi: selfTag === "Poi" ? selfClass : EntityRegistry.get("Poi"),
-    Badge: selfTag === "Badge" ? selfClass : EntityRegistry.get("Badge"),
-    News: selfTag === "News" ? selfClass : EntityRegistry.get("News")
-  };
-  
-  const map = {
-    citoyens:     { entityClass: commonDeps.User,         deps: commonDeps },
-    organizations:{ entityClass: commonDeps.Organization, deps: commonDeps },
-    projects:      { entityClass: commonDeps.Project,      deps: commonDeps },
-    events:       { entityClass: commonDeps.Event,        deps: { ...commonDeps, Badge: undefined } },
-    poi:          { entityClass: commonDeps.Poi,          deps: { ...commonDeps, Badge: undefined, News: undefined } },
-    news:         { entityClass: commonDeps.News,         deps: { ...commonDeps } },
-    badges:       { entityClass: commonDeps.Badge,        deps: { 
-      EndpointApi: commonDeps.EndpointApi, 
-      User: commonDeps.User, 
-      Organization: commonDeps.Organization, 
-      Project: commonDeps.Project 
-    } }
-  };
-  
-  return map[entityType] || null;
-}
-
-/**
- * Crée une instance d'entité basée sur le seul nom de la collection.
- * @param {string} collection - ex: "citoyens", "projects", ...
- * @param {Object} parent - ApiClient ou entité parente
- * @returns {BaseEntity|null}
- */
-export function createFromCollection(collection, parent = null, data = {}) {
-  const _collectionMap = {
-    citoyens: {
-      entityTag: "User",
-      meta: tag => _buildMeta(tag, { remove: [] })
-    },
-    organizations: {
-      entityTag: "Organization",
-      meta: tag => _buildMeta(tag, { remove: [] })
-    },
-    projects: {
-      entityTag: "Project",
-      meta: tag => _buildMeta(tag, { remove: [] })
-    },
-    events: {
-      entityTag: "Event",
-      meta: tag => _buildMeta(tag, { remove: ["Badge"] })
-    },
-    poi: {
-      entityTag: "Poi",
-      meta: tag => _buildMeta(tag, { remove: ["Badge","News"] })
-    },
-    news: {
-      entityTag: "News",
-      meta: tag => _buildMeta(tag, { remove: [] })
-    },
-    badges: {
-      entityTag: "Badge",
-      meta: tag => _buildCustomMeta(tag)
-    }
-  };
-  const entry = _collectionMap[collection];
-  if (!entry) {
-    console.warn(`Collection inconnue : '${collection}'`);
-    return null;
-  }
-  const { entityTag, meta } = entry;
-  const { entityClass, deps } = meta(entityTag);
-  return new entityClass(parent, data, deps);
-}
-
-/**
- * Construit entityClass et deps pour une collection standard.
- * @param {string} tag
- * @param {{remove: string[]}} options
- */
-function _buildMeta(tag, options) {
-  const EntityClass = EntityRegistry.get(tag);
-  const allDeps = {
-    EndpointApi: EntityRegistry.get("EndpointApi"),
-    User: EntityRegistry.get("User"),
-    Organization: EntityRegistry.get("Organization"),
-    Project: EntityRegistry.get("Project"),
-    Event: EntityRegistry.get("Event"),
-    Poi: EntityRegistry.get("Poi"),
-    Badge: EntityRegistry.get("Badge"),
-    News: EntityRegistry.get("News")
-  };
-  // inject self
-  allDeps[tag] = EntityClass;
-  // remove undesired
-  options.remove.forEach(dep => delete allDeps[dep]);
-  return { entityClass: EntityClass, deps: allDeps };
-}
-
-/**
- * Cas spécifique des badges : seules certaines dépendances.
- */
-function _buildCustomMeta(tag) {
-  const EntityClass = EntityRegistry.get(tag);
-  const deps = {
-    EndpointApi: EntityRegistry.get("EndpointApi"),
-    User: EntityRegistry.get("User"),
-    Organization: EntityRegistry.get("Organization"),
-    Project: EntityRegistry.get("Project")
-  };
-  deps[tag] = EntityClass;
-  return { entityClass: EntityClass, deps };
-}

package/src/api/Event.js

@@ -1,226 +0,0 @@
-import { ApiError } from "../error.js";
-import BaseEntity from "./BaseEntity.js";
-
-export class Event extends BaseEntity {
-  static entityType = "events";
-
-  static entityTag = "Event";
-
-  static SCHEMA_CONSTANTS = [
-    "ADD_EVENT",
-    // "UPDATE_BLOCK_DESCRIPTION",
-    // "UPDATE_BLOCK_INFO",
-    // "UPDATE_BLOCK_SOCIAL",
-    // "UPDATE_BLOCK_LOCALITY",
-    "UPDATE_BLOCK_SLUG",
-    "PROFIL_IMAGE"
-  ];
-
-  static ADD_BLOCKS = new Map([
-    ["ADD_EVENT", "addEvent"],
-    ["PROFIL_IMAGE", "updateImageProfil"]
-  ]);
-
-  static UPDATE_BLOCKS = new Map([
-    // ["UPDATE_BLOCK_DESCRIPTION", "updateDescription"],
-    // ["UPDATE_BLOCK_SOCIAL", "updateSocial"],
-    // ["UPDATE_BLOCK_LOCALITY", "updateLocality"],
-    // ["UPDATE_BLOCK_INFO", "updateInfo"],
-    ["UPDATE_BLOCK_SLUG", "updateSlug"],
-    ["PROFIL_IMAGE", "updateImageProfil"]
-  ]);
-
-  defaultFields = {
-    typeElement: this.getEntityType()
-  };
-
-  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) {
-    if (!this._calledFromSave) {
-      throw new ApiError("utilisation invalide de _add, utilisez save");
-    }
-
-    payload.id = this._newId?.();
-    if (payload.slug) delete payload.slug;
-
-    for (const [constant, methodName] of Event.ADD_BLOCKS) {
-      const blockData = this._extractChangedFieldsFromSchema(
-        this.apiClient,
-        constant,
-        { ...payload, ...this.defaultFields },
-        () => {}
-      );
-      if (blockData && Object.keys(blockData).length > 0) {
-        const data = await this[methodName](blockData);
-        if (!this.id && data?.map?.id) {
-          this._draftData.id = data.map.id;
-          this._draftData.slug = data.map.slug;
-        }
-      }
-    }
-  }
-
-  async _update(payload) {
-    if(!this.isAdmin()){
-      throw new ApiError("Vous n'avez pas les droits pour modifier cet événement", 403);
-    }
-
-    if (!this._calledFromSave) {
-      throw new ApiError("utilisation invalide de _update, utilisez save");
-    }
-
-    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,
-        constant,
-        { ...payload, ...this.defaultFields },
-        () => this.initialDraftData,
-        this.removeFields
-      );
-      if (blockData && Object.keys(blockData).length > 0) {
-        await this[methodName](blockData);
-        hasChanged = true;
-      }
-    }
-
-    return hasChanged;
-  }
-
-  async addEvent(data = {}) {
-
-    if (!this.isMe && !data.organizer) {
-      data.organizer = {};
-      data.organizer[`${this.parent.id}`] = {
-        type: this.parent.getEntityType(),
-        name: this.parent.name
-      };
-    }
-
-    return this.callIsConnected(() => this.endpointApi.addEvent(data));
-  }
-
-  async getOrganizations() {
-    throw new ApiError(`getOrganizations n'existe pas dans ${this.constructor.name}`);
-  }
-
-  async getProjects() {
-    throw new ApiError(`getProjects n'existe pas dans ${this.constructor.name}`);
-  }
-
-  async getEvents() {
-    throw new ApiError(`getEvents - les sous-events ne sont pas encore implémentés dans ${this.constructor.name}`);
-  }
-
-  async getPois() {
-    throw new ApiError(`getPois n'existe pas dans ${this.constructor.name}`);
-  }
-
-  async getBadgesIssuer() {
-    throw new ApiError(`getBadgesIssuer n'existe pas dans ${this.constructor.name}`);
-  }
-
-  async getNews(data = {}) {
-    return super.getNews(data);
-  }
-
-  async getSubscribers(data = {}) {
-    return super.getSubscribers(data);
-  }
-
-  async project() {
-    throw new ApiError(`project n'existe pas dans ${this.constructor.name}`);
-  }
-
-  async poi() {
-    throw new ApiError(`poi n'existe pas dans ${this.constructor.name}`);
-  }
-
-  async event() {
-    throw new ApiError(`les sous-events ne sont pas encore implémentés dans ${this.constructor.name}`);
-  }
-
-  async badge() {
-    throw new ApiError(`badge n'existe pas dans ${this.constructor.name}`);
-  }
-
-  /**
-   * Crée une instance de news et la récupère si nécessaire.
-   * 
-   * @param {Object} newsData - Les données nécessaires pour initialiser la news.
-   * @returns {Promise<News>} Une promesse qui résout l'objet News créé.
-   * @throws {Error} Si une erreur se produit lors de la création de la news.
-   */
-  async news(newsData = {}) {
-    return super.news(newsData);
-  }
-
-  /**
-   * Suivre un événement.
-   * Cette action permet à l'utilisateur de suivre un événement.
-   * 
-   * @returns {Promise<Object>} - Résultat de l'action de suivi.
-   * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si l'entité ne supporte pas l'action.
-   */
-  async follow() {
-    return super.follow();
-  }
-
-  /**
-   * Se désabonne d'un événement.
-   * 
-   * @returns {Promise<Object>} - Résultat de la désinscription.
-   * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si l'entité n'est pas enregistrée.
-   */
-  async unfollow() {
-    return super.unfollow();
-  }
-  
-}

package/src/api/News.js

@@ -1,244 +0,0 @@
-import { ApiError } from "../error.js";
-import BaseEntity from "./BaseEntity.js";
-
-export class News extends BaseEntity {
-  static entityType = "news";
-
-  static entityTag = "News";
-
-  static SCHEMA_CONSTANTS = [
-    "ADD_NEWS"
-  ];
-
-  static ADD_BLOCKS = new Map([
-    ["ADD_NEWS", "addNews"]
-  ]);
-
-  static UPDATE_BLOCKS = new Map([
-    ["ADD_NEWS", "updateNews"]
-  ]);
-
-  defaultFields = {
-
-  };
-
-  removeFields = [
-
-  ];
-
-  transforms = {
-    scope: val => val?.type,
-    mentions: val =>
-      Array.isArray(val)
-        ? val.map(m => ({ ...m, count: parseInt(m.count) }))
-        : [],
-    mediaImg: val => {
-      const images = val?.images?.map(img => img.id).filter(Boolean) || [];
-      return images.length > 0 ? { countImages: images.length, images } : undefined;
-    },
-    mediaFile: val => {
-      const files = val?.files?.map(f => f.id).filter(Boolean) || [];
-      return files.length > 0 ? { countFiles: files.length, files } : undefined;
-    }
-  };
-
-  /**
-   * 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
-   */
-  async get() {
-    if (!this.id) throw new ApiError("Impossible de rafraîchir sans ID.");
-    
-    const newsArray = await this.callIsConnected(() =>
-      this.endpointApi.getNewsById({ ids: [this.id] })
-    );
-    
-    if (newsArray && Array.isArray(newsArray) && newsArray.length === 1) {
-      const data = newsArray[0];
-      this._setData(data);
-      return this.serverData;
-    }
-    throw new ApiError(`Aucune actualité trouvée pour l'ID ${this.id}`);
-  }
-
-      
-  async _add(payload) {
-    if (!this._calledFromSave) {
-      throw new Error("utilisation invalide de _add, utilisez save");
-    }
-
-    // si le texte est vide, on met un espace pour que le champ soit pris en compte car sur le serveur
-    // il y a une vérification de la taille du texte je pense
-    if(payload.text === ""){
-      payload.text = " ";
-    }
-    payload.parentId = this.parent.id;
-    payload.parentType = this.parent.getEntityType();
-    
-    // const data = await this.callIsConnected(() => this.endpointApi.addNews(payload));
-    // this._draftData.id = data.object.id;
-    // // TODO : voir si j'ai ce qui faut dans reponseData de ADD_NEWS pour mettre à jour #serverData
-    // // c'est dans reponseData.object
-    // // if(data?.object){
-    // //   this._serverData = { ...data.object };
-    // // }
-    
-    for (const [constant, methodName] of News.ADD_BLOCKS) {
-      const blockData = this._extractChangedFieldsFromSchema(
-        this.apiClient,
-        constant,
-        { ...payload, ...this.defaultFields },
-        () => {}
-      );
-      if (blockData && Object.keys(blockData).length > 0) {
-        const data = await this[methodName](blockData);
-        if (!this.id && data?.object?.id) {
-          this._draftData.id = data.object.id;
-          // this._serverData = { ...data.object };
-        }
-      }
-    }
-  }
-
-  async _update(payload) {
-    if (!this._calledFromSave) {
-      throw new Error("utilisation invalide de _update, utilisez save");
-    }
-
-    if (payload.id) delete payload.id;
-
-    // si le texte est vide, on met un espace pour que le champ soit pris en compte car sur le serveur
-    // il y a une vérification de la taille du texte je pense
-    if(payload?.text === ""){
-      payload.text = " ";
-    }
-    
-    payload.parentId = this.parent.id;
-    payload.parentType = this.parent.getEntityType();
-    payload.idNews = this.id;
-
-    let hasChanged = false;
-    const data = await this.callIsConnected(() => this.endpointApi.updateNews(payload));
-    // TODO : voir si j'ai ce qui faut dans data de UPDATE_NEWS pour mettre à jour #serverData
-    // c'est dans data.object
-    if(data?.object){
-      this._serverData = { ...data.object };
-    }
-    hasChanged = true;
-    return hasChanged;
-
-    // if (payload.id) delete payload.id;
-    // let hasChanged = false;
-
-    // for (const [constant, methodName] of News.UPDATE_BLOCKS) {
-    //   const blockData = this._extractChangedFieldsFromSchema(
-    //     this.apiClient,
-    //     constant,
-    //     { ...payload, ...this.defaultFields },
-    //     () => this.initialDraftData,
-    //     this.removeFields
-    //   );
-    //   if (blockData && Object.keys(blockData).length > 0) {
-    //     await this[methodName](blockData);
-    //     hasChanged = true;
-    //   }
-    // }
-
-    // return hasChanged;
-  }
-
-  async addNews(data = {}) {
-    return this.callIsConnected(() => this.endpointApi.addNews(data));
-  }
-
-  async updateNews(data = {}) {
-    return this.callIsConnected(() => this.endpointApi.updateNews(data));
-  }
-
-  async addMention({ slug, id }) {
-    try {
-      if (!slug && !id) {
-        throw new ApiError("Vous devez fournir un slug ou un id pour ajouter une mention.");
-      }
-
-      const userInstance = await this.entity("citoyens", { id, slug });
-      //   const userInstance = new this.deps.User(this.apiClient, { id, slug }, { EndpointApi: this.endpointApi  });
-      const user = userInstance.serverData;
-
-      if (!this._draftData.mentions) {
-        this._draftData.mentions = [];
-      }
-      // Vérification si la mention existe déjà
-      if (this._draftData.mentions.find((mention) => mention.id === user.id)) {
-        // Si la mention existe déjà, on incrémente le compteur
-        this._draftData.mentions = this._draftData.mentions.map((mention) => {
-          if (mention.id === user.id) {
-            mention.count += 1;
-          }
-          return mention;
-        });
-        return this._draftData.mentions;
-      }
-      const mention = { id: user.id, slug: user.slug, type: userInstance.getEntityType(), name: user.name, value:  user.name, count: 1 };
-      this._draftData.mentions.push(mention);
-      return this._draftData.mentions;
-    } catch (error) {
-      this.apiClient._logger.error("Erreur lors de l'ajout de la mention :", error);
-      throw error;
-    }
-
-  }
-
-  
-  /**
-   * Ajouter une image à une actualité : Ajoute une images à une actualité.
-   * Constant : ADD_IMAGE_NEWS
-   */
-  async addImage(image) {
-    image = await this._validateImage(image);
-    const data = { pathParams: { folder: this.parent.getEntityType(), ownerId: this.parent.id }, newsImage: image  };
-    const dataImage = await this.callIsConnected(() => this.endpointApi.addImageNews(data));
-    if (this._draftData.mediaImg) {
-      this._draftData.mediaImg.countImages = this._draftData.mediaImg.countImages + 1;
-      this._draftData.mediaImg.images.push(dataImage.id);
-    } else {
-      this._draftData.mediaImg = { countImages: 1, images: [dataImage.id] };
-    }
-    return dataImage;
-  }
-
-  /**
-   * Ajouter un fichier à une actualité : Ajoute un fichier à une actualité.
-   * Constant : ADD_FILE_NEWS
-   */
-  async addFile(file) {
-    file = await this._validateFile(file);
-    const data = { pathParams: { folder: this.parent.getEntityType(), ownerId: this.parent.id }, newsFile: file };
-    const dataFile = await this.callIsConnected(() =>this.endpointApi.addFileNews(data));
-    if (this._draftData.mediaFile) {
-      this._draftData.mediaFile.countFiles = this._draftData.mediaFile.countFiles + 1;
-      this._draftData.mediaFile.files.push(dataFile);
-    } else {
-      this._draftData.mediaFile = { countFiles: 1, files: [dataFile] };
-    }
-    return dataFile;
-  }
-
-  /**
-   * Supprimer une actualité : Supprime une actualité existante.
-   * Constant : DELETE_NEWS
-   */
-  async delete() {
-    if(!this.id) {
-      throw new ApiError("Vous devez fournir un id pour supprimer une news.");
-    }
-    const data = { pathParams: { id: this.id } };
-    await this.callIsConnected(() => this.endpointApi.deleteNews(data));
-    this._draftData = {};
-    this._serverData = null;
-    this._draftData.id = null;
-    this._isDeleted = true;
-  }
-  
-
-}

package/src/api/UserApi.js

@@ -1,81 +0,0 @@
-// UserApi.js
-import ApiClient from "../ApiClient.js";
-import { ApiError, ApiResponseError } from "../error.js";
-import { Badge } from "./Badge.js";
-import EndpointApi from "./EndpointApi.js";
-import { Event } from "./Event.js";
-import { News } from "./News.js";
-import { Organization } from "./Organization.js";
-import { Poi } from "./Poi.js";
-import { Project } from "./Project.js";
-import { User } from "./User.js";
-
-export class UserApi {
-
-  constructor(clientOrOptions) {
-    if (clientOrOptions instanceof ApiClient) {
-      this.client = clientOrOptions;
-    } else {
-      // Injection de dépendance : ApiClient est créé à partir des options
-      this.client = new ApiClient(clientOrOptions);
-      // si l'option "tokenStorageStrategy" est définie, on l'utilise pour créer une instance de ApiClient
-    }
-  
-    this.loggedUser = null;
-  }
-
-  get isConnected() {
-    return this.client.isConnected;
-  }
-  get userId() {
-    return this.client.userId;
-  }
-  
-  // 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, response.data.user, { EndpointApi, Organization, Project, Event, Poi, Badge, News });
-      return this.loggedUser;
-    });
-  }
-
-  async meIsconnected() {
-    if(!this.client.isConnected || !this.client.userId) {
-      throw new ApiError("User not connected", 401);
-    }
-    this.client._logger.info("UserApi", "meIsconnected", this.client.userId);
-    this.loggedUser = new User(this.client, { id: this.client.userId }, { EndpointApi, Organization, Project, Event, Poi, Badge, News });
-    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;
-    });
-  }
-
-}