@communecter/cocolight-api-client 1.0.137 → 1.0.138

package/package.json

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

package/src/api/Action.ts

@@ -1,7 +1,7 @@
 import { ApiError } from "../error.js";
 import { BaseEntity } from "./BaseEntity.js";
 
-import type { CostumProjectActionRequestNewData } from "./EndpointApi.types.js";
+import type { CostumProjectActionRequestNewData, DeleteElementData } from "./EndpointApi.types.js";
 import type { ActionItemNormalized } from "./serverDataType/Action.js";
 
 /**
@@ -552,6 +552,68 @@ export class Action extends BaseEntity<ActionItemNormalized> {
     return result;
   }
 
+  /**
+   * Supprime définitivement cette Action via `DELETE_ELEMENT` (`type=actions`).
+   *
+   * **Guard** : autorisation client via `isAuthorOrAdmin({checkHierarchy: true})` :
+   *  - **auteur** de l'Action (`serverData.creator === userId`), OU
+   *  - **admin** du projet parent via la hiérarchie
+   *    (`serverData.parent[projectId]` × `userContext.links.projects[projectId].isAdmin`).
+   *
+   * Le check exploite `_isAdminViaHierarchy` (étendu à `actions` côté BaseEntity)
+   * qui remonte vers le Project parent via `serverData.parent`.
+   *
+   * **Pré-requis** :
+   *  - `userContext` (User connecté) doit avoir `serverData.links.projects` chargés
+   *    (cas `api.me()`).
+   *  - L'Action doit avoir `serverData.parent` populé (cas après `get()` ou
+   *    `project.action({id})` qui fait un get automatique).
+   *
+   * Après succès :
+   *  - `serverData` et `draftData` sont vidés (sans casser la réactivité)
+   *  - `_isDeleted = true` → toute mutation ultérieure (`save`, `updateField`, etc.) throw
+   *
+   * @param reason - Raison libre transmise au backend (audit). Défaut : `"delete action"`.
+   * @throws {ApiError} 400 si l'Action n'a pas d'id (jamais sauvegardée).
+   * @throws {ApiError} 403 si ni auteur ni admin du projet parent.
+   *
+   * @example
+   * const action = await project.action({ id: actionId });
+   * await action.delete();                    // OK si auteur OU admin projet
+   * action._isDeleted; // true
+   *
+   * @example
+   * // Raison custom (audit)
+   * await action.delete("Annulation suite à doublon (ticket #123)");
+   */
+  async delete(reason: string = "delete action"): Promise<void> {
+    if (!this.id) {
+      throw new ApiError("Vous devez fournir un id pour supprimer une Action.", 400);
+    }
+
+    // Guard : auteur OU admin du projet parent (via hiérarchie).
+    if (!this.isAuthorOrAdmin({ checkHierarchy: true })) {
+      throw new ApiError(
+        "Suppression refusée — vous devez être l'auteur de l'Action "
+        + "ou administrateur du projet parent.",
+        403
+      );
+    }
+
+    const data: DeleteElementData = {
+      reason,
+      pathParams: { type: "actions", id: this.id },
+    };
+
+    await this.callIsConnected(() => this.endpointApi.deleteElement(data));
+
+    // Vider les objets réactifs sans casser la réactivité (pattern cf. Answer.delete / Comment.delete)
+    Object.keys(this._draftData).forEach(key => delete this._draftData[key]);
+    Object.keys(this._serverData).forEach(key => delete (this._serverData as any)[key]);
+
+    this._isDeleted = true;
+  }
+
   // ───────────────────────────────────────────────────────────────────────────
   // Privés
   // ───────────────────────────────────────────────────────────────────────────

package/src/api/BaseEntity.ts

@@ -2777,7 +2777,7 @@ export class BaseEntity<TServerData = any> {
     let hierarchyField: Record<string, any> | undefined;
     if (entityType === "events") {
       hierarchyField = entityData?.organizer;
-    } else if (entityType === "projects" || entityType === "poi" || entityType === "classifieds") {
+    } else if (entityType === "projects" || entityType === "poi" || entityType === "classifieds" || entityType === "actions") {
       hierarchyField = entityData?.parent;
     } else {
       // Organizations et autres types n'ont pas de hiérarchie parent

package/types/api/Action.d.ts

@@ -281,6 +281,41 @@ export declare class Action extends BaseEntity<ActionItemNormalized> {
      * Effets : status=disabled + unset tracking.
      */
     archive(): Promise<unknown>;
+    /**
+     * Supprime définitivement cette Action via `DELETE_ELEMENT` (`type=actions`).
+     *
+     * **Guard** : autorisation client via `isAuthorOrAdmin({checkHierarchy: true})` :
+     *  - **auteur** de l'Action (`serverData.creator === userId`), OU
+     *  - **admin** du projet parent via la hiérarchie
+     *    (`serverData.parent[projectId]` × `userContext.links.projects[projectId].isAdmin`).
+     *
+     * Le check exploite `_isAdminViaHierarchy` (étendu à `actions` côté BaseEntity)
+     * qui remonte vers le Project parent via `serverData.parent`.
+     *
+     * **Pré-requis** :
+     *  - `userContext` (User connecté) doit avoir `serverData.links.projects` chargés
+     *    (cas `api.me()`).
+     *  - L'Action doit avoir `serverData.parent` populé (cas après `get()` ou
+     *    `project.action({id})` qui fait un get automatique).
+     *
+     * Après succès :
+     *  - `serverData` et `draftData` sont vidés (sans casser la réactivité)
+     *  - `_isDeleted = true` → toute mutation ultérieure (`save`, `updateField`, etc.) throw
+     *
+     * @param reason - Raison libre transmise au backend (audit). Défaut : `"delete action"`.
+     * @throws {ApiError} 400 si l'Action n'a pas d'id (jamais sauvegardée).
+     * @throws {ApiError} 403 si ni auteur ni admin du projet parent.
+     *
+     * @example
+     * const action = await project.action({ id: actionId });
+     * await action.delete();                    // OK si auteur OU admin projet
+     * action._isDeleted; // true
+     *
+     * @example
+     * // Raison custom (audit)
+     * await action.delete("Annulation suite à doublon (ticket #123)");
+     */
+    delete(reason?: string): Promise<void>;
     /**
      * Helper privé : délègue à `BaseEntity.updateField()` pour un path donné.
      * Bénéficie du normalize automatique (R0 Date → isoDate, R1 collapse setType,