@communecter/cocolight-api-client 1.0.191 → 1.0.193

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 {
@@ -4329,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 {
@@ -4409,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 {
@@ -4428,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 {
@@ -4760,6 +4988,168 @@ export interface NavigatorGettlData {
     };
     [k: string]: unknown;
 }
+export interface NavigatorGetRessourceTlData {
+    /**
+     * Nom ou mot-clé de la recherche
+     */
+    name?: string;
+    /**
+     * Localités ciblées. Trois formes acceptées : object keyé (forme historique), array d'objets (forme alternative consommée par `foreach`), ou chaîne vide (placeholder = pas de filtre).
+     */
+    locality?: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[^\s]+$".
+         */
+        [k: string]: {
+            /**
+             * Identifiant de la localité
+             */
+            id: string;
+            /**
+             * Type de localité
+             */
+            type: "cities" | "cp" | "country" | "level1" | "level2" | "level3" | "level4" | "level5";
+            postalCode?: string;
+            countryCode?: string;
+            name?: string;
+            level?: string | number;
+        };
+    } | {
+        id: string;
+        type: "cities" | "cp" | "country" | "level1" | "level2" | "level3" | "level4" | "level5";
+        postalCode?: string;
+        countryCode?: string;
+        name?: string;
+        level?: string | number;
+    }[] | "";
+    /**
+     * Types d'entités à inclure dans la recherche
+     */
+    searchType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
+    /**
+     * Balises (tags) à utiliser pour filtrer la recherche
+     */
+    searchTags?: string[];
+    /**
+     * Liste fixe des types à compter dans les résultats
+     */
+    countType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
+    /**
+     * Sélecteur des champs où chercher le terme `name`. Trois formes acceptées : `"ALL"` (cherche dans name/title/slug/tags/source.keys/sigle/description), chaîne CSV (`"name,slug,tags"`), ou tableau de chemins (`["name", "address.addressLocality"]`).
+     */
+    searchBy?: string | [string, ...string[]];
+    /**
+     * Index de départ global pour la pagination
+     */
+    indexMin: number;
+    /**
+     * Index de fin global pour la pagination
+     */
+    indexMax?: number;
+    /**
+     * Nombre d’éléments à récupérer (limite de pagination)
+     */
+    indexStep: number;
+    /**
+     * Configuration des plages de résultats pour chaque type de recherche
+     */
+    ranges?: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[^\s]+$".
+         */
+        [k: string]: {
+            /**
+             * Index de départ pour la pagination
+             */
+            indexMin: number;
+            /**
+             * Index de fin pour la pagination
+             */
+            indexMax: number;
+        };
+    };
+    /**
+     * Type initial de la recherche, vide par défaut
+     */
+    initType: "";
+    /**
+     * Indique si les types doivent être comptés dans les résultats
+     */
+    count: true;
+    /**
+     * Filtres additionnels appliqués à la recherche (objet ou chaîne vide)
+     */
+    filters?: {
+        [k: string]: unknown;
+    } | "";
+    /**
+     * Liste des champs à retourner
+     */
+    fields?: string[];
+    /**
+     * Champ de tri (clé = champ, valeur = 1 ou -1)
+     */
+    sortBy?: {
+        [k: string]: 1 | -1;
+    };
+    /**
+     * Indique si la recherche doit s'étendre au Fediverse (toujours désactivé)
+     */
+    fediverse: boolean;
+    /**
+     * Indique si la recherche est effectuée à partir d'une carte (toujours désactivé)
+     */
+    mapUsed?: true;
+    /**
+     * Indique si on doit exclure les éléments avec une source
+     */
+    notSourceKey?: true;
+    /**
+     * ID du contexte de recherche (actuellement vide)
+     */
+    contextId?: string;
+    /**
+     * Type de contexte de recherche (actuellement vide)
+     */
+    contextType?: "projects" | "organizations";
+    /**
+     * Slug du costume utilisé pour la recherche
+     */
+    costumSlug: string;
+    /**
+     * Alias historique de `contextId` — id du contexte costum. Le backend lit l'un OU l'autre (`isset($post['contextId']) ? ... : $post['costumId']`).
+     */
+    costumId?: string;
+    /**
+     * Alias historique de `contextType` — type du contexte costum.
+     */
+    costumType?: "projects" | "organizations";
+    /**
+     * Mode d'affichage / comportement côté backend. Valeurs observées : `table` (charge `creatorData`), `mapWithDirectory`. String libre.
+     */
+    mode?: string;
+    /**
+     * Clés de source pour la recherche
+     */
+    sourceKey?: string[];
+    /**
+     * Indique si le mode d'édition du costume est activé (toujours désactivé)
+     */
+    costumEditMode: boolean;
+    options?: {
+        tags?: {
+            /**
+             * Verbe d'action pour le filtre de recherche
+             */
+            verb?: string;
+            [k: string]: unknown;
+        };
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
 export interface CostumEventRequestActorsData {
     /**
      * Types de liens à inclure (ex: organizer, attendees, creator, animator)
@@ -5740,6 +6130,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 {
@@ -5765,6 +6167,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 {
@@ -5860,6 +6274,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.
      *