@communecter/cocolight-api-client 1.0.66 → 1.0.68

package/package.json

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

package/src/api/News.ts

@@ -2,7 +2,7 @@ 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 } from "./EndpointApi.types.js";
+import type { AddNewsData, UpdateNewsData, DeleteNewsData, AddImageNewsData, AddFileNewsData, GetCommentsData, AddVoteData, AddReportAbuseData, ShareNewsData } from "./EndpointApi.types.js";
 import type { NewsItemNormalized } from "./serverDataType/News.js";
 
 export class News extends BaseEntity<NewsItemNormalized> {
@@ -377,4 +377,62 @@ export class News extends BaseEntity<NewsItemNormalized> {
     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));
+  }
+
 }

package/types/api/News.d.ts

@@ -95,4 +95,23 @@ export declare class News extends BaseEntity<NewsItemNormalized> {
         reason: string;
         comment?: string;
     }): Promise<unknown>;
+    /**
+     * 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)
+     */
+    shareNews({ childId, childType, comment }?: {
+        childId?: string;
+        childType?: string;
+        comment?: string;
+    }): Promise<unknown>;
 }