@communecter/cocolight-api-client 1.0.149 → 1.0.150

package/src/forms/entityForm.ts

@@ -0,0 +1,142 @@
+/**
+ * Descripteur de FORMULAIRE de BASE d'une entité (création) — NEUTRE (zéro dépendance UI/site).
+ *
+ * Pendant de `CostumScope.describeForm` (qui décrit l'OVERLAY costum), pour les champs de BASE de
+ * l'entité (name/email/url/address/tags/telephone/openingHours/socialNetwork/image…). Le consommateur
+ * (site-json) compose `describeEntityForm(collection)` ⊕ `describeForm(collection)` → un form complet
+ * base+costum, SANS dupliquer la base par costum.
+ *
+ * Décision (B) : la base est **curée UNE FOIS par entité** ici, pas auto-extraite des schémas. Le
+ * modèle lib étale la base sur plusieurs schémas hétérogènes (`ADD_*` + `UPDATE_BLOCK_*` +
+ * `VIRTUAL_SCHEMAS` + `PROFIL_IMAGE`) avec des dualités (social objet vs à plat, image hors-ADD,
+ * virtuals déclarés en CODE) → une auto-extraction propre est fragile. La curation reste « from the
+ * lib build » (exportée par la lib) et « définie une fois ». La config générée est ensuite ÉDITABLE.
+ *
+ * NEUTRE : aucun `widget` ici (vocabulaire UI du site). On porte un `format` (indice sémantique) que le
+ * consommateur mappe vers son widget (`address`→location, `image`→image, `social`→editSocial, …).
+ */
+import { EVENT_TYPES } from "../api/serverDataType/Event.js";
+import { ORGANIZATION_TYPES } from "../api/serverDataType/Organization.js";
+import { POI_TYPES } from "../api/serverDataType/Poi.js";
+
+import type { Collection } from "../costum/types.js";
+
+/** Type logique d'un champ de base (aligné sur `CostumFieldType`). */
+export type EntityFieldType = "string" | "number" | "boolean" | "date" | "array" | "object";
+
+/** Indice sémantique de rendu — le site le mappe vers son widget (la lib reste UI-neutre). */
+export type EntityFieldFormat =
+  | "email" | "url" | "tel" | "markdown"
+  | "address" | "image" | "social" | "openingHours";
+
+/** Champ de base décrit pour un formulaire (curé, neutre). */
+export interface BaseFieldDescriptor {
+  name: string;
+  type: EntityFieldType;
+  multiple: boolean;
+  /** Options de choix (select/multiselect). */
+  enum?: (string | number)[];
+  /** Libellé humain curé (la source schéma n'en a pas de fiable). */
+  label?: string;
+  required?: boolean;
+  /** Indice de rendu pour le consommateur (widget spécialisé). */
+  format?: EntityFieldFormat;
+}
+
+/** Formulaire de BASE d'une entité (champs curés) — pendant neutre de `CostumFormDescriptor`. */
+export interface EntityFormDescriptor {
+  collection: Collection;
+  fields: BaseFieldDescriptor[];
+}
+
+/**
+ * Base ORGANIZATIONS (création) — curée depuis `Organization.ts` (SCHEMA_CONSTANTS `ADD_ORGANIZATION` +
+ * `PROFIL_IMAGE` + `VIRTUAL_*`), réconciliée : champs système/plumbing retirés, social pris en OBJET
+ * (`socialNetwork`, pas la variante à plat de `UPDATE_BLOCK_SOCIAL`), image `profil_avatar` ajoutée
+ * (absente d'`ADD_ORGANIZATION`). `type` enum ← `ADD_ORGANIZATION.type`.
+ */
+const ORGANIZATION_BASE: BaseFieldDescriptor[] = [
+  { name: "name", type: "string", multiple: false, label: "Nom", required: true },
+  { name: "type", type: "string", multiple: false, label: "Type", enum: [...ORGANIZATION_TYPES] },
+  { name: "email", type: "string", multiple: false, label: "Email", format: "email" },
+  { name: "url", type: "string", multiple: false, label: "Site web", format: "url" },
+  { name: "telephone", type: "string", multiple: false, label: "Téléphone", format: "tel" },
+  { name: "shortDescription", type: "string", multiple: false, label: "Description courte" },
+  { name: "description", type: "string", multiple: false, label: "Description", format: "markdown" },
+  { name: "tags", type: "array", multiple: true, label: "Tags" },
+  { name: "address", type: "object", multiple: false, label: "Adresse", format: "address" },
+  { name: "socialNetwork", type: "object", multiple: false, label: "Réseaux sociaux", format: "social" },
+  { name: "openingHours", type: "array", multiple: false, label: "Horaires d'ouverture", format: "openingHours" },
+  { name: "profil_avatar", type: "object", multiple: false, label: "Logo / image", format: "image" },
+];
+
+/**
+ * Base PROJECTS (création) — curée depuis `Project.ts` (`ADD_PROJECT` + `UPDATE_BLOCK_DESCRIPTION/SOCIAL` +
+ * `PROFIL_IMAGE`). `public` (visibilité) est propre au projet (absent de l'org). Pas de `type` (le contrat
+ * projet n'en a pas), pas d'`email`/`telephone`/`openingHours`. Exclus système/plumbing : id/collection/
+ * key/parent/preferences/geo/geoPosition/scope.
+ */
+const PROJECT_BASE: BaseFieldDescriptor[] = [
+  { name: "name", type: "string", multiple: false, label: "Nom du projet", required: true },
+  { name: "shortDescription", type: "string", multiple: false, label: "Description courte" },
+  { name: "description", type: "string", multiple: false, label: "Description", format: "markdown" },
+  { name: "url", type: "string", multiple: false, label: "Site web", format: "url" },
+  { name: "public", type: "boolean", multiple: false, label: "Projet public" },
+  { name: "tags", type: "array", multiple: true, label: "Tags" },
+  { name: "address", type: "object", multiple: false, label: "Adresse", format: "address" },
+  { name: "socialNetwork", type: "object", multiple: false, label: "Réseaux sociaux", format: "social" },
+  { name: "profil_avatar", type: "object", multiple: false, label: "Logo / image", format: "image" },
+];
+
+/**
+ * Base POI (création) — curée depuis `Poi.ts` (`ADD_POI` + `UPDATE_BLOCK_DESCRIPTION` + `PROFIL_IMAGE`).
+ * `type` enum ← `POI_TYPES` ; `urls` (liens externes) propre au POI. Pas de social/openingHours/email.
+ * Exclus système/plumbing : id/source/collection/key/parent/geo/geoPosition/scope.
+ */
+const POI_BASE: BaseFieldDescriptor[] = [
+  { name: "name", type: "string", multiple: false, label: "Nom", required: true },
+  { name: "type", type: "string", multiple: false, label: "Type", enum: [...POI_TYPES] },
+  { name: "description", type: "string", multiple: false, label: "Description", format: "markdown" },
+  { name: "tags", type: "array", multiple: true, label: "Tags" },
+  { name: "urls", type: "array", multiple: true, label: "Liens / URLs" },
+  { name: "address", type: "object", multiple: false, label: "Adresse", format: "address" },
+  { name: "profil_avatar", type: "object", multiple: false, label: "Logo / image", format: "image" },
+];
+
+/**
+ * Base EVENTS (création) — curée depuis `Event.ts` (`ADD_EVENT` + `PROFIL_IMAGE`). `type` enum ← `EVENT_TYPES` ;
+ * `startDate`/`endDate` (dates) + `openingHours` (récurrence) propres à l'événement. Pas de `description`
+ * longue (le contrat event n'en a pas), pas de social/telephone. Exclus système/plumbing : id/collection/
+ * key/organizer/parent/preferences/timeZone/recurrency.
+ */
+const EVENT_BASE: BaseFieldDescriptor[] = [
+  { name: "name", type: "string", multiple: false, label: "Nom de l'événement", required: true },
+  { name: "type", type: "string", multiple: false, label: "Type d'événement", enum: [...EVENT_TYPES] },
+  { name: "public", type: "boolean", multiple: false, label: "Événement public" },
+  { name: "shortDescription", type: "string", multiple: false, label: "Description courte" },
+  { name: "url", type: "string", multiple: false, label: "Site web", format: "url" },
+  { name: "email", type: "string", multiple: false, label: "Email", format: "email" },
+  { name: "tags", type: "array", multiple: true, label: "Tags" },
+  { name: "startDate", type: "date", multiple: false, label: "Date de début" },
+  { name: "endDate", type: "date", multiple: false, label: "Date de fin" },
+  { name: "openingHours", type: "array", multiple: false, label: "Horaires d'ouverture", format: "openingHours" },
+  { name: "address", type: "object", multiple: false, label: "Adresse", format: "address" },
+  { name: "profil_avatar", type: "object", multiple: false, label: "Logo / image", format: "image" },
+];
+
+/** Base curée par collection (entités créables via formulaire ; citoyen = inscription, hors périmètre). */
+const ENTITY_FORMS: Partial<Record<Collection, BaseFieldDescriptor[]>> = {
+  organizations: ORGANIZATION_BASE,
+  projects: PROJECT_BASE,
+  poi: POI_BASE,
+  events: EVENT_BASE,
+};
+
+/**
+ * Décrit le formulaire de BASE (création) d'une entité — curé, neutre. `null` si non couverte
+ * (le consommateur retombe alors sur le costum seul). Statique : aucune dépendance réseau/instance.
+ */
+export function describeEntityForm(collection: Collection): EntityFormDescriptor | null {
+  const fields = ENTITY_FORMS[collection];
+  return fields ? { collection, fields } : null;
+}

package/src/index.ts

@@ -127,6 +127,20 @@ export type {
 // Constantes BaseEntity
 export { UPDATE_PATH_MAGIC } from "./api/BaseEntity.js";
 
+// Costum runtime : scope + descripteur de formulaire (pour générer un form depuis le runtime distribué)
+export type {
+  CostumScope,
+  CostumRuntimeContext,
+  CostumFormDescriptor,
+  CostumFieldDescriptor,
+  CostumFieldType,
+} from "./costum/runtime.js";
+export type { Collection, KnownCostumSlug } from "./costum/types.js";
+
+// Formulaire de BASE d'une entité (curé, neutre) — composé avec l'overlay costum (describeForm).
+export { describeEntityForm } from "./forms/entityForm.js";
+export type { EntityFormDescriptor, BaseFieldDescriptor, EntityFieldType, EntityFieldFormat } from "./forms/entityForm.js";
+
 // Types Answer (file-source, en plus des types serverData)
 export type {
   AllStepsData,

package/types/ApiClient.d.ts

@@ -82,6 +82,7 @@ export default class ApiClient extends EventEmitter {
     private readonly _tokenStorage;
     private _offlineClientManager;
     private _ajv;
+    private _ajvNoDefaults;
     _logger: any;
     private _client;
     private readonly _breakerThreshold;

package/types/api/BaseEntity.d.ts

@@ -1,4 +1,5 @@
 import type { UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, GetNewsData, GetGalleryData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestDatesData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetOrganizationsAdminData, GetOrganizationsNoAdminData, GetProjectsAdminData, GetProjectsNoAdminData, GetPoisAdminData, GetPoisNoAdminData, GetSubscribersData, GetBadgesData, CoformAnswersSearchData, SearchMemberAutocompleteData, GetEventsData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, FundingEnvelopeData, CoremuOperationData, UpdatePathValueData } from "./EndpointApi.types.js";
+import type { CostumRuntimeContext } from "../costum/runtime.js";
 import type { TransformsMap } from "../types/entities.js";
 import type { CountryItem } from "./serverDataType/Country.js";
 import type { ZoneItemNormalized } from "./serverDataType/Zone.js";
@@ -130,6 +131,8 @@ interface Deps {
 }
 interface BaseEntityConfig {
     entityTag?: string;
+    /** Contexte costum (résolu par `CostumScope`) — ouvre les champs costum sur draft/extraction/AJV. */
+    costumCtx?: CostumRuntimeContext;
 }
 interface EntityTypeMap {
     citoyens: User;
@@ -313,6 +316,24 @@ export type EntityType = "citoyens" | "organizations" | "projects" | "events" |
  * @template object TServerData
  * @abstract
  */
+/**
+ * Identifie un document image dans une liste `document/list`, par `contentKey` :
+ *  1. `d.contentKey === contentKey` (backend cocolight, qui projette contentKey) ;
+ *  2. sinon par **nom de fichier** matché sur `imageUrl` (backend legacy : `document/list` ne
+ *     renvoie PAS de contentKey → on rapproche le `name` du doc du basename de l'URL image).
+ * Pure (testable sans backend). Renvoie `undefined` si aucun doc identifiable.
+ */
+export declare function findImageDocument<T extends {
+    id: string;
+    name?: string;
+    contentKey?: string;
+}>(docs: T[], contentKey: string, imageUrl?: string): T | undefined;
+/** Document image de PROFIL (`findImageDocument` avec contentKey="profil"). */
+export declare function findProfilDocument<T extends {
+    id: string;
+    name?: string;
+    contentKey?: string;
+}>(docs: T[], profilImageUrl?: string): T | undefined;
 export declare class BaseEntity<TServerData = any> {
     __entityTag: string;
     deps: Partial<Deps>;
@@ -328,6 +349,8 @@ export declare class BaseEntity<TServerData = any> {
     _calledFromSave: boolean;
     _syncReactiveDraft: boolean;
     _isDeleted: boolean;
+    /** Contexte costum porté par cette instance (null hors d'un `CostumScope`). Posé au constructeur. */
+    _costumCtx: CostumRuntimeContext | null;
     _add?: ((payload: any) => Promise<void | unknown>) | undefined;
     _update?: ((payload: any) => Promise<boolean>) | undefined;
     _allowedFieldsCache?: string[];
@@ -344,6 +367,9 @@ export declare class BaseEntity<TServerData = any> {
         updateMethod: string;
         schemaConstant?: string;
     }>;
+    /** Constante de schéma du bloc de CRÉATION (ADD_*) où injecter les champs costum à la validation
+     *  d'extraction. Définie par les entités créables sous costum (Poi/Organization/Event/Project). */
+    static COSTUM_ADD_CONSTANT?: string;
     /**
      * Vérifie que l'objet n'a pas été supprimé.
      * @throws {ApiError} - Si l'objet a été supprimé.
@@ -423,6 +449,22 @@ export declare class BaseEntity<TServerData = any> {
      * @returns Données serveur mises à jour (après éventuel `refresh()`)
      */
     save(): Promise<Record<string, any>>;
+    /**
+     * UPDATE d'une entité costum-scopée — pendant EXACT de l'ADD. Au lieu de N `updatepathvalue` champ-par-champ
+     * (route « édition inline » legacy : AUCUN hook, AUCUNE validation), on envoie UN SEUL `element/save` portant
+     * tous les champs MODIFIÉS (standard + costum) + l'id + l'enveloppe costum (contexte + schémas des champs
+     * envoyés, `isUpdate:true`). Côté backend, `element/save` branche update déclenche prepData / elementBeforeSave /
+     * elementAfterUpdate / elementAfterSave / validation costum (cf. legacy `Element::save` : ce sont les SEULES
+     * routes qui exécutent ces hooks ; updatepathvalue/updateblock n'en exécutent aucun de dérivation). Atomique
+     * (un seul `updated`/recalcul slug). Effacement (`null`/`""`/`[]`) → `""` (survit à `stripNulls`, backend → `$unset`).
+     *
+     * L'univers des champs éditables = `_allowedFieldsCache` (union writable des SCHEMA_CONSTANTS + schéma costum,
+     * calculée au build du draft) ∪ champs DATA costum déclarés (robuste si le cache est antérieur au costum).
+     * @returns true si au moins un champ a été envoyé (donc refresh ensuite).
+     */
+    protected _saveCostumViaElementSave(payload: Record<string, any>): Promise<boolean>;
+    /** Recherche le schéma d'une propriété dans un schéma combiné `{ allOf: [...] }` (1er match). */
+    private _lookupPropSchema;
     /**
      * Crée une nouvelle instance d'entité à partir des données du serveur.
      *
@@ -648,6 +690,31 @@ export declare class BaseEntity<TServerData = any> {
      * await news.deleteFile(imageDocId);
      */
     deleteFile(docId: string): Promise<void>;
+    /**
+     * Liste les documents (images/fichiers) attachés à CETTE entité (`id` + `type`) via `DOCUMENT_LIST`
+     * (port legacy `document/list`). Renvoie un tableau plat `{ id, name, path, author, contentKey }`.
+     * Utile pour récupérer le `docId` d'une image (ex. profil) — non exposé sur l'élément — afin de la
+     * supprimer (`deleteFile`).
+     */
+    getDocuments(): Promise<Array<{
+        id: string;
+        name?: string;
+        path?: string;
+        author?: string;
+        contentKey?: string;
+    }>>;
+    /**
+     * Supprime l'image de PROFIL de cette entité : récupère le `docId` du document `contentKey:"profil"`
+     * (via `getDocuments`) puis `deleteFile`. No-op (`false`) s'il n'y a pas d'image. Pendant exact de
+     * `updateImageProfil` côté suppression.
+     */
+    removeProfilImage(): Promise<boolean>;
+    /**
+     * Supprime l'image de BANNIÈRE de cette entité : récupère le `docId` du document `contentKey:"banner"`
+     * (via `getDocuments`) puis `deleteFile`. No-op (`false`) s'il n'y a pas de bannière. Pendant de
+     * `updateImageBanner` côté suppression (le backend désassigne `profilBannerUrl`/`profilRealBannerUrl`).
+     */
+    removeBannerImage(): Promise<boolean>;
     /**
      * Vide les objets réactifs et marque l'entité comme supprimée (tombstone),
      * sans casser la réactivité. Pattern partagé par tous les `delete()`.
@@ -1097,7 +1164,7 @@ export declare class BaseEntity<TServerData = any> {
      * @return {EntityTypeMap[T]}
      * @private
      */
-    _entityInstanceData<T extends keyof EntityTypeMap>(entityType: T, entityData: object): EntityTypeMap[T];
+    _entityInstanceData<T extends keyof EntityTypeMap>(entityType: T, entityData: object, config?: BaseEntityConfig): EntityTypeMap[T];
     /**
      * Crée une instance d'entité, et déclenche get() si certaines propriétés sont présentes.
      * @template keyof EntityTypeMap T
@@ -1105,7 +1172,7 @@ export declare class BaseEntity<TServerData = any> {
      * @param [entityData={}]
      * @return {Promise<EntityTypeMap[T]>}
      */
-    entity<T extends keyof EntityTypeMap>(entityType: T, entityData?: object): Promise<EntityTypeMap[T]>;
+    entity<T extends keyof EntityTypeMap>(entityType: T, entityData?: object, config?: BaseEntityConfig): Promise<EntityTypeMap[T]>;
     /**
      * Récupère et lie une entité à partir de son slug.
      * @param slug - Le slug de l'entité.

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 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, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, 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, PersonActivateData } from "./EndpointApi.types.js";
+import type { DocumentListData, 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, 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, PersonActivateData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -46,6 +46,16 @@ export declare class EndpointApi {
      * @throws {ApiResponseError} En cas d'erreur de l'API.
      */
     callIsConnected<T>(constant: string, data?: any): Promise<T>;
+    /**
+     * Lister les documents d'une entité : Liste les documents (images/fichiers) attachés à un élément (id+type). Port de citizenToolKit document/ListAction (tpl=json). Sert notamment à récupérer le docId de l'image de profil (contentKey=profil) pour la supprimer via DELETE_DOCUMENT_BY_ID.
+     * Constant : DOCUMENT_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.
+     */
+    documentList(data: DocumentListData): Promise<any>;
     /**
      * Enregistrement d'un utilisateur : Permet d’enregistrer un nouvel utilisateur avec ses informations personnelles.
      * Constant : PERSON_REGISTER

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

@@ -1,3 +1,17 @@
+export interface DocumentListData {
+    pathParams?: {
+        /**
+         * ID MongoDB de l'élément
+         */
+        id: string;
+        /**
+         * Type d'élément
+         */
+        type: "citoyens" | "organizations" | "projects" | "events" | "poi";
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
 export interface PersonRegisterData {
     /**
      * Nom complet de l'utilisateur
@@ -2669,34 +2683,6 @@ export interface AddOrganizationData {
         streetAddress?: string;
     };
     scope: "";
-    /**
-     * Nom de la structure porteuse (différent du nom du tiers-lieu)
-     */
-    holderOrganization?: string;
-    /**
-     * Mode de gestion (Association, Collectif citoyen, SCIC, etc.)
-     */
-    manageModel?: string;
-    /**
-     * Famille(s) de tiers-lieux (Coworking, Fablab, Foodlab, etc.)
-     */
-    typePlace?: string;
-    /**
-     * Réseau accompagnateur (ex: Compagnon France Tiers-Lieux)
-     */
-    compagnon?: string;
-    /**
-     * Surface bâtie en m²
-     */
-    buildingSurfaceArea?: number;
-    /**
-     * Surface extérieure en m²
-     */
-    siteSurfaceArea?: number;
-    /**
-     * Date d'ouverture du tiers-lieu (format libre, ex: 05/05/2026)
-     */
-    openingDate?: string;
     /**
      * Horaires d'ouverture (7 entrées, une par jour de la semaine ; "" pour un jour fermé). Doit rester synchronisé avec VIRTUAL_OPENING_HOURS dans Organization.ts.
      *
@@ -2855,17 +2841,11 @@ export interface AddOrganizationData {
      */
     mainTag?: string;
     /**
-     * Slug du costum d'origine
-     */
-    costumSlug?: string;
-    /**
-     * ID Mongo du costum d'origine
+     * Réseaux sociaux — objet keyé par plateforme (facebook/twitter/instagram/linkedin/youtube/mastodon/telegram/...). dataBinding org legacy `socialNetwork` (Organization.php:82).
      */
-    costumId?: string;
-    /**
-     * Type d'entité du costum (ex: projects)
-     */
-    costumType?: string;
+    socialNetwork?: {
+        [k: string]: string;
+    };
     [k: string]: unknown;
 }
 export interface AddProjectData {
@@ -2986,18 +2966,6 @@ export interface AddProjectData {
         streetAddress?: string;
     };
     scope: "";
-    /**
-     * Slug du costum d'origine
-     */
-    costumSlug?: string;
-    /**
-     * ID Mongo du costum d'origine
-     */
-    costumId?: string;
-    /**
-     * Type d'entité du costum (ex: projects)
-     */
-    costumType?: string;
     [k: string]: unknown;
 }
 export interface AddPoiData {
@@ -3112,174 +3080,6 @@ 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[];
-    /**
-     * Slug du costum d'origine
-     */
-    costumSlug?: string;
-    /**
-     * ID Mongo du costum d'origine
-     */
-    costumId?: string;
-    /**
-     * Type d'entité du costum (ex: projects)
-     */
-    costumType?: string;
     [k: string]: unknown;
 }
 export interface AddEventData {
@@ -3580,18 +3380,6 @@ export interface AddEventData {
         streetAddress?: string;
     };
     scope: "";
-    /**
-     * Slug du costum d'origine
-     */
-    costumSlug?: string;
-    /**
-     * ID Mongo du costum d'origine
-     */
-    costumId?: string;
-    /**
-     * Type d'entité du costum (ex: projects)
-     */
-    costumType?: string;
     [k: string]: unknown;
 }
 export interface DeleteElementData {

package/types/api/Event.d.ts

@@ -6,6 +6,8 @@ type EventItemNormalized = import("./serverDataType/Event.js").EventItemNormaliz
 export declare class Event extends BaseEntity<EventItemNormalized> {
     static entityType: string;
     static entityTag: string;
+    /** Bloc de création où injecter les champs costum (CostumScope). */
+    static COSTUM_ADD_CONSTANT: string;
     static SCHEMA_CONSTANTS: string[];
     static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "ADD_EVENT", "updateImageProfil" | "addEvent">;
     static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateSlug">;