@communecter/cocolight-api-client 1.0.179 → 1.0.180

package/README.md

@@ -450,6 +450,35 @@ const { results: orgs } = await user.getOrganizations();
 console.log("Organisations :", orgs.map(o => o.data.name));
 ```
 
+##### Périmètre costum des lectures de relation (≥ 1.0.179)
+
+Les 9 lectures de relation (`user.getOrganizations/getProjects/getPois/getEvents/getEligiblePlaces`
+et `org/project/event/poi.getOrganizations/getProjects/getEvents/getPois`) acceptent un
+commutateur de périmètre :
+
+```js
+// Mes organisations DANS le costum institutBleu (source.keys OU reference.costum)
+const { results } = await user.getOrganizations({ sourceKey: ["institutBleu"] });
+
+// Réseau entier (comportement historique, défaut)
+const { results: toutes } = await user.getOrganizations();
+```
+
+⚠ Piège de transport : la garde serveur est `empty(notSourceKey)` et le corps part en
+form-urlencoded — `notSourceKey: false` arriverait en `"false"` (non vide) et DÉSACTIVERAIT le
+périmètre exactement comme `true`. Seule l'ABSENCE de la clé active le scope : ne jamais envoyer
+`notSourceKey` avec un `sourceKey` (la lib gère ça — passer `sourceKey` suffit, le défaut
+historique `notSourceKey=true` est posé par le finalizer quand aucun périmètre n'est demandé).
+Les `filters` d'appelant sont FUSIONNÉS à la clause d'adhésion (jamais écrasés).
+
+##### `costum/co/listvalues` — listes déclarées d'un costum (≥ 1.0.179)
+
+`COSTUM_LIST_VALUES` résout une liste DYNAMIQUE déclarée (`costum.lists.<nom>` :
+`{collection, distinct, where}`) hors du cache costum — valeurs fraîches. Recherche et pagination
+serveur : `q` (forme canonique sans accents/casse, ≤ 64 chars) et `limit` (≤ 5000) ; la réponse
+porte `total`/`truncated` seulement en cas de coupe. Garde-fou : le client demande une liste par
+son NOM — collection, champ et filtre viennent de la déclaration en base.
+
 ---
 
 ### 📰 Actualités associées