@communecter/cocolight-api-client 1.0.185 → 1.0.187

package/package.json

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

package/types/api/BaseEntity.d.ts

@@ -383,8 +383,26 @@ export declare class BaseEntity<TServerData = any> {
     _isDeleted: boolean;
     /** Contexte costum porté par cette instance (null hors d'un `CostumScope`). Posé au constructeur.
      *  Sens A — « quel costum définit le SCHÉMA de cet élément » : dérivé du `source.key` (provenance),
-     *  ré-affirmé à chaque `_setData`. Gouverne draft/proxy, merge de schémas, héritage aux enfants. */
+     *  ré-affirmé à chaque `_setData` (sauf épingle, cf. `_costumCtxPinned`). Gouverne draft/proxy,
+     *  merge de schémas, héritage aux enfants. */
     _costumCtx: CostumRuntimeContext | null;
+    /**
+     * ÉPINGLE du schéma costum (sens A) : posée par `setCostumScope(slug, {pinSchema:true})` et par
+     * `loadCostumScope`, elle SUSPEND la re-dérivation de `_costumCtx` depuis `source.key` dans
+     * `_setData` — le costum ÉPINGLÉ gouverne alors la whitelist d'écriture du draft, pas la
+     * provenance. Cas d'usage : un costum ANNUAIRE (ex. navigatorDesTierslieux) édite avec SON
+     * formulaire des fiches qui ne viennent pas de lui (`source.key` étranger, hors registre, ou
+     * absent) — sans l'épingle, chacun de ces cas rejetait l'édition (`[DraftProxy] Le champ "…"
+     * n'est pas autorisé.`) alors que la CRÉATION passait, elle, par `me.costum(slug)`. Même statut
+     * que `_adminScope` : un choix EXPLICITE de l'appelant, qui survit aux refresh/hydratations.
+     *
+     * PORTÉE : l'épingle ouvre l'ÉCRITURE (whitelist du draft + enveloppe `element/save`) — elle ne
+     * change pas qui gouverne la LECTURE ailleurs (la normalisation suit toujours la provenance) :
+     * un champ écrit sous le schéma de l'annuaire reste muet hors de l'annuaire (cf.
+     * cocolight-backend docs/28 §6b, triple déclaration). Elle ne déclenche PAS les presets de
+     * création du costum épinglé. @private
+     */
+    private _costumCtxPinned;
     /**
      * Scope d'ADMINISTRATION costum — sens B : « au NOM de quel costum j'agis » (`validateGroup`,
      * `addReference`/`removeReference`/`removeFromSource`, `previewImport`/`importElements`,
@@ -404,6 +422,10 @@ export declare class BaseEntity<TServerData = any> {
         combinedSchema: any;
         transforms: TransformsMap;
         removeFields: string[];
+        /** Constantes de schéma du build — mémorisées pour REJOUER le combinedSchema quand `_costumCtx`
+         *  change APRÈS le build (épingle `pinSchema`) : sans rejeu, poser un scope est un no-op pour
+         *  l'édition (le proxy relit un combinedSchema figé au chargement). */
+        constants: string[];
     };
     static entityTag: string;
     static entityType?: string;
@@ -1070,6 +1092,25 @@ export declare class BaseEntity<TServerData = any> {
      * @private
      */
     private _extractWritableFields;
+    /**
+     * Construit le schéma COMBINÉ de la whitelist d'écriture : schémas de requête des constantes
+     * (+ VIRTUAL_SCHEMAS, $defs fusionnés) ⊕ schéma du `_costumCtx` COURANT. Extrait de
+     * `_buildDraftAndProxy` pour être REJOUABLE : quand `_costumCtx` change après le build
+     * (épingle `pinSchema`), la whitelist doit être reconstruite — sinon poser un scope est un
+     * no-op visible pour l'édition (le proxy relit un combinedSchema figé au chargement).
+     * @private
+     */
+    private _buildCombinedSchema;
+    /**
+     * ÉPINGLE le costum courant comme schéma d'ÉCRITURE (cf. `_costumCtxPinned`) et REJOUE la
+     * whitelist : reconstruit le combinedSchema depuis les constantes mémorisées au build (le
+     * `_costumCtx` a changé APRÈS `_buildDraftAndProxy`), puis SÈME les champs nouvellement ouverts
+     * dans le draft ET dans la baseline depuis `serverData` — sans ce semis, la comparaison
+     * draft/baseline les verrait tous « modifiés » (baseline `undefined`) et le save émettrait des
+     * champs intouchés. Invariant vérifié par test : `hasChanges()` reste `false` juste après la pose.
+     * @private
+     */
+    private _pinCostumSchema;
     /**
      * Construit un brouillon et un proxy à partir des données et du schéma.
      *
@@ -1876,10 +1917,17 @@ export declare class BaseEntity<TServerData = any> {
      * @param slug - Slug du costum (ex. `"equipementsSportifs974"`).
      * @param opts.costumId / opts.costumType - Identité de l'élément hôte, requise si le costum
      *   n'est pas dans le registre bundlé (résolue par le front via slug/getinfo).
+     * @param opts.pinSchema - ÉPINGLE le costum comme schéma d'ÉCRITURE (sens A) : la whitelist du
+     *   draft est REJOUÉE avec ses champs et la re-dérivation depuis `source.key` est suspendue —
+     *   pour ÉDITER, avec le formulaire d'un costum ANNUAIRE, une fiche qui ne vient pas de lui.
+     *   Défaut `false`, et ce défaut est LOAD-BEARING : `setCostumScope` est déjà appelée sur le
+     *   carrier de nombreux sites (import/export/validation via ensureCostumScope), où la provenance
+     *   doit RESTER maîtresse du schéma (contrat des sens A/B). Cf. `_costumCtxPinned`.
      */
     setCostumScope(slug: string, opts?: {
         costumId?: string;
         costumType?: string;
+        pinSchema?: boolean;
     }): void;
     /**
      * Épingle le scope d'ADMINISTRATION (sens B) SI l'identité est complète — sinon no-op : les
@@ -2012,6 +2060,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<{

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, CostumResolvedData, 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

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

@@ -6733,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;
 }