@communecter/cocolight-api-client 1.0.138 → 1.0.139

package/package.json

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

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/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