@communecter/cocolight-api-client 1.0.141 → 1.0.143

package/package.json

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

package/src/ApiClient.ts

@@ -1658,14 +1658,14 @@ export default class ApiClient extends EventEmitter {
   /**
  * Liste des champs de date à normaliser.
  */
-  private _dateFields = ["modified", "created", "updated", "birthDate", "lastLoginDate", "startDate", "endDate", "date", "issuedOn"];
+  private _dateFields = ["modified", "created", "updated", "birthDate", "lastLoginDate", "startDate", "endDate", "date", "issuedOn", "equip_maj_date", "inst_date_creation", "inst_enqu_date"];
 
   /**
  * Liste des champs numériques à normaliser (le backend les renvoie en string
  * via x-www-form-urlencoded ; sans cette coercion, JSON.stringify diff
  * produit des faux positifs dans `hasChanges()`).
  */
-  private _numberFields = ["buildingSurfaceArea", "siteSurfaceArea", "credits", "min", "max", "timeSpent"];
+  private _numberFields = ["buildingSurfaceArea", "siteSurfaceArea", "credits", "min", "max", "timeSpent", "equip_surf", "equip_larg", "equip_long"];
 
   /**
  * Normalise récursivement un objet, un tableau ou une valeur simple.

package/src/api/BaseEntity.ts

@@ -1504,6 +1504,18 @@ export class BaseEntity<TServerData = any> {
       normalized = { ...normalized, value: "" };
     }
 
+    // R7 — value: [] (array vide) en $set simple (sans arrayForm/pull) → on envoie "".
+    // Raison : en form-urlencoded un array vide n'émet AUCUN paramètre `value`, donc le
+    // backend fait `$_POST["value"]` (accès direct) → "Undefined index: value" / 500.
+    // Et de toute façon le backend traite un array vide comme un effacement
+    // (`!empty([])` === false → `$unset`). On envoie donc "" (sans setType) → $unset.
+    if (Array.isArray(normalized.value) && normalized.value.length === 0
+        && !normalized.arrayForm && !normalized.pull) {
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      const { setType, ...rest } = normalized;
+      normalized = { ...rest, value: "" };
+    }
+
     return normalized;
   }
 

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, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, SaveCoformAnswerData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData } 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, GetUserEligiblePlacesData, 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, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData } from "./EndpointApi.types.js";
 
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
@@ -747,6 +747,22 @@ export class EndpointApi {
     return this.callIsConnected("GET_ORGANIZATIONS_ADMIN", data);
   }
 
+  /**
+   * Récupérer les lieux éligibles d'un utilisateur : Récupère les organisations memberOf de l'utilisateur filtrées par filters arbitraires (tags, etc.) et notSourceKey configurables. Utilisé par la vue collaborative coform/place pour pré-filtrer côté serveur les lieux éligibles à un formulaire.
+   * Constant : GET_USER_ELIGIBLE_PLACES
+   * @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 {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async getUserEligiblePlaces(data: GetUserEligiblePlacesData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("GET_USER_ELIGIBLE_PLACES", data);
+  }
+
   /**
    * Récupérer les membres non administrables : Récupère les membres d’une organisation sans droits d’admin.
    * Constant : GET_MEMBERS_NO_ADMIN
@@ -1702,6 +1718,21 @@ export class EndpointApi {
     return this.callIsConnected("COFORM_GET_ANSWER_FILES", data);
   }
 
+  /**
+   * Récupérer les catalogues collaboratifs commonTable d'un formulaire : Pour les inputs de type tpls.forms.evaluation.commonTableV2, retourne en un seul appel le catalogue agrégé des criterias (besoins/solutions) déclarées par tous les répondants pour chaque inputKey demandé, avec un compteur de répondants par criteriaId.
+   * Constant : GET_COFORM_CATALOGS
+   * @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 getCoformCatalogs(data: GetCoformCatalogsData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("GET_COFORM_CATALOGS", data);
+  }
+
   /**
    * Sauvegarder une réponse de formulaire CoForm : Enregistre ou met à jour les réponses d'un utilisateur pour un formulaire CoForm
    * Constant : SAVE_COFORM_ANSWER
@@ -1718,6 +1749,54 @@ export class EndpointApi {
     return this.callIsConnected("SAVE_COFORM_ANSWER", data);
   }
 
+  /**
+   * Récupérer l'historique des modifications d'une réponse coform : Retourne l'historique des modifications (create + update) d'une réponse coform partagée, depuis la collection answerChanges. Trié du plus récent au plus ancien, limité à 200 entrées. Auth: l'utilisateur doit être propriétaire OU autorisé via canAdminAnswer (admin du parent du form, admin/membre du finder selon membersCanEditSharedAnswer, ou form publicCanEditSharedAnswer).
+   * Constant : GET_COFORM_ANSWER_HISTORY
+   * @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 {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async getCoformAnswerHistory(data: GetCoformAnswerHistoryData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("GET_COFORM_ANSWER_HISTORY", data);
+  }
+
+  /**
+   * Récupérer les données agrégées d'évaluation multiple (radar) d'une réponse coform : Pour une réponse coform partagée comportant des inputs radioNew avec activeMultieval=true, retourne les datasets agrégés (1 par utilisateur contributeur) pour chaque step. Lecture tolérante : priorité au format canonical `value`, fallback sur le format legacy `answer` '{idx}_{slug}'. Auth : owner OU canAdminAnswer.
+   * Constant : GET_COFORM_MULTIEVAL_DATA
+   * @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 {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async getCoformMultievalData(data: GetCoformMultievalDataData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("GET_COFORM_MULTIEVAL_DATA", data);
+  }
+
+  /**
+   * Récupérer les contributeurs d'une ligne de commonTable : Pour un input commonTable et une liste de criteriaIds (= une ligne du tableau, qui peut agréger plusieurs criterias dédupés via groupKey côté React), retourne la liste des contributions individuelles avec l'auteur, sa solution, sa satisfaction et sa note.
+   * Constant : GET_COFORM_COMMONTABLE_CONTRIBUTORS
+   * @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 {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async getCoformCommontableContributors(data: GetCoformCommontableContributorsData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("GET_COFORM_COMMONTABLE_CONTRIBUTORS", data);
+  }
+
   /**
    * Voter sur un élément (commentaire ou news) : Permet de voter sur un commentaire ou une news en spécifiant un statut de vote
    * Constant : ADD_VOTE

package/src/api/EndpointApi.types.ts

@@ -1644,6 +1644,86 @@ export interface GetOrganizationsAdminData {
 }
 
 
+export interface GetUserEligiblePlacesData {
+  /**
+   * Nom ou terme recherché
+   */
+  name?: string;
+  /**
+   * Types d'entités à inclure dans la recherche
+   */
+  searchType: string[];
+  /**
+   * Index minimum pour la pagination
+   */
+  indexMin: number;
+  /**
+   * Index de fin global pour la pagination
+   */
+  indexMax?: number;
+  /**
+   * Nombre d'éléments à récupérer (limite de pagination)
+   */
+  indexStep: number;
+  /**
+   * Configuration des plages de résultats pour chaque type de recherche
+   */
+  ranges?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^[^\s]+$".
+     */
+    [k: string]: {
+      indexMin: number;
+      indexMax: number;
+    };
+  };
+  searchBy?: "ALL";
+  /**
+   * Type initial de la recherche, vide par défaut
+   */
+  initType?: string;
+  /**
+   * Indique si les types doivent être comptés dans les résultats
+   */
+  count?: boolean;
+  /**
+   * Liste des types à compter dans les résultats
+   */
+  countType?: string[];
+  /**
+   * true = désactive le filtrage automatique par sourceKey du contexte (cf. SearchNew.php). Configurable dynamiquement selon la config du finder du formulaire.
+   */
+  notSourceKey: boolean;
+  /**
+   * Filtres MongoDB arbitraires : tags, source.key, links.members.{id}, etc. Les valeurs peuvent être une string (match exact), un tableau (any-of), ou un objet ($exists/$in/$ne/etc).
+   */
+  filters: {
+    [k: string]: unknown;
+  };
+  /**
+   * Localité vide ou spécifique
+   */
+  locality?: string;
+  /**
+   * Indique si la recherche doit s'étendre au Fediverse
+   */
+  fediverse?: boolean;
+  pathParams?: {
+    /**
+     * Type d'entité
+     */
+    type: "citoyens" | "organizations";
+    /**
+     * ID de l'utilisateur ou de l'entité
+     */
+    id: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
 export interface GetMembersNoAdminData {
   /**
    * Nom ou terme recherché
@@ -3281,6 +3361,162 @@ export interface AddPoiData {
     streetAddress?: string;
   };
   scope?: "";
+  /**
+   * Catégorie du POI
+   */
+  categorie?: string;
+  /**
+   * Type d'équipement
+   */
+  equip_type_name?: string;
+  /**
+   * Nom de l'institution associée
+   */
+  inst_nom?: string;
+  /**
+   * Accessibilité handicapé
+   */
+  inst_acc_handi_bool?: boolean;
+  /**
+   * Transport
+   */
+  inst_trans_bool?: boolean;
+  /**
+   * Famille du type d'équipement
+   */
+  equip_type_famille?: string;
+  /**
+   * Date de création de l'institution
+   */
+  inst_date_creation?: string;
+  /**
+   * Date de l'enquête
+   */
+  inst_enqu_date?: string;
+  /**
+   * Date de mise à jour
+   */
+  equip_maj_date?: string;
+  /**
+   * Nature de l'équipement
+   */
+  equip_nature?: string;
+  /**
+   * Type de sol
+   */
+  equip_sol?: string;
+  /**
+   * Surface
+   */
+  equip_surf?: number;
+  /**
+   * Éclairage
+   */
+  equip_eclair?: boolean;
+  /**
+   * Nom de l'APS
+   */
+  aps_name?: string[];
+  /**
+   * Accessibilité libre
+   */
+  equip_acc_libre?: boolean;
+  /**
+   * Type d'accessibilité handicapé
+   */
+  inst_acc_handi_type?: string;
+  /**
+   * Type de transport
+   */
+  inst_trans_type?: string;
+  /**
+   * Participation
+   */
+  inst_part_bool?: boolean;
+  /**
+   * Type de participation
+   */
+  inst_part_type?: string[];
+  /**
+   * Nom du propriétaire de l'équipement
+   */
+  equip_prop_nom?: string;
+  /**
+   * Type du propriétaire de l'équipement
+   */
+  equip_prop_type?: string;
+  /**
+   * Type de gestion de l'équipement
+   */
+  equip_gest_type?: string;
+  /**
+   * Accessibilité pour personnes à mobilité réduite
+   */
+  equip_pmr_acc?: boolean;
+  /**
+   * Chemin pour personnes à mobilité réduite
+   */
+  equip_pmr_chem?: boolean;
+  /**
+   * Douche pour personnes à mobilité réduite
+   */
+  equip_pmr_douche?: boolean;
+  /**
+   * Sanitaire pour personnes à mobilité réduite
+   */
+  equip_pmr_sanit?: boolean;
+  /**
+   * Tribune pour personnes à mobilité réduite
+   */
+  equip_pmr_trib?: boolean;
+  /**
+   * Vestiaire pour personnes à mobilité réduite
+   */
+  equip_pmr_vest?: boolean;
+  /**
+   * Aire de repos pour personnes à mobilité réduite
+   */
+  equip_pshs_aire?: boolean;
+  /**
+   * Chemin pour personnes à mobilité réduite
+   */
+  equip_pshs_chem?: boolean;
+  /**
+   * Sanitaire pour personnes à mobilité réduite
+   */
+  equip_pshs_sanit?: boolean;
+  /**
+   * Tribune pour personnes à mobilité réduite
+   */
+  equip_pshs_trib?: boolean;
+  /**
+   * Vestiaire pour personnes à mobilité réduite
+   */
+  equip_pshs_vest?: boolean;
+  /**
+   * Signalisation pour personnes à mobilité réduite
+   */
+  equip_pshs_sign?: boolean;
+  /**
+   * Largeur de l'équipement
+   */
+  equip_larg?: number;
+  /**
+   * Longueur de l'équipement
+   */
+  equip_long?: number;
+  /**
+   * Douche
+   */
+  equip_douche?: boolean;
+  /**
+   * Type de localisation de l'équipement
+   */
+  equip_loc_type?: string[];
+  /**
+   * Utilisateur de l'équipement
+   */
+  equip_utilisateur?: string[];
   [k: string]: unknown;
 }
 
@@ -5460,6 +5696,14 @@ export interface GetCoformByIdData {
    * ID du formulaire parent à récupérer
    */
   parentFormId: string;
+  /**
+   * Optionnel : ID d'un élément (lieu) pour la vue collaborative par lieu. Avec elementType, l'access info pointe sur la réponse partagée du lieu plutôt que sur la réponse personnelle du user.
+   */
+  elementId?: string;
+  /**
+   * Type de l'élément (collection MongoDB). Requis si elementId fourni.
+   */
+  elementType?: "organizations" | "projects" | "events" | "poi" | "citoyens";
   [k: string]: unknown;
 }
 
@@ -5528,6 +5772,19 @@ export interface CoformGetAnswerFilesData {
 }
 
 
+export interface GetCoformCatalogsData {
+  /**
+   * ID du formulaire parent
+   */
+  formId: string;
+  /**
+   * Tableau JSON sérialisé des fieldKey des inputs commonTable concernés. Ex: ["abc123","def456"]
+   */
+  inputKeys: string;
+  [k: string]: unknown;
+}
+
+
 export interface SaveCoformAnswerData {
   /**
    * ID du formulaire parent
@@ -5553,6 +5810,45 @@ export interface SaveCoformAnswerData {
 }
 
 
+export interface GetCoformAnswerHistoryData {
+  /**
+   * ID de la réponse dont on veut l'historique
+   */
+  answerId: string;
+  [k: string]: unknown;
+}
+
+
+export interface GetCoformMultievalDataData {
+  /**
+   * ID de la réponse
+   */
+  answerId: string;
+  /**
+   * Optionnel : si fourni, ne retourne que la step spécifiée. Sinon, toutes les steps avec multi-eval.
+   */
+  stepKey?: string;
+  [k: string]: unknown;
+}
+
+
+export interface GetCoformCommontableContributorsData {
+  /**
+   * ID du formulaire parent
+   */
+  formId: string;
+  /**
+   * Clé originale de l'input commonTable (sans préfixe yesOrNo)
+   */
+  inputKey: string;
+  /**
+   * Tableau JSON sérialisé des criteriaIds correspondant à la ligne agrégée (commonTable peut dédupliquer plusieurs criterias sous un même usage côté React). Ex: ["criteria1778265370227"]
+   */
+  criteriaIds: string;
+  [k: string]: unknown;
+}
+
+
 export interface AddVoteData {
   /**
    * ID de l'élément (commentaire ou news) sur lequel voter

package/src/api/Form.ts

@@ -4,7 +4,7 @@ import { ApiError } from "../error.js";
 import type { Answer } from "./Answer.js";
 import type { PaginatorPage, PaginatorState } from "./BaseEntity.js";
 import type { CoformAnswersSearchData } from "./EndpointApi.types.js";
-import type { FormItemNormalized } from "./serverDataType/Form.js";
+import type { CoformCommonTableContributor, FormItemNormalized } from "./serverDataType/Form.js";
 
 export class Form extends BaseEntity<FormItemNormalized> {
   static override entityType = "forms";
@@ -157,4 +157,46 @@ export class Form extends BaseEntity<FormItemNormalized> {
     const entity = await this.entity("answers", payload);
     return entity as Answer;
   }
+
+  /**
+   * Récupère la liste des contributeurs d'une table commune (commonTable) de CE formulaire.
+   *
+   * Pour un input `commonTable` et une ligne du tableau (un ou plusieurs `criteriaIds`
+   * dédupés côté React via `groupKey`), retourne les contributions individuelles
+   * (auteur, solution, satisfaction, note).
+   *
+   * Constant : GET_COFORM_COMMONTABLE_CONTRIBUTORS
+   * (POST /survey/coform/getcommontablecontributors, auth bearer).
+   *
+   * @param params.inputKey - Clé originale de l'input commonTable (sans préfixe yesOrNo).
+   * @param params.criteriaIds - criteriaIds de la ligne agrégée : tableau `string[]`
+   *                             (sérialisé automatiquement) ou string JSON déjà sérialisée.
+   * @returns La liste des contributions (une entrée par contribution).
+   * @throws {ApiError} si le Form n'a pas d'id.
+   *
+   * @example
+   * const form = await org.form({ id: "6925e2b05dd63b02ca70d6d9" });
+   * const contributors = await form.getCommonTableContributors({
+   *   inputKey: "usagesEtSolutions",
+   *   criteriaIds: ["criteria1778265370227"],
+   * });
+   */
+  async getCommonTableContributors(
+    params: { inputKey: string; criteriaIds: string | string[] }
+  ): Promise<CoformCommonTableContributor[]> {
+    const formId = this.id;
+    if (!formId) throw new ApiError("Form sans id, impossible de récupérer les contributeurs.", 400);
+
+    const criteriaIds = Array.isArray(params.criteriaIds)
+      ? JSON.stringify(params.criteriaIds)
+      : params.criteriaIds;
+
+    const res = (await this.endpointApi.getCoformCommontableContributors({
+      formId,
+      inputKey: params.inputKey,
+      criteriaIds
+    })) as { data?: { contributors?: CoformCommonTableContributor[] } };
+
+    return res?.data?.contributors ?? [];
+  }
 }