@communecter/cocolight-api-client 1.0.118 → 1.0.120

package/package.json

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

package/src/ApiClient.ts

@@ -207,7 +207,6 @@ export default class ApiClient extends EventEmitter {
       baseURL,
       timeout
     });
-
     // axios-retry : pour retenter en cas de soucis réseau ou code 5xx
     if (maxRetries > 0) {
       axiosRetry(this._client, {
@@ -741,7 +740,7 @@ export default class ApiClient extends EventEmitter {
         throw new ApiClientError(`Path param manquant ou non résolu : {${key}}`, 400);
       });
     }
-  
+
     // === 2. Validation données (request schema) ===
     if (requestSchema) {
       // Si auth est "none" et que userId n'est pas défini, on nettoie le schéma

package/src/api/BaseEntity.ts

@@ -44,10 +44,13 @@ import type {
   CoformAnswersSearchData,
   ProfilBannerData,
   SearchMemberAutocompleteData,
-  GetEventsData
+  GetEventsData,
+  CostumFilterCoformData,
+  SearchZonesData
 } from "./EndpointApi.types.js";
 import type { GetElementsKeyResponse } from "../types/api-responses.js";
 import type { TransformsMap } from "../types/entities.js";
+import type { ZoneItemNormalized } from "./serverDataType/Zone.js";
 const { fromBuffer } = pkg;
 
 /**
@@ -3959,12 +3962,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");
   }
 
@@ -3977,12 +3983,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");
   }
 
@@ -4634,6 +4643,64 @@ export class BaseEntity<TServerData = any> {
     return paginator.next() as Promise<PaginatorPage<any>>;
   }
 
+
+  /**
+   * Récupère les filtres disponibles basés sur les réponses CoForm de l'entité courante.
+   * Utilise le contexte Communecter (costumSlug, contextId, contextType) de l'entité.
+   *
+   * La réponse est un objet indexé par nom de filtre, chaque entrée contenant :
+   * - `count` : nombre de résultats par catégorie
+   * - `results` : valeurs disponibles pour ce filtre (libellé, image, etc.)
+   *
+   * @param data - Paramètres optionnels de recherche
+   * @param data.searchedData - Filtres actifs : clé → `{ label, forms, path, finderPath }`
+   * @returns Objet `Record<filterName, { count, results }>` des filtres disponibles
+   *
+   * @example
+   * const filters = await project.coformFiltersSearch({
+   *   searchedData: {
+   *     "activités": {
+   *       label: "Activités",
+   *       forms: "6486d24e9cad105cbf29a777",
+   *       path: "lesCommunsDesTierslieux...",
+   *       finderPath: "answers.lesCommunsDesTierslieux..."
+   *     }
+   *   }
+   * });
+   * filters["activités"].count; // { "Atelier": 12, "Coworking": 8 }
+   */
+  async coformFiltersSearch(
+    data: Partial<CostumFilterCoformData> = {},
+  ): Promise<any> {
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: CostumFilterCoformData) => this.endpointApi.costumFilterCoform(finalData)
+    );
+    return wrappedFinalizer(data);
+  }
+
+
+  /**
+   * Recherche des zones géographiques selon un pays et un niveau administratif.
+   * Utilise le contexte Communecter de l'entité courante.
+   *
+   * @param data - Paramètres de recherche
+   * @param data.countryCode - Code(s) pays ISO (ex: `["FR"]`)
+   * @param data.level - Niveau(x) administratif(s) (ex: `["1"]`)
+   * @returns Liste des zones correspondantes
+   * @throws {ApiError} Si `countryCode` ou `level` sont absents
+   */
+  async searchZone(
+    data: SearchZonesData,
+  ): Promise<ZoneItemNormalized[]> {
+    if(!data.countryCode?.length || !data.level?.length){
+      throw new ApiError("countryCode et level sont requis.", 400);
+    }
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: SearchZonesData) => this.endpointApi.searchZones(finalData)
+    );
+    return wrappedFinalizer(data) as Promise<ZoneItemNormalized[]>;
+  }
+
   /**
    * ───────────────────────────────
    * Pagination restoration methods

package/src/api/Comment.ts

@@ -246,7 +246,7 @@ export class Comment extends BaseEntity<CommentItemNormalized> {
       }
     };
   
-    return await this.callIsConnected(() => this.endpointApi.addReportAbuse(payload));;
+    return await this.callIsConnected(() => this.endpointApi.addReportAbuse(payload));
   }
 
 }

package/src/api/EndpointApi.ts

@@ -2,7 +2,7 @@
 import { ApiAuthenticationError } from "../error.js";
 
 import type ApiClient from "../ApiClient.js";
-import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DemoteAdminData } from "./EndpointApi.types.js";
+import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DemoteAdminData, CostumFilterCoformData, SearchZonesData } from "./EndpointApi.types.js";
 
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
@@ -1720,6 +1720,36 @@ export class EndpointApi {
     return this.callIsConnected("DEMOTE_ADMIN", data);
   }
     
+  /**
+   * Filtre par reponses CoForm : Recuperer tous les filtres possibles via l'answers
+   * Constant : COSTUM_FILTER_COFORM
+   * @param data - Données envoyées à l'API
+   * @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 costumFilterCoform(data: CostumFilterCoformData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COSTUM_FILTER_COFORM", data);
+  }
+    
+  /**
+   * Rechercher des zones géographiques : Rechercher des zones géographiques
+   * Constant : SEARCH_ZONES
+   * @param data - Données envoyées à l'API
+   * @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 searchZones(data: SearchZonesData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("SEARCH_ZONES", data);
+  }
+    
 }
 
 export default EndpointApi;

package/src/api/EndpointApi.types.ts

@@ -3967,7 +3967,7 @@ export interface GlobalAutocompleteCostumData {
       /**
        * Type de la localité : 'cities' pour une ville ou 'level1' pour une région
        */
-      type: "cities" | "level1";
+      type: "cities" | "level1" | "level2" | "level3" | "level4" | "level5";
     };
   };
   /**
@@ -4948,3 +4948,59 @@ export interface DemoteAdminData {
   isAdmin: false;
   [k: string]: unknown;
 }
+
+
+export interface CostumFilterCoformData {
+  /**
+   * Données de recherche pour le filtre
+   */
+  searchedData?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Slug du costume
+   */
+  costumSlug?: string;
+  /**
+   * ID du costume
+   */
+  costumId?: string;
+  /**
+   * Type du costume
+   */
+  costumType?: string;
+  [k: string]: unknown;
+}
+
+
+export interface SearchZonesData {
+  /**
+   * Code du pays pour la recherche
+   */
+  countryCode: unknown[];
+  /**
+   * Niveau de la zone géographique pour la recherche
+   */
+  level: unknown[];
+  /**
+   * Critère de tri des résultats
+   */
+  sortBy?: string;
+  /**
+   * ID du niveau supérieur pour la recherche
+   */
+  upperLevelId?: string;
+  /**
+   * Slug du costume
+   */
+  costumSlug?: string;
+  /**
+   * ID du costume
+   */
+  costumId?: string;
+  /**
+   * Type du costume
+   */
+  costumType?: string;
+  [k: string]: unknown;
+}

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/src/api/UserApi.ts

@@ -83,7 +83,7 @@ export class UserApi {
       throw new ApiError("User not connected", 401);
     }
 
-    this.client._logger.info("UserApi", "meIsconnected", this.client.userId);
+    this.client._logger.debug("UserApi", "meIsconnected", this.client.userId);
 
     this.loggedUser = new User(
       this.client,

package/src/api/serverDataType/Zone.ts

@@ -0,0 +1,33 @@
+import { GeoCoordinates, GeoPosition, IdObject } from "./common.js";
+
+import type EJSONType from "../../EJSONType.js";
+
+type ObjectIDCtor = typeof EJSONType["ObjectID"];
+type ObjectID = InstanceType<ObjectIDCtor>;
+
+export interface ZoneItemNormalized {
+    _id: IdObject;
+    countryCode: string;
+    geo: GeoCoordinates;
+    geoPosition: GeoPosition;
+    level: string[];
+    name: string;
+    osmID?: string;
+    wikidataID?: string;
+    translateId: string;
+    [key: string]: unknown;
+}
+
+export interface ZoneItemJson {
+    id: string;
+    _id: ObjectID;
+    countryCode: string;
+    geo: GeoCoordinates;
+    geoPosition: GeoPosition;
+    level: string[];
+    name: string;
+    osmID?: string;
+    wikidataID?: string;
+    translateId: string;
+    [key: string]: unknown;
+}