@communecter/cocolight-api-client 1.0.119 → 1.0.121

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.119",
+    "version": "1.0.121",
     "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,15 @@ import type {
   CoformAnswersSearchData,
   ProfilBannerData,
   SearchMemberAutocompleteData,
-  GetEventsData
+  GetEventsData,
+  CostumFilterCoformData,
+  GetCountriesData,
+  SearchZonesData
 } from "./EndpointApi.types.js";
 import type { GetElementsKeyResponse } from "../types/api-responses.js";
 import type { TransformsMap } from "../types/entities.js";
+import type { CountryItem } from "./serverDataType/Country.js";
+import type { ZoneItemNormalized } from "./serverDataType/Zone.js";
 const { fromBuffer } = pkg;
 
 /**
@@ -3220,14 +3225,13 @@ export class BaseEntity<TServerData = any> {
       finalizer: async (finalData) => {
         if(this.isMe){
           finalData.pathParams = { type: this.getEntityType(), id: this.id };
-          // NOTE : dans le schema je crois que si pas de finalData.filters alors le default ce fait avec finalData.pathParams
-          // finalData.filters = {
-          //   "$or": {
-          //     [`links.contributors.${this.id}`]: { "$exists": true },
-          //     [`parent.${this.id}`]: { "$exists": true }
-          //   },
-          //   [`links.contributors.${this.id}`]: { "$exists": true }
-          // };
+          finalData.filters = {
+            "$or": {
+              [`links.contributors.${this.id}`]: { "$exists": true },
+              [`parent.${this.id}`]: { "$exists": true }
+            },
+            [`links.contributors.${this.id}`]: { "$exists": true }
+          };
         } else {
           delete finalData?.pathParams;
           finalData.filters = {
@@ -4640,6 +4644,81 @@ 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[]>;
+  }
+
+  /**
+   * Récupère la liste de tous les pays (endpoint public, sans authentification).
+   *
+   * @param data - Paramètres optionnels (costumSlug, costumId, costumType)
+   * @returns Liste des pays `{ name, countryCode, level, geo, ... }`
+   *
+   * @example
+   * const countries = await organization.getCountries();
+   * countries[0].name; // "France"
+   * countries[0].countryCode; // "FR"
+   */
+  async getCountries(
+    data: Partial<GetCountriesData> = {},
+  ): Promise<CountryItem[]> {
+    return this.endpointApi.getCountries(data as GetCountriesData) as Promise<CountryItem[]>;
+  }
+
   /**
    * ───────────────────────────────
    * 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, GetCountriesData, SearchZonesData } from "./EndpointApi.types.js";
 
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
@@ -1720,6 +1720,51 @@ 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);
+  }
+    
+  /**
+   * Récupérer la liste des pays : Récupérer la liste de tous les pays
+   * Constant : GET_COUNTRIES
+   * @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 getCountries(data: GetCountriesData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("GET_COUNTRIES", 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,80 @@ 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 GetCountriesData {
+  /**
+   * Slug personnalisé
+   */
+  costumSlug?: string;
+  /**
+   * Mode édition personnalisé (boolean, string ou number)
+   */
+  costumEditMode?: ("true" | "false") | (0 | 1) | boolean;
+  /**
+   * ID personnalisé (format ObjectID MongoDB)
+   */
+  costumId?: string;
+  /**
+   * Type de collection
+   */
+  costumType?: "organizations" | "projects" | "events" | "citoyens" | "poi";
+  [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/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/Country.ts

@@ -0,0 +1 @@
+export type { ZoneItemNormalized as CountryItem } from "./Zone.js";

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;
+}