@communecter/cocolight-api-client 1.0.166 → 1.0.168

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.166",
+    "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`.
@@ -708,6 +723,48 @@ export declare class BaseEntity<TServerData = any> {
      * await news.deleteFile(imageDocId);
      */
     deleteFile(docId: string): Promise<void>;
+    /**
+     * Champs de contexte costum à joindre à un upload multipart (profil/bannière/galerie) pour que le
+     * backend stampe `source.key` (Document.php:228-232). Dérivés de `_costumCtx` (résolu du `source.key`
+     * de l'élément) → un POI scopé "parent62" envoie `costumSlug="parent62"`. `{}` hors contexte costum.
+     */
+    protected _costumUploadFields(): {
+        costumSlug?: string;
+        costumId?: string;
+        costumType?: string;
+    };
+    /**
+     * Uploade un document (image/fichier) rattaché à CET élément, avec `contentKey`/`docType`
+     * PARAMÉTRABLES — ex. `contentKey:"slider"` pour une galerie (Option C). La provenance costum
+     * (`source.key`) est injectée automatiquement depuis `_costumCtx` (résolu du `source.key` de
+     * l'élément). L'élément DOIT préexister (pas d'auto-création, contraste avec `Answer.uploadFile`).
+     * Endpoint générique `UPLOAD_DOCUMENT` (backend `co2/document/upload-save`, route wildcard).
+     *
+     * STATELESS : ne rafraîchit PAS `serverData` (pas de push local façon `News.addImage`). Pour refléter
+     * la nouvelle image dans `getGalleryImages()`, re-fetch l'élément via `about` après upload (le
+     * consommateur peut afficher optimistement via le `docPath` retourné en attendant). Cf. patron
+     * `Answer.processUploads` : la galerie s'uploade APRÈS `save()` (l'élément doit avoir un `id`).
+     *
+     * @returns `{ docId, docPath }` — id du document créé + URL relative servie.
+     * @throws {ApiError} 404 si l'entité n'est pas enregistrée (pas d'`id`).
+     */
+    uploadDocument(file: UploadInput, opts: {
+        contentKey: string;
+        docType?: "image" | "file";
+        subKey?: string;
+        folder?: string;
+        ownerId?: string;
+    }): Promise<{
+        docId: string;
+        docPath: string;
+    }>;
+    /**
+     * Images d'une galerie de CET élément, lues depuis le champ `images` fusionné par `about`/getById
+     * (backend `enrichAbout` — {Poi,Classified}::getById), filtrées par `contentKey` (défaut `"slider"`).
+     * SYNCHRONE : nécessite que l'entité ait été chargée via `about` (sinon `[]`). Forme = getListOfImage
+     * (`{ id, _id, contentKey, imagePath, imageThumbPath, imageMediumPath, subKey, name, ... }`).
+     */
+    getGalleryImages(contentKey?: string): Array<Record<string, unknown>>;
     /**
      * Liste les documents (images/fichiers) attachés à CETTE entité (`id` + `type`) via `DOCUMENT_LIST`
      * (port legacy `document/list`). Renvoie un tableau plat `{ id, name, path, author, contentKey }`.
@@ -721,6 +778,26 @@ export declare class BaseEntity<TServerData = any> {
         author?: string;
         contentKey?: string;
     }>>;
+    /**
+     * Liste les FICHIERS (documents non-image, `doctype:"file"`) attachés à CETTE entité via `GET_GALLERY`
+     * (`co2/gallery/index`, branche fichier : `docs` = OBJET keyé par `_id`, records BRUTS + `docPath`
+     * absolutisé par `_imageFields`). Source UNIQUE et uniforme tous types (org/projet/citoyen/poi/events/
+     * classifieds — l'`IndexAction` legacy est type-agnostique). Contraste `getGalleryImages` (images,
+     * synchrone via `about`) et `getDocuments` (DOCUMENT_LIST, forme réduite sans `size`/`docType`, `path`
+     * = dossier seul). Les fichiers rangés en dossier (`folderId`) sont exclus par défaut (parité
+     * `IndexAction` : `folderId:{$exists:false}`).
+     *
+     * @returns `{ docId, docPath, name, size, contentKey }[]` — `contentKey` = valeur DÉRIVÉE stockée
+     *   (`pdf`/`spreadsheet`/`text`/`presentation`), utilisable pour choisir l'icône.
+     * @throws {ApiError} 404 si l'entité n'est pas enregistrée.
+     */
+    getGalleryFiles(): Promise<Array<{
+        docId: string;
+        docPath?: string;
+        name?: string;
+        size?: number;
+        contentKey?: string;
+    }>>;
     /**
      * Supprime l'image de PROFIL de cette entité : récupère le `docId` du document `contentKey:"profil"`
      * (via `getDocuments`) puis `deleteFile`. No-op (`false`) s'il n'y a pas d'image. Pendant exact de

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GlobalAutocompleteAdminCostumData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteMembersData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, DeleteCoformAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData } from "./EndpointApi.types.js";
+import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GlobalAutocompleteAdminCostumData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteMembersData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, DeleteCoformAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1502,5 +1502,15 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     commentModerate(data: CommentModerateData): Promise<any>;
+    /**
+     * Uploader un document/image sur un élément (galerie) : Uploade un document (image/fichier) rattaché à un ÉLÉMENT, avec docType/contentKey PARAMÉTRABLES (ex. contentKey=slider pour une galerie) et provenance costum optionnelle (costumSlug/costumId/costumType stampent source.key). Backend: co2/document/upload-save (route wildcard, parseKv). L'élément doit préexister.
+     * Constant : UPLOAD_DOCUMENT
+     * @param data - Données envoyées à l'API
+     * @returns Les données de réponse.
+     * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+     * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+     * @throws {Error} - En cas d'erreur inattendue.
+     */
+    uploadDocument(data: UploadDocumentData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -364,6 +364,18 @@ export interface ProfilImageData {
     profil_avatar: {
         [k: string]: unknown;
     };
+    /**
+     * Slug du costum actif (stampe source.key côté backend) — optionnel
+     */
+    costumSlug?: string;
+    /**
+     * ID du contexte costum — optionnel
+     */
+    costumId?: string;
+    /**
+     * Type (collection) du contexte costum — optionnel
+     */
+    costumType?: string;
     pathParams?: {
         /**
          * Type d'entité
@@ -391,6 +403,18 @@ export interface ProfilBannerData {
     cropH: number;
     cropX: number;
     cropY: number;
+    /**
+     * Slug du costum actif (stampe source.key côté backend) — optionnel
+     */
+    costumSlug?: string;
+    /**
+     * ID du contexte costum — optionnel
+     */
+    costumId?: string;
+    /**
+     * Type (collection) du contexte costum — optionnel
+     */
+    costumType?: string;
     pathParams?: {
         /**
          * Type d'entité
@@ -522,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.
      */
@@ -1414,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
      */
@@ -1422,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"]`).
      */
@@ -3190,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
      */
@@ -4156,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
      */
@@ -4164,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"]`).
      */
@@ -4318,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
      */
@@ -4326,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"]`).
      */
@@ -4912,9 +4966,9 @@ export interface GetGalleryData {
          */
         id: string;
         /**
-         * Type d'entité
+         * Type d'entité (IndexAction legacy est type-agnostique ; poi/events/classifieds ajoutés pour la lecture des documents/fichiers via getGalleryFiles)
          */
-        type: "citoyens" | "organizations" | "projects";
+        type: "citoyens" | "organizations" | "projects" | "poi" | "events" | "classifieds";
         /**
          * Type de document
          */
@@ -6348,3 +6402,51 @@ export interface CommentModerateData {
     isAnAbuse?: "true" | "false";
     [k: string]: unknown;
 }
+export interface UploadDocumentData {
+    /**
+     * Fichier à uploader
+     */
+    qqfile: {
+        [k: string]: unknown;
+    };
+    /**
+     * Slug du costum actif (stampe source.key=costumSlug)
+     */
+    costumSlug?: string;
+    /**
+     * ID du contexte costum
+     */
+    costumId?: string;
+    /**
+     * Type (collection) du contexte costum
+     */
+    costumType?: string;
+    /**
+     * Sous-clé de galerie (optionnelle)
+     */
+    subKey?: string;
+    /**
+     * Dossier d'album cible (optionnel)
+     */
+    folderId?: string;
+    pathParams?: {
+        /**
+         * Type (collection) de l'élément porteur
+         */
+        folder: "citoyens" | "projects" | "organizations" | "events" | "poi" | "classifieds";
+        /**
+         * ID de l'élément porteur (doit exister)
+         */
+        ownerId: string;
+        /**
+         * Nature du document
+         */
+        docType: "image" | "file";
+        /**
+         * Clé de contenu (ex: 'slider' pour galerie, 'file', 'profil', 'banner'...)
+         */
+        contentKey: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}

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
@@ -121,12 +129,18 @@ export declare class CostumScope {
  */
 export declare function resolveCostumCtxFromSource(sourceKey: string | undefined | null, collection: Collection, type?: string | null): CostumRuntimeContext | null;
 /**
- * Ouvre un scope costum FIELDLESS depuis une entité DÉJÀ CHARGÉE (zéro fetch) : `costumSlug` = slug de
- * l'entité (= `source.key` posé par le backend), `costumId/costumType` = l'entité porteuse. Pendant runtime
- * exact de `_withCostumContext` (BaseEntity), pour la voie « entité tenue » (un site nu sans form). Le
- * backend re-gate `found` sur l'existence d'un costum sur l'entité → un site sans costum n'estampille rien.
+ * Ouvre un scope costum depuis une entité DÉJÀ CHARGÉE (org/projet/event porteur d'un costum) : `costumSlug`
+ * = slug de l'entité (= `source.key` posé par le backend), `costumId/costumType` = l'entité porteuse. C'est
+ * la voie AMBIANTE (« costum du déploiement ») de `me.costum(entity)`.
+ *
+ * Le scope porte les DÉFINITIONS du costum (champs + presets de sous-type, ex. `type:"article"`), PAS
+ * seulement l'identité : sinon un CREATE de sous-type sous l'ambiant perd le `type` forcé → rejet enum ADD_*.
+ * Résolution (dégradée, jamais throw) : 1) cache live frais (zéro fetch — le costum est déjà chargé au rendu
+ * du site) ; 2) digest live `getcostumjson` (comble presets/champs + peuple le cache) ; 3) fieldless
+ * (identité seule — site nu sans costum, ou offline = comportement historique). Le backend re-gate `found`
+ * sur l'existence d'un costum → un site sans costum n'estampille rien.
  */
-export declare function costumScopeFromEntity(user: BaseEntity, entity: BaseEntity): CostumScope;
+export declare function costumScopeFromEntity(user: BaseEntity, entity: BaseEntity): Promise<CostumScope>;
 /**
  * Résout un `CostumScope` par SLUG pour un user connecté.
  *  - slug à champs (meta + loader) → charge le module généré (code-split via dynamic import).