@communecter/cocolight-api-client 1.0.137 → 1.0.139

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.137",
+    "version": "1.0.139",
     "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/src/api/Organization.ts

@@ -26,7 +26,8 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
     "UPDATE_BLOCK_LOCALITY",
     "UPDATE_BLOCK_SLUG",
     "PROFIL_IMAGE",
-    "VIRTUAL_OPENING_HOURS"
+    "VIRTUAL_OPENING_HOURS",
+    "VIRTUAL_ORG_TIERS_LIEU_FIELDS"
   ];
 
   static override VIRTUAL_SCHEMAS = {
@@ -81,6 +82,27 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
           }
         }
       }
+    },
+    /**
+     * Champs custom tiers-lieu — enregistrent les champs éditables côté draft proxy
+     * via _composeAllowedFields. Aucun endpoint UPDATE_BLOCK_* ne couvre ces champs
+     * côté backend ; chaque champ est dispatché via UPDATE_PATH_VALUE (cf. updateField()).
+     *
+     * Même pattern qu'Action.ts/VIRTUAL_ACTION_EDITABLE : déclaration uniquement pour
+     * autoriser l'écriture sur le draft. Le persiste réel se fait via CUSTOM_FIELD_HANDLERS.
+     */
+    VIRTUAL_ORG_TIERS_LIEU_FIELDS: {
+      type: "object",
+      properties: {
+        holderOrganization:  { type: "string" },
+        manageModel:         { type: "string" },
+        typePlace:           { type: "string" },
+        buildingSurfaceArea: { type: "number" },
+        siteSurfaceArea:     { type: "number" },
+        openingDate:         { type: "string" },
+        telephone:           { type: "string" },
+        video:               { type: "array", items: { type: "string" } }
+      }
     }
   };
 
@@ -88,7 +110,15 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
     ["openingHours", {
       updateMethod: "updateOpeningHours",
       schemaConstant: "VIRTUAL_OPENING_HOURS"
-    }]
+    }],
+    ["holderOrganization",  { updateMethod: "updateHolderOrganization",  schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS" }],
+    ["manageModel",         { updateMethod: "updateManageModel",         schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS" }],
+    ["typePlace",           { updateMethod: "updateTypePlace",           schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS" }],
+    ["buildingSurfaceArea", { updateMethod: "updateBuildingSurfaceArea", schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS" }],
+    ["siteSurfaceArea",     { updateMethod: "updateSiteSurfaceArea",     schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS" }],
+    ["openingDate",         { updateMethod: "updateOpeningDate",         schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS" }],
+    ["telephone",           { updateMethod: "updateTelephone",           schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS" }],
+    ["video",               { updateMethod: "updateVideo",               schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS" }]
   ] as const);
 
   static ADD_BLOCKS = new Map([
@@ -518,6 +548,88 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
     return result;
   }
 
+  /**
+   * ───────────────────────────────
+   *  Champs custom tiers-lieu (navigatorDesTierslieux, etc.)
+   *
+   *  Tous les champs ci-dessous sont dispatched via UPDATE_PATH_VALUE car aucun
+   *  endpoint UPDATE_BLOCK_* côté backend ne les couvre. Sans ces méthodes, le
+   *  flow `org.data.X = Y` + `save()` les drop silencieusement (les schémas de
+   *  UPDATE_BLOCK_INFO/DESCRIPTION/SOCIAL/LOCALITY filtrent strictement).
+   *
+   *  Pattern identique à Action.ts (CUSTOM_FIELD_HANDLERS → updateXxx → updateField).
+   *  Voir tests/integration/advanced/tiers-lieux-save-fields.test.ts pour la preuve.
+   * ───────────────────────────────
+   */
+
+  /** Met à jour `holderOrganization` (nom de la structure porteuse). */
+  async updateHolderOrganization(value: string): Promise<unknown> {
+    const result = await this.updateField("holderOrganization", value);
+    await this._refreshIfDirect();
+    return result;
+  }
+
+  /** Met à jour `manageModel` (mode de gestion : association, SCIC, SCOP, etc.). */
+  async updateManageModel(value: string): Promise<unknown> {
+    const result = await this.updateField("manageModel", value);
+    await this._refreshIfDirect();
+    return result;
+  }
+
+  /**
+   * Met à jour `typePlace` (famille(s) de tiers-lieux).
+   * Format : string CSV "label1, label2" (le backend stocke tel quel).
+   */
+  async updateTypePlace(value: string): Promise<unknown> {
+    const result = await this.updateField("typePlace", value);
+    await this._refreshIfDirect();
+    return result;
+  }
+
+  /** Met à jour `buildingSurfaceArea` (surface bâtie en m²). `setType: "int"` force le cast. */
+  async updateBuildingSurfaceArea(value: number): Promise<unknown> {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+      throw new ApiError(`buildingSurfaceArea: attendu nombre fini. Reçu: ${JSON.stringify(value)}`, 400);
+    }
+    const result = await this.updateField("buildingSurfaceArea", value, { setType: "int" });
+    await this._refreshIfDirect();
+    return result;
+  }
+
+  /** Met à jour `siteSurfaceArea` (surface extérieure en m²). `setType: "int"` force le cast. */
+  async updateSiteSurfaceArea(value: number): Promise<unknown> {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+      throw new ApiError(`siteSurfaceArea: attendu nombre fini. Reçu: ${JSON.stringify(value)}`, 400);
+    }
+    const result = await this.updateField("siteSurfaceArea", value, { setType: "int" });
+    await this._refreshIfDirect();
+    return result;
+  }
+
+  /** Met à jour `openingDate` (format libre, ex: "05/05/2026" ou "01/MM/YYYY"). */
+  async updateOpeningDate(value: string): Promise<unknown> {
+    const result = await this.updateField("openingDate", value);
+    await this._refreshIfDirect();
+    return result;
+  }
+
+  /** Met à jour `telephone` (téléphone du tiers-lieu, distinct des champs citoyen fixe/mobile). */
+  async updateTelephone(value: string): Promise<unknown> {
+    const result = await this.updateField("telephone", value);
+    await this._refreshIfDirect();
+    return result;
+  }
+
+  /** Met à jour `video` (liste d'URLs de vidéos de présentation). */
+  async updateVideo(value: string[]): Promise<unknown> {
+    if (!Array.isArray(value)) {
+      throw new ApiError(`video: attendu tableau d'URLs. Reçu: ${JSON.stringify(value)}`, 400);
+    }
+    const result = await this.updateField("video", value);
+    await this._refreshIfDirect();
+    return result;
+  }
+
   /**
    * ───────────────────────────────
    *  Lien utilisateur ↔ organisation

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,

package/types/api/Organization.d.ts

@@ -62,10 +62,74 @@ export declare class Organization extends BaseEntity<OrganizationItemNormalized>
                 };
             };
         };
+        /**
+         * Champs custom tiers-lieu — enregistrent les champs éditables côté draft proxy
+         * via _composeAllowedFields. Aucun endpoint UPDATE_BLOCK_* ne couvre ces champs
+         * côté backend ; chaque champ est dispatché via UPDATE_PATH_VALUE (cf. updateField()).
+         *
+         * Même pattern qu'Action.ts/VIRTUAL_ACTION_EDITABLE : déclaration uniquement pour
+         * autoriser l'écriture sur le draft. Le persiste réel se fait via CUSTOM_FIELD_HANDLERS.
+         */
+        VIRTUAL_ORG_TIERS_LIEU_FIELDS: {
+            type: string;
+            properties: {
+                holderOrganization: {
+                    type: string;
+                };
+                manageModel: {
+                    type: string;
+                };
+                typePlace: {
+                    type: string;
+                };
+                buildingSurfaceArea: {
+                    type: string;
+                };
+                siteSurfaceArea: {
+                    type: string;
+                };
+                openingDate: {
+                    type: string;
+                };
+                telephone: {
+                    type: string;
+                };
+                video: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+            };
+        };
     };
-    static CUSTOM_FIELD_HANDLERS: Map<"openingHours", {
+    static CUSTOM_FIELD_HANDLERS: Map<"holderOrganization" | "manageModel" | "typePlace" | "buildingSurfaceArea" | "siteSurfaceArea" | "openingDate" | "openingHours" | "video" | "telephone", {
         readonly updateMethod: "updateOpeningHours";
         readonly schemaConstant: "VIRTUAL_OPENING_HOURS";
+    } | {
+        readonly updateMethod: "updateHolderOrganization";
+        readonly schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS";
+    } | {
+        readonly updateMethod: "updateManageModel";
+        readonly schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS";
+    } | {
+        readonly updateMethod: "updateTypePlace";
+        readonly schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS";
+    } | {
+        readonly updateMethod: "updateBuildingSurfaceArea";
+        readonly schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS";
+    } | {
+        readonly updateMethod: "updateSiteSurfaceArea";
+        readonly schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS";
+    } | {
+        readonly updateMethod: "updateOpeningDate";
+        readonly schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS";
+    } | {
+        readonly updateMethod: "updateTelephone";
+        readonly schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS";
+    } | {
+        readonly updateMethod: "updateVideo";
+        readonly schemaConstant: "VIRTUAL_ORG_TIERS_LIEU_FIELDS";
     }>;
     static ADD_BLOCKS: Map<"UPDATE_BLOCK_SOCIAL" | "PROFIL_IMAGE" | "ADD_ORGANIZATION", "updateImageProfil" | "updateSocial" | "addOrganization">;
     static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_SOCIAL" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateDescription" | "updateSocial" | "updateLocality" | "updateInfo" | "updateSlug">;
@@ -243,6 +307,38 @@ export declare class Organization extends BaseEntity<OrganizationItemNormalized>
      * await org.updateOpeningHours(openingHours);
      */
     updateOpeningHours(hours: OpeningHoursEntry[]): Promise<unknown>;
+    /**
+     * ───────────────────────────────
+     *  Champs custom tiers-lieu (navigatorDesTierslieux, etc.)
+     *
+     *  Tous les champs ci-dessous sont dispatched via UPDATE_PATH_VALUE car aucun
+     *  endpoint UPDATE_BLOCK_* côté backend ne les couvre. Sans ces méthodes, le
+     *  flow `org.data.X = Y` + `save()` les drop silencieusement (les schémas de
+     *  UPDATE_BLOCK_INFO/DESCRIPTION/SOCIAL/LOCALITY filtrent strictement).
+     *
+     *  Pattern identique à Action.ts (CUSTOM_FIELD_HANDLERS → updateXxx → updateField).
+     *  Voir tests/integration/advanced/tiers-lieux-save-fields.test.ts pour la preuve.
+     * ───────────────────────────────
+     */
+    /** Met à jour `holderOrganization` (nom de la structure porteuse). */
+    updateHolderOrganization(value: string): Promise<unknown>;
+    /** Met à jour `manageModel` (mode de gestion : association, SCIC, SCOP, etc.). */
+    updateManageModel(value: string): Promise<unknown>;
+    /**
+     * Met à jour `typePlace` (famille(s) de tiers-lieux).
+     * Format : string CSV "label1, label2" (le backend stocke tel quel).
+     */
+    updateTypePlace(value: string): Promise<unknown>;
+    /** Met à jour `buildingSurfaceArea` (surface bâtie en m²). `setType: "int"` force le cast. */
+    updateBuildingSurfaceArea(value: number): Promise<unknown>;
+    /** Met à jour `siteSurfaceArea` (surface extérieure en m²). `setType: "int"` force le cast. */
+    updateSiteSurfaceArea(value: number): Promise<unknown>;
+    /** Met à jour `openingDate` (format libre, ex: "05/05/2026" ou "01/MM/YYYY"). */
+    updateOpeningDate(value: string): Promise<unknown>;
+    /** Met à jour `telephone` (téléphone du tiers-lieu, distinct des champs citoyen fixe/mobile). */
+    updateTelephone(value: string): Promise<unknown>;
+    /** Met à jour `video` (liste d'URLs de vidéos de présentation). */
+    updateVideo(value: string[]): Promise<unknown>;
     /**
      * ───────────────────────────────
      *  Lien utilisateur ↔ organisation