@communecter/cocolight-api-client 1.0.142 → 1.0.144

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.142",
+    "version": "1.0.144",
     "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,171 @@ 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[];
+  /**
+   * Source d'insertion (costum)
+   */
+  source?: {
+    insertOrign?: string;
+    keys?: string[];
+    key?: string;
+    [k: string]: unknown;
+  };
   [k: string]: unknown;
 }
 
@@ -5460,6 +5705,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 +5781,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 +5819,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 ?? [];
+  }
 }

package/src/api/Organization.ts

@@ -173,13 +173,16 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
     if (rawAnswers && typeof rawAnswers === "object") {
       const linkedAnswers: Record<string, unknown[]> = {};
       for (const [formId, docs] of Object.entries(rawAnswers)) {
-        if (Array.isArray(docs)) {
-          linkedAnswers[formId] = docs.map((doc) =>
-            doc && typeof doc === "object"
-              ? this._linkEntity("answers", { ...(doc as Record<string, unknown>), collection: "answers" })
-              : doc
-          );
-        }
+        // Le backend renvoie tantôt un tableau `[doc, ...]`, tantôt une map indexée
+        // par id `{ answerId: doc }`. On normalise vers un tableau dans les deux cas.
+        const list = Array.isArray(docs)
+          ? docs
+          : (docs && typeof docs === "object" ? Object.values(docs) : []);
+        linkedAnswers[formId] = list.map((doc) =>
+          doc && typeof doc === "object"
+            ? this._linkEntity("answers", { ...(doc as Record<string, unknown>), collection: "answers" })
+            : doc
+        );
       }
       (data as Record<string, unknown>).answers = linkedAnswers;
     }
@@ -448,9 +451,75 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
     return paginator.next() as Promise<PaginatorPage<User | Organization>>;
   }
 
+  /**
+   * Récupère les organisations dont **cette** organisation est membre
+   * (lien montant : réseau, fédération, collectif… dont l'orga fait partie).
+   *
+   * C'est le miroir de {@link Organization#getMembers} : `getMembers()` liste
+   * *qui* est membre de cette orga, tandis que `getMemberOf()` liste *les orgas
+   * dont cette orga est elle-même membre*.
+   *
+   * Contrairement à {@link BaseEntity#getOrganizations} (désactivée ici car pensée
+   * pour un citoyen via `GET_ORGANIZATIONS_*`), on passe par la recherche réseau
+   * globale `searchCostum` : on cible `searchType: ["organizations"]` et on filtre
+   * sur `links.members.{thisOrgId}`. Seules les adhésions **confirmées** sont
+   * retournées (les liens `toBeValidated` et `isInviting` sont exclus).
+   *
+   * La pagination (`hasNext`/`next()`) et la restauration via `restoredState`
+   * fonctionnent comme pour `searchCostum` : le filtre membership est conservé
+   * d'une page à l'autre.
+   *
+   * @param data - Paramètres de recherche/pagination additionnels (`name`, `indexStep`,
+   *   `sortBy`, `locality`, `filters` complémentaires…). Les `filters` fournis sont
+   *   fusionnés avec le filtre membership, ce dernier restant prioritaire.
+   * @param options - Options. `restoredState` pour reprendre une pagination sérialisée.
+   * @returns Première page paginée d'organisations.
+   * @throws {ApiError} Si l'organisation n'a pas d'`id`.
+   *
+   * @example
+   * // Toutes les orgas dont cette orga est membre
+   * const page = await org.getMemberOf();
+   * console.log(page.results, page.count.total);
+   *
+   * @example
+   * // Filtrer par nom + pagination plus large
+   * const page = await org.getMemberOf({ name: "réseau", indexStep: 50 });
+   * if (page.hasNext) await page.next();
+   */
+  async getMemberOf(
+    data: Parameters<BaseEntity<OrganizationItemNormalized>["searchCostum"]>[0] = {},
+    options: { restoredState?: PaginatorState } = {}
+  ): Promise<PaginatorPage<Organization>> {
+    if (!this.id) {
+      throw new ApiError("L'organisation n'est pas définie, impossible de récupérer ses adhésions", 400);
+    }
+
+    const path = `links.members.${this.id}`;
+    const membershipFilters = {
+      [path]: { $exists: true },
+      [`${path}.toBeValidated`]: { $exists: false },
+      [`${path}.isInviting`]: { $exists: false }
+    };
+    const callerFilters = (data?.filters && typeof data.filters === "object") ? data.filters : {};
+
+    const orgParam: Parameters<typeof this.searchCostum>[0] = {
+      indexMin: 0,
+      indexStep: 20,
+      notSourceKey: true,
+      ...data,
+      // Champs imposés (le caller ne peut pas casser la sémantique « adhésions »)
+      searchType: ["organizations"],
+      countType: ["organizations"],
+      count: true,
+      filters: { ...callerFilters, ...membershipFilters }
+    };
+
+    return this.searchCostum(orgParam, options) as Promise<PaginatorPage<Organization>>;
+  }
+
   /**
    * {@inheritDoc BaseEntity#getGallery}
-   * 
+   *
    * Récupère la galerie de l'organisation.
    */
   override async getGallery(data: Parameters<BaseEntity<OrganizationItemNormalized>["getGallery"]>[0] = {}) {