@communecter/cocolight-api-client 1.0.167 → 1.0.168

package/package.json

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

package/types/api/BaseEntity.d.ts

@@ -183,6 +183,21 @@ export type CostumContextFields = {
     sourceKey: string[];
 };
 export type WithCostumContext<T> = T & CostumContextFields;
+/**
+ * Exclut les items de FIL (`activityStream`/`activitypub`) d'une recherche `searchType: news`.
+ *
+ * Invariant de « news éditoriale » : la collection `news` contient AUSSI des items auto-générés
+ * ("X a créé Y") que `globalautocomplete` remonte bruts ; un `searchType: ["news"]` veut dire ACTUALITÉS,
+ * pour TOUT consommateur. Filtre posé au niveau REQUÊTE → honoré à l'identique par le legacy ET le backend
+ * Node (`buildFilters`) → byte-parité préservée. Cohérent avec `getNews` (mur profil, exclut déjà activityStream).
+ *
+ * NO-OP si `news` absent des types, OU si un filtre `type` explicite est déjà posé (OVERRIDABLE :
+ * un outil de modération voulant le fil brut passe son propre `filters.type`).
+ */
+export declare function withNewsActivityExclusion<T extends {
+    searchType?: string[];
+    filters?: unknown;
+}>(data: T): T;
 /**
  * Bornes d'agenda acceptant un `Date` (coercé en ISO par la méthode avant l'envoi — le fil reste
  * `type:string`). Partagé par `searchEventsCostum` et `getEvents`.

package/types/api/EndpointApi.types.d.ts

@@ -546,6 +546,24 @@ export interface AddNewsData {
      * Indique que la réponse est au format JSON.
      */
     json: true;
+    /**
+     * Optionnel. Provenance costum (estampille source.key côté backend, cf. News::prepData). Injecté par le scope costum de la lib (me.costum(...).news()) depuis le _costumCtx — l'appelant n'a normalement pas à le fournir. Format canonique {insertOrign, key, keys} (cf. Element.php + données réelles).
+     */
+    source?: {
+        /**
+         * Origine de la source (ex: 'costum'). Faute de frappe historique conservée (fait FOI).
+         */
+        insertOrign?: string;
+        /**
+         * Slug du costum (= source.key).
+         */
+        key?: string;
+        /**
+         * Slugs de costum (= source.keys).
+         */
+        keys?: string[];
+        [k: string]: unknown;
+    };
     /**
      * Tags : "" pour effacer tous les tags, ou tableau de mots-clés.
      */
@@ -1438,7 +1456,7 @@ export interface GlobalAutocompleteAdminCostumData {
     /**
      * Types d'entités à inclure dans la recherche
      */
-    searchType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "answers" | "forms" | "classifieds")[];
+    searchType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
     /**
      * Balises (tags) à utiliser pour filtrer la recherche
      */
@@ -1446,7 +1464,7 @@ export interface GlobalAutocompleteAdminCostumData {
     /**
      * Liste fixe des types à compter dans les résultats
      */
-    countType?: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "answers" | "forms" | "classifieds")[];
+    countType?: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
     /**
      * Sélecteur des champs où chercher le terme `name`. Trois formes acceptées : `"ALL"` (cherche dans name/title/slug/tags/source.keys/sigle/description), chaîne CSV (`"name,slug,tags"`), ou tableau de chemins (`["name", "address.addressLocality"]`).
      */
@@ -3214,6 +3232,18 @@ export interface AddPoiData {
      */
     description?: string;
     tags?: "" | string[];
+    /**
+     * Médias attachés au POI (audio/vidéo…) : [{type, url, …}]. Champ natif du dataBinding POI (Poi.php:64), absent du contrat curé jusqu'ici. Permissif (items objet libre).
+     */
+    medias?: {
+        [k: string]: unknown;
+    }[];
+    /**
+     * Préférences de l'élément (drapeaux legacy : toBeValidated = modération a priori costum {slug:true}, isOpenEdition…). Objet libre, normalisé côté backend (Element::prepData → Costum::prepData).
+     */
+    preferences?: {
+        [k: string]: unknown;
+    };
     /**
      * URLs externes associées
      */
@@ -4180,7 +4210,7 @@ export interface GlobalAutocompleteCostumData {
     /**
      * Types d'entités à inclure dans la recherche
      */
-    searchType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "answers" | "forms" | "classifieds")[];
+    searchType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
     /**
      * Balises (tags) à utiliser pour filtrer la recherche
      */
@@ -4188,7 +4218,7 @@ export interface GlobalAutocompleteCostumData {
     /**
      * Liste fixe des types à compter dans les résultats
      */
-    countType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "answers" | "forms" | "classifieds")[];
+    countType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
     /**
      * Sélecteur des champs où chercher le terme `name`. Trois formes acceptées : `"ALL"` (cherche dans name/title/slug/tags/source.keys/sigle/description), chaîne CSV (`"name,slug,tags"`), ou tableau de chemins (`["name", "address.addressLocality"]`).
      */
@@ -4342,7 +4372,7 @@ export interface NavigatorGettlData {
     /**
      * Types d'entités à inclure dans la recherche
      */
-    searchType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "answers" | "forms" | "classifieds")[];
+    searchType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
     /**
      * Balises (tags) à utiliser pour filtrer la recherche
      */
@@ -4350,7 +4380,7 @@ export interface NavigatorGettlData {
     /**
      * Liste fixe des types à compter dans les résultats
      */
-    countType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "answers" | "forms" | "classifieds")[];
+    countType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
     /**
      * Sélecteur des champs où chercher le terme `name`. Trois formes acceptées : `"ALL"` (cherche dans name/title/slug/tags/source.keys/sigle/description), chaîne CSV (`"name,slug,tags"`), ou tableau de chemins (`["name", "address.addressLocality"]`).
      */

package/types/costum/runtime.d.ts

@@ -102,6 +102,14 @@ export declare class CostumScope {
     organization(data?: Record<string, unknown>): Promise<import("../index.js").Organization>;
     project(data?: Record<string, unknown>): Promise<import("../index.js").Project>;
     event(data?: Record<string, unknown>): Promise<import("../index.js").Event>;
+    /**
+     * Poste une news sous CE costum, sur le mur de `target` : `source.key` = costum du scope (le SITE,
+     * comme poi/org — cf. `News::prepData`), `parent` = `target`. News n'est PAS une collection « élément »
+     * (pas d'`element/save` ni de champs costum) : on la crée via `target.entity("news", …, {costumCtx})`.
+     * Le `costumCtx` EXPLICITE court-circuite l'héritage parent d'`entity()` → la source vient du SITE,
+     * jamais du mur. `News._add` lit ce `_costumCtx` et estampille `source` (pendant des uploads costum).
+     */
+    news(target: BaseEntity, data?: Record<string, unknown>): Promise<import("../index.js").News>;
     /**
      * Décrit le FORMULAIRE costum d'une collection (null si non couverte) — projection NEUTRE des
      * métadonnées runtime (champs typés + enum/multiple, presets, hidden, add, createLabel). Le module