@communecter/cocolight-api-client 1.0.169 → 1.0.171

package/package.json

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

package/types/ApiClient.d.ts

@@ -36,6 +36,12 @@ export interface ApiClientOptions {
      */
     mode?: "legacy" | "clean";
     tokenStorageStrategy?: TokenStorageStrategy | null;
+    /**
+     * Ignore les schémas costum BUNDLÉS et ne résout que par `getcostumjson` (cf. `setCostumForceLive`).
+     * À activer quand la config costum évolue en base plus vite que les artefacts publiés — sans quoi
+     * un artefact périmé masque indéfiniment les champs réels. Contrepartie : plus de démarrage à froid.
+     */
+    costumForceLive?: boolean;
 }
 /**
  * Structure des données pour les appels d'endpoint
@@ -96,7 +102,7 @@ export default class ApiClient extends EventEmitter {
     private _refreshToken;
     private _setUserId;
     private _mode;
-    constructor({ baseURL, accessToken, refreshToken, refreshUrl, endpoints, timeout, debug, maxRetries, circuitBreakerThreshold, circuitBreakerResetTime, fromJSONValue, mode, tokenStorageStrategy }: ApiClientOptions);
+    constructor({ baseURL, accessToken, refreshToken, refreshUrl, endpoints, timeout, debug, maxRetries, circuitBreakerThreshold, circuitBreakerResetTime, fromJSONValue, mode, tokenStorageStrategy, costumForceLive }: ApiClientOptions);
     /**
      * Sets the access token for the API client and updates the authorization header.
      */

package/types/api/BaseEntity.d.ts

@@ -1,8 +1,8 @@
-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, SearchEventsCostumData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, FundingEnvelopeData, CoremuOperationData, UpdatePathValueData } from "./EndpointApi.types.js";
+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, SearchEventsCostumData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, ZoneGetShapeData, ZoneGetZonirisData, 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";
+import type { ZoneItemNormalized, ZoneShapeItem, ZonirisShapeItem } from "./serverDataType/Zone.js";
 /**
  * Types pour les méthodes d'entité (organization, project, poi, event, badge, news)
  * Permettent soit de récupérer une entité existante (GET), soit de créer une nouvelle instance (CREATE)
@@ -2577,6 +2577,56 @@ export declare class BaseEntity<TServerData = any> {
      * @throws {ApiError} Si `countryCode` ou `level` sont absents
      */
     searchZone(data: SearchZonesData): Promise<ZoneItemNormalized[]>;
+    /**
+     * Récupère les **contours géographiques** (`geoShape`) des zones ou des communes.
+     *
+     * Complémentaire de {@link searchZone} : `searchZone` (`/co2/search/getzone`) projette
+     * `geoShape` DEHORS, cet endpoint-ci est le seul, avec {@link getZoniris}, à le renvoyer.
+     *
+     * Trois branches côté serveur, pilotées par `level` :
+     *  - `level` **numérique** (`"1"`…`"6"`) → collection `zones`, filtre `{countryCode, level}` ;
+     *  - `level: "QPV"` → collection `zones`, filtre `{type:"QPV"}` (le `countryCode` est ignoré) ;
+     *  - `level: "cities"` → collection `cities`, via le tableau `cities` de l'EPCI si
+     *    `parentLevel: "5"`, sinon `{country, level4?}`.
+     *
+     * ⚠️ **Volumétrie** : sans `parentId`/`parentLevel`, `countryCode:"FR", level:"cities"` renvoie
+     * ~65 Mo et `level:"QPV"` ~9,4 Mo. Toujours borner par un parent.
+     *
+     * ⚠️ `parentId` n'est pris en compte que si `parentLevel` est fourni **et non vide au sens de
+     * PHP** : `parentLevel: "0"` désactive le filtre parent.
+     *
+     * @param data - Filtres. `countryCode` et `level` sont obligatoires.
+     * @returns Les documents complets, aplatis en tableau (`{ id, …doc }`) par le normaliseur du
+     *          client ; `[]` si aucun résultat ; `null` si `level` ne résout aucune branche.
+     * @throws {ApiError} Si `countryCode` ou `level` sont absents.
+     *
+     * @example
+     * const epcis = await organization.getZoneShape({ countryCode: "RE", level: "5" });
+     * epcis?.[0].geoShape; // { type: "Polygon", coordinates: [...] }
+     */
+    getZoneShape(data: ZoneGetShapeData): Promise<ZoneShapeItem[] | null>;
+    /**
+     * Récupère les **contours géographiques thématiques** de la collection `zoniris`
+     * (IRIS, grands quartiers, bassins de vie), `geoShape` inclus.
+     *
+     * Le serveur exige **au moins un filtre identifiant** parmi `cityId`, `insee`, `countryCode`,
+     * `spec`, `shapeType`, `name` — la collection compte plus de 49 000 documents et n'est jamais
+     * renvoyée en entier. `level` **ne compte pas** comme filtre identifiant : il ne fait
+     * qu'affiner (`level:"6"` seul sélectionnerait les 49 400 IRIS). La précondition est vérifiée
+     * ici, avant l'appel réseau ; côté serveur elle se traduirait par `{result:false}`, donc par
+     * une `ApiResponseError("missing parameters")`.
+     *
+     * `name` est une recherche insensible à la casse **et aux accents** (regex non ancrée).
+     *
+     * @param data - Filtres (au moins un identifiant).
+     * @returns Les documents complets, aplatis en tableau (`{ id, …doc }`) ; `[]` si aucun résultat.
+     * @throws {ApiError} Si aucun filtre identifiant n'est fourni.
+     *
+     * @example
+     * const bassins = await organization.getZoniris({ cityId: "54c0965cf6b95c141800a518" });
+     * bassins.length; // 7 bassins de vie de Saint-Paul (La Réunion)
+     */
+    getZoniris(data?: ZoneGetZonirisData): Promise<ZonirisShapeItem[]>;
     /**
      * Récupère la liste de tous les pays (endpoint public, sans authentification).
      *

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, GlobalAutocompleteAdminCostumData, 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, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData } 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, GlobalAutocompleteAdminCostumData, 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, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1512,5 +1512,23 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     uploadDocument(data: UploadDocumentData): Promise<any>;
+    /**
+     * Recuperer les contours geographiques (geoShape) des zones ou des communes : Recupere les documents COMPLETS (geoShape inclus) de la collection `zones` ou `cities` selon `level`. Trois branches (modules/citizenToolKit/controllers/zone/GetZoneShapeAction.php:11-59, mappee sur 'getshape' dans modules/co2/controllers/ZoneController.php:44) : (1) `level` numerique -> zones {countryCode, level} ; (2) `level="QPV"` -> zones {type:'QPV'} (le filtre countryCode est ECRASE) ; (3) `level="cities"` -> cities, via le tableau `cities` de l'EPCI si `parentLevel=5`, sinon {country, level4?}. Endpoint PUBLIC (aucune auth). Reponses potentiellement TRES volumineuses : `countryCode=FR&level=cities` sans parent renvoie ~65 Mo. Toujours borner avec `parentId`/`parentLevel`.
+     * Constant : ZONE_GET_SHAPE
+     * @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.
+     */
+    zoneGetShape(data: ZoneGetShapeData): Promise<any>;
+    /**
+     * Recuperer les contours geographiques thematiques (zoniris) : Lecture FILTREE de la collection `zoniris` (IRIS, grands quartiers, bassins de vie) : documents COMPLETS, `geoShape` inclus, sous forme de map keyee par _id. modules/citizenToolKit/controllers/zone/GetZonirisAction.php, mappee sur 'getzoniris' dans modules/co2/controllers/ZoneController.php. Endpoint PUBLIC (aucune auth). AU MOINS UN filtre IDENTIFIANT est requis cote serveur (cityId, insee, countryCode, spec, shapeType ou name) : la collection compte plus de 49 000 documents (~21 Mo) et n'est jamais renvoyee en entier. `level` NE COMPTE PAS comme filtre identifiant, il ne fait qu'affiner (level='6' seul selectionnerait les 49 400 IRIS). Sans filtre identifiant : {result:false, msg:'missing parameters'}.
+     * Constant : ZONE_GET_ZONIRIS
+     * @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.
+     */
+    zoneGetZoniris(data: ZoneGetZonirisData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -3113,6 +3113,12 @@ export interface AddProjectData {
      * Site web
      */
     url?: string | "";
+    /**
+     * Réseaux sociaux — objet keyé par plateforme (facebook/twitter/instagram/mastodon/telegram/…). dataBinding projet legacy `socialNetwork` (Project.php). La clé OBJET ENTIER manquait à Project là où Organization la déclare (Organization.php:82) : un client qui l'envoyait la voyait retirée à l'extraction, donc perdue en silence. Les réseaux un par un (`facebook`…) restent portés par UPDATE_BLOCK_SOCIAL.
+     */
+    socialNetwork?: {
+        [k: string]: string;
+    };
     preferences?: {
         /**
          * Open data (true/false)
@@ -6450,3 +6456,119 @@ export interface UploadDocumentData {
     };
     [k: string]: unknown;
 }
+/**
+ * Filtres lus dans $_POST par GetZoneShapeAction. Schema FERME (`additionalProperties:false`) : le legacy injecte les valeurs telles quelles dans le filtre Mongo, un `parentId[$ne]=` y passe donc un operateur NoSQL (exploit verifie live). Typer tous les filtres en `string` interdit structurellement au client d'emettre cette forme.
+ */
+export interface ZoneGetShapeData {
+    /**
+     * Code pays ISO (ex 'FR', 'RE'). Filtre `zones.countryCode` sur les branches numeriques, `cities.country` sur la branche `cities` (les deux collections ne nomment PAS le pays pareil, GetZoneShapeAction.php:15 vs :39). IGNORE sur la branche QPV, ou le filtre est ecrase par {type:'QPV'} (:19-21).
+     */
+    countryCode: string;
+    /**
+     * SCALAIRE (contrairement a SEARCH_ZONES ou c'est un tableau). Trois formes : (a) niveau administratif numerique '1'..'6' -> collection `zones` ; (b) 'QPV' -> zones {type:'QPV'} ; (c) 'cities' -> collection `cities`. Toute autre valeur ne resout aucune branche : le legacy renvoie alors le corps litteral `null` (HTTP 200). Le test PHP est `is_numeric()`, plus large que /^[0-9]+$/ (' 4' passe, '4 ' non).
+     */
+    level: string;
+    /**
+     * ID (24 hex) du parent servant a borner la requete. N'est pris en compte QUE si `parentLevel` est fourni ET non vide au sens de PHP — attention, `parentLevel="0"` est vide pour `!empty()`, le filtre parent est alors DESACTIVE. Selon la branche : {level<parentLevel>: parentId} sur les zones (nom de champ construit dynamiquement, :27), {level5: parentId} sur les QPV (nom EN DUR, :23 — et level5 pointe alors une COMMUNE), _id de l'EPCI sur la branche cities+parentLevel=5 (:32), {level4: parentId} sinon (:52).
+     */
+    parentId?: string;
+    /**
+     * Niveau du parent ('1'..'5', ou 'cities'). Sert (a) de garde pour activer `parentId`, (b) de SUFFIXE du nom de champ Mongo sur la branche zones ('level'.parentLevel) : `parentLevel=cities` donne le champ `levelcities`, qui ne matche rien. La valeur '5' (comparaison PHP lache, donc '5.0' aussi) declenche le passage par le tableau `cities` de l'EPCI. ⚠️ Sur la branche `cities`, `parentId` ET `parentLevel` sont OBLIGATOIRES : sans eux la requete n'est pas bornee (36 798 communes avec leurs contours pour la France) et l'action renvoie `[]` sans rien lire — cf. BUG-L-213.
+     */
+    parentLevel?: string;
+    /**
+     * VERSION LEGERE, optionnelle. Toute valeur non vide (au sens de PHP : ni '', ni '0') active une projection sur les seuls champs utiles a une carte — `_id`, `name`, `geoShape`, `level`, `type`, `insee`, `geo`, `geoPosition`. Le DEFAUT reste le document ENTIER, byte-identique au legacy. Gains mesures : QPV 9,4 Mo -> 425 Ko (96 %), communes d'un departement 834 Ko -> 349 Ko (59 %). ATTENTION, le gain depend de OU est le gras : sur les EPCI il n'est que de 4 %, parce que le contour EST la charge utile — `light` retire les metadonnees, pas la geometrie.
+     */
+    light?: string;
+    /**
+     * Slug du costum courant. Injecte automatiquement par `BaseEntity._withCostumContext`. Ignore par les deux actions legacy (elles ne lisent que leurs propres filtres) mais transmis pour homogeneite avec le reste du contrat.
+     */
+    costumSlug?: string;
+    /**
+     * ID du costum courant (ObjectId 24 hex). Alias historique de `contextId`. Injecte par `_withCostumContext`.
+     */
+    costumId?: string;
+    /**
+     * Collection portant le costum. Alias historique de `contextType`. Injecte par `_withCostumContext`.
+     */
+    costumType?: "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds" | "actions";
+    /**
+     * Mode edition du costum (boolean, string ou number).
+     */
+    costumEditMode?: ("true" | "false") | (0 | 1) | boolean;
+    /**
+     * ID de l'entite portant le contexte costum (ObjectId 24 hex). Injecte par `_withCostumContext`.
+     */
+    contextId?: string;
+    /**
+     * Collection de l'entite portant le contexte costum. Injecte par `_withCostumContext`.
+     */
+    contextType?: "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds" | "actions";
+    /**
+     * Cles de source du costum. Injecte par `_withCostumContext` (defaut : [slug du costum courant]). Sans effet sur ces deux actions.
+     */
+    sourceKey?: string[];
+    [k: string]: unknown;
+}
+/**
+ * Filtres lus dans $_POST par GetZonirisAction (methode `postString` :34-38 : les tableaux sont rejetes cote serveur, les chaines vides ignorees). Schema FERME (`additionalProperties:false`) et tous les filtres typables en `string` : la lib ne peut donc pas emettre de notation a crochets. AUCUN champ n'est `required` au sens JSON Schema, mais au moins un filtre identifiant est exige par le serveur (voir description de l'endpoint) — la facade `BaseEntity.getZoniris` verifie cette precondition avant l'appel.
+ */
+export interface ZoneGetZonirisData {
+    /**
+     * FILTRE IDENTIFIANT. _id (24 hex, en STRING) de la commune de rattachement, tel que stocke dans `zoniris.cityId`. Ex '54c0965cf6b95c141800a518' (Saint-Paul, La Reunion) -> 7 bassins de vie.
+     */
+    cityId?: string;
+    /**
+     * FILTRE IDENTIFIANT. Code INSEE de la commune (ex '97415'). Egalite stricte sur la chaine.
+     */
+    insee?: string;
+    /**
+     * FILTRE IDENTIFIANT. Code pays ISO (ex 'RE', 'FR'). Attention : la majorite des documents `zoniris` (les IRIS de niveau 6) n'ont PAS de countryCode et sont donc invisibles a ce filtre.
+     */
+    countryCode?: string;
+    /**
+     * FILTRE IDENTIFIANT. Identifiant du lot d'import (ex 'bassins_vie_saintpaul').
+     */
+    spec?: string;
+    /**
+     * FILTRE IDENTIFIANT. Type de forme (ex 'BassinVie').
+     */
+    shapeType?: string;
+    /**
+     * FILTRE IDENTIFIANT. Recherche INSENSIBLE A LA CASSE ET AUX ACCENTS sur le nom : le serveur construit une MongoRegex via SearchNew::accentToRegex (avec preg_quote), donc une sous-chaine non ancree — 'saint' matche 'Saint Paul centre'.
+     */
+    name?: string;
+    /**
+     * AFFINE UNIQUEMENT, ne se suffit pas a lui-meme (une requete portant seulement `level` renvoie {result:false}). Compare a `zoniris.level`, qui est un TABLEAU DE CHAINES : '6' pour les IRIS, '8' pour les bassins de vie.
+     */
+    level?: string;
+    /**
+     * Slug du costum courant. Injecte automatiquement par `BaseEntity._withCostumContext`. Ignore par les deux actions legacy (elles ne lisent que leurs propres filtres) mais transmis pour homogeneite avec le reste du contrat.
+     */
+    costumSlug?: string;
+    /**
+     * ID du costum courant (ObjectId 24 hex). Alias historique de `contextId`. Injecte par `_withCostumContext`.
+     */
+    costumId?: string;
+    /**
+     * Collection portant le costum. Alias historique de `contextType`. Injecte par `_withCostumContext`.
+     */
+    costumType?: "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds" | "actions";
+    /**
+     * Mode edition du costum (boolean, string ou number).
+     */
+    costumEditMode?: ("true" | "false") | (0 | 1) | boolean;
+    /**
+     * ID de l'entite portant le contexte costum (ObjectId 24 hex). Injecte par `_withCostumContext`.
+     */
+    contextId?: string;
+    /**
+     * Collection de l'entite portant le contexte costum. Injecte par `_withCostumContext`.
+     */
+    contextType?: "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds" | "actions";
+    /**
+     * Cles de source du costum. Injecte par `_withCostumContext` (defaut : [slug du costum courant]). Sans effet sur ces deux actions.
+     */
+    sourceKey?: string[];
+    [k: string]: unknown;
+}

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

@@ -27,4 +27,58 @@ export interface ZoneItemJson {
     translateId: string;
     [key: string]: unknown;
 }
+/**
+ * Élément renvoyé par `ZONE_GET_SHAPE` (`/co2/zone/getshape`).
+ *
+ * Sur le réseau, le legacy renvoie une **map keyée par l'`_id` hexadécimal** de documents
+ * `zones` ou `cities` **complets** (aucune projection). Le normaliseur du client
+ * (`ApiClient._transformData`) reconvertit cette map en tableau et pose la clé d'origine
+ * dans `id` — d'où la présence simultanée de `id` (string) et `_id`.
+ *
+ * Les documents des deux collections sont hétérogènes (zone administrative, EPCI, QPV,
+ * commune) : **toutes** les propriétés sont optionnelles hors `id`. Attention, le champ
+ * pays s'appelle `countryCode` dans `zones` et `country` dans `cities`.
+ */
+export interface ZoneShapeItem {
+    /** `_id` hexadécimal du document — clé de la map réseau, promue en champ par `_transformData`. */
+    id: string;
+    _id?: IdObject | ObjectID;
+    name?: string;
+    /** Niveau(x) administratif(s). Stocké en TABLEAU DE CHAÎNES en base (`["6"]`, `["1","3","4"]`
+     *  pour les DOM), parfois en chaîne nue selon l'import. Ne jamais coercer en nombre. */
+    level?: string[] | string;
+    /** `"QPV"` sur les quartiers prioritaires (c'est le filtre de la branche QPV). */
+    type?: string;
+    /** Champ pays des documents `zones`. */
+    countryCode?: string;
+    /** Champ pays des documents `cities` (les deux collections ne le nomment pas pareil). */
+    country?: string;
+    insee?: string;
+    geo?: GeoCoordinates;
+    geoPosition?: GeoPosition;
+    /**
+     * Contour géographique : **géométrie GeoJSON NUE** (`{type, coordinates}`), pas une Feature.
+     * Volontairement NON TYPÉ (`unknown`) : la donnée réelle mélange `Polygon`, `MultiPolygon`,
+     * `Point`, `LineString`, et des coordonnées tantôt `double` tantôt `string`. Absent de
+     * beaucoup de documents (1 981 zones sur 52 915 en portent un).
+     */
+    geoShape?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Élément renvoyé par `ZONE_GET_ZONIRIS` (`/co2/zone/getzoniris`) : document complet de la
+ * collection `zoniris` (IRIS, grands quartiers, bassins de vie). Même forme réseau que
+ * {@link ZoneShapeItem} (map keyée par `_id`, aplatie en tableau par le client).
+ */
+export interface ZonirisShapeItem extends ZoneShapeItem {
+    /** Identifiant du lot d'import (ex. `"bassins_vie_saintpaul"`). */
+    spec?: string;
+    /** Type de forme (ex. `"BassinVie"`). */
+    shapeType?: string;
+    /** `_id` (en STRING) de la commune de rattachement. */
+    cityId?: string;
+    cityName?: string;
+    codeIris?: string;
+    typeIris?: string;
+}
 export {};

package/types/costum/runtime.d.ts

@@ -1,5 +1,9 @@
 import type { CostumExtensionModule, CostumExtensionField, KnownCostumSlug, Collection } from "./types.js";
 import type { BaseEntity } from "../api/BaseEntity.js";
+/** Active/désactive FORCE-LIVE (cf. `COSTUM_FORCE_LIVE`). */
+export declare function setCostumForceLive(actif: boolean): void;
+/** État courant de FORCE-LIVE. */
+export declare function isCostumForceLive(): boolean;
 /**
  * Invalide le cache costum live — d'UN slug (ex. après avoir modifié ce costum en base), ou de TOUT
  * (`invalidateCostumCache()`). Le prochain accès refetchera `getcostumjson` (C2e). Sans effet sur le bundle.

package/types/costum/types.d.ts

@@ -328,14 +328,14 @@ export interface CostumFieldMap {
     };
     equipementsSportifs974: {
         poi: {
-            aps_name?: string[];
+            aps_name?: string;
             categorie?: string;
             equip_acc_libre?: boolean;
             equip_douche?: boolean;
             equip_eclair?: boolean;
             equip_gest_type?: string;
             equip_larg?: number;
-            equip_loc_type?: string[];
+            equip_loc_type?: string;
             equip_long?: number;
             equip_maj_date?: string;
             equip_nature?: string;
@@ -357,14 +357,14 @@ export interface CostumFieldMap {
             equip_surf?: number;
             equip_type_famille?: string;
             equip_type_name?: string;
-            equip_utilisateur?: string[];
+            equip_utilisateur?: string;
             inst_acc_handi_bool?: boolean;
             inst_acc_handi_type?: string;
             inst_date_creation?: string;
             inst_enqu_date?: string;
             inst_nom?: string;
             inst_part_bool?: boolean;
-            inst_part_type?: string[];
+            inst_part_type?: string;
             inst_trans_bool?: boolean;
             inst_trans_type?: string;
         };
@@ -933,14 +933,13 @@ export interface CostumFieldMap {
             personInChargeName?: string;
             personInChargeTelephone?: number;
             personInChargeTitle?: "Président" | "Maire.sse" | "Chef.fe d'entreprise" | "Chef.fe d'établissement" | "Autre...";
-            recepisseDeclaration?: string;
             representativeCivility?: string;
             representativeEmail?: string;
             representativeFirstName?: string;
             representativeName?: string;
             representativeTelephone?: number;
             representativeTitle?: "Président" | "Maire.sse" | "Chef.fe d'entreprise" | "Chef.fe d'établissement" | "Autre...";
-            responsableCivilePro?: string;
+            responsableCivilePro?: Record<string, unknown>;
             responsableSameAsRepresent?: boolean;
             sextionInfo?: Record<string, unknown>;
             sextionInfoRepresentant?: Record<string, unknown>;