@communecter/cocolight-api-client 1.0.129 → 1.0.131

package/src/index.ts

@@ -1,5 +1,5 @@
 import { BaseEntity } from "./api/BaseEntity.js";
-import { fromEntityJSON } from "./api/EntityRegistry.js";
+import { fromEntityJSON, reviveEntities } from "./api/EntityRegistry.js";
 import Api from "./Api.js";
 import ApiClient from "./ApiClient.js";
 import * as error from "./error.js";
@@ -33,6 +33,7 @@ const cocolightApiClient = {
   },
   helper: {
     fromEntityJSON,
+    reviveEntities,
     restorePaginationFromJSON: BaseEntity.restorePaginationFromJSON
   },
   OfflineClientManager

package/types/api/Action.d.ts

@@ -8,15 +8,139 @@ import type { ActionItemNormalized } from "./serverDataType/Action.js";
  * S'instancie via `project.action(...)` plutôt que directement.
  *
  * Endpoints utilisés :
- * - `get()` : hérité (GET_ELEMENTS_ABOUT via `/co2/element/about/type/actions/id/{id}`)
- * - `_add()` : COSTUM_PROJECT_ACTION_REQUEST_NEW (parentId/parentType injectés depuis le parent)
+ * - `get()`   : hérité (GET_ELEMENTS_ABOUT via `/co2/element/about/type/actions/id/{id}`)
+ * - `_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é)
  */
 export declare class Action extends BaseEntity<ActionItemNormalized> {
     static entityType: string;
     static entityTag: string;
     static SCHEMA_CONSTANTS: string[];
+    /**
+     * Schémas virtuels : enregistrent les champs éditables auprès du draft proxy
+     * via _composeAllowedFields. Aucun endpoint backend réel — l'update passe par
+     * UPDATE_PATH_VALUE field par field.
+     */
+    static VIRTUAL_SCHEMAS: {
+        VIRTUAL_ACTION_EDITABLE: {
+            type: string;
+            properties: {
+                name: {
+                    type: string;
+                };
+                credits: {
+                    type: string;
+                };
+                min: {
+                    type: string;
+                    minimum: number;
+                };
+                max: {
+                    type: string;
+                    minimum: number;
+                };
+                status: {
+                    type: string;
+                    enum: string[];
+                };
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                links: {
+                    type: string;
+                };
+                startDate: {
+                    oneOf: {
+                        type: string;
+                    }[];
+                };
+                endDate: {
+                    oneOf: {
+                        type: string;
+                    }[];
+                };
+                milestone: {
+                    oneOf: {
+                        type: string;
+                    }[];
+                };
+                importance: {
+                    type: string;
+                };
+            };
+        };
+    };
     static ADD_BLOCKS: Map<"COSTUM_PROJECT_ACTION_REQUEST_NEW", "addAction">;
+    /**
+     * Champs éditables → méthode publique qui réalise l'update (via UPDATE_PATH_VALUE).
+     * Même pattern qu'Organization.openingHours : chaque field nom → method name.
+     * Les `updateXxx` méthodes ci-dessous délèguent toutes à `_updatePath`.
+     */
+    static CUSTOM_FIELD_HANDLERS: Map<"name" | "tags" | "startDate" | "endDate" | "links" | "status" | "credits" | "milestone" | "min" | "max" | "importance", {
+        readonly updateMethod: "updateName";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateCredits";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateMin";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateMax";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateStatus";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateTags";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateContributors";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateStartDate";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateEndDate";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateMilestone";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    } | {
+        readonly updateMethod: "updateImportance";
+        readonly schemaConstant: "VIRTUAL_ACTION_EDITABLE";
+    }>;
+    /**
+     * Champs présents dans le schéma de création (donc writable dans le draft) mais
+     * **non modifiables après création** — soit pas exposés en update backend, soit
+     * gérés par un autre flow.
+     *
+     * Si un caller modifie un de ces champs après get() puis save(), `_update` throw
+     * avec un message d'aide indiquant la voie alternative. Sans cette garde, le
+     * changement serait silencieusement ignoré.
+     */
+    private static CREATE_ONLY_FIELDS;
+    /**
+     * Slot UPDATE_BLOCKS vide pour l'instant : aucun endpoint dédié côté backend.
+     * Préservé pour cohérence structurelle avec Organization/Project — quand un endpoint
+     * `UPDATE_BLOCK_ACTION_XXX` arrivera, il s'ajoutera ici sans toucher au flow.
+     */
+    static UPDATE_BLOCKS: Map<string, string>;
+    /**
+     * `parentType` est injecté au payload de création (required par le schéma
+     * COSTUM_PROJECT_ACTION_REQUEST_NEW). `_add` ne filtre pas avec removeFields,
+     * donc il passe bien à la requête. Reste défensif si AJV `useDefaults` change.
+     */
     defaultFields: Record<string, any>;
+    /**
+     * Champs techniques exclus du draft writable (set au moment de la création,
+     * jamais modifiables ensuite par le caller). Restent accessibles en lecture
+     * via `action.serverData.parentId` / `.parentType`.
+     */
     removeFields: string[];
     _add: (payload: Record<string, any>) => Promise<void>;
     /**
@@ -24,4 +148,153 @@ export declare class Action extends BaseEntity<ActionItemNormalized> {
      * Méthode de bas niveau — utiliser `save()` après modification du draft à la place.
      */
     addAction(data?: Partial<CostumProjectActionRequestNewData>): Promise<unknown>;
+    _update: (payload: Record<string, any>) => Promise<boolean>;
+    updateName(value: string): Promise<unknown>;
+    /**
+     * Met à jour `credits` (entier). `setType: "int"` force le cast côté backend
+     * (form-urlencoded transmet en string sinon).
+     */
+    updateCredits(value: number): Promise<unknown>;
+    /** Met à jour `min` (entier ≥ 0). `setType: "int"`. */
+    updateMin(value: number): Promise<unknown>;
+    /** Met à jour `max` (entier ≥ 0). `setType: "int"`. */
+    updateMax(value: number): Promise<unknown>;
+    /**
+     * Change le statut de l'action via l'endpoint dédié backend `set_status`.
+     *
+     * **PAS via UPDATE_PATH_VALUE** : utiliser cet endpoint préserve la logique métier
+     * critique :
+     * - Ajoute une entrée dans `updateStatus[]` (historique des changements)
+     * - Auto endDate=now si status="done", auto startDate=now si "tracking"
+     * - Auto-purge des tags discuter/totest/next à la transition
+     * - Auto-set du tag pour discuter/next/totest (alias de "todo")
+     * - Notification Rocket.Chat au projet parent
+     *
+     * Statuses supportés côté backend : todo, done, tracking, discuter, next, totest, disabled, closed.
+     */
+    updateStatus(value: "todo" | "done" | "tracking" | "discuter" | "next" | "totest" | "disabled" | "closed"): Promise<unknown>;
+    updateTags(value: string[]): Promise<unknown>;
+    /**
+     * Met à jour `importance` ("low" / "medium" / "high" / autres valeurs custom).
+     * Champ simple sans effets de bord backend connus.
+     */
+    updateImportance(value: string): Promise<unknown>;
+    /**
+     * Remplace la liste complète des contributeurs via l'endpoint dédié `set_contributors`.
+     *
+     * **Sécurité** : touche plusieurs users → réservé aux admins du projet parent.
+     *
+     * Avantages vs UPDATE_PATH_VALUE :
+     * - Validation min/max côté backend (refus si hors bornes)
+     * - Notification socket aux autres clients (.set-contributors, .cd-int-contributors)
+     * - Réponse enrichie avec name/image des contributeurs
+     *
+     * @param value objet `{ contributors: { userId: {...} } }` — on extrait juste les keys (userIds).
+     *   Les méta (type, isAdmin, name) sont gérées côté backend (type="citoyens" par défaut).
+     *   Pour vider : passer `{ contributors: {} }`.
+     */
+    updateContributors(value: {
+        contributors?: Record<string, unknown>;
+    }): Promise<unknown>;
+    /**
+     * Ajoute un user comme contributeur de l'action (mode "join").
+     * Préserve les autres contributeurs existants.
+     *
+     * **Sécurité** :
+     * - Sans argument (ou userId = soi-même) → autorisé pour tout user connecté ("je participe")
+     * - Avec un autre userId → réservé aux admins du projet parent ("j'ajoute X")
+     *
+     * @param userId userId à ajouter. Par défaut : l'utilisateur connecté.
+     */
+    joinContributor(userId?: string): Promise<unknown>;
+    /**
+     * Retire un user de la liste des contributeurs (mode "quit").
+     * Préserve les autres contributeurs existants.
+     *
+     * **Sécurité** :
+     * - Sans argument (ou userId = soi-même) → autorisé pour tout user connecté ("je quitte")
+     * - Avec un autre userId → réservé aux admins du projet parent ("je retire X")
+     *
+     * @param userId userId à retirer. Par défaut : l'utilisateur connecté.
+     */
+    leaveContributor(userId?: string): Promise<unknown>;
+    /**
+     * Vérifie que l'utilisateur connecté est admin du projet parent — requis pour les
+     * mutations affectant des tiers (replace bulk ou agir sur un autre userId).
+     */
+    private _assertParentAdminForContributorMutation;
+    /**
+     * Met à jour ou efface le milestone d'une action.
+     * - `{ milestoneId }` : attache (validé via `Project.hasMilestone`).
+     * - `null` : détache via `$unset` Mongo côté backend.
+     *
+     * **Détail technique de l'effacement** :
+     * Le backend (`Element::updatePathValue`) fait `$verb = '$unset'` quand `$value === null`.
+     * Notre SDK strip les `null` avant l'envoi (`stripNullsInPlace`), donc on contourne en
+     * envoyant la chaîne vide `""` : la coercion PHP `(!empty($value) || $value == "0" || $value === false)`
+     * la transforme en `null` → `$unset`. Bonus : évite aussi le bug backend
+     * `"text" => $_POST["value"]` (accès direct, crash si value absent).
+     *
+     * NOTE: changer/effacer le milestone peut avoir des effets de bord côté backend non
+     * gérés (compteurs par milestone, idParentRoom, statuts dérivés). À utiliser avec discernement.
+     */
+    updateMilestone(value: {
+        milestoneId: string;
+    } | null): Promise<unknown>;
+    /**
+     * Met à jour startDate via l'endpoint dédié `set_date`.
+     *
+     * Utilise `set_date` plutôt qu'UPDATE_PATH_VALUE car :
+     * - Support natif de l'effacement : `null` → envoyer "" → backend fait `$unset`
+     * - Parser de date robuste côté backend (vs notre validation client-side)
+     *
+     * @param value chaîne ISO 8601 ("2026-05-20T08:00:00.000Z") ou null pour effacer.
+     */
+    updateStartDate(value: string | null): Promise<unknown>;
+    /**
+     * Met à jour endDate via l'endpoint dédié `set_date`.
+     * @param value chaîne ISO 8601 ou null pour effacer.
+     */
+    updateEndDate(value: string | null): Promise<unknown>;
+    /**
+     * Vérifie si l'utilisateur connecté est contributeur de CETTE action.
+     *
+     * Override la version de BaseEntity car la sémantique diffère :
+     * - 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.
+     *
+     * @param options.silent si `false`, throw en cas de précondition manquante. Par défaut `true`.
+     */
+    isContributor(options?: {
+        silent?: boolean;
+    }): boolean;
+    /**
+     * Annule l'action via l'endpoint dédié `cancel`.
+     * Effets : status=closed + unset tracking + retire le tag "totest".
+     */
+    cancel(): Promise<unknown>;
+    /**
+     * Archive l'action via l'endpoint dédié `archive`.
+     * Effets : status=disabled + unset tracking.
+     */
+    archive(): Promise<unknown>;
+    /**
+     * Helper privé : envoie un UPDATE_PATH_VALUE pour un path donné.
+     */
+    private _updatePath;
+    /**
+     * Validation stricte int (refus float, NaN, etc.).
+     */
+    private _assertInt;
+    /**
+     * Validation stricte ISO 8601 (refus DD/MM/YYYY, "5 août", etc.). `null` accepté (clear).
+     */
+    private _assertIsoDate;
+    /**
+     * Vérifie un format ISO 8601 date-time strict (avec T et option timezone Z ou ±HH:MM).
+     */
+    private _isIsoDateTime;
 }

package/types/api/BaseEntity.d.ts

@@ -317,6 +317,23 @@ export declare class BaseEntity<TServerData = any> {
      * @returns Données mises à jour
      */
     refresh(): Promise<Record<string, any>>;
+    /**
+     * Helper pour les entités enfants : refresh automatique APRÈS une mutation directe
+     * (méthode appelée hors flow `save()`). Skip si l'appel vient de `save()` qui refresh
+     * lui-même à la fin — détecté via le flag `_calledFromSave`.
+     *
+     * À appeler dans les méthodes publiques de mutation (ex: `Action.cancel()`,
+     * `Organization.updateOpeningHours()`) après l'opération réussie, pour que le caller
+     * trouve `entity.serverData` à jour sans avoir à appeler `refresh()` manuellement.
+     *
+     * @example
+     * async myMutation(): Promise<unknown> {
+     *   const result = await this.endpointApi.someEndpoint({ ... });
+     *   await this._refreshIfDirect();
+     *   return result;
+     * }
+     */
+    protected _refreshIfDirect(): Promise<void>;
     /**
      * Sauvegarde les modifications locales vers le serveur (add ou update).
      * @returns Données serveur mises à jour (après éventuel `refresh()`)

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, SaveCoformAnswerData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData } from "./EndpointApi.types.js";
+import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, SaveCoformAnswerData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1181,6 +1181,56 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     costumProjectActionRequestNew(data: CostumProjectActionRequestNewData): Promise<any>;
+    /**
+     * Change le statut d'une action (avec logique métier) : Change le status d'une action via l'endpoint dédié backend. Ajoute une entrée à updateStatus[], gère les tags (discuter/totest/next), auto-injecte startDate/endDate selon le status, gère tracking, envoie une notification Rocket.Chat au parent. NE PAS confondre avec UPDATE_PATH_VALUE qui bypass toute cette logique.
+     * Constant : COSTUM_PROJECT_ACTION_REQUEST_SET_STATUS
+     * @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.
+     */
+    costumProjectActionRequestSetStatus(data: CostumProjectActionRequestSetStatusData): Promise<any>;
+    /**
+     * Met à jour les dates d'une action : Met à jour startDate et/ou endDate d'une action via l'endpoint dédié. Supporte nativement l'effacement (envoyer chaîne vide → $unset). Parser de date robuste côté backend.
+     * Constant : COSTUM_PROJECT_ACTION_REQUEST_SET_DATE
+     * @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.
+     */
+    costumProjectActionRequestSetDate(data: CostumProjectActionRequestSetDateData): Promise<any>;
+    /**
+     * Définit les contributeurs d'une action : Modifie links.contributors d'une action via 3 modes : (A) `contributors` array de userIds = remplace toute la liste ; (B) `contributor` + `participate=1` = ajoute un user ; (C) `contributor` + `participate=0` = retire un user. Valide les bornes `min`/`max` côté backend. Émet `.set-contributors{parentId}` et `.cd-int-contributors` aux clients socket.
+     * Constant : COSTUM_PROJECT_ACTION_REQUEST_SET_CONTRIBUTORS
+     * @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.
+     */
+    costumProjectActionRequestSetContributors(data: CostumProjectActionRequestSetContributorsData): Promise<any>;
+    /**
+     * Annule une action : Annule une action : status=closed + unset tracking + retire le tag 'totest'.
+     * Constant : COSTUM_PROJECT_ACTION_REQUEST_CANCEL
+     * @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.
+     */
+    costumProjectActionRequestCancel(data: CostumProjectActionRequestCancelData): Promise<any>;
+    /**
+     * Archive une action : Archive une action : status=disabled + unset tracking.
+     * Constant : COSTUM_PROJECT_ACTION_REQUEST_ARCHIVE
+     * @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.
+     */
+    costumProjectActionRequestArchive(data: CostumProjectActionRequestArchiveData): Promise<any>;
     /**
      * Interoperabilité Discourse Lié un compte : Lier un compte Discourse
      * Constant : LINK_DISCOURSE_ACCOUNT

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

@@ -5145,6 +5145,69 @@ export interface CostumProjectActionRequestNewData {
     tags?: string[];
     [k: string]: unknown;
 }
+export interface CostumProjectActionRequestSetStatusData {
+    /**
+     * ID de l'action
+     */
+    id: string;
+    /**
+     * Nouveau statut. Triggers backend : 'done' set endDate=now, 'tracking' set startDate=now+tracking:true, 'discuter'/'next'/'totest' ajoutent un tag et forcent status='todo', 'todo' unset startDate/endDate, 'closed' purge les tags discuter/totest/next, 'disabled' unset tracking.
+     */
+    status: "todo" | "done" | "tracking" | "discuter" | "next" | "totest" | "disabled" | "closed";
+    /**
+     * Optionnel : userId qui effectue le changement (utilisé pour updateStatus[].author et notification RC). Par défaut session userId.
+     */
+    user?: string;
+    [k: string]: unknown;
+}
+export interface CostumProjectActionRequestSetDateData {
+    /**
+     * ID de l'action
+     */
+    id: string;
+    /**
+     * Date de début ISO 8601, ou chaîne vide pour effacer ($unset)
+     */
+    startDate?: string;
+    /**
+     * Date de fin ISO 8601, ou chaîne vide pour effacer ($unset)
+     */
+    endDate?: string;
+    [k: string]: unknown;
+}
+export interface CostumProjectActionRequestSetContributorsData {
+    /**
+     * ID de l'action (côté backend lu via $_POST['action'], pas 'id')
+     */
+    action: string;
+    /**
+     * Mode A : remplace la liste complète des contributeurs par cet array de userIds.
+     */
+    contributors?: string[];
+    /**
+     * Mode B/C : userId à ajouter (participate=1) ou retirer (participate=0).
+     */
+    contributor?: string;
+    /**
+     * Mode B/C : 1=join, 0=quit. Couplé avec `contributor`.
+     */
+    participate?: 0 | 1;
+    [k: string]: unknown;
+}
+export interface CostumProjectActionRequestCancelData {
+    /**
+     * ID de l'action à annuler
+     */
+    id: string;
+    [k: string]: unknown;
+}
+export interface CostumProjectActionRequestArchiveData {
+    /**
+     * ID de l'action à archiver
+     */
+    id: string;
+    [k: string]: unknown;
+}
 export interface LinkDiscourseAccountData {
     /**
      * Nom d'utilisateur du compte Discourse

package/types/api/EntityRegistry.d.ts

@@ -17,6 +17,27 @@ export declare function registerEntity(tag: EntityTag, EntityClass: EntityClass)
  * Si la collection ou la métadonnée d'entité est absente, renvoie l'objet d'origine.
  */
 export declare function fromEntityJSON(json: unknown, parent?: ApiClient | BaseEntity | null): BaseEntity | unknown | null;
+/**
+ * Walker récursif : parcourt un objet/tableau et ressuscite toutes les entités
+ * sérialisées (marqueurs `__isSerializedEntity` / `__entityTag`) rencontrées.
+ *
+ * Pensé pour les wrappers non-entité retournés par certains endpoints (ex: `fundingEnvelope`)
+ * ou pour réhydrater un état côté client après un transfert JSON (SSR, cache restore).
+ *
+ * Dates, RegExp et primitives sont préservées. Pour les entités, la chaîne de parents
+ * est reconstruite automatiquement depuis les méta embarquées par `toJSON()`.
+ *
+ * @param obj - L'objet à parcourir (wrapper, array, primitive…)
+ * @param parent - Parent racine (typiquement l'ApiClient côté client)
+ * @returns L'objet avec toutes les entités revived
+ *
+ * @example
+ * // Côté client SSR : revive l'état dehydraté
+ * const apiClient = new ApiClient({ baseURL });
+ * const envelope = reviveEntities(window.__INIT__.envelope, apiClient);
+ * envelope.projects[0].serverData.actions[0]; // Action instance
+ */
+export declare function reviveEntities<T = unknown>(obj: unknown, parent?: ApiClient | BaseEntity | null): T;
 /**
  * Crée une instance d'entité basée sur le seul nom de la collection.
  */

package/types/api/Project.d.ts

@@ -142,6 +142,14 @@ export declare class Project extends BaseEntity<ProjectItemNormalized> {
      * Crée une instance de news et la récupère si nécessaire.
      */
     news(newsData?: Parameters<BaseEntity<ProjectItemNormalized>["news"]>[0]): Promise<import("./News.js").News>;
+    /**
+     * Vérifie qu'un milestoneId existe dans `serverData.oceco.milestones[]`.
+     * Sert à valider une référence avant d'attacher une entité (Action) à un milestone.
+     *
+     * @param milestoneId - L'ID du milestone à chercher.
+     * @returns `true` si trouvé, `false` sinon (y compris si oceco/milestones absents).
+     */
+    hasMilestone(milestoneId: string): boolean;
     /**
      * {@inheritDoc BaseEntity#action}
      *