@communecter/cocolight-api-client 1.0.181 → 1.0.182

package/package.json

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

package/types/api/Answer.d.ts

@@ -1,5 +1,6 @@
 import { BaseEntity } from "./BaseEntity.js";
 import type { AnswerItemNormalized } from "./serverDataType/Answer.js";
+import type { CommunInfo } from "./serverDataType/CommunInfo.js";
 import type { FormItemNormalized } from "./serverDataType/Form.js";
 type UploadInput = File | Blob | Buffer | import("stream").Readable;
 /**
@@ -243,6 +244,19 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
      */
     private _autoFormIdFromParent;
     form(): Promise<never>;
+    /**
+     * Fiche du **commun** rattaché à un outil : cette Answer EST la réponse AAP du commun
+     * (`communId = this.id`). `opts.formId` = **verrou de périmètre** (le serveur vérifie
+     * `answer.form === formId`, endpoint `auth: none`) : sans lui, la requête n'a pas de sens (le
+     * front ne l'émet pas). Fail-closed → **`null`** en HTTP 200 (jamais de 500) sur entrée invalide.
+     *
+     * @example
+     * const answer = await api.answer({ id: communId });
+     * const commun = await answer.getCommunInfo({ formId: communFormId }); // CommunInfo | null
+     */
+    getCommunInfo(opts?: {
+        formId?: string;
+    }): Promise<CommunInfo | null>;
     /**
      * Supprime cette Answer côté serveur via `DELETE_ELEMENT`
      * (`type=answers`, `id=this.id`).

package/types/api/BaseEntity.d.ts

@@ -2,6 +2,7 @@ import type { UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoDat
 import type { CostumRuntimeContext } from "../costum/runtime.js";
 import type { TransformsMap } from "../types/entities.js";
 import type { CountryItem } from "./serverDataType/Country.js";
+import type { ToolEnrichmentInput, ToolEnrichmentResult, CommunListItem } from "./serverDataType/ToolsCatalog.js";
 import type { ZoneItemNormalized, ZoneShapeItem, ZonirisShapeItem } from "./serverDataType/Zone.js";
 /**
  * Types pour les méthodes d'entité (organization, project, poi, event, badge, news)
@@ -2442,6 +2443,23 @@ export declare class BaseEntity<TServerData = any> {
      * @throws {Error}
      */
     costumEventRequestSubevents(data?: Partial<Omit<CostumEventRequestSubeventsData, "pathParams">>): Promise<unknown>;
+    /**
+     * Upsert de l'**enrichissement d'un outil** (`navigatorcriteria`, clé d'upsert = `name`).
+     *
+     * BEARER + gate admin serveur (`isInterfaceAdmin` → 401). Porté par `BaseEntity` (et **pas**
+     * `Organization`) car le host du costum peut être un **projet** — `_withCostumContext` lit
+     * `serverData.slug/id` du host. Deux subtilités byte-fidèles :
+     *  - `isOpenSource` booléen → stringifié `"true"/"false"` (forme historique, comparée `=== "true"`) ;
+     *  - **clé-absente ≠ chaîne-vide** : on n'émet QUE les clés présentes de `input` (une clé absente
+     *    laisse le champ inchangé serveur ; `""` l'efface) — ne jamais compléter les champs manquants.
+     */
+    saveToolEnrichment(input: ToolEnrichmentInput): Promise<ToolEnrichmentResult>;
+    /**
+     * Les `{id,title}` des **communs** rattachables (options du select), tri titre, cap 1000.
+     * BEARER + gate admin, **même placement `BaseEntity`** que {@link saveToolEnrichment} (le host
+     * costum peut être un projet). `formId` en argument positionnel. Retourne le tableau NU.
+     */
+    getCommunList(formId: string): Promise<CommunListItem[]>;
     /**
      * @param data
      *        Paramètres de recherche (partiels — les valeurs manquantes sont complétées

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GlobalAutocompleteAdminCostumData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, CreateInvitationLinkData, ConnectByRefData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteMembersData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, DeleteCoformAnswerFileData, 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, PersonActivateData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
+import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GlobalAutocompleteAdminCostumData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, CreateInvitationLinkData, ConnectByRefData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteMembersData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, DeleteCoformAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, CostumToolsCatalogData, CostumToolUsersData, CostumCommunInfoData, CostumSaveToolEnrichmentData, CostumCommunListData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1268,6 +1268,53 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     coformAnswersByForms(data: CoformAnswersByFormsData): Promise<any>;
+    /**
+     * Catalogue d'outils d'usage (liste paginee) : Liste paginee/recherchable/filtrable des outils agreges depuis les reponses coform.
+     * Constant : COSTUM_TOOLS_CATALOG
+     * @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.
+     */
+    costumToolsCatalog(data: CostumToolsCatalogData): Promise<any>;
+    /**
+     * Lieux utilisateurs d'un outil : Les lieux utilisateurs d'un outil (recherche par criteriaIds, jamais regex sur le nom).
+     * Constant : COSTUM_TOOL_USERS
+     * @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.
+     */
+    costumToolUsers(data: CostumToolUsersData): Promise<any>;
+    /**
+     * Fiche du commun rattache a un outil : Fiche du commun (reponse AAP) rattache a un outil. formId = verrou de perimetre (answer.form===formId).
+     * Constant : COSTUM_COMMUN_INFO
+     * @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.
+     */
+    costumCommunInfo(data: CostumCommunInfoData): Promise<any>;
+    /**
+     * Upsert de l'enrichissement d'un outil : Upsert d'un document navigatorcriteria par nom d'outil (cle absente=inchangee, chaine vide=effacee). Gate isInterfaceAdmin.
+     * Constant : COSTUM_SAVE_TOOL_ENRICHMENT
+     * @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.
+     */
+    costumSaveToolEnrichment(data: CostumSaveToolEnrichmentData): Promise<any>;
+    /**
+     * Options du select de rattachement (communs) : {id,title} des communs pour le select de rattachement, tri titre, cap 1000. Gate isInterfaceAdmin.
+     * Constant : COSTUM_COMMUN_LIST
+     * @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.
+     */
+    costumCommunList(data: CostumCommunListData): Promise<any>;
     /**
      * Generer une nouvelle reponse à partir d'un formulaire : Generer une nouvelle reponse à partir d'un formulaire
      * Constant : GENERATE_ANSWER_FROM_FORM

package/types/api/EndpointApi.types.d.ts

@@ -5929,6 +5929,177 @@ export interface CoformAnswersByFormsData {
     };
     [k: string]: unknown;
 }
+export interface CostumToolsCatalogData {
+    /**
+     * form des reponses (requis)
+     */
+    formId: string;
+    /**
+     * champ id du form dont les inputs sont les categories d'usage (requis)
+     */
+    step: string;
+    /**
+     * dot-path du lieu dans la reponse (requis, regex ^[a-zA-Z0-9_.]+$)
+     */
+    finderPath: string;
+    /**
+     * recherche, accent/casse-insensible serveur
+     */
+    name?: string;
+    /**
+     * {category?,usage?,isOpenSource?(boolean)}
+     */
+    filters?: {
+        [k: string]: unknown;
+    };
+    /**
+     * {champ:1|-1} ; defaut serveur {totalOccurrences:-1,title:1} ; whitelist totalOccurrences/title/usagesCount
+     */
+    sortBy?: {
+        [k: string]: 1 | -1;
+    };
+    /**
+     * skip, defaut 0
+     */
+    indexMin?: number;
+    /**
+     * limit, defaut 24, borne <=0||>200 => 24
+     */
+    indexStep?: number;
+    /**
+     * Slug du costum
+     */
+    costumSlug?: string;
+    /**
+     * ID du contexte costum (alias contextId)
+     */
+    costumId?: string;
+    /**
+     * Collection du host costum
+     */
+    costumType?: "projects" | "organizations";
+    [k: string]: unknown;
+}
+export interface CostumToolUsersData {
+    /**
+     * (requis)
+     */
+    formId: string;
+    /**
+     * (requis)
+     */
+    step: string;
+    /**
+     * (requis)
+     */
+    finderPath: string;
+    /**
+     * JSON string[] serialise (requis)
+     */
+    criteriaIds: string;
+    /**
+     * JSON string[] serialise (optionnel)
+     */
+    inputKeys?: string;
+    /**
+     * Slug du costum
+     */
+    costumSlug?: string;
+    /**
+     * ID du contexte costum (alias contextId)
+     */
+    costumId?: string;
+    /**
+     * Collection du host costum
+     */
+    costumType?: "projects" | "organizations";
+    [k: string]: unknown;
+}
+export interface CostumCommunInfoData {
+    /**
+     * _id de la reponse AAP du commun (requis)
+     */
+    communId: string;
+    /**
+     * form AAP des communs, verrou anti-IDOR (requis)
+     */
+    formId: string;
+    /**
+     * Slug du costum
+     */
+    costumSlug?: string;
+    /**
+     * ID du contexte costum (alias contextId)
+     */
+    costumId?: string;
+    /**
+     * Collection du host costum
+     */
+    costumType?: "projects" | "organizations";
+    [k: string]: unknown;
+}
+export interface CostumSaveToolEnrichmentData {
+    /**
+     * nom EXACT de l'outil, cle d'upsert (requis)
+     */
+    name: string;
+    /**
+     * lien de l'outil
+     */
+    url?: string;
+    /**
+     * lien du commun, porte l'ancre #detail-un-commun.communId.<24hex>
+     */
+    urlTool?: string;
+    /**
+     * markdown
+     */
+    description?: string;
+    /**
+     * 'true'/'false' en STRING (forme historique) OU boolean cote SDK avant stringify
+     */
+    isOpenSource?: string;
+    /**
+     * docPath relatif de UPLOAD_DOCUMENT ou URL http(s)
+     */
+    imageTool?: string;
+    /**
+     * id du document uploade
+     */
+    imageToolId?: string;
+    /**
+     * Slug du costum
+     */
+    costumSlug?: string;
+    /**
+     * ID du contexte costum (alias contextId)
+     */
+    costumId?: string;
+    /**
+     * Collection du host costum
+     */
+    costumType?: "projects" | "organizations";
+    [k: string]: unknown;
+}
+export interface CostumCommunListData {
+    /**
+     * form AAP des communs (requis)
+     */
+    formId: string;
+    /**
+     * Slug du costum
+     */
+    costumSlug?: string;
+    /**
+     * ID du contexte costum (alias contextId)
+     */
+    costumId?: string;
+    /**
+     * Collection du host costum
+     */
+    costumType?: "projects" | "organizations";
+    [k: string]: unknown;
+}
 export interface GenerateAnswerFromFormData {
     action?: string;
     pathParams?: {

package/types/api/Form.d.ts

@@ -3,6 +3,7 @@ import type { Answer } from "./Answer.js";
 import type { PaginatorPage, PaginatorState } from "./BaseEntity.js";
 import type { CoformAnswersSearchData, DirectoryProposalCountData, DirectoryProposalData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
 import type { CoformCommonTableContributor, FormItemNormalized } from "./serverDataType/Form.js";
+import type { ToolsCatalogPage, ToolsCatalogParams, ToolUser, ToolUsersParams } from "./serverDataType/ToolsCatalog.js";
 /**
  * Une entrée de catalogue commonTable (une criteria agrégée cross-réponses).
  * `label`/`usage`/`usageKey`/`coeff`/`count` toujours présents (le backend
@@ -115,6 +116,27 @@ export declare class Form extends BaseEntity<FormItemNormalized> {
     getAnswers(data?: Partial<CoformAnswersSearchData>, options?: {
         restoredState?: PaginatorState;
     }): Promise<PaginatorPage<Answer>>;
+    /**
+     * Catalogue d'outils d'usage agrégé depuis les réponses coform de CE form (`formId = this.id`).
+     *
+     * Retourne la PAGE BRUTE `{ results, count:{total}, facets? }` — **pas** de moteur de pagination :
+     * les `ToolCatalogItem` sont des DTO plats (sans `collection`), que `_linkEntities` jetterait.
+     * Le scroll infini se pilote côté front via `count.total` et la longueur cumulée. `sortBy` absent
+     * ⇒ défaut serveur `{ totalOccurrences:-1, title:1 }`.
+     *
+     * @example
+     * const form = await api.form({ id: formId });
+     * const page = await form.toolsCatalog({ step, finderPath, indexMin: 0 });
+     * page.results;      // ToolCatalogItem[]
+     * page.count.total;  // nombre d'outils (arrêt du scroll)
+     */
+    toolsCatalog(params: ToolsCatalogParams): Promise<ToolsCatalogPage>;
+    /**
+     * Les lieux utilisateurs d'un outil (recherche par `criteriaIds`, jamais par regex sur le nom).
+     * Retourne le tableau NU (désenveloppe `{ results }`). Les tableaux `criteriaIds`/`inputKeys`
+     * sont sérialisés en JSON (le fil attend une string `string[]` sérialisée).
+     */
+    getToolUsers(params: ToolUsersParams): Promise<ToolUser[]>;
     /**
      * {@inheritDoc BaseEntity#answer}
      *

package/types/api/serverDataType/CommunInfo.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Types de la **fiche du commun** rattaché à un outil (`Answer.getCommunInfo()`).
+ *
+ * Source de vérité : `modules/costum/controllers/actions/franceTierslieux/CommunInfoAction.php`.
+ * Endpoint `auth: none` verrouillé par `formId` (le serveur vérifie `answer.form === formId`) :
+ * sans lui, n'importe quel ObjectId lirait n'importe quelle réponse. Entrée invalide ⇒ `null` en
+ * HTTP 200 (fail-closed, jamais de 500).
+ */
+/** Un poste financier — recalculé serveur, ne contient JAMAIS les `financer[]` (données nominatives). */
+export interface CommunFundingPoste {
+    label: string;
+    target: number;
+    collected: number;
+}
+/**
+ * Fiche d'un commun. Le legacy émet **toujours les 8 clés** (défaut `""`/`[]`, cf.
+ * `cible-costum-francetierslieux-communinfo.md`) → tous les champs sont REQUIS (jamais `undefined`).
+ * Le front les lit sans garde (`commun.email`, `commun.tags.length`, `commun.description`).
+ */
+export interface CommunInfo {
+    /** communId = l'`_id` (24hex) de l'answer du commun */
+    id: string;
+    title: string;
+    /** markdown ; `""` si vide */
+    description: string;
+    /** `""` si vide */
+    email: string;
+    /** URL du canal de discussion (safeUrl `^https?://`), `""` si vide/invalide */
+    channelUrl: string;
+    /** libellé « site web » (safeUrl), `""` si vide/invalide */
+    toolUrl: string;
+    /** tableau dédupliqué, `[]` si aucun */
+    tags: string[];
+    /** postes financiers recalculés serveur, `[]` si aucun */
+    postes: CommunFundingPoste[];
+}

package/types/api/serverDataType/ToolsCatalog.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Types du **catalogue d'outils d'usage** (module `toolsCatalog` de site-json).
+ *
+ * Source de vérité : les actions legacy `FrancetierslieuxController` (module costum),
+ * `controllers/actions/franceTierslieux/{ToolsCatalogListAction,ToolUsersAction,navigator/SaveCriteriaAction}.php`.
+ * Un « outil » n'est PAS une entité : c'est une AGRÉGATION de réponses coform regroupées par nom
+ * normalisé + l'enrichissement éditorial (`navigatorcriteria`). Les DTO sont donc **plats** (aucun
+ * champ `collection`) : `BaseEntity._linkEntities` les jetterait — d'où le retour de page BRUT.
+ *
+ * ⚠ Optionalité **load-bearing** (le front les lit sans garde) : cf. doc `35-sdk-tools-catalog.md`
+ * et le rapport d'analyse. Ne pas relâcher un champ requis sans casser le `tsc` de site-json.
+ */
+/** Un outil agrégé — une ligne de `ToolsCatalogPage.results`.
+ *  ⚠ Byte-truth : `id/title/normalizedName/originalNames[]` + `category/categoriesList/usagesList` dérivent
+ *  de CLÉS de tableau PHP → pour un nom d'outil/label NUMÉRIQUE (donnée dégénérée, ex. valeurs radio 0/1/2)
+ *  le fil porte des NOMBRES. Le type reste `string` (les vrais outils ont des noms texte ; c'est le contrat
+ *  attendu par site-json) ; la coercion est documentée dans la fiche `cible-…-toolscatalog.md`. */
+export interface ToolCatalogItem {
+    /** nom normalisé (clé stable entre pages) */
+    id: string;
+    title: string;
+    normalizedName: string;
+    originalNames: string[];
+    /** `categoriesList[0]` ou `""` */
+    category: string;
+    categoriesList: string[];
+    usagesList: string[];
+    usagesCount: number;
+    totalOccurrences: number;
+    /** cascade d'image ; `""` si aucune (jamais `undefined`) */
+    image: string;
+    /** fusion d'AFFICHAGE `url ?: urlTool` (conserve l'ancre). NE PAS pré-remplir un éditeur avec. */
+    url?: string;
+    /** `navigatorcriteria.url` BRUT (ce que l'admin a saisi) — pour le prefill éditeur */
+    urlOwn?: string;
+    /** `navigatorcriteria.urlTool` BRUT (lien du commun, avec l'ancre `#detail-un-commun.communId.<24hex>`) */
+    urlTool?: string;
+    description?: string;
+    /** booléen (le fil legacy stocke `"true"/"false"` en string, reconverti serveur) */
+    isOpenSource: boolean;
+    /** 24hex minuscule extrait de l'ancre, ou `""` si aucun (jamais `undefined`) */
+    communId: string;
+    criteriaIds: string[];
+    inputKeys?: string[];
+    idAnswers: string[];
+}
+/** Facettes calculées sur le catalogue COMPLET (pas la page) — ne se vident pas au scroll. */
+export interface ToolsCatalogFacets {
+    categories: string[];
+    usages: string[];
+    /** co-occurrence catégorie → usages */
+    usagesByCategory?: Record<string, string[]>;
+}
+/** Page BRUTE de `Form.toolsCatalog()` — pas de moteur de pagination (DTO plats). */
+export interface ToolsCatalogPage {
+    results: ToolCatalogItem[];
+    /** `count.total` = nombre d'OUTILS (après filtres, avant page) — pilote l'arrêt du scroll infini */
+    count: {
+        total: number;
+    };
+    facets?: ToolsCatalogFacets;
+}
+/** Un lieu utilisateur d'un outil — une ligne du retour de `Form.getToolUsers()`.
+ *  Le legacy émet TOUJOURS les 13 clés (défaut `""`/`0`), cf. fiche `cible-…-toolusers.md`. */
+export interface ToolUser {
+    answerId: string;
+    criteriaId: string;
+    /** nom de l'outil de l'entrée (`entry.criteria`) */
+    criteria: string;
+    placeName: string;
+    /** id 24hex de l'entité-lieu, ou `""` */
+    placeId: string;
+    /** type de l'entité-lieu (`organizations|projects|events|poi|citoyens`), ou `""` */
+    placeType: string;
+    placeSlug?: string;
+    image?: string;
+    /** `love` | `happySmile` | `neutral` | `sad` | `cry` */
+    happiness?: string;
+    note: number;
+    /** commentaire libre de l'entrée, ou `""` */
+    comment: string;
+    category: string;
+    usage: string;
+}
+/** Entrée d'upsert de `BaseEntity.saveToolEnrichment()`. Sémantique **clé-absente ≠ chaîne-vide** :
+ *  ne pas injecter de défaut / ne pas coercer `undefined → ""` (sinon `urlTool` efface un lien légitime). */
+export interface ToolEnrichmentInput {
+    /** nom EXACT de l'outil — clé d'upsert */
+    name: string;
+    url?: string;
+    urlTool?: string;
+    description?: string;
+    /** booléen côté SDK ; la méthode stringifie en `"true"/"false"` (forme historique) à l'envoi */
+    isOpenSource?: boolean;
+    imageTool?: string;
+    imageToolId?: string;
+}
+/** Retour de `saveToolEnrichment()` — forme historique partagée avec les vues legacy `listTools`.
+ *  `msg` est du FR en dur côté PHP : à conserver pour le diagnostic, jamais à afficher tel quel. */
+export interface ToolEnrichmentResult {
+    results: boolean;
+    msg: string;
+    data?: unknown;
+    name?: string;
+}
+/** Option du select de rattachement — une ligne du retour de `BaseEntity.getCommunList()`. */
+export interface CommunListItem {
+    id: string;
+    title: string;
+}
+/** Paramètres de `Form.toolsCatalog()` (le `formId` vient de `this.id`). */
+export interface ToolsCatalogParams {
+    step: string;
+    finderPath: string;
+    name?: string;
+    /** `{ category?, usage?, isOpenSource? (boolean) }` */
+    filters?: Record<string, unknown>;
+    /** défaut serveur `{ totalOccurrences: -1, title: 1 }` si absent */
+    sortBy?: Record<string, 1 | -1>;
+    indexMin?: number;
+    indexStep?: number;
+}
+/** Paramètres de `Form.getToolUsers()` (le `formId` vient de `this.id`). */
+export interface ToolUsersParams {
+    step: string;
+    finderPath: string;
+    /** tableau brut ou déjà sérialisé — la méthode le sérialise en JSON si tableau */
+    criteriaIds: string | string[];
+    inputKeys?: string | string[];
+}

package/types/costum/types.d.ts

@@ -521,6 +521,9 @@ export interface CostumFieldMap {
         };
     };
     institutBleu: {
+        events: {
+            description?: string;
+        };
         organizations: {
             acronym?: string;
             categoryThematic?: ("Action de l'Etat en mer" | "Environnement & Recherche et Innovation" | "Industrie et maintenance navale" | "Pêche et produits de la mer" | "Tourisme bleu et activités nautiques" | "Transport maritime & infrastructures portuaires" | "Energies Marines Renouvelables" | "Appui & soutien et accompagnement")[];
@@ -539,6 +542,19 @@ export interface CostumFieldMap {
             similarLink?: Record<string, unknown>;
             siret?: number;
         };
+        poi: {
+            auteurs?: string[];
+            coteDocument?: number;
+            date?: string;
+            echelle?: "Locale" | "Nationale" | "Régionale" | "Européen" | "International" | "Autre";
+            financementSource?: string;
+            financementType?: "Appels à projets" | "Appel à Manifestation d'Intérêt" | "Marché public" | "Subventions" | "Autre";
+            langue?: "FR" | "EN";
+            organisme?: string[];
+            territoires?: ("collection" | "where" | "distinct")[];
+            thematique?: ("Droit" | "Géographie" | "Biologie" | "Sociologie" | "Information-Communication" | "Ingénierie (Dispositifs de Répulsion Électrique individuel)" | "Sciences de gestion" | "Médecine" | "Innovation" | "Economie")[];
+            typeDocument?: "Mémoire" | "Rapport d'étude" | "Rapport" | "Extrait d'ouvrage" | "Ouvrage" | "Article" | "Autres" | "Article scientifique" | "Note de synthèse" | "Feuille de route" | "Magazine" | "Plan d'action";
+        };
     };
     journalInsoumisChambery: {
         events: {