@communecter/cocolight-api-client 1.0.172 → 1.0.179

package/package.json

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

package/types/api/BaseEntity.d.ts

@@ -1999,12 +1999,20 @@ export declare class BaseEntity<TServerData = any> {
         result: boolean;
         msg?: string;
     }>;
-    /** Retire l'élément (type,id) de `reference.costum` du costum de cette entité + nettoie les liens. */
+    /**
+     * Retire l'élément (type,id) de `reference.costum` du costum de cette entité.
+     * ⚠ PAS de `costumId`/`costumType` : aucun caller legacy n'envoie ces clés (institutBleu/meir/
+     * essConnect admin.js postent `{id, type, origin, sourceKey}`), et leur présence déclenche la
+     * branche « Clean links » de `Admin::removeSourceFromElement` — fatale (500) pour les types
+     * absents de `Link::$linksTypes[parent]` (poi…), et destructrice pour les autres (elle
+     * déconnecterait de VRAIS liens membres entre le porteur et l'élément dé-référencé).
+     */
     removeReference(type: string, id: string): Promise<{
         result: boolean;
         msg?: string;
     }>;
-    /** Détache l'élément (type,id) de `source.keys` du costum de cette entité (dé-rattachement) + nettoie les liens. */
+    /** Détache l'élément (type,id) de `source.keys` du costum de cette entité (dé-rattachement). Même
+     *  parité de payload que `removeReference` : jamais `costumId`/`costumType`. */
     removeFromSource(type: string, id: string): Promise<{
         result: boolean;
         msg?: string;
@@ -2289,6 +2297,43 @@ export declare class BaseEntity<TServerData = any> {
     }): {
         next: () => Promise<PaginatorPage<TOut>>;
     };
+    /**
+     * PÉRIMÈTRE d'une lecture de RELATION (« mes organisations », « les événements de cette orga »…).
+     *
+     * Ces lectures étaient réseau-wide par construction : le contrat imposait `notSourceKey: true`
+     * (`const` + `default`), le client ne pouvait donc rien demander d'autre. Le contrat a été ouvert ;
+     * ce helper porte désormais la règle, pour les neuf méthodes concernées.
+     *
+     * TROIS CAS, et un seul est neuf :
+     *  • l'appelant a tranché lui-même (`notSourceKey` présent dans ses données) → on ne touche à rien ;
+     *  • il demande un périmètre costum (`sourceKey` non vide) → la clé reste ABSENTE du corps ;
+     *  • il ne demande rien → on repose `notSourceKey: true`, le défaut historique, à l'octet près.
+     *
+     * POURQUOI L'ABSENCE, et pas `notSourceKey: false`. La garde serveur est un `empty()`
+     * (`SearchNew.php:999-1002`, et son portage `shared/search.ts:389-391`) :
+     * `if (!empty(sourceKey) && empty(notSourceKey)) buildSourceKey(...)`. Or ces endpoints sont en
+     * `x-www-form-urlencoded` : un `false` part sur le fil en chaîne `"false"`, et `empty("false")` vaut
+     * FAUX. Envoyer `false` désactiverait donc le périmètre exactement comme `true` — la clé est active
+     * dès qu'elle est PRÉSENTE. C'est aussi pourquoi le `default` a dû quitter le contrat : l'AJV du
+     * client tourne en `useDefaults` et l'aurait réinjectée après le finalizer.
+     */
+    protected _applyRelationScope<T extends Record<string, unknown>>(finalData: T): T;
+    /**
+     * Fusionne la clause de RELATION (appartenance, contribution, parenté…) avec les `filters` de
+     * l'appelant, au lieu de l'écraser — et ne pose RIEN quand l'appelant n'envoie pas de `filters`, pour
+     * que le défaut du contrat (résolu par AJV) reste la source et que le corps émis ne bouge pas.
+     *
+     * L'écrasement était la règle jusqu'ici (`getProjects`, `getEvents`, branches non-`isMe`), et il rend
+     * le périmètre costum inutilisable : le `filters` métier de l'appelant emportait la clause. Le miroir
+     * inverse existait aussi — `User.getOrganizations` en `isMe` laissait le `filters` de l'appelant
+     * REMPLACER le défaut d'appartenance, et la liste devenait « toutes les entités » au lieu de
+     * « les miennes ». `getEligiblePlaces` était seul à fusionner ; c'est ce comportement qu'on généralise.
+     */
+    protected _mergeRelationFilters<T extends {
+        filters?: unknown;
+    }>(finalData: T, clause: Record<string, unknown>, options?: {
+        always?: boolean;
+    }): T;
     /**
      * Injection de contexte Communecter dans une requête finalizer.
      */

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, ZoneGetShapeData, ZoneGetZonirisData } 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, CostumListValuesData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1530,5 +1530,14 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     zoneGetZoniris(data: ZoneGetZonirisData): Promise<any>;
+    /**
+     * Valeurs d'une liste de costum : Résout UNE liste DYNAMIQUE déclarée d'un costum (costum.lists.<nom>) et renvoie ses VALEURS. Ne sert QUE les dynamiques — {collection,distinct,where} ou {type:badges,category} — car elles seules manquent au client : Costum::getAndConvertLists n'est appelée qu'au rendu des pages PHP et son résultat part dans le costum mis en cache, tandis que getcostumjson livre la déclaration BRUTE. Une liste STATIQUE (tableau, ou map valeur→libellé) porte au contraire ses valeurs dans sa déclaration : elle voyage déjà dans le costum que le client a en mémoire, la demander ici serait un aller-retour pour rien — elle est donc REFUSÉE, avec un message qui dit où la lire. La résolution est faite à la demande, hors cache : les valeurs sont FRAÎCHES, donc une valeur saisie librement apparaît aux suivants. Le client ne choisit ni la collection ni le champ — il demande une liste par son NOM, et c'est la déclaration en base qui porte collection/champ/filtre : la surface exposée est exactement celle que le costum a publiée. Une liste d'ENTITÉS ({collection,where,fields}) est refusée, ses clés étant des ObjectId et non des valeurs.
+     * Constant : COSTUM_LIST_VALUES
+     * @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.
+     */
+    costumListValues(data: CostumListValuesData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -298,21 +298,37 @@ export interface UpdateBlockLocalityData {
         level1: string;
         level1Name: string;
         /**
-         * ID du département. Peut être vide pour les pays étrangers.
+         * ID du niveau administratif intermédiaire propre à certains pays (ex. Wallonie en Belgique, province malgache). Absent pour la France.
+         */
+        level2?: string;
+        /**
+         * Nom du niveau intermédiaire. Absent pour la France.
+         */
+        level2Name?: string;
+        /**
+         * ID de la région. Peut être vide pour les pays étrangers.
          */
         level3?: string;
         /**
-         * Nom du département. Peut être vide pour les pays étrangers.
+         * Nom de la région. Peut être vide pour les pays étrangers.
          */
         level3Name?: string;
         /**
-         * ID de la commune. Peut être vide pour les pays étrangers.
+         * ID du département. Peut être vide pour les pays étrangers.
          */
         level4?: string;
         /**
-         * Nom de la commune. Peut être vide pour les pays étrangers.
+         * Nom du département. Peut être vide pour les pays étrangers.
          */
         level4Name?: string;
+        /**
+         * ID de l'EPCI (intercommunalité). Peut être vide.
+         */
+        level5?: string;
+        /**
+         * Nom de l'EPCI. Peut être vide.
+         */
+        level5Name?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -1139,15 +1155,15 @@ export interface GetProjectsNoAdminData {
      */
     countType: "projects"[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
-        $or?: Record<string, unknown>;
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^links\.contributors\.(?:[a-f0-9]{24}|@\w+)$".
-         */
+        $or: {};
         [k: string]: unknown;
     };
     /**
@@ -1217,15 +1233,15 @@ export interface GetProjectsAdminData {
      */
     countType: "projects"[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
-        $or?: Record<string, unknown>;
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^links\.contributors\.(?:[a-f0-9]{24}|@(?:\{[^}]+\}|[A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+)?))$".
-         */
+        $or: {};
         [k: string]: unknown;
     };
     /**
@@ -1306,17 +1322,15 @@ export interface GetPoisNoAdminData {
      */
     countType: "poi"[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^parent\.(?:[a-f0-9]{24}|@\w+)$".
-         */
-        [k: string]: {
-            $exists: true;
-        };
+        [k: string]: unknown;
     };
     /**
      * Localité vide ou spécifique
@@ -1385,17 +1399,15 @@ export interface GetPoisAdminData {
      */
     countType: "poi"[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^parent\.(?:[a-f0-9]{24}|@(?:\{[^}]+\}|[A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+)?))$".
-         */
-        [k: string]: {
-            $exists: true;
-        };
+        [k: string]: unknown;
     };
     /**
      * Localité vide ou spécifique
@@ -1658,10 +1670,16 @@ export interface GetOrganizationsNoAdminData {
      */
     countType: ("NGO" | "Cooperative" | "LocalBusiness" | "Group" | "GovernmentOrganization")[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
-    filters: {};
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
+    filters: {
+        [k: string]: unknown;
+    };
     /**
      * Localité vide ou spécifique
      */
@@ -1729,9 +1747,13 @@ export interface GetOrganizationsAdminData {
      */
     countType: ("NGO" | "Cooperative" | "LocalBusiness" | "Group" | "GovernmentOrganization")[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
         [k: string]: unknown;
     };
@@ -1804,9 +1826,13 @@ export interface GetUserEligiblePlacesData {
      */
     countType?: string[];
     /**
-     * true = désactive le filtrage automatique par sourceKey du contexte (cf. SearchNew.php). Configurable dynamiquement selon la config du finder du formulaire.
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: boolean;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     /**
      * Filtres MongoDB arbitraires : tags, source.key, links.members.{id}, etc. Les valeurs peuvent être une string (match exact), un tableau (any-of), ou un objet ($exists/$in/$ne/etc).
      */
@@ -2883,21 +2909,37 @@ export interface AddOrganizationData {
         level1: string;
         level1Name: string;
         /**
-         * ID du département. Peut être vide pour les pays étrangers.
+         * ID du niveau administratif intermédiaire propre à certains pays (ex. Wallonie en Belgique, province malgache). Absent pour la France.
+         */
+        level2?: string;
+        /**
+         * Nom du niveau intermédiaire. Absent pour la France.
+         */
+        level2Name?: string;
+        /**
+         * ID de la région. Peut être vide pour les pays étrangers.
          */
         level3?: string;
         /**
-         * Nom du département. Peut être vide pour les pays étrangers.
+         * Nom de la région. Peut être vide pour les pays étrangers.
          */
         level3Name?: string;
         /**
-         * ID de la commune. Peut être vide pour les pays étrangers.
+         * ID du département. Peut être vide pour les pays étrangers.
          */
         level4?: string;
         /**
-         * Nom de la commune. Peut être vide pour les pays étrangers.
+         * Nom du département. Peut être vide pour les pays étrangers.
          */
         level4Name?: string;
+        /**
+         * ID de l'EPCI (intercommunalité). Peut être vide.
+         */
+        level5?: string;
+        /**
+         * Nom de l'EPCI. Peut être vide.
+         */
+        level5Name?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -3166,21 +3208,37 @@ export interface AddProjectData {
         level1: string;
         level1Name: string;
         /**
-         * ID du département. Peut être vide pour les pays étrangers.
+         * ID du niveau administratif intermédiaire propre à certains pays (ex. Wallonie en Belgique, province malgache). Absent pour la France.
+         */
+        level2?: string;
+        /**
+         * Nom du niveau intermédiaire. Absent pour la France.
+         */
+        level2Name?: string;
+        /**
+         * ID de la région. Peut être vide pour les pays étrangers.
          */
         level3?: string;
         /**
-         * Nom du département. Peut être vide pour les pays étrangers.
+         * Nom de la région. Peut être vide pour les pays étrangers.
          */
         level3Name?: string;
         /**
-         * ID de la commune. Peut être vide pour les pays étrangers.
+         * ID du département. Peut être vide pour les pays étrangers.
          */
         level4?: string;
         /**
-         * Nom de la commune. Peut être vide pour les pays étrangers.
+         * Nom du département. Peut être vide pour les pays étrangers.
          */
         level4Name?: string;
+        /**
+         * ID de l'EPCI (intercommunalité). Peut être vide.
+         */
+        level5?: string;
+        /**
+         * Nom de l'EPCI. Peut être vide.
+         */
+        level5Name?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -3286,21 +3344,37 @@ export interface AddPoiData {
         level1: string;
         level1Name: string;
         /**
-         * ID du département. Peut être vide pour les pays étrangers.
+         * ID du niveau administratif intermédiaire propre à certains pays (ex. Wallonie en Belgique, province malgache). Absent pour la France.
+         */
+        level2?: string;
+        /**
+         * Nom du niveau intermédiaire. Absent pour la France.
+         */
+        level2Name?: string;
+        /**
+         * ID de la région. Peut être vide pour les pays étrangers.
          */
         level3?: string;
         /**
-         * Nom du département. Peut être vide pour les pays étrangers.
+         * Nom de la région. Peut être vide pour les pays étrangers.
          */
         level3Name?: string;
         /**
-         * ID de la commune. Peut être vide pour les pays étrangers.
+         * ID du département. Peut être vide pour les pays étrangers.
          */
         level4?: string;
         /**
-         * Nom de la commune. Peut être vide pour les pays étrangers.
+         * Nom du département. Peut être vide pour les pays étrangers.
          */
         level4Name?: string;
+        /**
+         * ID de l'EPCI (intercommunalité). Peut être vide.
+         */
+        level5?: string;
+        /**
+         * Nom de l'EPCI. Peut être vide.
+         */
+        level5Name?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -3580,21 +3654,37 @@ export interface AddEventData {
         level1: string;
         level1Name: string;
         /**
-         * ID du département. Peut être vide pour les pays étrangers.
+         * ID du niveau administratif intermédiaire propre à certains pays (ex. Wallonie en Belgique, province malgache). Absent pour la France.
+         */
+        level2?: string;
+        /**
+         * Nom du niveau intermédiaire. Absent pour la France.
+         */
+        level2Name?: string;
+        /**
+         * ID de la région. Peut être vide pour les pays étrangers.
          */
         level3?: string;
         /**
-         * Nom du département. Peut être vide pour les pays étrangers.
+         * Nom de la région. Peut être vide pour les pays étrangers.
          */
         level3Name?: string;
         /**
-         * ID de la commune. Peut être vide pour les pays étrangers.
+         * ID du département. Peut être vide pour les pays étrangers.
          */
         level4?: string;
         /**
-         * Nom de la commune. Peut être vide pour les pays étrangers.
+         * Nom du département. Peut être vide pour les pays étrangers.
          */
         level4Name?: string;
+        /**
+         * ID de l'EPCI (intercommunalité). Peut être vide.
+         */
+        level5?: string;
+        /**
+         * Nom de l'EPCI. Peut être vide.
+         */
+        level5Name?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -3927,6 +4017,14 @@ export interface AssignBadgesData {
     [k: string]: unknown;
 }
 export interface GetEventsData {
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
+    /**
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
+     */
+    notSourceKey?: boolean;
     searchType: "events"[];
     indexMin: number;
     indexStep: number;
@@ -3966,11 +4064,7 @@ export interface GetEventsData {
      */
     recurrency?: false;
     filters?: {
-        $or?: Record<string, unknown>;
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^links\.attendees\.(?:[a-f0-9]{24}|@\w+)$".
-         */
+        $or: {};
         [k: string]: unknown;
     };
     [k: string]: unknown;
@@ -6193,6 +6287,8 @@ export interface AddClassifiedData {
         level3Name?: string;
         level4?: string;
         level4Name?: string;
+        level5?: string;
+        level5Name?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -6572,3 +6668,22 @@ export interface ZoneGetZonirisData {
     sourceKey?: string[];
     [k: string]: unknown;
 }
+export interface CostumListValuesData {
+    /**
+     * Slug du costum (élément porteur ou document `costum`).
+     */
+    slug: string;
+    /**
+     * Nom de la liste déclarée dans `costum.lists`.
+     */
+    list: string;
+    /**
+     * Recherche SERVEUR sur les valeurs. Comparaison canonique — minuscules, accents dépliés, ponctuation retirée — donc « economie » trouve « Économie ». C'est la MÊME normalisation que la clé de tri (`sansAccents` / `cleTri`), pour que les deux ports filtrent exactement le même ensemble. Sans `q`, la liste entière est rendue.
+     */
+    q?: string;
+    /**
+     * Nombre MAXIMAL de valeurs rendues, appliqué APRÈS `q`, le dédoublonnage et le tri — donc sur une liste déjà déterministe. Quand il coupe, la réponse porte `total` et `truncated`. Sans `limit`, la liste entière est rendue (comportement historique).
+     */
+    limit?: number;
+    [k: string]: unknown;
+}

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

@@ -48,6 +48,8 @@ export interface PostalAddress {
     level3Name?: string;
     level4?: string;
     level4Name?: string;
+    level5?: string;
+    level5Name?: string;
     addressCountry?: string;
     localityId?: string;
     inseeDensity?: number;