@communecter/cocolight-api-client 1.0.69 → 1.0.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@communecter/cocolight-api-client",
3
- "version": "1.0.69",
3
+ "version": "1.0.70",
4
4
  "description": "Client Axios simplifié pour l'API cocolight",
5
5
  "repository": {
6
6
  "type": "git",
package/src/api/News.ts CHANGED
@@ -435,4 +435,61 @@ export class News extends BaseEntity<NewsItemNormalized> {
435
435
  return await this.callIsConnected(() => this.endpointApi.shareNews(payload));
436
436
  }
437
437
 
438
+ /**
439
+ * Vérifie si l'utilisateur connecté est l'auteur de cette actualité.
440
+ *
441
+ * Cette méthode compare l'ID de l'utilisateur connecté avec l'ID de l'auteur
442
+ * de l'actualité. L'auteur peut être soit un objet simple NewsAuthor, soit
443
+ * une instance d'entité User ou Organization.
444
+ *
445
+ * @returns `true` si l'utilisateur connecté est l'auteur, `false` sinon
446
+ * @throws {ApiError} Si l'utilisateur n'est pas connecté (401)
447
+ * @throws {ApiError} Si l'actualité n'a pas d'ID - non enregistrée (404)
448
+ * @throws {ApiError} Si les données serveur ne sont pas disponibles (404)
449
+ *
450
+ * @example
451
+ * ```typescript
452
+ * const news = await me.news({ id: "123" });
453
+ * await news.get();
454
+ *
455
+ * if (news.isAuthor()) {
456
+ * console.log("Vous êtes l'auteur de cette actualité");
457
+ * await news.delete(); // Vous pouvez la supprimer
458
+ * }
459
+ * ```
460
+ */
461
+ override isAuthor(): boolean {
462
+ if (!this.isMe) {
463
+ throw new ApiError("Vous devez être connecté pour vérifier l'auteur.", 401);
464
+ }
465
+ if (!this.id) {
466
+ throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
467
+ }
468
+ if (!this.serverData) {
469
+ throw new ApiError("Aucune donnée serveur disponible.", 404);
470
+ }
471
+ if (!this.userId) {
472
+ throw new ApiError("Utilisateur non connecté.", 401);
473
+ }
474
+
475
+ const author = this.serverData.author;
476
+ if (!author) {
477
+ return false;
478
+ }
479
+
480
+ // Extraire l'ID selon le type d'author
481
+ // author peut être NewsAuthor (objet simple avec .id) ou User/Organization (entité avec .serverData.id)
482
+ let authorId: string | undefined;
483
+
484
+ if ("serverData" in author && author.serverData && typeof author.serverData === "object" && "id" in author.serverData) {
485
+ // C'est une instance d'entité (User ou Organization)
486
+ authorId = author.serverData.id as string;
487
+ } else if ("id" in author) {
488
+ // C'est un objet NewsAuthor simple
489
+ authorId = author.id as string;
490
+ }
491
+
492
+ return Boolean(authorId && this.userId === authorId);
493
+ }
494
+
438
495
  }
@@ -114,4 +114,28 @@ export declare class News extends BaseEntity<NewsItemNormalized> {
114
114
  childType?: string;
115
115
  comment?: string;
116
116
  }): Promise<unknown>;
117
+ /**
118
+ * Vérifie si l'utilisateur connecté est l'auteur de cette actualité.
119
+ *
120
+ * Cette méthode compare l'ID de l'utilisateur connecté avec l'ID de l'auteur
121
+ * de l'actualité. L'auteur peut être soit un objet simple NewsAuthor, soit
122
+ * une instance d'entité User ou Organization.
123
+ *
124
+ * @returns `true` si l'utilisateur connecté est l'auteur, `false` sinon
125
+ * @throws {ApiError} Si l'utilisateur n'est pas connecté (401)
126
+ * @throws {ApiError} Si l'actualité n'a pas d'ID - non enregistrée (404)
127
+ * @throws {ApiError} Si les données serveur ne sont pas disponibles (404)
128
+ *
129
+ * @example
130
+ * ```typescript
131
+ * const news = await me.news({ id: "123" });
132
+ * await news.get();
133
+ *
134
+ * if (news.isAuthor()) {
135
+ * console.log("Vous êtes l'auteur de cette actualité");
136
+ * await news.delete(); // Vous pouvez la supprimer
137
+ * }
138
+ * ```
139
+ */
140
+ isAuthor(): boolean;
117
141
  }