@communecter/cocolight-api-client 1.0.155 → 1.0.157

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.155",
+    "version": "1.0.157",
     "description": "Client Axios simplifié pour l'API cocolight",
     "repository": {
         "type": "git",
@@ -18,7 +18,7 @@
             "default": "./dist/cocolight-api-client.vite.mjs.js"
         },
         "require": "./dist/cocolight-api-client.cjs",
-        "default": "./dist/cocolight-api-client.mjs.js"
+        "default": "./dist/cocolight-api-client.vite.mjs.js"
     },
     "type": "module",
     "types": "./types/index.d.ts",
@@ -26,7 +26,6 @@
         "test": "vitest run",
         "test:watch": "vitest watch",
         "test:ui": "vitest --ui",
-        "test:old": "node --experimental-vm-modules ./node_modules/.bin/jest --config jest.config.js",
         "exemple": "node exemple/exemple.js",
         "exemple-api": "tsx exemple/exemple-api.ts",
         "lint": "eslint ./src ./scripts --ext .js,.ts",
@@ -34,14 +33,12 @@
         "typecheck": "tsc --noEmit",
         "build:browser": "webpack --config webpack.config.standalone.js",
         "build:node": "webpack --config webpack.config.node.js",
-        "build:esm": "webpack --config webpack.config.esm.mjs",
         "build:esm:rollup": "rollup -c rollup.config.mjs",
-        "verif:esm": "webpack --config webpack.config.esm.mjs --profile --json > stats.json",
         "build:ts": "tsc --project tsconfig.json",
         "build:types": "npm run generate:methodeapi && tsc --project tsconfig.types.json",
-        "build": "npm run generate:module:publish && npm run generate:methodeapi && npm run generate:doc && npm run lint:fix && npm run build:browser && npm run build:node && npm run build:esm && npm run build:esm:rollup && npm run build:types",
+        "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+        "build": "npm run clean && npm run generate:module:publish && npm run generate:methodeapi && npm run generate:doc && npm run lint && npm run build:browser && npm run build:node && npm run build:esm:rollup && npm run build:types",
         "build:publish": "npm run build && npm publish --access public",
-        "generate:module": "node ./scripts/transform-json-module.js",
         "generate:module:publish": "node ./scripts/transform-json-module.publish.js",
         "generate:doc": "node ./scripts/generate-doc.js",
         "generate:reponses": "node ./scripts/generate-constant-response-200.js",
@@ -59,7 +56,6 @@
     "license": "MIT",
     "files": [
         "dist/",
-        "src/",
         "types/",
         "package.json",
         "README.md"
@@ -79,11 +75,7 @@
         "pino-pretty": "^13.0.0"
     },
     "devDependencies": {
-        "@babel/core": "^7.26.10",
-        "@babel/preset-env": "^7.26.9",
-        "@babel/preset-typescript": "^7.27.1",
         "@eslint/js": "^9.23.0",
-        "@rollup/plugin-babel": "^6.0.4",
         "@rollup/plugin-commonjs": "^28.0.3",
         "@rollup/plugin-json": "^6.1.0",
         "@rollup/plugin-node-resolve": "^16.0.1",
@@ -93,13 +85,11 @@
         "@types/ejson": "^2.2.2",
         "@typescript-eslint/eslint-plugin": "^8.46.2",
         "@typescript-eslint/parser": "^8.46.2",
-        "@vitest/ui": "^4.0.1",
+        "@vitest/ui": "^4.1.9",
         "ajv": "^8.17.1",
         "ajv-formats": "^3.0.1",
         "axios": "^1.4.0",
         "axios-retry": "^4.5.0",
-        "babel-jest": "^29.7.0",
-        "babel-loader": "^10.0.0",
         "bson-objectid": "^2.0.4",
         "dotenv": "^17.2.3",
         "ejson": "^2.2.3",
@@ -108,7 +98,6 @@
         "events": "^3.3.0",
         "file-type": "^16.5.4",
         "globals": "^16.0.0",
-        "jest": "^29.7.0",
         "json-schema-to-typescript": "^15.0.4",
         "jwt-decode": "^4.0.0",
         "nodemon": "^3.1.9",
@@ -116,11 +105,12 @@
         "pino-pretty": "^13.0.0",
         "rollup": "^4.40.0",
         "rollup-plugin-peer-deps-external": "^2.2.4",
+        "terser-webpack-plugin": "^5.3.14",
         "ts-loader": "^9.5.4",
         "tslib": "^2.8.1",
         "tsx": "^4.20.6",
         "typescript": "^5.9.2",
-        "vitest": "^4.0.1",
+        "vitest": "^4.1.9",
         "webpack": "^5.98.0",
         "webpack-cli": "^6.0.1"
     }

package/types/Api.d.ts

@@ -14,6 +14,7 @@ import type { EntityData, EntityTypes } from "./types/entities.js";
 export default class Api {
     private _loggedUser;
     private _client;
+    private _endpointApi?;
     /**
      * Authentifie l'utilisateur et retourne une instance d'Api.
      */

package/types/ApiClient.d.ts

@@ -77,6 +77,8 @@ export default class ApiClient extends EventEmitter {
     private readonly _baseURL;
     private readonly _refreshUrl;
     private readonly _endpoints;
+    /** Index constant -> endpoint, construit une fois (évite un .find() O(n) sur ~141 endpoints par appel). */
+    private readonly _endpointsByConstant;
     private readonly _debug;
     private readonly _fromJSONValue;
     private readonly _tokenStorage;
@@ -120,11 +122,18 @@ export default class ApiClient extends EventEmitter {
      * Extrait l'identifiant depuis un JWT.
      */
     private _getIdFromToken;
+    /** Promesse de refresh en cours, partagée par toutes les requêtes 401 concurrentes (single-flight). */
+    private _refreshPromise;
     /**
      * Méthode simplifiée de refresh (en JSON).
-     * Emet un event refreshSuccess si ça marche
+     * Single-flight : un seul appel réseau /refresh à la fois. Les 401 concurrents
+     * attendent la même promesse au lieu de déclencher N refresh en parallèle — ce qui,
+     * avec un refresh token à usage unique/rotatif, faisait échouer toutes les rafales
+     * sauf la première et détruisait la session via resetSession().
+     * Emet un event refreshSuccess si ça marche.
      */
     private _refreshAccessToken;
+    private _performTokenRefresh;
     /**
      * checkCircuitBreaker : vérifie si on peut appeler l'API ou non
      * si le breaker est "open", on regarde si on peut "reset"

package/types/api/Answer.d.ts

@@ -277,13 +277,16 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
     /**
      * {@inheritDoc BaseEntity#deleteFile}
      *
-     * Override avec **cleanup local** : après suppression backend, retire le
-     * `docId` des structures uploader normalisées dans `serverData.answers` et
-     * `_draftData.answers` (format `{updateDate, files: {docId: docPath}}`
-     * produit par `processUploads()` et `_transformServerData`).
+     * Override Answer : appelle l'endpoint coform **answer-authorisé**
+     * `DELETE_COFORM_ANSWER_FILE` (`{formId, answerId, docId}`) plutôt que le
+     * `DELETE_DOCUMENT_BY_ID` générique (qui opère par docId nu, sans contexte
+     * d'autorisation). Le backend vérifie ainsi le droit d'éditer CETTE réponse
+     * (propriétaire OU `canAdminAnswer`) — même périmètre d'auth que l'upload,
+     * sans dépendre du `canEdit` générique du document.
      *
-     * Le caller n'a pas besoin de refetch — `answer.serverData.answers[*][*].files`
-     * reflète directement l'état post-suppression.
+     * Après succès : **cleanup local** — retire le `docId` des structures uploader
+     * normalisées `{updateDate, files: {docId: docPath}}` dans `serverData.answers`
+     * et `_draftData.answers`. Le caller n'a pas besoin de refetch.
      *
      * @example
      * const files = await answer.getFiles({ subKey: "sf.input", docType: "image" });
@@ -291,6 +294,20 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
      * // answer.serverData.answers[sf][input].files[files[0].docId] === undefined
      */
     deleteFile(docId: string): Promise<void>;
+    /**
+     * Supprime PLUSIEURS fichiers uploader en une seule opération, par batches
+     * parallèles (défaut 4 simultanés) — MIROIR exact du batching d'upload de
+     * `processUploads` (réutilise `_uploadInBatches`). Chaque suppression passe
+     * par `deleteFile` (endpoint answer-authorisé + cleanup local).
+     *
+     * Best-effort : une suppression échouée (ex. fichier déjà supprimé côté
+     * serveur) est loguée mais n'interrompt PAS les autres. Conçue pour la
+     * réconciliation au save (fichiers retirés du formulaire) : le caller fait
+     * **un seul appel** au lieu d'une boucle de requêtes.
+     *
+     * @param docIds - liste des docId à supprimer (vide → no-op).
+     */
+    deleteFiles(docIds: readonly string[]): Promise<void>;
     /**
      * Walk `answers[subFormId][inputId]` et retire `docId` des structures
      * `{updateDate, files: {docId: docPath}}` (format canonique uploader).
@@ -355,13 +372,14 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
      * chaque step.
      *
      * Constant : `GET_COFORM_MULTIEVAL_DATA` (POST
-     * `/survey/coform/getmultievaldata`, auth bearer). Auth côté serveur :
-     * owner OU canAdminAnswer.
+     * `/survey/coform/getmultievaldata`, auth none — radar lisible déconnecté).
+     * Lecture publique du radar agrégé ; l'identité des contributeurs est
+     * renvoyée telle quelle (anonymisation pour visiteurs anonymes à ajouter
+     * si besoin).
      *
      * @param opts.stepKey - Optionnel : filtrer aux datasets d'une seule
      *                       step. Sinon retourne toutes les steps.
      * @throws {ApiError} 400 si Answer sans id.
-     * @throws {ApiAuthenticationError} si non connecté.
      *
      * @example
      * const data = await answer.getMultiEvalData();

package/types/api/BaseEntity.d.ts

@@ -434,6 +434,8 @@ export declare class BaseEntity<TServerData = any> {
      * @returns {boolean}
      */
     hasChanges(): boolean;
+    /** Chaîne EJSON canonique d'un objet nettoyé, pour comparaison d'égalité (cf. hasChanges). */
+    private _ejsonForCompare;
     /**
      * Rafraîchit l'entité en rechargeant ses données depuis le serveur.
      * @returns Données mises à jour
@@ -1729,6 +1731,81 @@ export declare class BaseEntity<TServerData = any> {
         isAdmin?: "" | "admin";
         roles?: string[];
     }>): Promise<unknown>;
+    /**
+     * Contexte costum de CETTE entité (résolu de son `source.key`) — requis par l'import/export admin.
+     * @throws {ApiError} si l'entité n'est pas rattachée à un costum.
+     * @private
+     */
+    private _requireCostumCtx;
+    /**
+     * PRÉVISUALISE un import (GEOCODAGE / Import::Geocodage) : géocode + valide chaque ligne SANS rien
+     * insérer. À appeler AVANT `importElements` pour montrer à l'utilisateur les adresses résolues et les
+     * erreurs/warnings, puis confirmer. `data` est JSON-encodé en interne ; la réponse (map par rowIndex)
+     * est normalisée en tableau ordonné. (Le géocodage ne dépend pas du type d'élément.)
+     *
+     * @param rows - Lignes à prévisualiser (objets plats `{ name, address?, … }`).
+     * @returns `{ rows: [{ rowIndex, success, data?, warnings?, msgErrorAddress? }] }`.
+     */
+    previewImport(rows: Array<Record<string, unknown>>): Promise<{
+        rows: Array<{
+            rowIndex: string;
+            success: boolean;
+            data?: Record<string, unknown>;
+            warnings?: string[];
+            msgErrorAddress?: string;
+        }>;
+    }>;
+    /**
+     * Importe en masse des éléments SOUS le costum de cette entité (IMPORT_ELEMENTS / importData).
+     * Méthode de haut niveau à PRÉFÉRER à `endpointApi.importElements`. `costumSlug/costumId/costumType`
+     * sont dérivés du `_costumCtx` (source.key) — pas de paramètre costum à fournir. Les lignes sont
+     * découpées en lots (`chunkSize`) pour la progression ; `data` est JSON-encodé en interne. Le backend
+     * (re)vérifie + déduplique (update si le nom existe déjà) + insère + relie au costum.
+     *
+     * @param type - Collection cible (poi/organizations/projects/events/citoyens).
+     * @param rows - Lignes à importer (objets plats `{ name, …champs }`).
+     * @param opts.chunkSize - Taille de lot (def. 50). @param opts.onProgress - `(current,total)` par lot.
+     * @returns `{ result, elements (par rowIndex), attributesWithTypes, progress, summary:{created,updated,errors} }`.
+     */
+    importElements(type: "poi" | "organizations" | "projects" | "events" | "citoyens", rows: Array<Record<string, unknown>>, opts?: {
+        chunkSize?: number;
+        onProgress?: (current: number, total: number) => void;
+    }): Promise<{
+        result: boolean;
+        elements: Record<string, unknown>;
+        attributesWithTypes: Record<string, unknown>;
+        progress: {
+            current: number;
+            total: number;
+        };
+        summary: {
+            created: number;
+            updated: number;
+            errors: number;
+        };
+    }>;
+    /** Agrège la réponse d'import en `{créés, mis à jour, erreurs}` pour l'UI. @private */
+    private _summarizeImport;
+    /**
+     * Exporte les éléments du costum de cette entité (EXPORT_ELEMENTS / getCsvAdmin). Méthode haut niveau.
+     * Scope automatiquement sur `source.key` = costum de l'entité (`_costumCtx.slug`). RÉSERVÉ aux
+     * super-admins côté backend (gater l'UI via `me.isSuperAdmin()`). Renvoie `{ results, fields }` ;
+     * utiliser le helper `toCsv(results, fields)` pour produire le CSV téléchargeable.
+     *
+     * @param params.searchType - Types/collections à exporter (+ name/filters/fields/labels/multicolumn optionnels).
+     * @returns `{ results, fields }`.
+     */
+    exportElements(params: {
+        searchType: string[];
+        name?: string;
+        filters?: Record<string, unknown>;
+        fields?: string[];
+        labels?: Record<string, unknown>;
+        multicolumn?: boolean;
+    }): Promise<{
+        results: unknown[];
+        fields: unknown;
+    }>;
     /** UUID v4 compatible browser + Node (`crypto.randomUUID()` si dispo, sinon fallback). @private */
     private _uuidV4;
     /**

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.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, SearchEventsCostumData, ShareEventsData, InviteMembersData, 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, 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 } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1046,6 +1046,16 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     coformUploadAnswerFile(data: CoformUploadAnswerFileData): Promise<any>;
+    /**
+     * Supprimer un fichier d'une réponse CoForm : Supprime un document (image/fichier) attaché à une réponse CoForm, identifié par son docId, après contrôle d'accès answer-side (owner ou Coform::canAdminAnswer). Pendant suppression de COFORM_UPLOAD_ANSWER_FILE.
+     * Constant : DELETE_COFORM_ANSWER_FILE
+     * @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.
+     */
+    deleteCoformAnswerFile(data: DeleteCoformAnswerFileData): Promise<any>;
     /**
      * Récupérer les fichiers d'une réponse CoForm : Récupère la liste des fichiers uploadés pour un input spécifique dans une réponse CoForm. Utilisé pour récupérer les fichiers de l'ancien système qui n'ont que 'updateDate' sans la clé 'files'.
      * Constant : COFORM_GET_ANSWER_FILES
@@ -1086,12 +1096,11 @@ export declare class EndpointApi {
      */
     getCoformAnswerHistory(data: GetCoformAnswerHistoryData): Promise<any>;
     /**
-     * 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.
+     * 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}'. Lecture publique du radar agrégé (visible déconnecté) ; l'identité des contributeurs (userId/userName/userSlug) est renvoyée telle quelle — anonymisation pour visiteurs anonymes à ajouter si besoin.
      * 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.
      */
     getCoformMultievalData(data: GetCoformMultievalDataData): Promise<any>;
@@ -1394,5 +1403,44 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     personActivate(data: PersonActivateData): Promise<any>;
+    /**
+     * Prévisualiser un import (table de contrôle) : Construit la table d'affichage [name, address, warnings, msgError] d'une liste d'éléments déjà vérifiés (Import::createArrayList), pour prévisualiser un import avant insertion.
+     * Constant : IMPORT_PREVIEW
+     * @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.
+     */
+    importPreview(data: ImportPreviewData): Promise<any>;
+    /**
+     * Exporter des éléments (CSV admin) : Recherche admin et renvoie {results, fields} prêt pour un parser CSV (Csv::getCsvAdmin). Réservé aux super-admins (sinon {results:[],fields:[]}). Les events sont reshapés forme-carte (getSimpleEventById).
+     * Constant : EXPORT_ELEMENTS
+     * @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.
+     */
+    exportElements(data: ExportElementsData): Promise<any>;
+    /**
+     * Importer des éléments en masse : Import en masse d'éléments (Import::importData) : typage microformat, déduplication par nom, save + lien au costum. `data` = JSON encodé d'un tableau de lignes.
+     * Constant : IMPORT_ELEMENTS
+     * @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.
+     */
+    importElements(data: ImportElementsData): Promise<any>;
+    /**
+     * Géocoder/valider des lignes d'import (preview) : Géocode + valide chaque ligne SANS insérer (Import::Geocodage) : résout l'adresse par code postal (cities), renvoie success/data/msgErrorAddress par ligne. Étape de prévisualisation avant import. `data` = JSON encodé d'un tableau de lignes.
+     * Constant : GEOCODAGE
+     * @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.
+     */
+    geocodage(data: GeocodageData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -3428,7 +3428,7 @@ export interface LinkValidateData {
     /**
      * Type de validation
      */
-    linkOption?: "isInviting" | "toBeValidated" | "isAdminPending";
+    linkOption?: "isInviting" | "isAdminInviting" | "toBeValidated" | "isAdminPending";
     [k: string]: unknown;
 }
 export interface SearchMemberAutocompleteData {
@@ -5119,6 +5119,21 @@ export interface CoformUploadAnswerFileData {
     };
     [k: string]: unknown;
 }
+export interface DeleteCoformAnswerFileData {
+    /**
+     * ID du formulaire parent (contrôle d'accès).
+     */
+    formId: string;
+    /**
+     * ID de la réponse propriétaire du fichier.
+     */
+    answerId: string;
+    /**
+     * ID MongoDB du document à supprimer.
+     */
+    docId: string;
+    [k: string]: unknown;
+}
 export interface CoformGetAnswerFilesData {
     /**
      * ID de la réponse CoForm
@@ -5964,3 +5979,99 @@ export interface PersonActivateData {
     validationKey: string;
     [k: string]: unknown;
 }
+export interface ImportPreviewData {
+    /**
+     * Liste d'éléments vérifiés à prévisualiser.
+     */
+    list: {
+        name?: string;
+        address?: {
+            streetAddress?: string;
+            postalCode?: string;
+            addressLocality?: string;
+            addressCountry?: string;
+            [k: string]: unknown;
+        };
+        warnings?: string[];
+        msgError?: string;
+        [k: string]: unknown;
+    }[];
+    [k: string]: unknown;
+}
+export interface ExportElementsData {
+    /**
+     * Types/collections à exporter (events, organizations, projects, poi, citoyens, NGO…).
+     *
+     * @minItems 1
+     */
+    searchType: [string, ...string[]];
+    /**
+     * Terme de recherche optionnel.
+     */
+    name?: string;
+    /**
+     * Ordre/sélection des colonnes.
+     */
+    fields?: string[];
+    /**
+     * Libellés de colonnes {indexFieldString: label}.
+     */
+    labels?: {
+        [k: string]: unknown;
+    };
+    /**
+     * Si défini (≠ faux PHP), colonnes de 1er niveau seulement.
+     */
+    multicolumn?: {
+        [k: string]: unknown;
+    };
+    /**
+     * Colonnes de contributeurs par rôle.
+     */
+    roles?: string[];
+    /**
+     * Filtres de recherche.
+     */
+    filters?: {
+        [k: string]: unknown;
+    };
+    /**
+     * Restreint l'export à ces source.key (scope costum). Posé automatiquement par BaseEntity.exportElements.
+     */
+    sourceKey?: string[];
+    [k: string]: unknown;
+}
+export interface ImportElementsData {
+    /**
+     * Tableau de lignes encodé en JSON (chaque ligne : {name, ...champs, rowIndex?}).
+     */
+    data: string;
+    /**
+     * Collection cible.
+     */
+    typeElement: "poi" | "organizations" | "projects" | "events" | "citoyens";
+    /**
+     * Id de l'élément costum parent (rattachement/lien).
+     */
+    costumId?: string;
+    /**
+     * Type de l'élément costum parent.
+     */
+    costumType?: string;
+    /**
+     * Slug costum -> source.key.
+     */
+    costumSlug?: string;
+    /**
+     * Taille totale (progression).
+     */
+    totalSize?: string;
+    [k: string]: unknown;
+}
+export interface GeocodageData {
+    /**
+     * Tableau de lignes encodé en JSON ({name, address?, hotRowIndex?, latitude?, longitude?}).
+     */
+    data: string;
+    [k: string]: unknown;
+}

package/types/api/User.d.ts

@@ -59,6 +59,26 @@ export declare class User extends BaseEntity<UserItemNormalized> {
     get isActingUser(): boolean;
     /** @returns {"citoyens"} */
     getEntityType(): "citoyens";
+    /**
+     * Rôles de l'utilisateur (depuis `serverData.roles`, présent sur `me` après authenticate/meInfo —
+     * `ME_PROJECTION` garde `roles` et exclut `pwd`/tokens). Vide si non chargé ou profil public.
+     */
+    get roles(): Record<string, unknown>;
+    /**
+     * Super-admin global STRICT (`roles.superAdmin === true`) — équivalent legacy `Role::isUserSuperAdmin`,
+     * et c'est le gate RÉEL de l'export admin (`exportElements`). N'inclut PAS `adminPlatform`.
+     */
+    isSuperAdmin(): boolean;
+    /**
+     * Admin de plateforme (`roles.adminPlatform === true`). NB : rôle hors-legacy (absent du PHP) mais
+     * HONORÉ par le backend comme super-admin (cf. isUserSuperAdmin/deleteElement) ; posé en base, pas par le code.
+     */
+    isAdminPlatform(): boolean;
+    /**
+     * Accès admin plateforme large : `superAdmin || adminPlatform` (= `isUserSuperAdmin` backend général,
+     * celui de la suppression). Pour gater l'UI ; l'export reste sur `isSuperAdmin()` strict.
+     */
+    canPlatformAdmin(): boolean;
     /**
        * Récupère le profil complet de l'utilisateur.
        * Si l'utilisateur est connecté, on appelle le endpoint ME_INFO_URL,

package/types/costum/types.d.ts

@@ -216,7 +216,6 @@ export interface CostumFieldMap {
             place?: string;
         };
         organizations: {
-            extraActivity?: string[];
             formLocality?: string;
             location?: string;
             similarLink?: string;
@@ -497,7 +496,6 @@ export interface CostumFieldMap {
     lakou: {
         organizations: {
             buildingSurfaceArea?: number;
-            extraActivity?: string[];
             extraManageModel?: string;
             extraTypePlace?: string;
             formLocality?: string;