@communecter/cocolight-api-client 1.0.184 → 1.0.186

package/package.json

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

package/types/api/BaseEntity.d.ts

@@ -2012,6 +2012,103 @@ export declare class BaseEntity<TServerData = any> {
         result: boolean;
         msg?: string;
     }>;
+    /** Corps commun check/apply — `to` défaut = costum de cette entité (repreneur = site courant). */
+    private _ownershipTransferBody;
+    /**
+     * Analyse (DRY-RUN) d'un transfert d'appropriation — aucune écriture. Renvoie `canApply`, les
+     * contrôles d'uniformité (bloquants/warnings), les compteurs (byLocality/byType), la résolution
+     * du sous-type, la comparaison de schéma costum et un exemple avant/après.
+     */
+    checkOwnershipTransfer(params: Parameters<BaseEntity["_ownershipTransferBody"]>[0]): Promise<{
+        result: boolean;
+        msg?: string;
+        canApply?: boolean;
+        counts?: {
+            selected: number;
+            byLocality: Record<string, number>;
+            byType: Record<string, number>;
+        };
+        controls?: {
+            id: string;
+            level: "blocking" | "warning";
+            count: number;
+            ids: string[];
+        }[];
+        subType?: {
+            mode: string;
+            value: string | null;
+            types: (string | null)[];
+        };
+        schema?: {
+            fromFields: number;
+            toFields: number;
+            missing: string[];
+        };
+        sample?: {
+            id: string;
+            name: string | null;
+            before: unknown;
+            after: unknown;
+        } | null;
+    }>;
+    /**
+     * APPLIQUE le transfert : re-déroule intégralement le check côté serveur (refus au moindre
+     * bloquant, et si `expectedCount` — le compteur affiché au dry-run — a dérivé), journalise le run
+     * dans `sourceMigrations` (snapshot AVANT écriture), écrit, et renvoie `migrationId` + compteurs
+     * auto-vérifiés. Rollbackable via rollbackOwnershipTransfer(migrationId).
+     */
+    applyOwnershipTransfer(params: Parameters<BaseEntity["_ownershipTransferBody"]>[0] & {
+        expectedCount?: number;
+    }): Promise<{
+        result: boolean;
+        msg?: string;
+        migrationId?: string;
+        controls?: {
+            id: string;
+            level: "blocking" | "warning";
+            count: number;
+            ids: string[];
+        }[];
+        applied?: {
+            migrated: number;
+            referenceAdded: number;
+            annotated: number;
+            selfReferenceCleaned: number;
+        };
+        verification?: {
+            ownedByTo: number;
+            stillOwnedByFrom: number;
+        };
+    }>;
+    /**
+     * ANNULE un transfert : restaure, depuis le snapshot du run, les racines source/reference de
+     * chaque fiche encore en état post-migration. Rollback PARTIEL accepté (`skipped` : moved =
+     * re-transférée depuis, missing = supprimée). Gate recalculé sur les slugs DU RUN.
+     */
+    rollbackOwnershipTransfer(migrationId: string): Promise<{
+        result: boolean;
+        msg?: string;
+        restored?: number;
+        skipped?: {
+            id: string;
+            reason: "moved" | "missing";
+        }[];
+        status?: string;
+    }>;
+    /**
+     * HISTORIQUE des transferts dont le costum de cette entité est cédant ou repreneur (created
+     * décroissant, sans snapshot). Avec `migrationId` : le run COMPLET, snapshot inclus — c'est le
+     * téléchargement JSON de rollback côté UI.
+     */
+    listOwnershipTransfers(params?: {
+        slug?: string;
+        migrationId?: string;
+    }): Promise<{
+        result: boolean;
+        msg?: string;
+        migrations?: Record<string, unknown>[];
+        migration?: Record<string, unknown>;
+    }>;
     /** 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<{
@@ -2261,6 +2358,23 @@ export declare class BaseEntity<TServerData = any> {
      * @throws {ApiError} - Si le slug de l'entité n'est pas défini.
      */
     getCostumJson(): Promise<unknown>;
+    /**
+     * Récupère le costum RÉSOLU de l'entité : le document MOTEUR (`costum.slug`) fusionné avec l'overlay
+     * porté par l'entité, plus le contexte (`contextType`/`contextId`/`contextSlug`) et le scope
+     * (`sourceKey`).
+     *
+     * À préférer à {@link getCostumJson}, qui renvoie l'overlay BRUT — sans le socle du moteur. Pour un site
+     * à moteur partagé l'écart est massif : `relief` déclare 1 propriété de formulaire dans son overlay là où
+     * son moteur en déclare 25, et ses 15 listes vivent entièrement dans le moteur. La charge utile est aussi
+     * 24 fois plus légère (~10 Ko contre ~244 Ko, `getcostumjson` transportant l'arbre CMS).
+     *
+     * `getCostumJson` reste disponible et inchangée : elle sert qui veut l'overlay tel quel, ou une clé hors
+     * de la liste blanche servie ici (`typeObj`, `lists`, `import.mapping`).
+     *
+     * @returns - Le costum résolu de l'entité.
+     * @throws {ApiError} - Si le slug de l'entité n'est pas défini.
+     */
+    getCostumResolved(): Promise<unknown>;
     /**
      * Génère des plages d'index pour la pagination.
      *

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, 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, CreateInvitationLinkData, ConnectByRefData, 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, CostumToolsCatalogData, CostumToolUsersData, CostumCommunInfoData, CostumSaveToolEnrichmentData, CostumCommunListData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, PersonValidateInvitationData, ValidateInvitationByMailData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
+import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, 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, CreateInvitationLinkData, ConnectByRefData, 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, CostumToolsCatalogData, CostumToolUsersData, CostumCommunInfoData, CostumSaveToolEnrichmentData, CostumCommunListData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, PersonValidateInvitationData, ValidateInvitationByMailData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, TransferSourceCheckData, TransferSourceApplyData, TransferSourceRollbackData, TransferSourceHistoryData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, CostumResolvedData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1576,6 +1576,46 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     setSource(data: SetSourceData): Promise<any>;
+    /**
+     * Analyser un transfert d'appropriation (dry-run) : Migration d'APPROPRIATION : transfère la PROPRIÉTÉ d'un ensemble de fiches du costum `from` vers le costum `to` (source.key/keys : from → to), `from` restant en RÉFÉRENCEMENT (reference.costum += from, + annotation reference.costumTypes.<from>). Réécriture EN PLACE (_id préservé : documents/images, liens, slug, historique intacts). C'est la voie DÉDIÉE et la SEULE : les verrous historiques restent (Element::prepData jette source à l'update ; setsource add refuse set=source). Gate : super-admin OU (admin du costum `from` ET admin du costum `to`) — le cédant consent, le repreneur accepte. Action legacy née EN MIROIR du port Node (byte-parité dès la naissance). MODE CHECK : dry-run STRUCTUREL (aucune écriture) — sélectionne, déroule les contrôles d'uniformité (bloquants : source.keys en objet à trous, provenance divergente, rattachements multiples selon keysPolicy, sous-type indéterminable, champs costum du cédant absents du repreneur [fusion moteur⊕overlay des DEUX slugs, pas la lecture naïve du doc costum], ids introuvables, sélection >5000 ; warnings : référencement préexistant [complété, jamais écrasé], modération en attente [les flags scopés survivent], auto-référencement parasite), déduit le sous-type, compare les schémas costum et renvoie un exemple avant/après. canApply=true autorise l'apply. La sélection est triée _id croissant (déterminisme : sample = plus petit _id, ids des contrôles triés).
+     * Constant : TRANSFER_SOURCE_CHECK
+     * @param data - Données envoyées à l'API
+     * @returns Les données de réponse.
+     * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+     * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+     * @throws {Error} - En cas d'erreur inattendue.
+     */
+    transferSourceCheck(data: TransferSourceCheckData): Promise<any>;
+    /**
+     * Appliquer un transfert d'appropriation : Migration d'APPROPRIATION : transfère la PROPRIÉTÉ d'un ensemble de fiches du costum `from` vers le costum `to` (source.key/keys : from → to), `from` restant en RÉFÉRENCEMENT (reference.costum += from, + annotation reference.costumTypes.<from>). Réécriture EN PLACE (_id préservé : documents/images, liens, slug, historique intacts). C'est la voie DÉDIÉE et la SEULE : les verrous historiques restent (Element::prepData jette source à l'update ; setsource add refuse set=source). Gate : super-admin OU (admin du costum `from` ET admin du costum `to`) — le cédant consent, le repreneur accepte. Action legacy née EN MIROIR du port Node (byte-parité dès la naissance). MODE APPLY : RE-DÉROULE INTÉGRALEMENT le pipeline de check sur la sélection recalculée (la sélection peut bouger entre check et apply) et refuse au moindre bloquant ; `expectedCount` (posé par l'UI depuis le dry-run) refuse aussi si le compte a dérivé. Puis : insert du run dans sourceMigrations (statut applying + SNAPSHOT {id, source, reference} de chaque fiche AVANT écriture — Mongo 4.2 sans transactions, le rollback est matérialisé), passe de nettoyage cleanSelfReference, écriture ($set source.key/keys + annotation, $addToSet reference.costum — jamais $set de la racine reference), activityStream par fiche, recomptage auto-vérifiant, statut applied. Idempotent par construction : rejouer → sélection vide ou sourceKeyMismatch → refus propre.
+     * Constant : TRANSFER_SOURCE_APPLY
+     * @param data - Données envoyées à l'API
+     * @returns Les données de réponse.
+     * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+     * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+     * @throws {Error} - En cas d'erreur inattendue.
+     */
+    transferSourceApply(data: TransferSourceApplyData): Promise<any>;
+    /**
+     * Annuler un transfert d'appropriation (rollback) : Migration d'APPROPRIATION : transfère la PROPRIÉTÉ d'un ensemble de fiches du costum `from` vers le costum `to` (source.key/keys : from → to), `from` restant en RÉFÉRENCEMENT (reference.costum += from, + annotation reference.costumTypes.<from>). Réécriture EN PLACE (_id préservé : documents/images, liens, slug, historique intacts). C'est la voie DÉDIÉE et la SEULE : les verrous historiques restent (Element::prepData jette source à l'update ; setsource add refuse set=source). Gate : super-admin OU (admin du costum `from` ET admin du costum `to`) — le cédant consent, le repreneur accepte. Action legacy née EN MIROIR du port Node (byte-parité dès la naissance). MODE ROLLBACK : restaure, fiche par fiche depuis le snapshot du run, les RACINES source et reference ENTIÈRES ($set/$unset racine — jamais de mix racine/sous-chemin dans un même update). Une fiche dont source.key a changé depuis est passée (moved) ; une fiche supprimée aussi (missing) — rollback PARTIEL accepté, compteurs renvoyés. Une édition de CONTENU n'est PAS un conflit (seuls source/reference sont restaurés). Gate recalculé sur les from/to DU RUN (jamais du body). Un run rolledback n'est pas rejouable. Un run resté applying (crash à mi-course) reste rollbackable.
+     * Constant : TRANSFER_SOURCE_ROLLBACK
+     * @param data - Données envoyées à l'API
+     * @returns Les données de réponse.
+     * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+     * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+     * @throws {Error} - En cas d'erreur inattendue.
+     */
+    transferSourceRollback(data: TransferSourceRollbackData): Promise<any>;
+    /**
+     * Historique des transferts d'appropriation : Migration d'APPROPRIATION : transfère la PROPRIÉTÉ d'un ensemble de fiches du costum `from` vers le costum `to` (source.key/keys : from → to), `from` restant en RÉFÉRENCEMENT (reference.costum += from, + annotation reference.costumTypes.<from>). Réécriture EN PLACE (_id préservé : documents/images, liens, slug, historique intacts). C'est la voie DÉDIÉE et la SEULE : les verrous historiques restent (Element::prepData jette source à l'update ; setsource add refuse set=source). Gate : super-admin OU (admin du costum `from` ET admin du costum `to`) — le cédant consent, le repreneur accepte. Action legacy née EN MIROIR du port Node (byte-parité dès la naissance). MODE HISTORY : sans migrationId, liste les runs (SANS snapshot) où `slug` est cédant ou repreneur, triés created décroissant (gate : super-admin ou admin de `slug`). Avec migrationId : le run COMPLET, snapshot inclus — c'est le téléchargement JSON de rollback côté UI (gate : super-admin ou admin d'un des deux slugs du run). Dates en secondes Unix (scalaires purs — convention byte-parité du né-en-miroir).
+     * Constant : TRANSFER_SOURCE_HISTORY
+     * @param data - Données envoyées à l'API
+     * @returns Les données de réponse.
+     * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+     * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+     * @throws {Error} - En cas d'erreur inattendue.
+     */
+    transferSourceHistory(data: TransferSourceHistoryData): Promise<any>;
     /**
      * File de modération (news + commentaires signalés) : File de modération : news et commentaires signalés (reportAbuse) non encore tranchés et non déjà modérés par l'utilisateur courant. Port de ModerateAction (vue HTML → JSON). Les commentaires dont la news parente est flaggée abus sont retirés.
      * Constant : MODERATE
@@ -1643,6 +1683,15 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     costumListValues(data: CostumListValuesData): Promise<any>;
+    /**
+     * Costum résolu d'un site : Livre le costum RÉSOLU d'un site : le document MOTEUR (`<élément>.costum.slug`, partagé — 46 sites pour reseauTierslieux) fusionné avec l'OVERLAY de l'entité porteuse, plus le contexte et le scope. COMBLE UN TROU DE getcostumjson, qui renvoie l'overlay BRUT sans le socle du moteur : 125 sites du parc sur 822 y reçoivent une configuration amputée — relief sert 1 propriété de formulaire là où il en a 26, et perd ses 15 lists. getcostumjson n'est PAS modifié (il est sous parité byte-à-byte, et sa réponse pèse ~244 Ko d'arbre CMS dont la résolution n'a que faire : 10 Ko ici). La fusion est celle de Costum::init (array_merge plat puis Costum::combine récursif), suivie du pivot `assetsSlug` = moteur / `slug` = ENTITÉ, d'où découle `sourceKey`. `typeObj` est ARBITRÉ, pas brut : après fusion, deux clés SŒURS peuvent coexister (`organization` de l'overlay et `organizations` du moteur), que le client legacy départage plus tard via le registre `typeObj.js` — chaque clé vise le slot `sameAs`, le DERNIER déclaré gagne. On applique la règle ici, une fois, plutôt que de la faire rejouer par chaque client ; `arbitrage` dit ce qui a été écarté et au profit de quoi. CHARGE UTILE EN LISTE BLANCHE : seuls `typeObj`, `lists` et `import.mapping` sortent du costum — jamais le document entier, `costum.interop` portant des secrets. Les listes ne sont PAS résolues : `costum/co/listvalues` les sert à la demande et FRAÎCHES ; on livre la DÉCLARATION `lists`, dont le client a besoin pour les `enum` (`def.list` / `def.tagsList`). Économise un aller-retour : `contextType`/`contextId` étant dans la réponse, l'appel préalable à `getElementsKey` n'est plus nécessaire.
+     * Constant : COSTUM_RESOLVED
+     * @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.
+     */
+    costumResolved(data: CostumResolvedData): Promise<any>;
     /**
      * Annuaire des communs (AAP) : Annuaire des communs AAP (port SDK de DirectoryProposalAction → Aap::globalAutocompleteProposal, citizenToolKit). Gates appliqués par le serveur : form.params.onlyAdminCanSeeList (restreint aux propres réponses + status='vote' sauf admin OU membre porteur de rôles dans les listes aapStep2.canEdit ET aapStep3.canEdit — bypass filters.formStandalone). MODE NORMAL (liste).
      * Constant : DIRECTORY_PROPOSAL

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

@@ -3145,9 +3145,11 @@ export interface AddOrganizationData {
      */
     video?: string[];
     /**
-     * Numéro de téléphone de contact
+     * Numéro de téléphone de contact — le legacy stocke un objet {mobile:[…],fixe:[…]} (mesuré : 133/133 orgs SSBE, 65/65 cyber-reunion) ; la chaîne reste acceptée
      */
-    telephone?: string;
+    telephone?: string | {
+        [k: string]: unknown;
+    };
     /**
      * Description longue (markdown supporté)
      */
@@ -6731,6 +6733,198 @@ export interface SetSourceData {
     };
     [k: string]: unknown;
 }
+export interface TransferSourceCheckData {
+    /**
+     * Slug du costum CÉDANT (propriétaire actuel des fiches).
+     */
+    from: string;
+    /**
+     * Slug du costum REPRENEUR (nouveau propriétaire). Posé automatiquement par BaseEntity (= site courant) si absent.
+     */
+    to: string;
+    /**
+     * Collection des fiches. Sous-ensemble d'ELEMENT_COLLECTIONS — jamais citoyens (profils personnels).
+     */
+    collection: "poi" | "organizations" | "projects" | "events" | "classifieds";
+    /**
+     * Sélection des fiches : {ids} OU {field,value}. L'endpoint est agnostique du cas d'usage (commune, fusion de costums, correction de provenance, fiche isolée).
+     */
+    selection: {
+        /**
+         * Sélection explicite par _id (n'importe quelle sélection UI : table, fiche isolée). Les ids passent par TOUS les contrôles. Plafond 1000 : au-delà, le form-urlencoded dépasse max_input_vars PHP (troncature silencieuse legacy) — utiliser le mode critère.
+         *
+         * @minItems 1
+         * @maxItems 1000
+         */
+        ids: [string, ...string[]];
+    } | {
+        /**
+         * Champ de sélection de masse (whitelist serveur). La requête est {source.keys: from, <field>: value}.
+         */
+        field: "address.codeInsee" | "address.level1" | "address.level3" | "address.level4" | "address.localityId" | "address.addressLocality" | "tags" | "type";
+        /**
+         * Valeur scalaire du champ (ex. codeInsee "97415").
+         */
+        value: string;
+    };
+    /**
+     * Options du geste. Défauts appliqués côté client (AJV useDefaults) ET normalisés côté serveur.
+     */
+    options?: {
+        /**
+         * true (défaut) : from reste en référencement (reference.costum += from) avec annotation éventuelle. false : transfert SEC (ni référence, ni annotation) — correction de provenance.
+         */
+        keepReference?: boolean;
+        /**
+         * Annotation reference.costumTypes.<from>. "auto" (défaut) = déduite du `type` si la sélection est homogène (sinon bloquant subTypeIndeterminable) ; "" = pas d'annotation ; sinon valeur explicite. Ignorée si keepReference=false.
+         */
+        subType?: string;
+        /**
+         * Mode réparation générique : cible les fiches DÉJÀ possédées par `to` et référencées par `from` SANS annotation ; pose uniquement reference.costumTypes.<from>. Successeur produit du --repair du script CLI.
+         */
+        annotateOnly?: boolean;
+        /**
+         * true (défaut) : purge l'auto-référencement parasite de `to` (reference.costum ∋ to, reference.costumTypes.<to>) en passe préalable — séquelle des ré-imports.
+         */
+        cleanSelfReference?: boolean;
+        /**
+         * strict (défaut) : source.keys multiples = bloquant. replace : remplace from par to DANS keys en préservant les autres clés (ex. marqueur ESS974), écriture par fiche.
+         */
+        keysPolicy?: "strict" | "replace";
+    };
+    /**
+     * Slug du costum courant (contexte). Posé automatiquement par BaseEntity.
+     */
+    costumSlug?: string;
+    /**
+     * ID de l'entité porteuse du costum courant. Optionnel.
+     */
+    costumId?: string;
+    /**
+     * Type de l'entité porteuse du costum courant. Optionnel.
+     */
+    costumType?: string;
+    [k: string]: unknown;
+}
+export interface TransferSourceApplyData {
+    /**
+     * Slug du costum CÉDANT (propriétaire actuel des fiches).
+     */
+    from: string;
+    /**
+     * Slug du costum REPRENEUR (nouveau propriétaire). Posé automatiquement par BaseEntity (= site courant) si absent.
+     */
+    to: string;
+    /**
+     * Collection des fiches. Sous-ensemble d'ELEMENT_COLLECTIONS — jamais citoyens (profils personnels).
+     */
+    collection: "poi" | "organizations" | "projects" | "events" | "classifieds";
+    /**
+     * Sélection des fiches : {ids} OU {field,value}. L'endpoint est agnostique du cas d'usage (commune, fusion de costums, correction de provenance, fiche isolée).
+     */
+    selection: {
+        /**
+         * Sélection explicite par _id (n'importe quelle sélection UI : table, fiche isolée). Les ids passent par TOUS les contrôles. Plafond 1000 : au-delà, le form-urlencoded dépasse max_input_vars PHP (troncature silencieuse legacy) — utiliser le mode critère.
+         *
+         * @minItems 1
+         * @maxItems 1000
+         */
+        ids: [string, ...string[]];
+    } | {
+        /**
+         * Champ de sélection de masse (whitelist serveur). La requête est {source.keys: from, <field>: value}.
+         */
+        field: "address.codeInsee" | "address.level1" | "address.level3" | "address.level4" | "address.localityId" | "address.addressLocality" | "tags" | "type";
+        /**
+         * Valeur scalaire du champ (ex. codeInsee "97415").
+         */
+        value: string;
+    };
+    /**
+     * Options du geste. Défauts appliqués côté client (AJV useDefaults) ET normalisés côté serveur.
+     */
+    options?: {
+        /**
+         * true (défaut) : from reste en référencement (reference.costum += from) avec annotation éventuelle. false : transfert SEC (ni référence, ni annotation) — correction de provenance.
+         */
+        keepReference?: boolean;
+        /**
+         * Annotation reference.costumTypes.<from>. "auto" (défaut) = déduite du `type` si la sélection est homogène (sinon bloquant subTypeIndeterminable) ; "" = pas d'annotation ; sinon valeur explicite. Ignorée si keepReference=false.
+         */
+        subType?: string;
+        /**
+         * Mode réparation générique : cible les fiches DÉJÀ possédées par `to` et référencées par `from` SANS annotation ; pose uniquement reference.costumTypes.<from>. Successeur produit du --repair du script CLI.
+         */
+        annotateOnly?: boolean;
+        /**
+         * true (défaut) : purge l'auto-référencement parasite de `to` (reference.costum ∋ to, reference.costumTypes.<to>) en passe préalable — séquelle des ré-imports.
+         */
+        cleanSelfReference?: boolean;
+        /**
+         * strict (défaut) : source.keys multiples = bloquant. replace : remplace from par to DANS keys en préservant les autres clés (ex. marqueur ESS974), écriture par fiche.
+         */
+        keysPolicy?: "strict" | "replace";
+    };
+    /**
+     * Compteur affiché à l'utilisateur au dry-run. Si ≠ du recomptage à l'apply → refus (selectionDrift).
+     */
+    expectedCount?: number;
+    /**
+     * Slug du costum courant (contexte). Posé automatiquement par BaseEntity.
+     */
+    costumSlug?: string;
+    /**
+     * ID de l'entité porteuse du costum courant. Optionnel.
+     */
+    costumId?: string;
+    /**
+     * Type de l'entité porteuse du costum courant. Optionnel.
+     */
+    costumType?: string;
+    [k: string]: unknown;
+}
+export interface TransferSourceRollbackData {
+    /**
+     * _id du run dans sourceMigrations (renvoyé par apply, listé par history).
+     */
+    migrationId: string;
+    /**
+     * Slug du costum courant (contexte). Posé automatiquement par BaseEntity.
+     */
+    costumSlug?: string;
+    /**
+     * Optionnel.
+     */
+    costumId?: string;
+    /**
+     * Optionnel.
+     */
+    costumType?: string;
+    [k: string]: unknown;
+}
+export interface TransferSourceHistoryData {
+    /**
+     * Slug dont on liste l'historique (cédant OU repreneur). Posé automatiquement par BaseEntity (= site courant).
+     */
+    slug: string;
+    /**
+     * Si présent : renvoie CE run complet (avec snapshot) au lieu de la liste.
+     */
+    migrationId?: string;
+    /**
+     * Slug du costum courant (contexte). Posé automatiquement par BaseEntity.
+     */
+    costumSlug?: string;
+    /**
+     * Optionnel.
+     */
+    costumId?: string;
+    /**
+     * Optionnel.
+     */
+    costumType?: string;
+    [k: string]: unknown;
+}
 export interface ModerateData {
     [k: string]: unknown;
 }
@@ -6947,6 +7141,13 @@ export interface CostumListValuesData {
     limit?: number;
     [k: string]: unknown;
 }
+export interface CostumResolvedData {
+    /**
+     * Slug du SITE (l'entité porteuse), pas celui du moteur. Ex. `relief`, pas `reseauTierslieux`.
+     */
+    slug: string;
+    [k: string]: unknown;
+}
 export interface DirectoryProposalData {
     /**
      * searchType[0] = la COLLECTION interrogée par tous les find/count (typiquement 'answers'). Obligatoire — absent = 500 legacy.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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