@communecter/cocolight-api-client 1.0.117 → 1.0.119

package/package.json

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

package/src/api/BaseEntity.ts

@@ -3826,17 +3826,26 @@ export class BaseEntity<TServerData = any> {
 
   /**
    * Vérifie si l'utilisateur est l'auteur de l'entité.
-   *
+   * @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 est l'auteur, `false` sinon.
    * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si les données du serveur ne sont pas disponibles.
    */
-  isAuthor(): boolean {
-    this._checkAccess("vérifier l'auteur");
-    if (!this.serverData) {
-      throw new ApiError("Aucune donnée serveur disponible.", 404);
-    }
-    if (!this.userId) {
-      throw new ApiError("Utilisateur non connecté.", 401);
+  isAuthor(options?: { silent?: boolean }): boolean {
+
+    const silent = options?.silent ?? true;
+
+    try {
+      this._checkAccess("vérifier l'auteur");
+      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 sd: { creator?: string | null } = this.serverData;
@@ -3950,12 +3959,15 @@ export class BaseEntity<TServerData = any> {
    * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
   isFollower(options?: { silent?: boolean }): boolean {
-    const userLink = this._getValidatedUserLink(
-      "vérifier si il vous suit",
-      ["citoyens", "organizations", "projects", "events", "poi"],
-      { silent: options?.silent }
-    );
-    if (!userLink) return false;
+    const silent = options?.silent ?? true;
+    const expectedTypes = ["citoyens", "organizations", "projects", "events", "poi"];
+    try {
+      this._checkAccess("vérifier si il vous suit");
+      this._assertEntityType(...expectedTypes);
+    } catch (e) {
+      if (silent) return false;
+      throw e;
+    }
     return this._isLinked("followers");
   }
 
@@ -3968,12 +3980,15 @@ export class BaseEntity<TServerData = any> {
    * @throws {ApiError} - Si `silent` est `false` et que les préconditions ne sont pas remplies.
    */
   isFollowing(options?: { silent?: boolean }): boolean {
-    const userLink = this._getValidatedUserLink(
-      "vérifier si vous le suivez",
-      ["citoyens", "organizations", "projects", "events", "poi"],
-      { silent: options?.silent }
-    );
-    if (!userLink) return false;
+    const silent = options?.silent ?? true;
+    const expectedTypes = ["citoyens", "organizations", "projects", "events", "poi"];
+    try {
+      this._checkAccess("vérifier si vous le suivez");
+      this._assertEntityType(...expectedTypes);
+    } catch (e) {
+      if (silent) return false;
+      throw e;
+    }
     return this._isLinked("follows");
   }
 

package/src/api/News.ts

@@ -457,7 +457,8 @@ export class News extends BaseEntity<NewsItemNormalized> {
    * 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)
@@ -474,18 +475,25 @@ export class News extends BaseEntity<NewsItemNormalized> {
    * }
    * ```
    */
-  override isAuthor(): boolean {
-    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);
+  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;

package/src/api/User.ts

@@ -858,31 +858,46 @@ export class User extends BaseEntity<UserItemNormalized> {
 
   /**
    * Vérifie si l'utilisateur connecté est ami avec cet utilisateur.
-   * 
+   * @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 ami, sinon false.
    * @throws {ApiError} - Si l'utilisateur n'est pas connecté.
    */
-  isFriend(): boolean {
-    if (!this.isActingUser) {
-      throw new ApiError("Vous devez être connecté pour vérifier si vous êtes ami.", 401);
+  isFriend(options?: { silent?: boolean }): boolean {
+    const silent = options?.silent ?? true;
+    try {
+      if (!this.isActingUser) {
+        throw new ApiError("Vous devez être connecté pour vérifier si vous êtes ami.", 401);
+      }
+    } catch (e) {
+      if (silent) return false;
+      throw e;
     }
     this._assertEntityType("citoyens");
     const userLink = this._getLinkFromConnectedUser();
+    if(!userLink) return false;
     return this._validateUserLink(userLink);
   }
 
   /**
    * Vérifie si l'utilisateur suit l'entité.
-   *
+   * @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 suit l'entité, `false` sinon.
    * @throws {ApiError}
    */
-  override isFollower(): boolean {
-    if (!this.isActingUser) {
-      throw new ApiError("Vous devez être connecté pour vérifier si il vous suit.", 401);
-    }
-    if (!this.id) {
-      throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
+  override isFollower(options?: { silent?: boolean }): boolean {
+    const silent = options?.silent ?? true;
+    try {
+      if (!this.isActingUser) {
+        throw new ApiError("Vous devez être connecté pour vérifier si il vous suit.", 401);
+      }
+      if (!this.id) {
+        throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
+      }
+    } catch (e) {
+      if (silent) return false;
+      throw e;
     }
     this._assertEntityType("citoyens");
     return this._isLinked("followers");
@@ -890,16 +905,23 @@ export class User extends BaseEntity<UserItemNormalized> {
 
   /**
    * Vérifie si l'utilisateur est abonné à l'entité.
-   *
+   * @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 est abonné, `false` sinon.
    * @throws {ApiError}
    */
-  override isFollowing(): boolean {
-    if (!this.isActingUser) {
-      throw new ApiError("Vous devez être connecté pour vérifier si vous le suivez.", 401);
-    }
-    if (!this.id) {
-      throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
+  override isFollowing(options?: { silent?: boolean }): boolean {
+    const silent = options?.silent ?? true;
+    try {
+      if (!this.isActingUser) {
+        throw new ApiError("Vous devez être connecté pour vérifier si vous le suivez.", 401);
+      }
+      if (!this.id) {
+        throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
+      }
+    } catch (e) {
+      if (silent) return false;
+      throw e;
     }
     this._assertEntityType("citoyens");
     return this._isLinked("follows");

package/types/api/BaseEntity.d.ts

@@ -1310,11 +1310,14 @@ export declare class BaseEntity<TServerData = any> {
     protected _isLinked(linkType: string): boolean;
     /**
      * Vérifie si l'utilisateur est l'auteur de l'entité.
-     *
+     * @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 est l'auteur, `false` sinon.
      * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si les données du serveur ne sont pas disponibles.
      */
-    isAuthor(): boolean;
+    isAuthor(options?: {
+        silent?: boolean;
+    }): boolean;
     /**
      * Vérifie si l'utilisateur est administrateur de l'entité.
      *

package/types/api/News.d.ts

@@ -120,7 +120,8 @@ export declare class News extends BaseEntity<NewsItemNormalized> {
      * 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)
@@ -137,5 +138,7 @@ export declare class News extends BaseEntity<NewsItemNormalized> {
      * }
      * ```
      */
-    isAuthor(): boolean;
+    isAuthor(options?: {
+        silent?: boolean;
+    }): boolean;
 }

package/types/api/User.d.ts

@@ -318,25 +318,34 @@ export declare class User extends BaseEntity<UserItemNormalized> {
     unfollow(): Promise<unknown>;
     /**
      * Vérifie si l'utilisateur connecté est ami avec cet utilisateur.
-     *
+     * @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 ami, sinon false.
      * @throws {ApiError} - Si l'utilisateur n'est pas connecté.
      */
-    isFriend(): boolean;
+    isFriend(options?: {
+        silent?: boolean;
+    }): boolean;
     /**
      * Vérifie si l'utilisateur suit l'entité.
-     *
+     * @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 suit l'entité, `false` sinon.
      * @throws {ApiError}
      */
-    isFollower(): boolean;
+    isFollower(options?: {
+        silent?: boolean;
+    }): boolean;
     /**
      * Vérifie si l'utilisateur est abonné à l'entité.
-     *
+     * @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 est abonné, `false` sinon.
      * @throws {ApiError}
      */
-    isFollowing(): boolean;
+    isFollowing(options?: {
+        silent?: boolean;
+    }): boolean;
     /**
      * Retourne une entité à partir d'un slug.
      * @param slug - Le slug de l'entité à récupérer.