@communecter/cocolight-api-client 1.0.186 → 1.0.187

package/package.json

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

package/types/api/BaseEntity.d.ts

@@ -383,8 +383,26 @@ export declare class BaseEntity<TServerData = any> {
     _isDeleted: boolean;
     /** Contexte costum porté par cette instance (null hors d'un `CostumScope`). Posé au constructeur.
      *  Sens A — « quel costum définit le SCHÉMA de cet élément » : dérivé du `source.key` (provenance),
-     *  ré-affirmé à chaque `_setData`. Gouverne draft/proxy, merge de schémas, héritage aux enfants. */
+     *  ré-affirmé à chaque `_setData` (sauf épingle, cf. `_costumCtxPinned`). Gouverne draft/proxy,
+     *  merge de schémas, héritage aux enfants. */
     _costumCtx: CostumRuntimeContext | null;
+    /**
+     * ÉPINGLE du schéma costum (sens A) : posée par `setCostumScope(slug, {pinSchema:true})` et par
+     * `loadCostumScope`, elle SUSPEND la re-dérivation de `_costumCtx` depuis `source.key` dans
+     * `_setData` — le costum ÉPINGLÉ gouverne alors la whitelist d'écriture du draft, pas la
+     * provenance. Cas d'usage : un costum ANNUAIRE (ex. navigatorDesTierslieux) édite avec SON
+     * formulaire des fiches qui ne viennent pas de lui (`source.key` étranger, hors registre, ou
+     * absent) — sans l'épingle, chacun de ces cas rejetait l'édition (`[DraftProxy] Le champ "…"
+     * n'est pas autorisé.`) alors que la CRÉATION passait, elle, par `me.costum(slug)`. Même statut
+     * que `_adminScope` : un choix EXPLICITE de l'appelant, qui survit aux refresh/hydratations.
+     *
+     * PORTÉE : l'épingle ouvre l'ÉCRITURE (whitelist du draft + enveloppe `element/save`) — elle ne
+     * change pas qui gouverne la LECTURE ailleurs (la normalisation suit toujours la provenance) :
+     * un champ écrit sous le schéma de l'annuaire reste muet hors de l'annuaire (cf.
+     * cocolight-backend docs/28 §6b, triple déclaration). Elle ne déclenche PAS les presets de
+     * création du costum épinglé. @private
+     */
+    private _costumCtxPinned;
     /**
      * Scope d'ADMINISTRATION costum — sens B : « au NOM de quel costum j'agis » (`validateGroup`,
      * `addReference`/`removeReference`/`removeFromSource`, `previewImport`/`importElements`,
@@ -404,6 +422,10 @@ export declare class BaseEntity<TServerData = any> {
         combinedSchema: any;
         transforms: TransformsMap;
         removeFields: string[];
+        /** Constantes de schéma du build — mémorisées pour REJOUER le combinedSchema quand `_costumCtx`
+         *  change APRÈS le build (épingle `pinSchema`) : sans rejeu, poser un scope est un no-op pour
+         *  l'édition (le proxy relit un combinedSchema figé au chargement). */
+        constants: string[];
     };
     static entityTag: string;
     static entityType?: string;
@@ -1070,6 +1092,25 @@ export declare class BaseEntity<TServerData = any> {
      * @private
      */
     private _extractWritableFields;
+    /**
+     * Construit le schéma COMBINÉ de la whitelist d'écriture : schémas de requête des constantes
+     * (+ VIRTUAL_SCHEMAS, $defs fusionnés) ⊕ schéma du `_costumCtx` COURANT. Extrait de
+     * `_buildDraftAndProxy` pour être REJOUABLE : quand `_costumCtx` change après le build
+     * (épingle `pinSchema`), la whitelist doit être reconstruite — sinon poser un scope est un
+     * no-op visible pour l'édition (le proxy relit un combinedSchema figé au chargement).
+     * @private
+     */
+    private _buildCombinedSchema;
+    /**
+     * ÉPINGLE le costum courant comme schéma d'ÉCRITURE (cf. `_costumCtxPinned`) et REJOUE la
+     * whitelist : reconstruit le combinedSchema depuis les constantes mémorisées au build (le
+     * `_costumCtx` a changé APRÈS `_buildDraftAndProxy`), puis SÈME les champs nouvellement ouverts
+     * dans le draft ET dans la baseline depuis `serverData` — sans ce semis, la comparaison
+     * draft/baseline les verrait tous « modifiés » (baseline `undefined`) et le save émettrait des
+     * champs intouchés. Invariant vérifié par test : `hasChanges()` reste `false` juste après la pose.
+     * @private
+     */
+    private _pinCostumSchema;
     /**
      * Construit un brouillon et un proxy à partir des données et du schéma.
      *
@@ -1876,10 +1917,17 @@ export declare class BaseEntity<TServerData = any> {
      * @param slug - Slug du costum (ex. `"equipementsSportifs974"`).
      * @param opts.costumId / opts.costumType - Identité de l'élément hôte, requise si le costum
      *   n'est pas dans le registre bundlé (résolue par le front via slug/getinfo).
+     * @param opts.pinSchema - ÉPINGLE le costum comme schéma d'ÉCRITURE (sens A) : la whitelist du
+     *   draft est REJOUÉE avec ses champs et la re-dérivation depuis `source.key` est suspendue —
+     *   pour ÉDITER, avec le formulaire d'un costum ANNUAIRE, une fiche qui ne vient pas de lui.
+     *   Défaut `false`, et ce défaut est LOAD-BEARING : `setCostumScope` est déjà appelée sur le
+     *   carrier de nombreux sites (import/export/validation via ensureCostumScope), où la provenance
+     *   doit RESTER maîtresse du schéma (contrat des sens A/B). Cf. `_costumCtxPinned`.
      */
     setCostumScope(slug: string, opts?: {
         costumId?: string;
         costumType?: string;
+        pinSchema?: boolean;
     }): void;
     /**
      * Épingle le scope d'ADMINISTRATION (sens B) SI l'identité est complète — sinon no-op : les