@communecter/cocolight-api-client 1.0.194 → 1.0.195

package/package.json

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

package/types/api/Action.d.ts

@@ -12,6 +12,14 @@ import type { ActionItemNormalized } from "./serverDataType/Action.js";
  * - `_add()`  : COSTUM_PROJECT_ACTION_REQUEST_NEW (parentId/parentType injectés depuis le parent)
  * - `_update()` : UPDATE_PATH_VALUE field par field via CUSTOM_FIELD_HANDLERS
  *   (pas d'endpoint dédié par bloc côté backend — on dispatche chaque champ modifié)
+ *
+ * Droits (gardes client) :
+ * - `_update()` : **auteur** (`serverData.creator`), **admin du projet parent** (via
+ *   hiérarchie), ou **contributeur assigné** (`links.contributors[userId]`) ;
+ * - `delete()`  : auteur ou admin seulement — supprimer est plus fort que corriger.
+ *
+ * Ces gardes restent indicatifs : l'autorité est le backend, qui pour l'édition accepte
+ * tout membre du projet parent (`Authorisation::canEditItem` → `canParticipate`).
  */
 export declare class Action extends BaseEntity<ActionItemNormalized> {
     static entityType: string;
@@ -263,8 +271,9 @@ export declare class Action extends BaseEntity<ActionItemNormalized> {
      * - Project : regarde `user.serverData.links.projects[projectId]` (sens user→project)
      * - Action  : regarde `action.serverData.links.contributors[userId]` (sens inverse)
      *
-     * Pour modifier des données de l'action, c'est `parent.isAdmin()` qui compte
-     * (admin du projet parent) — pas cette méthode.
+     * Être contributeur assigné suffit à MODIFIER l'action (`_update` accepte auteur,
+     * admin du projet parent, ou contributeur), mais **pas à la supprimer** : `delete()`
+     * exige auteur ou admin.
      *
      * @param options.silent si `false`, throw en cas de précondition manquante. Par défaut `true`.
      */

package/types/api/Answer.d.ts

@@ -43,6 +43,70 @@ export interface GenerateProjectResult {
 export interface GenerateMilestoneFromDepenseResult {
     milestoneId: string;
 }
+/**
+ * Statut de paiement d'une ligne de financement, dans le vocabulaire du serveur.
+ *
+ * ⚠️ `payed` (sic) est la valeur réellement écrite par `Aap::recomputeFinancerPayment`
+ * (Aap.php:7179) — ce n'est pas `paid`. Traduire à l'affichage si besoin, mais ne
+ * jamais « corriger » la valeur stockée.
+ */
+export type FinancerPaymentStatus = "unpaid" | "partial" | "payed";
+/** Un versement journalisé dans `financer[i].payment.logs[]`. */
+export interface FinancerPaymentLog {
+    invoiceId?: string;
+    financerId?: string;
+    financerName?: string;
+    finkey?: string;
+    amount?: number;
+    /** `"manual"` | `"stripe"` | `"helloasso"`. */
+    type?: string;
+    date?: unknown;
+    /** `"pending"` tant que le porteur n'a pas confirmé la réception des fonds. */
+    confirmation?: "pending" | "validated";
+    paidBy?: string;
+    validatedAt?: unknown;
+    validatedBy?: string;
+    /** Référence du prestataire de paiement, pour un encaissement en ligne. */
+    transactionId?: string;
+}
+/**
+ * Bloc `payment` d'une ligne de financement, recalculé par le serveur à chaque
+ * versement et à chaque validation.
+ *
+ * ⚠️ Seuls les logs `validated` alimentent `paidAmount` : un versement encaissé
+ * mais non confirmé figure en `pendingAmount`, et `status` reste `"unpaid"`.
+ */
+export interface FinancerPaymentBlock {
+    logs?: FinancerPaymentLog[];
+    paidAmount?: number;
+    pendingAmount?: number;
+    status?: FinancerPaymentStatus;
+}
+/** Résultat de `Answer.addFinancer()`. `finkey` est la clé stable de la ligne créée. */
+export interface AddFinancerResult {
+    depenseKey: string;
+    finkey: string;
+    finIndex?: number;
+}
+/** Résultat de `Answer.payFinancer()`. */
+export interface PayFinancerResult {
+    /** Identifiant du versement — à conserver pour le valider ensuite. */
+    invoiceId: string;
+    /** `"validated"` seulement si celui qui enregistre administre le projet receveur. */
+    confirmation: "pending" | "validated";
+    /** Bloc `payment` tel que le serveur l'a recalculé après le versement. */
+    payment?: FinancerPaymentBlock;
+}
+/** Résultat de `Answer.validateFinancerPayment()`. */
+export interface ValidateFinancerPaymentResult {
+    invoiceId: string;
+    confirmation: "validated";
+}
+/** Résultat de `Answer.deleteFinancer()`. `remaining` = financeurs restants sur la dépense. */
+export interface DeleteFinancerResult {
+    depenseKey: string;
+    remaining: number;
+}
 /** Un axe du radar multi-eval (= un input radioNew d'une step donnée). */
 export interface MultiEvalAxis {
     key: string;
@@ -272,27 +336,42 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
      *  - `serverData` et `draftData` sont vidés (sans casser la réactivité)
      *  - `_isDeleted = true` → toute mutation ultérieure (`save`, `get`, etc.) throw
      *
-     * **Guard** : autorisation côté client si l'utilisateur courant est :
+     * **Guard** (déléguée à `_deleteViaElement`) : autorisation côté client si
+     * l'utilisateur courant est :
+     *  - **super-admin**, ou **admin de costum** dont le droit a été pré-résolu par
+     *    l'appelant via `setCostumAdminAuthorized()` — parité du backend
+     *    `canDeleteElement` (`isUserSuperAdmin` puis `isCostumAdmin`) ; OU
      *  - l'**auteur** de l'Answer (`serverData.user === userId`), OU
      *  - **admin** d'un parent du Form (org/project) via la hiérarchie
-     *    (`form.serverData.parent[orgId]` × `userContext.links.memberOf[orgId].isAdmin`).
+     *    (`form.serverData.parent[orgId]` × `userContext.links.memberOf[orgId].isAdmin`),
+     *    résolue par l'override `Answer._isAdminViaHierarchy`.
      *
-     * Le check utilise `isAuthorOrAdmin({checkHierarchy: true})` qui s'appuie sur
-     * l'override `Answer._isAdminViaHierarchy` (remonte via parent instance Form).
-     *
-     * **Pré-requis** :
+     * **Pré-requis** pour la branche hiérarchie :
      *  - `this.parent` doit être un Form (cas `form.answer({id})`)
      *  - `userContext` (User connecté) doit avoir `serverData.links` chargés (cas `api.me()`)
-     * Sans ces pré-requis, seul `isAuthor` peut autoriser.
+     * Sans ces pré-requis, seuls `isAuthor` et le droit élevé peuvent autoriser.
+     *
+     * ⚠️ `isAuthor()` lit `serverData.user`, que `findanswered` REMPLACE par
+     * l'entité d'affichage (l'organisation, sur une réponse portée par une orga) ;
+     * le déposant reste dans `serverData.userId`. Sur ces réponses-là, la branche
+     * auteur ne reconnaît donc pas le véritable auteur.
+     *
+     * Le serveur reste la source de vérité dans tous les cas.
      *
      * @param reason - Raison libre transmise au backend (audit). Défaut : `"delete coform answer"`.
      * @throws {ApiError} 400 si l'Answer n'a pas d'id (jamais sauvegardée).
-     * @throws {ApiError} 403 si ni auteur ni admin du parent.
+     * @throws {ApiError} 403 si ni droit élevé, ni auteur, ni admin du parent.
      *
      * @example
      * const answer = await form.answer({ id: "..." });
      * await answer.delete();   // OK si auteur OU admin org/project parent du Form
      * answer._isDeleted; // true
+     *
+     * @example
+     * // Admin de costum : poser le droit AVANT l'appel, sinon la garde client refuse.
+     * const answer = await form.answer({ id: "..." });
+     * answer.setCostumAdminAuthorized();
+     * await answer.delete();
      */
     delete(reason?: string): Promise<void>;
     /**
@@ -440,6 +519,145 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
      * const { milestoneId } = await answer.generateMilestoneFromDepense("0");
      */
     generateMilestoneFromDepense(depenseKey: string): Promise<GenerateMilestoneFromDepenseResult>;
+    /**
+     * Traduit une réponse d'échec du dispatcher `coremuoperation` en `ApiError`.
+     *
+     * Le backend répond toujours HTTP 200 avec `{success: 0, msg}` (ou
+     * `{success: 0, content}` pour la validation du dispatcher) : sans cette
+     * traduction, un refus de droits passerait pour un succès. Le code HTTP est
+     * déduit du message, seule information que le serveur donne sur la nature du
+     * refus (`Aap.php:7285-7618`).
+     */
+    private static financerOperationError;
+    /**
+     * Ajoute une promesse de financement sur une dépense de cette Answer.
+     *
+     * L'entrée écrite dans `answers.aapStep1.depense.<depenseKey>.financer[]` est
+     * construite **par le serveur**, au format canonique : `finkey` (clé stable de
+     * la ligne), `line`, `status: "pending"` et `payment: {logs: []}`. Ne jamais
+     * fabriquer cette entrée côté client — `finkey` vient de `random_bytes` serveur,
+     * et les agrégats de `payment` sont recalculés à chaque versement.
+     *
+     * Préférer `milestoneId` à `depenseKey` : le serveur résout alors la clé
+     * lui-même, ce qui évite de confondre la **clé** du sous-document dépense
+     * (ex. `"3"`) avec sa **position** dans la liste densifiée — `depense` arrive
+     * parfois en objet à clés creuses.
+     *
+     * Constant : `COREMU_ADD_FINANCER` (POST `/co2/aap/coremuoperation/`, auth bearer —
+     * le backend lit `Yii::app()->session['userId']`, alimentée par le JWT).
+     *
+     * @param opts.financerId - Qui s'engage : soi-même, une organisation qu'on
+     *   administre, ou un tiers si l'on est porteur du projet.
+     * @param opts.amount - Montant engagé, strictement positif.
+     * @param opts.milestoneId - Jalon visé (recommandé).
+     * @param opts.depenseKey - Clé de la dépense — requise seulement sans `milestoneId`.
+     * @returns `{ depenseKey, finkey, finIndex }` — conserver `finkey` : c'est par
+     *   elle que se cible le versement.
+     * @throws {ApiError} 400 si Answer sans id, si ni `milestoneId` ni `depenseKey`
+     *   n'est fourni, ou si la dépense est introuvable.
+     * @throws {ApiError} 403 si l'on ne peut pas s'engager pour ce financeur.
+     * @throws {ApiAuthenticationError} si non connecté.
+     *
+     * @example
+     * const { finkey, depenseKey } = await answer.addFinancer({
+     *   milestoneId, financerId: me.id, amount: 1000,
+     * });
+     */
+    addFinancer(opts: {
+        financerId: string;
+        amount: number;
+        milestoneId?: string;
+        depenseKey?: string;
+    }): Promise<AddFinancerResult>;
+    /**
+     * Enregistre un versement sur une promesse de financement de cette Answer.
+     *
+     * ⚠️ Le montant n'est **comptabilisé** (`payment.paidAmount`) qu'une fois le
+     * versement validé par le porteur. Le log naît `confirmation: "validated"`
+     * seulement si celui qui enregistre administre le projet receveur ; sinon il
+     * naît `"pending"`. Un encaissement Stripe/HelloAsso par un tiers est donc
+     * réellement encaissé mais compté en `pendingAmount` jusqu'à confirmation —
+     * l'UI ne doit pas annoncer « non payé » à qui vient de régler par carte.
+     *
+     * Toujours passer `finkey` : le ciblage par position casse dès qu'une
+     * insertion concurrente décale `financer[]`.
+     *
+     * Constant : `COREMU_PAY_FINANCER` (POST `/co2/aap/coremuoperation/`, auth bearer).
+     *
+     * @param opts.amount - Montant versé. Un versement partiel est légitime.
+     * @param opts.paymentType - `"manual"` (défaut), `"stripe"` ou `"helloasso"`.
+     * @param opts.transactionId - Référence du prestataire de paiement, journalisée
+     *   avec le versement.
+     * @returns `{ invoiceId, confirmation, payment }` — `invoiceId` sert à valider
+     *   le versement ensuite.
+     * @throws {ApiError} 400 si Answer sans id ou arguments invalides ; 403 si l'on
+     *   ne peut pas verser pour ce financeur ; 404 si la ligne est introuvable.
+     * @throws {ApiAuthenticationError} si non connecté.
+     *
+     * @example
+     * const { invoiceId, payment } = await answer.payFinancer({
+     *   depenseKey, financerId, finkey, amount: 500, paymentType: "stripe",
+     * });
+     * payment.status; // "unpaid" tant que le porteur n'a pas validé
+     */
+    payFinancer(opts: {
+        depenseKey: string;
+        financerId: string;
+        amount: number;
+        finkey?: string;
+        finIndex?: number;
+        paymentType?: string;
+        transactionId?: string;
+    }): Promise<PayFinancerResult>;
+    /**
+     * Valide un versement reçu : le porteur confirme avoir touché les fonds.
+     *
+     * C'est ce passage à `validated` qui fait entrer le montant dans
+     * `payment.paidAmount` — avant lui, l'argent figure en `pendingAmount`.
+     * Réservé à l'admin du projet, à l'admin de l'organisation parente ou à un
+     * super-admin : le financeur ne valide pas son propre versement.
+     *
+     * Constant : `COREMU_VALIDATE_FINANCER_PAYMENT` (POST `/co2/aap/coremuoperation/`, auth bearer).
+     *
+     * @param opts.invoiceId - Identifiant du versement, rendu par `payFinancer`.
+     * @throws {ApiError} 400 si Answer sans id ou arguments manquants ; 403 si l'on
+     *   n'administre pas le projet ; 404 si aucun log ne porte cet `invoiceId`.
+     * @throws {ApiAuthenticationError} si non connecté.
+     *
+     * @example
+     * await answer.validateFinancerPayment({ depenseKey, invoiceId });
+     */
+    validateFinancerPayment(opts: {
+        depenseKey: string;
+        invoiceId: string;
+    }): Promise<ValidateFinancerPaymentResult>;
+    /**
+     * Retire une promesse de financement de cette Answer.
+     *
+     * **Refusé (409) dès que la ligne porte un versement**, même non validé :
+     * supprimer la promesse effacerait la trace de l'argent.
+     *
+     * Droits plus étroits que pour l'ajout : seul le financeur, ou l'admin de
+     * l'organisation financeuse, peut retirer un engagement — administrer le projet
+     * receveur ne suffit pas.
+     *
+     * Constant : `COREMU_DELETE_FINANCER` (POST `/co2/aap/coremuoperation/`, auth bearer).
+     *
+     * @returns `{ depenseKey, remaining }` — `remaining` = financeurs restants sur la dépense.
+     * @throws {ApiError} 400 si Answer sans id ou arguments manquants ; 403 si l'on
+     *   ne peut pas agir pour ce financeur ; 404 si la ligne est introuvable ;
+     *   409 si un versement y est déjà rattaché.
+     * @throws {ApiAuthenticationError} si non connecté.
+     *
+     * @example
+     * const { remaining } = await answer.deleteFinancer({ depenseKey, financerId, finkey });
+     */
+    deleteFinancer(opts: {
+        depenseKey: string;
+        financerId: string;
+        finkey?: string;
+        finIndex?: number;
+    }): Promise<DeleteFinancerResult>;
     /**
      * Récupère les datasets agrégés des évaluations multiples (radar) de cette
      * Answer. Pour une réponse partagée contenant des inputs `radioNew` avec

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, ContactSendData, 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, NavigatorGetRessourceTlData, 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, GenerateProjectFromAnswerData, GenerateMilestoneFromDepenseData, 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";
+import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, ContactSendData, 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, NavigatorGetRessourceTlData, 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, GenerateProjectFromAnswerData, GenerateMilestoneFromDepenseData, FundingEnvelopeData, CoremuOperationData, CoremuAddFinancerData, CoremuPayFinancerData, CoremuValidateFinancerPaymentData, CoremuDeleteFinancerData, 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
  */
@@ -1380,6 +1380,46 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     coremuOperation(data: CoremuOperationData): Promise<any>;
+    /**
+     * Ajouter une promesse de financement sur une dépense : Crée un engagement de financement dans answers.aapStep1.depense.<depenseKey>.financer[] au format canonique : {line:'', amount, user, date, name, id, type, status:'pending', finkey, payment:{logs:[]}}. La `finkey` (clé stable de la ligne) et le nom/type du financeur sont résolus SERVEUR — ne jamais les envoyer. Aap::addFinancerEngagement (Aap.php:7285-7362). Droits : financeur lui-même, admin de l'organisation financeuse, ou porteur du projet (Aap.php:7313). Dispatch : CoremuOperationAction.php:175-186 (switch sur $_POST['action']), route déclarée dans modules/co2/controllers/AapController.php:74. auth bearer : le backend lit Yii::app()->session['userId'], alimentée par le JWT via CommunecterController::beforeAction → Authorisation::isJwtconnected → Person::saveUserSessionData.
+     * Constant : COREMU_ADD_FINANCER
+     * @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.
+     */
+    coremuAddFinancer(data: CoremuAddFinancerData): Promise<any>;
+    /**
+     * Enregistrer un versement sur une promesse de financement : Pousse un log dans financer[i].payment.logs[] et recalcule paidAmount/pendingAmount/status. `invoiceId` est généré serveur ('FIN-'+YmdHis+'-'+5 premiers car. du financerId). Le log naît confirmation:'validated' si le payeur administre le projet receveur, sinon 'pending' — un encaissement Stripe/HelloAsso par un tiers reste donc en attente de confirmation du porteur, et n'entre PAS dans paidAmount tant qu'il n'est pas validé. Aap::payFinancerEngagement (Aap.php:7468-7562). Dispatch : CoremuOperationAction.php:175-186 (switch sur $_POST['action']), route déclarée dans modules/co2/controllers/AapController.php:74. auth bearer : le backend lit Yii::app()->session['userId'], alimentée par le JWT via CommunecterController::beforeAction → Authorisation::isJwtconnected → Person::saveUserSessionData.
+     * Constant : COREMU_PAY_FINANCER
+     * @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.
+     */
+    coremuPayFinancer(data: CoremuPayFinancerData): Promise<any>;
+    /**
+     * Valider un versement reçu sur une promesse de financement : Le porteur confirme avoir reçu les fonds : passe le log d'`invoiceId` à confirmation:'validated', pose validatedAt/validatedBy, puis recalcule le bloc payment — c'est ce passage qui fait entrer le montant dans paidAmount. Réservé à l'admin du projet, l'admin de l'organisation parente ou un super-admin (Aap.php:7577). Aap::validateFinancerPayment (Aap.php:7559-7618). Dispatch : CoremuOperationAction.php:175-186 (switch sur $_POST['action']), route déclarée dans modules/co2/controllers/AapController.php:74. auth bearer : le backend lit Yii::app()->session['userId'], alimentée par le JWT via CommunecterController::beforeAction → Authorisation::isJwtconnected → Person::saveUserSessionData.
+     * Constant : COREMU_VALIDATE_FINANCER_PAYMENT
+     * @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.
+     */
+    coremuValidateFinancerPayment(data: CoremuValidateFinancerPaymentData): Promise<any>;
+    /**
+     * Retirer une promesse de financement : Retire un engagement de financer[]. REFUSÉ si la ligne porte le moindre versement, même non validé : effacer la promesse effacerait la trace de l'argent (Aap.php:7408-7414). Droits plus étroits que pour l'ajout — seul le financeur ou l'admin de l'organisation financeuse peut retirer ; administrer le projet receveur ne suffit PAS (Aap.php:7404). Aap::deleteFinancerEngagement (Aap.php:7377-7430). Dispatch : CoremuOperationAction.php:175-186 (switch sur $_POST['action']), route déclarée dans modules/co2/controllers/AapController.php:74. auth bearer : le backend lit Yii::app()->session['userId'], alimentée par le JWT via CommunecterController::beforeAction → Authorisation::isJwtconnected → Person::saveUserSessionData.
+     * Constant : COREMU_DELETE_FINANCER
+     * @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.
+     */
+    coremuDeleteFinancer(data: CoremuDeleteFinancerData): Promise<any>;
     /**
      * Ajouter nouvel action : Crée une nouvelle action rattachée à un projet.
      * Constant : COSTUM_PROJECT_ACTION_REQUEST_NEW

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

@@ -6765,6 +6765,109 @@ export interface CoremuOperationData {
     project: string;
     [k: string]: unknown;
 }
+export interface CoremuAddFinancerData {
+    /**
+     * Action du dispatcher.
+     */
+    action: "addFinancer";
+    /**
+     * ID de la réponse (collection answers) portant la dépense.
+     */
+    answer: string;
+    /**
+     * Jalon visé. PRÉFÉRER ce champ à `depenseKey` : le serveur résout la clé lui-même (findDepenseKeyForMilestone, Aap.php:7436-7456), ce qui évite le piège position/clé du tableau `depense`.
+     */
+    milestoneId?: string;
+    /**
+     * Clé du sous-document dépense — la CLÉ Mongo (ex. "3"), PAS la position dans la liste densifiée. Requis seulement si `milestoneId` est absent (dépense orpheline).
+     */
+    depenseKey?: string;
+    /**
+     * ID du financeur (citoyen, organisation ou projet).
+     */
+    financerId: string;
+    /**
+     * Montant engagé, strictement positif.
+     */
+    amount: number;
+    [k: string]: unknown;
+}
+export interface CoremuPayFinancerData {
+    action: "payFinancer";
+    /**
+     * ID de la réponse portant la dépense.
+     */
+    answer: string;
+    /**
+     * Clé du sous-document dépense (CLÉ Mongo, pas la position).
+     */
+    depenseKey: string;
+    /**
+     * ID du financeur dont on règle l'engagement.
+     */
+    financerId: string;
+    /**
+     * Clé stable de la ligne visée — TOUJOURS l'envoyer. Le ciblage par position (`finIndex`) casse dès qu'une insertion concurrente décale le tableau. Résolution : finIndex → finkey → premier id (Aap.php:7131-7152).
+     */
+    finkey?: string;
+    /**
+     * Position dans financer[] — repli pour les lignes antérieures à `finkey`.
+     */
+    finIndex?: number;
+    /**
+     * Montant versé, strictement positif.
+     */
+    amount: number;
+    /**
+     * Moyen du versement : 'manual' (défaut), 'stripe', 'helloasso'.
+     */
+    payment_type?: string;
+    /**
+     * Référence du prestataire de paiement, journalisée avec le versement. Optionnelle — sans objet pour un versement manuel.
+     */
+    transactionId?: string;
+    [k: string]: unknown;
+}
+export interface CoremuValidateFinancerPaymentData {
+    action: "validateFinancerPayment";
+    /**
+     * ID de la réponse portant la dépense.
+     */
+    answer: string;
+    /**
+     * Clé du sous-document dépense (CLÉ Mongo, pas la position).
+     */
+    depenseKey: string;
+    /**
+     * Identifiant du versement à valider, rendu par payFinancer.
+     */
+    invoiceId: string;
+    [k: string]: unknown;
+}
+export interface CoremuDeleteFinancerData {
+    action: "deleteFinancer";
+    /**
+     * ID de la réponse portant la dépense.
+     */
+    answer: string;
+    /**
+     * Clé du sous-document dépense (CLÉ Mongo, pas la position).
+     */
+    depenseKey: string;
+    /**
+     * ID du financeur dont on retire l'engagement.
+     */
+    financerId: string;
+    /**
+     * Clé stable de la ligne visée — à envoyer dès qu'elle existe.
+     */
+    finkey?: string;
+    /**
+     * Position — repli pour les lignes sans `finkey`.
+     */
+    finIndex?: number;
+    [k: string]: unknown;
+}
 export interface CostumProjectActionRequestNewData {
     /**
      * Nom de l'action