@communecter/cocolight-api-client 1.0.155 → 1.0.157

package/src/api/News.ts

@@ -1,547 +0,0 @@
-import { ApiError, ApiResponseError } from "../error.js";
-import { BaseEntity } from "./BaseEntity.js";
-
-import type { Comment } from "./Comment.js";
-import type { AddNewsData, UpdateNewsData, DeleteNewsData, AddImageNewsData, AddFileNewsData, GetCommentsData, AddVoteData, AddReportAbuseData, ShareNewsData, ShowVoteData } from "./EndpointApi.types.js";
-import type { NewsItemNormalized } from "./serverDataType/News.js";
-
-export class News extends BaseEntity<NewsItemNormalized> {
-  static override entityType = "news";
-
-  static override entityTag = "News";
-
-  static override SCHEMA_CONSTANTS: string[] = [
-    "ADD_NEWS"
-  ];
-
-  static ADD_BLOCKS = new Map([
-    ["ADD_NEWS", "addNews"]
-  ] as const);
-
-  static UPDATE_BLOCKS = new Map([
-    ["ADD_NEWS", "updateNews"]
-  ] as const);
-
-  override defaultFields: Record<string, any> = {};
-
-  override removeFields: string[] = ["parentId", "parentType"];
-
-  override transforms: {
-    scope: (val: any) => any;
-    mentions: (val: any) => any[];
-    mediaImg: (val: any) => {
-      countImages: number;
-      images: string[];
-    };
-    mediaFile: (val: any) => {
-      countFiles: number;
-      files: any[];
-    };
-  } = {
-      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: any) => img.id).filter(Boolean) || [];
-        return images.length > 0 ? { countImages: images.length, images } : { countImages: 0, images: [] };
-      },
-      mediaFile: val => {
-        const files = val?.files?.map((f: any) => f.id).filter(Boolean) || [];
-        return files.length > 0 ? { countFiles: files.length, files } : { countFiles: 0, files: [] };
-      }
-    };
-
-  /**
-   * Transforme les champs imbriqués (author, target, sharedBy, etc.) en instances d'entités.
-   * @param data - Les données brutes du serveur.
-   * @returns Les données transformées.
-   * @protected
-   */
-  protected override _transformServerData(data: NewsItemNormalized): NewsItemNormalized {
-    // Transformer author en instance User/Organization
-    if (data.author) {
-      data.author = this._linkNestedEntity(data.author);
-    }
-
-    // Transformer target en instance User/Organization/Project
-    if (data.target) {
-      data.target = this._linkNestedEntity(data.target);
-    }
-
-    // Transformer lastAuthorShare en instance
-    if (data.lastAuthorShare) {
-      data.lastAuthorShare = this._linkNestedEntity(data.lastAuthorShare);
-    }
-
-    // Transformer le tableau sharedBy
-    if (Array.isArray(data.sharedBy)) {
-      data.sharedBy = data.sharedBy.map(item => this._linkNestedEntity(item));
-    }
-
-    return 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
-   */
-  override async get(): Promise<Record<string, any>> {
-    if (!this.id) throw new ApiError("Impossible de rafraîchir sans ID.", 400);
-    const id = this.id; // Type narrowing
-
-    const newsArray = await this.endpointApi.getNewsById({ ids: [id] });
-
-    if (newsArray && Array.isArray(newsArray) && newsArray.length === 1) {
-      const data = newsArray[0];
-      this._setData(data, { forceInitialDraftReset: true });
-      return this.serverData;
-    }
-    throw new ApiError(`Aucune actualité trouvée pour l'ID ${this.id}`, 404);
-  }
-
-
-  override _add = async (payload: Record<string, any>): Promise<void> => {
-    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 = " ";
-    }
-    if (this.parent) {
-      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 Array.from(News.ADD_BLOCKS)) {
-      const blockData = this._extractChangedFieldsFromSchema(
-        this.apiClient,
-        constant,
-        { ...payload, ...this.defaultFields },
-        () => {},
-        []
-      );
-      if (blockData && Object.keys(blockData).length > 0) {
-        const data = await this._invokeBlockMethod(News.ADD_BLOCKS, methodName, blockData);
-        if (!this.id && data?.object?.id) {
-          this._draftData.id = data.object.id;
-          // this._serverData = { ...data.object };
-        }
-      }
-    }
-  };
-
-  override _update = async (payload: Record<string, any>): Promise<boolean> => {
-    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 = " ";
-    }
-
-    if (this.parent) {
-      payload.parentId = this.parent.id;
-      payload.parentType = this.parent.getEntityType();
-    }
-    payload.idNews = this.id;
-
-    let hasChanged = false;
-
-    
-    // il faut que j'ai les ids des images et fichiers avant la mise à jour venant de serverData
-    // if (this._serverData?.mediaImg?.images && this._serverData?.mediaImg?.images.length > 0) {
-    //   imagesIds = this._serverData.mediaImg.images.map((img: any) => img.id);
-    // }
-
-    // if (this._serverData?.mediaFile?.files && this._serverData?.mediaFile?.files.length > 0) {
-    //   filesIds = this._serverData.mediaFile.files.map((f: any) => f.id);
-    // }
-
-    // comparer avec this._draftData.mediaImg.images pour voir si des images ont été supprimées
-    // comparer avec this._draftData.mediaFile.files pour voir si des fichiers ont été supprimés
-
-
-    await this.callIsConnected(() => this.endpointApi.updateNews(payload as UpdateNewsData)) as any;
-
-    // TODO : je voudrais pouvoir comparer les images et fichiers pour supprimer ceux qui ont été enlevés
-    // avec deleteDocumentByContext() mais il faut que j'ai les ids des images et fichiers avant la mise à jour
-
-    hasChanged = true;
-    return hasChanged;
-  };
-
-  async addNews(data: Partial<AddNewsData> = {}): Promise<unknown> {
-    return this.callIsConnected(() => this.endpointApi.addNews(data as AddNewsData));
-  }
-
-  async updateNews(data: Partial<UpdateNewsData> = {}): Promise<unknown> {
-    return this.callIsConnected(() => this.endpointApi.updateNews(data as UpdateNewsData));
-  }
-
-  async addMention({ slug, id }: { slug?: string; id?: string; }): Promise<any[]> {
-    try {
-      if (!slug && !id) {
-        throw new ApiError("Vous devez fournir un slug ou un id pour ajouter une mention.", 400);
-      }
-
-      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: any) => mention.id === user.id)) {
-        // Si la mention existe déjà, on incrémente le compteur
-        this._draftData.mentions = this._draftData.mentions.map((mention: any) => {
-          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: File | Blob | Buffer | import("stream").Readable): Promise<{ id: string; [key: string]: any }> {
-    const validatedImage = await this._validateImage(image);
-    const data: AddImageNewsData = {
-      pathParams: {
-        folder: this.parent?.getEntityType() as "citoyens" | "projects" | "organizations",
-        ownerId: this.parent?.id as string
-      },
-      newsImage: validatedImage as any
-    };
-    const dataImage = await this.callIsConnected(() => this.endpointApi.addImageNews(data)) as { id: string; [key: string]: any };
-    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 | Blob | Buffer | import("stream").Readable): Promise<unknown> {
-    const validatedFile = await this._validateFile(file);
-    const data: AddFileNewsData = {
-      pathParams: {
-        folder: this.parent?.getEntityType() as "citoyens" | "projects" | "organizations",
-        ownerId: this.parent?.id as string
-      },
-      newsFile: validatedFile as any
-    };
-    const dataFile = await this.callIsConnected(() => this.endpointApi.addFileNews(data)) as { id: string; [key: string]: any };
-    if (this._draftData.mediaFile) {
-      this._draftData.mediaFile.countFiles = this._draftData.mediaFile.countFiles + 1;
-      this._draftData.mediaFile.files.push(dataFile.id);
-    } else {
-      this._draftData.mediaFile = { countFiles: 1, files: [dataFile.id] };
-    }
-    return dataFile;
-  }
-
-
-
-  /**
-   * Supprimer une actualité : Supprime une actualité existante.
-   * Constant : DELETE_NEWS
-   */
-  async delete(): Promise<void> {
-    if(!this.id) {
-      throw new ApiError("Vous devez fournir un id pour supprimer une news.", 400);
-    }
-    const data = {
-      pathParams: { id: this.id },
-      isLive: false  // Valeur par défaut, peut être surchargée
-    };
-    await this.callIsConnected(() => this.endpointApi.deleteNews(data as DeleteNewsData));
-
-    // Vider les objets réactifs sans casser la réactivité
-    Object.keys(this._draftData).forEach(key => delete this._draftData[key]);
-    Object.keys(this._serverData).forEach(key => delete (this._serverData as any)[key]);
-
-    // Marquer comme supprimé
-    this._isDeleted = true;
-  }
-
-  /**
-   * Créer une instance de commentaire pour cette news.
-   * @param commentData - Données du commentaire.
-   * @returns Instance de Comment.
-   */
-  async comment(commentData: Record<string, any> = {}): Promise<Comment> {
-    if(!this.isConnected){
-      throw new ApiError("Vous devez être connecté.", 401);
-    }
-
-    const entity = await this.entity("comments", commentData);
-    return entity as Comment;
-  }
-
-  /**
-   * Récupérer les commentaires : Récupère la liste de commentaires selon plusieurs critères.
-   * Constant : GET_COMMENTS
-   * @returns - 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 getComments(): Promise<Comment[]> {
-
-    if (!this.id) {
-      throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
-    }
-
-    const payload: GetCommentsData = {
-      pathParams: { type: "news", id: this.id },
-    };
-
-    const arrayObjet =  await this.endpointApi.getComments(payload);
-
-    if(!Array.isArray(arrayObjet)){
-      throw new ApiResponseError("Erreur lors de la récupération des commentaires.", 500, arrayObjet as object);
-    }
-
-    const rawList = this._linkEntities(arrayObjet);
-
-    return this._createFilteredProxy(rawList);
-  }
-
-  /**
-   * Ajoute un vote sur cette news
-   *
-   * @param status - Statut du vote (ex: 'like', 'dislike', 'love', etc.)
-   * @returns Promise contenant la réponse de l'API après l'ajout du vote
-   * @throws {ApiError} Si la news n'a pas d'ID (non enregistrée)
-   */
-  async addVote(status: string){
-    if (!this.id) {
-      throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
-    }
-
-    const payload: AddVoteData = {
-      collection: "news",
-      id: this.id,
-      action: "vote",
-      details: {
-        status
-      }
-    };
-
-    return await this.callIsConnected(() => this.endpointApi.addVote(payload));
-  }
-
-  /**
-   * Récupère la liste des votes (like, love, etc.) sur cette news.
-   *
-   * Wrap de `SHOW_VOTE` avec auto-injection du `type` (`"news"`) et de
-   * `this.id` dans `pathParams`. Le retour contient `vote` (votes individuels
-   * indexés par userId) et `voteCount` (compteurs par statut).
-   *
-   * @returns Réponse API : `{ _id, vote, voteCount }` ou variante d'erreur.
-   * @throws {ApiError} 404 si la news n'a pas d'id (non enregistrée).
-   *
-   * @example
-   * const votes = await news.getVotes();
-   * votes.voteCount?.like;     // nombre de likes
-   * votes.vote?.[userId];      // vote détaillé d'un user
-   */
-  async getVotes(): Promise<unknown> {
-    if (!this.id) {
-      throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
-    }
-    const payload: ShowVoteData = {
-      pathParams: { type: "news", id: this.id },
-    };
-    return this.endpointApi.showVote(payload);
-  }
-
-  /**
-   * Signale un abus sur cette news
-   *
-   * @param params - Paramètres du signalement
-   * @param params.reason - Raison du signalement
-   * @param params.comment - Commentaire expliquant le signalement (optionnel)
-   * @returns Promise contenant la réponse de l'API après le signalement
-   * @throws {ApiError} Si la news n'a pas d'ID (non enregistrée)
-   */
-  async addReportAbuse({ reason, comment }: { reason: string, comment?: string}){
-    if (!this.id) {
-      throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
-    }
-
-    const payload: AddReportAbuseData = {
-      collection: "news",
-      id: this.id,
-      action: "reportAbuse",
-      details: {
-        reason,
-        comment
-      }
-    };
-
-    return await this.callIsConnected(() =>this.endpointApi.addReportAbuse(payload));
-  }
-
-  /**
-   * Partage cette news vers une entité (utilisateur, projet ou organisation)
-   *
-   * @param params - Paramètres de partage
-   * @param params.childId - ID de l'entité cible (par défaut: utilisateur connecté)
-   * @param params.childType - Type de l'entité cible (par défaut: "citoyens")
-   * @param params.comment - Commentaire optionnel accompagnant le partage
-   * @returns Promise contenant la réponse de l'API après le partage
-   * @throws {ApiError} Si la news n'a pas d'ID (404)
-   * @throws {ApiError} Si l'utilisateur n'est pas connecté (400)
-   * @throws {ApiError} Si le parent n'est pas défini (400)
-   * @throws {ApiError} Si on tente de partager sa propre news à soi-même (400)
-   * @throws {ApiError} Si le type cible n'est pas valide (400)
-   */
-  async shareNews({ childId, childType, comment }: { childId?: string, childType?: string, comment?: string } = {}){
-    // Validations préalables
-    if (!this.id) {
-      throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
-    }
-
-    if (!this.userId) {
-      throw new ApiError("L'utilisateur connecté n'est pas défini.", 400);
-    }
-
-    if(!this.parent?.id){
-      throw new ApiError("Le parent doit être défini pour partager une news", 400);
-    }
-
-    // Déterminer la cible du partage (par défaut: l'utilisateur connecté)
-    const targetId = childId ?? this.userId;
-    const targetType = childType ?? "citoyens";
-
-    // Valider que le type est autorisé
-    const validChildTypes: Array<"citoyens" | "projects" | "organizations"> = ["citoyens", "projects", "organizations"];
-    if (!validChildTypes.includes(targetType as any)) {
-      throw new ApiError(
-        `Le type de cible "${targetType}" n'est pas valide. Types autorisés: ${validChildTypes.join(", ")}`,
-        400
-      );
-    }
-
-    // Empêcher l'auto-partage: on ne peut pas partager sa propre news à soi-même
-    if (this.parent.id === this.userId && targetId === this.userId) {
-      throw new ApiError("Vous ne pouvez pas partager votre propre news à vous-même", 400);
-    }
-
-    const payload: ShareNewsData = {
-      parentId: this.id,
-      parentType: "news",
-      connectType: "share",
-      childType: targetType as "citoyens" | "projects" | "organizations",
-      childId: targetId,
-      comment
-    };
-
-    return await this.callIsConnected(() => this.endpointApi.shareNews(payload));
-  }
-
-  /**
-   * Vérifie si l'utilisateur connecté est l'auteur de cette actualité.
-   *
-   * Cette méthode compare l'ID de l'utilisateur connecté avec l'ID de l'auteur
-   * de l'actualité. L'auteur peut être soit un objet simple NewsAuthor, soit
-   * une instance d'entité User ou Organization.
-   * @param options - Options de vérification.
-   * @param options.silent - Si `true`, retourne `false` au lieu de lever une exception. Par défaut `true`.
-   * @returns `true` si l'utilisateur connecté est l'auteur, `false` sinon
-   * @throws {ApiError} Si l'utilisateur n'est pas connecté (401)
-   * @throws {ApiError} Si l'actualité n'a pas d'ID - non enregistrée (404)
-   * @throws {ApiError} Si les données serveur ne sont pas disponibles (404)
-   *
-   * @example
-   * ```typescript
-   * const news = await me.news({ id: "123" });
-   * await news.get();
-   *
-   * if (news.isAuthor()) {
-   *   console.log("Vous êtes l'auteur de cette actualité");
-   *   await news.delete(); // Vous pouvez la supprimer
-   * }
-   * ```
-   */
-  override isAuthor(options?: { silent?: boolean }): boolean {
-    const silent = options?.silent ?? true;
-
-    try {
-      if (!this.isMe) {
-        throw new ApiError("Vous devez être connecté pour vérifier l'auteur.", 401);
-      }
-      if (!this.id) {
-        throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
-      }
-      if (!this.serverData) {
-        throw new ApiError("Aucune donnée serveur disponible.", 404);
-      }
-      if (!this.userId) {
-        throw new ApiError("Utilisateur non connecté.", 401);
-      }
-    } catch (e) {
-      if (silent) return false;
-      throw e;
-    }
-
-    const author = this.serverData.author;
-    if (!author) {
-      return false;
-    }
-
-    // Extraire l'ID selon le type d'author
-    // author peut être NewsAuthor (objet simple avec .id) ou User/Organization (entité avec .serverData.id)
-    let authorId: string | undefined;
-
-    if ("serverData" in author && author.serverData && typeof author.serverData === "object" && "id" in author.serverData) {
-      // C'est une instance d'entité (User ou Organization)
-      authorId = author.serverData.id as string;
-    } else if ("id" in author) {
-      // C'est un objet NewsAuthor simple
-      authorId = author.id as string;
-    }
-
-    return Boolean(authorId && this.userId === authorId);
-  }
-
-  override async form(): Promise<never> {
-    throw new ApiError(`form n'existe pas dans ${this.constructor.name}`, 501);
-  }
-}