@communecter/cocolight-api-client 1.0.190 → 1.0.192

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

@@ -45,6 +45,18 @@ export interface PersonRegisterData {
      * Indique s’il s’agit d’une invitation (facultatif)
      */
     isInvitation?: boolean;
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface AuthenticateUrlData {
@@ -77,6 +89,18 @@ export interface PasswordRecoveryData {
      * Type d'email envoyé
      */
     type: "password";
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface PasswordResetData {
@@ -133,6 +157,18 @@ export interface DeleteAccountData {
      * Raison de la suppression
      */
     reason: string;
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     pathParams?: {
         /**
          * Identifiant de l'utilisateur à supprimer
@@ -515,6 +551,18 @@ export interface MulticonnectData {
             };
         };
     };
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface RelaunchInvitationData {
@@ -522,6 +570,18 @@ export interface RelaunchInvitationData {
      * _id du compte invité à relancer
      */
     id: string;
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface ContactSendData {
@@ -709,6 +769,18 @@ export interface AddNewsData {
         count: number;
         [k: string]: unknown;
     }[];
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface AddImageNewsData {
@@ -851,6 +923,18 @@ export interface UpdateNewsData {
         count: number;
         [k: string]: unknown;
     }[];
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface ShareNewsData {
@@ -878,6 +962,18 @@ export interface ShareNewsData {
      * Commentaire de partage
      */
     comment?: string;
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface GetCommentsData {
@@ -945,6 +1041,18 @@ export interface AddCommentsData {
          */
         count: number;
     }[];
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface DeleteCommentsData {
@@ -2804,6 +2912,18 @@ export interface ConnectData {
      * Type de connexion
      */
     connectType: "admin" | "member" | "contributor" | "attendee" | "friend" | "connect";
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface CreateInvitationLinkData {
@@ -2827,9 +2947,33 @@ export interface CreateInvitationLinkData {
      * URL de redirection après rattachement (optionnel)
      */
     urlRedirection?: string;
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface ConnectByRefData {
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     pathParams?: {
         /**
          * Référence publique du lien (hex ; uniqid legacy 13 ou token Node 24) — segment d URL
@@ -2860,6 +3004,18 @@ export interface DisconnectData {
      * Type de connexion
      */
     connectType: "members" | "contributors" | "attendees" | "friends" | "followers";
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface GetElementsKeyData {
@@ -3836,6 +3992,18 @@ export interface DeleteElementData {
      * Raison de la suppression
      */
     reason: string;
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     pathParams?: {
         /**
          * Type d'élément à supprimer
@@ -3902,6 +4070,18 @@ export interface LinkValidateData {
      * Type de validation
      */
     linkOption?: "isInviting" | "isAdminInviting" | "toBeValidated" | "isAdminPending";
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface SearchMemberAutocompleteData {
@@ -4154,6 +4334,18 @@ export interface AssignBadgesData {
         narative: string;
     }[];
     scope?: "";
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface GetEventsData {
@@ -4200,9 +4392,21 @@ export interface GetEventsData {
     countType?: unknown[];
     fediverse: boolean;
     /**
-     * GARDE PARITÉ legacy (identique à SEARCH_EVENTS_COSTUM) : seule valeur autorisée `false` (= exclure les récurrents) OU champ omis (= inclure, défaut). NE JAMAIS envoyer `true` — le legacy teste STRICTEMENT $recurrency === true (AgendaAction.php:65) qui échoue sur la string POST → exclut les récurrents, alors que notre backend les inclurait (divergence assumée). En interdisant `true`, omis→inclus et false→exclus se comportent pareil sur les 2 serveurs.
+     * Inclure les événements récurrents (openingHours). Omis = inclure. `false` = exclure : en mode LISTE la requête des récurrents est sautée (comme avant 14c2caa1), en mode CALENDRIER les clauses openingHours.dayOfWeek ne sont pas posées. Depuis le 2026-09-04 le legacy parse la valeur en booléen (filter_var FILTER_VALIDATE_BOOLEAN) et le backend Node fait de même : `true`/`false` sont fiables sur les 2 serveurs (byte-parité prouvée). Historique : `=== true` strict (BUG-L-031, `true` excluait), puis truthy 14c2caa1 (la chaîne "false" INCLUAIT, BUG-L-259).
+     */
+    recurrency?: boolean;
+    /**
+     * Mode LISTE seulement (sans startDateUTC/endDateUTC). Borne basse « pas encore terminé à from » : ponctuels endDate ≥ from (sinon startDate ≥ from, un multi-jours en cours reste servi) ; récurrents : prochaine occurrence calculée DEPUIS from au lieu de maintenant (un créneau en cours reste « la prochaine »). Sert d'ANCRE de pagination : renvoyer la même valeur à chaque page (sinon la clé de tri des récurrents bouge entre deux pages). Dès que `from`, `to` ou `order` est présent, chaque ligne porte `endDateSortFormat`. Envoyer un ISO 8601 AVEC offset (toISOString) : une date nue est lue en Europe/Paris par le legacy et en UTC par le backend Node.
+     */
+    from?: string;
+    /**
+     * Mode LISTE seulement. Borne haute STRICTE sur la clé d'occurrence : ponctuels startDate < to ; récurrents prochaine occurrence < to. Même règle d'offset que `from`. « Les passés » = `to` = maintenant + `order` = desc + `recurrency` = false.
      */
-    recurrency?: false;
+    to?: string;
+    /**
+     * Mode LISTE seulement — PAS de default déclaré : la lib injecte les defaults du contrat dans la requête, et la seule présence d'`order` déclenche le mode borné (endDateSortFormat). Défaut serveur : desc. Sens du tri sur la clé d'occurrence (startDateSort), départage _id dans le même sens ; la requête des ponctuels suit le même sens (top-K juste). « Les prochains à partir de maintenant » = `from` = maintenant + `order` = asc. Sans `from`/`to`/`order`, requête ET réponse sont strictement celles d'avant (DESC non borné, aucune clé nouvelle).
+     */
+    order?: "asc" | "desc";
     filters?: {
         $or: {};
         [k: string]: unknown;
@@ -4245,9 +4449,21 @@ export interface SearchEventsCostumData {
     countType?: unknown[];
     fediverse: boolean;
     /**
-     * GARDE PARITÉ legacy : seule valeur autorisée `false` (= exclure les récurrents) OU champ omis (= inclure, défaut). NE JAMAIS envoyer `true` — le legacy teste STRICTEMENT $recurrency === true (AgendaAction.php:65) qui échoue sur la string POST → exclut les récurrents, alors que notre backend les inclurait (divergence assumée). En interdisant `true`, omis→inclus et false→exclus se comportent pareil sur les 2 serveurs.
+     * Inclure les événements récurrents (openingHours). Omis = inclure. `false` = exclure : en mode LISTE la requête des récurrents est sautée (comme avant 14c2caa1), en mode CALENDRIER les clauses openingHours.dayOfWeek ne sont pas posées. Depuis le 2026-09-04 le legacy parse la valeur en booléen (filter_var FILTER_VALIDATE_BOOLEAN) et le backend Node fait de même : `true`/`false` sont fiables sur les 2 serveurs (byte-parité prouvée). Historique : `=== true` strict (BUG-L-031, `true` excluait), puis truthy 14c2caa1 (la chaîne "false" INCLUAIT, BUG-L-259).
      */
-    recurrency?: false;
+    recurrency?: boolean;
+    /**
+     * Mode LISTE seulement (sans startDateUTC/endDateUTC). Borne basse « pas encore terminé à from » : ponctuels endDate ≥ from (sinon startDate ≥ from, un multi-jours en cours reste servi) ; récurrents : prochaine occurrence calculée DEPUIS from au lieu de maintenant (un créneau en cours reste « la prochaine »). Sert d'ANCRE de pagination : renvoyer la même valeur à chaque page (sinon la clé de tri des récurrents bouge entre deux pages). Dès que `from`, `to` ou `order` est présent, chaque ligne porte `endDateSortFormat`. Envoyer un ISO 8601 AVEC offset (toISOString) : une date nue est lue en Europe/Paris par le legacy et en UTC par le backend Node.
+     */
+    from?: string;
+    /**
+     * Mode LISTE seulement. Borne haute STRICTE sur la clé d'occurrence : ponctuels startDate < to ; récurrents prochaine occurrence < to. Même règle d'offset que `from`. « Les passés » = `to` = maintenant + `order` = desc + `recurrency` = false.
+     */
+    to?: string;
+    /**
+     * Mode LISTE seulement — PAS de default déclaré : la lib injecte les defaults du contrat dans la requête, et la seule présence d'`order` déclenche le mode borné (endDateSortFormat). Défaut serveur : desc. Sens du tri sur la clé d'occurrence (startDateSort), départage _id dans le même sens ; la requête des ponctuels suit le même sens (top-K juste). « Les prochains à partir de maintenant » = `from` = maintenant + `order` = asc. Sans `from`/`to`/`order`, requête ET réponse sont strictement celles d'avant (DESC non borné, aucune clé nouvelle).
+     */
+    order?: "asc" | "desc";
     /**
      * Filtres Mongo additionnels (buildFilters).
      */
@@ -4305,6 +4521,18 @@ export interface ShareEventsData {
      * Commentaire de partage
      */
     comment?: string;
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface InviteMembersData {
@@ -4385,6 +4613,18 @@ export interface InviteMembersData {
             };
         };
     };
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface FollowData {
@@ -4404,6 +4644,18 @@ export interface FollowData {
      * ID de l'élément parent
      */
     parentId: string;
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface GetCostumJsonData {
@@ -5716,6 +5968,18 @@ export interface AddVoteData {
          */
         status: string;
     };
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface AddReportAbuseData {
@@ -5741,6 +6005,18 @@ export interface AddReportAbuseData {
          */
         comment?: string;
     };
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface UpdatePathValueData {
@@ -5836,6 +6112,18 @@ export interface DemoteAdminData {
     childType: "citoyens";
     connect: "members" | "contributors";
     isAdmin: false;
+    /**
+     * Contexte costum de l'action : slug du SITE appelant (l'entité porteuse du costum), jamais le slug du moteur (« costumize »). Injecté automatiquement par le client (ApiClient.setSiteCostum / setCostumScope). Le legacy le lit dans $_POST — CommunecterController::costumCacheParams réchauffe alors le cache costum AVANT l'action, ce qui brande l'e-mail émis (domaine des liens, titre, logo, expéditeur) et stampe source.key sur le job cron.
+     */
+    costumSlug?: string;
+    /**
+     * Contexte costum : _id de l'entité porteuse du costum (contextId). Facultatif, complète costumSlug.
+     */
+    costumId?: string;
+    /**
+     * Contexte costum : collection de l'entité porteuse (organizations | projects | events | citoyens). Facultatif, complète costumSlug.
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface CostumFilterCoformData {

package/types/api/User.d.ts

@@ -473,6 +473,18 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * @private
      */
     private _getParentLinkForUser;
+    /**
+     * Contexte costum à faire porter par les actions de LIEN sur le parent (adhésion, validation,
+     * promotion, rétrogradation) : celui du PARENT — l'organisation/le projet/l'événement qui porte
+     * le costum du site.
+     *
+     * ⚠ JAMAIS celui de CETTE fiche citoyen : le `source.key` d'un citoyen est le costum où il s'est
+     * INSCRIT, sans aucun rapport avec le site depuis lequel l'action est faite. Comme l'enveloppe
+     * l'emporte sur le défaut du client (`ApiClient.setSiteCostum`), la poser depuis le citoyen
+     * branderait l'e-mail du MAUVAIS costum — un dégât net par rapport à ne rien poser.
+     * @private
+     */
+    private _parentCostumContext;
     /**
      * Valide les préconditions et retourne le lien parent.
      *

package/types/api/UserApi.d.ts

@@ -62,11 +62,29 @@ export declare class UserApi {
     /**
      * Lance une procédure de récupération de mot de passe.
      *
+     * Le costum, s'il est fourni, ne sert QU'À BRANDER l'e-mail envoyé (domaine du lien de
+     * réinitialisation = `costum.host`, titre, logo, expéditeur) : le legacy le lit dans `$_POST`
+     * (`CommunecterController::beforeAction` → `costumCacheParams()`) AVANT l'action, et
+     * `Mail::getCustomMail`/`Mail::getAppName` y puisent l'habillage. Aligné sur `register`.
+     *
+     * ⚠ SÉCURITÉ : `PASSWORD_RECOVERY` est `auth:"none"`. Le contexte costum est donc fourni par un
+     * appelant NON AUTHENTIFIÉ — il ne doit JAMAIS élargir un droit, ni servir à sélectionner un
+     * compte : il n'habille que le message. On ne relâche AUCUN autre champ du schéma (l'enveloppe
+     * ne porte que `context`, `properties` reste vide), et le destinataire reste résolu côté serveur
+     * depuis `email` — jamais depuis le costum.
+     *
      * @param email - Adresse email de l'utilisateur.
+     * @param opts.costumSlug - (option) slug de l'ENTITÉ PORTEUSE du costum (jamais « costumize »).
+     * @param opts.costumId / opts.costumType - (option) identité de l'entité porteuse, requises si le
+     *   slug n'est pas un doc `costum` (ex. un site porté par une organisation).
      * @returns Réponse brute de l'API.
      * @throws {ApiResponseError} Si l'API retourne un échec (`result === false`).
      */
-    recoverPassword(email: string): Promise<any>;
+    recoverPassword(email: string, { costumSlug, costumId, costumType }?: {
+        costumSlug?: string;
+        costumId?: string;
+        costumType?: string;
+    }): Promise<any>;
     /**
      * Active (valide l'email) un compte via le lien reçu par email.
      *

package/types/costum/schemas/associationEkilibre.d.ts

@@ -0,0 +1,3 @@
+import type { CostumExtensionModule } from "../types.js";
+declare const mod: CostumExtensionModule;
+export default mod;

package/types/costum/types.d.ts

@@ -1,4 +1,4 @@
-export type KnownCostumSlug = "CercleTravailleursSociauxLiberauxLaPlumeSociale" | "FabEn" | "LaReunionDesTiersLieux" | "LivingLabInnovationSocialeBraspanon" | "RoseLab" | "Santeentransition" | "alfph" | "ambitionTiersLieuxValDeLoire" | "assoKosasa" | "boclLe" | "bretagneTierslieux" | "caDuBassinDeThauTiersLieux" | "caDuBassinDeThauTiersLieux1" | "campagne" | "capTierslieux" | "catalyst" | "ccDesCaussesALaubracTiersLieux" | "chtitube" | "circuitCourt" | "cmcasHB" | "cmcasHauteBretagne" | "coFinancementTierslieux" | "coeurNumerique" | "communLundi" | "consortiumIledefranceTierslieux" | "copHautsdefrance" | "createchFablabDeLaMjcDeSaintjean" | "cressDeLaReunion1" | "cressReunion" | "cressReunionNetwork" | "ctenat" | "cyberReunion" | "daLocu" | "ecocentre" | "ekisphere" | "equipementsSportifs974" | "fabLimagne" | "fabdulys1" | "fablab3dplant" | "fablabChauxdefonds" | "federationDesCae" | "fianarantsoaAlimentation" | "formationGenerique" | "franceTierslieux" | "heraultTiersLieux" | "hinaura" | "hubmayotte" | "hubnouvellecaledonie" | "hubpolynesiefrancaise" | "hubreunion" | "hubterritoires" | "hubwallisetfutuna" | "hva" | "ibv2" | "institutBleu" | "journalInsoumisChambery" | "kpacite" | "laCompagnieDesTierslieux" | "laCooperativeTierslieux" | "laMaisonDesFaiseurs" | "laMinoterie1" | "laMyne" | "laReunionPourUnNumeriqueInclusif" | "laRosee" | "laSemaineDesTierslieux" | "laTresseTierslieu" | "labEnCommuns" | "labboite" | "lakou" | "lapossession" | "lattesTiersLieux" | "leFaugaTiersLieux" | "leTamponTiersLieux" | "lesCommunsDesTierslieux" | "lesImaginationsFertiles" | "lidairesTiersLieux" | "littoralHautsDeFrance" | "lotetgaronneTiersLieux" | "mayottePourUnNumeriqueInclusif" | "meir" | "montpellierMediterraneeMetropoleTiersLieux" | "montpellierTiersLieux" | "navigatorDesTierslieux" | "notragora" | "nouvellecaledoniePourUnNumeriqueInclusif" | "openAtlas" | "parent62" | "polynesieFrancaisePourUnNumeriqueInclusif" | "prdr" | "pyreneesatlantiquesTiersLieux" | "redlab" | "relief" | "reseauDesTierslieuxDeGuyane" | "reseauDesTierslieuxDeMayotte" | "reseauDesTierslieuxDuGrandEst" | "reseauNormandDesTierslieux" | "reseauRegionalDesTierslieuxGuadeloupe" | "reseauRegionalDesTierslieuxMartinique" | "reseauTierslieux" | "rfflabs" | "ries" | "sLieux" | "saintJosephTiersLieux" | "saintbenoitTiersLieux" | "saintbenoitTiersLieux1" | "saintbenoitTiersLieux2" | "saintpaulSport1" | "saintpaulTiersLieux" | "saintpierreTiersLieux" | "savoieTiersLieux" | "siteDuPactePourLaTransition" | "sportSanteBienetre" | "sudTierslieux" | "suppa" | "terramies" | "testeTplFormation" | "tiersLieuxGenerique" | "tierslieuxBfc" | "tierslieuxbelgique" | "tierslieuxorg" | "tierslieuxorg1" | "transiter" | "vhelioPeiTour2025" | "wallisetfutunaPourUnNumeriqueInclusif";
+export type KnownCostumSlug = "CercleTravailleursSociauxLiberauxLaPlumeSociale" | "FabEn" | "LaReunionDesTiersLieux" | "LivingLabInnovationSocialeBraspanon" | "RoseLab" | "Santeentransition" | "alfph" | "ambitionTiersLieuxValDeLoire" | "assoKosasa" | "associationEkilibre" | "boclLe" | "bretagneTierslieux" | "caDuBassinDeThauTiersLieux" | "caDuBassinDeThauTiersLieux1" | "campagne" | "capTierslieux" | "catalyst" | "ccDesCaussesALaubracTiersLieux" | "chtitube" | "circuitCourt" | "cmcasHB" | "cmcasHauteBretagne" | "coFinancementTierslieux" | "coeurNumerique" | "communLundi" | "consortiumIledefranceTierslieux" | "copHautsdefrance" | "createchFablabDeLaMjcDeSaintjean" | "cressDeLaReunion1" | "cressReunion" | "cressReunionNetwork" | "ctenat" | "cyberReunion" | "daLocu" | "ecocentre" | "ekisphere" | "equipementsSportifs974" | "fabLimagne" | "fabdulys1" | "fablab3dplant" | "fablabChauxdefonds" | "federationDesCae" | "fianarantsoaAlimentation" | "formationGenerique" | "franceTierslieux" | "heraultTiersLieux" | "hinaura" | "hubmayotte" | "hubnouvellecaledonie" | "hubpolynesiefrancaise" | "hubreunion" | "hubterritoires" | "hubwallisetfutuna" | "hva" | "ibv2" | "institutBleu" | "journalInsoumisChambery" | "kpacite" | "laCompagnieDesTierslieux" | "laCooperativeTierslieux" | "laMaisonDesFaiseurs" | "laMinoterie1" | "laMyne" | "laReunionPourUnNumeriqueInclusif" | "laRosee" | "laSemaineDesTierslieux" | "laTresseTierslieu" | "labEnCommuns" | "labboite" | "lakou" | "lapossession" | "lattesTiersLieux" | "leFaugaTiersLieux" | "leTamponTiersLieux" | "lesCommunsDesTierslieux" | "lesImaginationsFertiles" | "lidairesTiersLieux" | "littoralHautsDeFrance" | "lotetgaronneTiersLieux" | "mayottePourUnNumeriqueInclusif" | "meir" | "montpellierMediterraneeMetropoleTiersLieux" | "montpellierTiersLieux" | "navigatorDesTierslieux" | "notragora" | "nouvellecaledoniePourUnNumeriqueInclusif" | "openAtlas" | "parent62" | "polynesieFrancaisePourUnNumeriqueInclusif" | "prdr" | "pyreneesatlantiquesTiersLieux" | "redlab" | "relief" | "reseauDesTierslieuxDeGuyane" | "reseauDesTierslieuxDeMayotte" | "reseauDesTierslieuxDuGrandEst" | "reseauNormandDesTierslieux" | "reseauRegionalDesTierslieuxGuadeloupe" | "reseauRegionalDesTierslieuxMartinique" | "reseauTierslieux" | "rfflabs" | "ries" | "sLieux" | "saintJosephTiersLieux" | "saintbenoitTiersLieux" | "saintbenoitTiersLieux1" | "saintbenoitTiersLieux2" | "saintpaulSport1" | "saintpaulTiersLieux" | "saintpierreTiersLieux" | "savoieTiersLieux" | "siteDuPactePourLaTransition" | "sportSanteBienetre" | "sudTierslieux" | "suppa" | "terramies" | "testeTplFormation" | "tiersLieuxGenerique" | "tierslieuxBfc" | "tierslieuxbelgique" | "tierslieuxorg" | "tierslieuxorg1" | "transiter" | "vhelioPeiTour2025" | "wallisetfutunaPourUnNumeriqueInclusif";
 export type Collection = "addPhoto" | "badges" | "classifieds" | "crowdfunding" | "events" | "organizations" | "person" | "poi" | "projects" | "proposal" | "ressources";
 export interface CostumExtensionField {
     name: string;
@@ -143,6 +143,57 @@ export interface CostumFieldMap {
             image?: string;
         };
     };
+    associationEkilibre: {
+        organizations: {
+            affiliate?: string | boolean;
+            affiliateTo?: string;
+            autreDescription?: string;
+            formLocality?: string;
+            image?: string;
+            infoGeneral?: Record<string, unknown>;
+            legalStatus?: string | string[];
+            link?: string;
+            linkedin?: string;
+            location?: string;
+            mobile?: string;
+            otherPersonInChargeTitle?: string;
+            otherRepresentativeTitle?: string;
+            personInChargeCivility?: string | string[];
+            personInChargeEmail?: string;
+            personInChargeFirstName?: string;
+            personInChargeName?: string;
+            personInChargeTelephone?: string | number;
+            personInChargeTitle?: "Président" | "Maire.sse" | "Chef.fe d'entreprise" | "Chef.fe d'établissement" | "Autre...";
+            representativeCivility?: string | string[];
+            representativeEmail?: string;
+            representativeFirstName?: string;
+            representativeName?: string;
+            representativeTelephone?: string | number;
+            representativeTitle?: "Président" | "Maire.sse" | "Chef.fe d'entreprise" | "Chef.fe d'établissement" | "Autre...";
+            responsableCivilePro?: Record<string, unknown>;
+            responsableSameAsRepresent?: string | boolean;
+            sextionInfo?: Record<string, unknown>;
+            sextionInfoRepresentant?: Record<string, unknown>;
+            sextionInfoResponsable?: Record<string, unknown>;
+            sigle?: string;
+            similarLink?: Record<string, unknown>;
+            siren?: string | number;
+            statusActor?: string | string[];
+            statusCommunale?: string | string[];
+            statusFile?: Record<string, unknown>;
+            statusPrimaire?: string | string[];
+            statusSecondaire?: string | string[];
+            youtube?: string;
+        };
+        poi: {
+            category?: string;
+            featured?: string | boolean;
+            link?: string;
+            publicationDate?: string;
+            publicationStatus?: string;
+            status?: string | string[];
+        };
+    };
     boclLe: {
         badges: {
             thematic?: string | string[];