@communecter/cocolight-api-client 1.0.162 → 1.0.163

package/package.json

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

package/types/api/BaseEntity.d.ts

@@ -1735,6 +1735,35 @@ export declare class BaseEntity<TServerData = any> {
         isAdmin?: "" | "admin";
         roles?: string[];
     }>): Promise<unknown>;
+    /**
+     * L'entité porte-t-elle un contexte costum COMPLET (slug + costumId + costumType) ?
+     * Vrai pour une entité chargée avec un `source.key` connu, ou après `setCostumScope()`.
+     */
+    hasCostumScope(): boolean;
+    /**
+     * Pose EXPLICITEMENT le scope costum de l'entité — l'API OFFICIELLE pour rattacher une entité
+     * HÔTE de costum (qui n'a pas de `source.key` : c'est elle la source, la lib ne lui auto-dérive
+     * donc aucun `_costumCtx`) aux méthodes qui l'exigent (`_requireCostumCtx` : `previewImport`,
+     * `importElements`, `exportElements`, `addReference`…).
+     *
+     * Résolution :
+     *  1. le REGISTRE bundlé d'abord (`resolveCostumCtxFromSource` — costum connu : identité + overlay
+     *     de champs, source de vérité interne) ;
+     *  2. sinon un contexte NU construit depuis `opts` (costum de config/déploiement hors registre) —
+     *     même forme que le fallback interne (schema vide, fields:[]) ;
+     *  3. sinon throw (identité costum introuvable).
+     *
+     * Remplace la mutation externe de `_costumCtx` pratiquée par les fronts (champ INTERNE non
+     * contractuel) — cf. site-json `ensureCostumScope`, à migrer sur cette méthode.
+     *
+     * @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).
+     */
+    setCostumScope(slug: string, opts?: {
+        costumId?: string;
+        costumType?: string;
+    }): void;
     /**
      * Contexte costum de CETTE entité (résolu de son `source.key`) — requis par l'import/export admin.
      * @throws {ApiError} si l'entité n'est pas rattachée à un costum.