@communecter/cocolight-api-client 1.0.160 → 1.0.162

package/package.json

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

package/types/api/BaseEntity.d.ts

@@ -71,8 +71,12 @@ type ParentLike = BaseEntity<any> & {
  *
  * - `default`   → `/co2/search/globalautocomplete`
  * - `navigator-tl` → `/costum/navigator/gettl`
+ * - `admin`     → `/co2/search/globalautocompleteadmin/type/{type}/id/{id}/canSee/true`
+ *   (SearchNew::searchAdmin — réservé aux admins de l'entité porteuse : `fields` = projection
+ *   EXACTE, `preferences` NON strippé → badge/filtre `toBeValidated`, tri serveur via `sort`.
+ *   pathParams {type,id} posés automatiquement depuis l'entité appelante — cf. searchCostum.)
  */
-export type SearchCostumVariant = "default" | "navigator-tl";
+export type SearchCostumVariant = "default" | "navigator-tl" | "admin";
 /**
  * Types de coercion backend supportés par `UPDATE_PATH_VALUE.setType`.
  *
@@ -1849,6 +1853,36 @@ export declare class BaseEntity<TServerData = any> {
         news: unknown[];
         comments: unknown[];
     }>;
+    /**
+     * Détail consolidé des signalements d'un élément de la file de modération (NEWS_MODERATE /
+     * COMMENT_MODERATE, subAction consolidateModerate{News,Comment}).
+     * ⚠ Réponse legacy : `{ result: {text, reason, detail?} }` SANS booléen (clé PHP dupliquée écrasée) —
+     * `reason` est `{}` → `[]` (array vide) quand il n'y a aucun signalement.
+     *
+     * @param context - `"news"` ou `"comments"`.
+     * @param id - ID de l'élément signalé.
+     */
+    consolidateModeration(context: "news" | "comments", id: string): Promise<{
+        result: {
+            text: string | null;
+            reason: Record<string, number> | unknown[];
+            detail?: Record<string, string>;
+        };
+    }>;
+    /**
+     * Vote de modération sur un élément signalé (saveModerate) : pose `moderate.<uid>` + incrémente
+     * `moderateCount`. Pour les NEWS, au seuil de 3 votes le backend tranche `isAnAbuse` à la
+     * majorité (>49%) — une news « abus » est exclue des flux (pas supprimée). Les COMMENTS n'ont
+     * pas de seuil (parité legacy : consolidation commentée).
+     *
+     * @param context - `"news"` ou `"comments"`.
+     * @param id - ID de l'élément signalé.
+     * @param isAnAbuse - Le vote (transmis en STRING 'true'|'false' — parité legacy).
+     */
+    saveModeration(context: "news" | "comments", id: string, isAnAbuse: boolean): Promise<{
+        result: boolean;
+        msg: string;
+    }>;
     /** UUID v4 compatible browser + Node (`crypto.randomUUID()` si dispo, sinon fallback). @private */
     private _uuidV4;
     /**

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, 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 } 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 } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -449,6 +449,16 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     getPoisAdmin(data: GetPoisAdminData): Promise<any>;
+    /**
+     * Recherche globale ADMIN (scopée costum) : Variante ADMIN générique de la recherche costum (SearchNew::searchAdmin). {type}/{id} = l'élément CONTEXTE de droits (l'hôte du costum) : accès si super-admin OU admin de cet élément, sinon 200 {results:[]} (gate silencieuse legacy). Contrairement au public : `fields` = projection EXACTE (documents complets moins pwd si absent), `preferences` NON strippé (badge/filtre toBeValidated), pagination non plafonnée. Sert le variant `admin` de searchCostum (tables d'administration : recherche, tri serveur, statut de validation).
+     * Constant : GLOBAL_AUTOCOMPLETE_ADMIN_COSTUM
+     * @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.
+     */
+    globalAutocompleteAdminCostum(data: GlobalAutocompleteAdminCostumData): Promise<any>;
     /**
      * Récupérer les organisations non administrables : Récupère la liste des organisations auxquelles l’utilisateur appartient sans les administrer.
      * Constant : GET_ORGANIZATIONS_NO_ADMIN
@@ -1472,5 +1482,25 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     moderate(data: ModerateData): Promise<any>;
+    /**
+     * Modération des actualités (sous-actions) : Port de news/co/ModerateAction : consolidateModerateNews (détail des signalements — dates format 12h PHP TZ Europe/Paris), saveModerate (vote moderate.<uid> ; au seuil de 3 votes, tranche isAnAbuse à la majorité >49% + notification activityStream), getNextIdToModerate. Byte-diff L/B 12/12. Backend : requireAuth (durcissement — le legacy laisse consolidate/getNext publics).
+     * Constant : NEWS_MODERATE
+     * @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.
+     */
+    newsModerate(data: NewsModerateData): Promise<any>;
+    /**
+     * Modération des commentaires (sous-actions) : Port de citizenToolKit/comment/ModerateAction : consolidateModerateComment (reportAbuse map uid→raison string ; detail "<raison> - Par <nom>(<email>)"), saveModerate (vote seul, SANS seuil — consolidation commentée dans le legacy). Messages byte-exacts (accents ≠ news).
+     * Constant : COMMENT_MODERATE
+     * @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.
+     */
+    commentModerate(data: CommentModerateData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -1376,6 +1376,189 @@ export interface GetPoisAdminData {
     };
     [k: string]: unknown;
 }
+export interface GlobalAutocompleteAdminCostumData {
+    /**
+     * Nom ou mot-clé de la recherche
+     */
+    name?: string;
+    /**
+     * Localités ciblées. Trois formes acceptées : object keyé (forme historique), array d'objets (forme alternative consommée par `foreach`), ou chaîne vide (placeholder = pas de filtre).
+     */
+    locality?: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[^\s]+$".
+         */
+        [k: string]: {
+            /**
+             * Identifiant de la localité
+             */
+            id: string;
+            /**
+             * Type de localité
+             */
+            type: "cities" | "cp" | "country" | "level1" | "level2" | "level3" | "level4" | "level5";
+            postalCode?: string;
+            countryCode?: string;
+            name?: string;
+            level?: string | number;
+        };
+    } | {
+        id: string;
+        type: "cities" | "cp" | "country" | "level1" | "level2" | "level3" | "level4" | "level5";
+        postalCode?: string;
+        countryCode?: string;
+        name?: string;
+        level?: string | number;
+    }[] | "";
+    /**
+     * Types d'entités à inclure dans la recherche
+     */
+    searchType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "answers" | "forms" | "classifieds")[];
+    /**
+     * Balises (tags) à utiliser pour filtrer la recherche
+     */
+    searchTags?: string[];
+    /**
+     * Liste fixe des types à compter dans les résultats
+     */
+    countType?: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "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"]`).
+     */
+    searchBy?: string | [string, ...string[]];
+    /**
+     * Index de départ global pour la pagination
+     */
+    indexMin?: number;
+    /**
+     * Index de fin global pour la pagination
+     */
+    indexMax?: number;
+    /**
+     * Nombre d’éléments à récupérer (limite de pagination)
+     */
+    indexStep?: number;
+    /**
+     * Configuration des plages de résultats pour chaque type de recherche
+     */
+    ranges?: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[^\s]+$".
+         */
+        [k: string]: {
+            /**
+             * Index de départ pour la pagination
+             */
+            indexMin: number;
+            /**
+             * Index de fin pour la pagination
+             */
+            indexMax: number;
+        };
+    };
+    /**
+     * Type initial de la recherche, vide par défaut
+     */
+    initType?: "";
+    /**
+     * Indique si les types doivent être comptés dans les résultats
+     */
+    count?: true;
+    /**
+     * Filtres additionnels appliqués à la recherche (objet ou chaîne vide)
+     */
+    filters?: {
+        [k: string]: unknown;
+    } | "";
+    /**
+     * Liste des champs à retourner
+     */
+    fields?: string[];
+    /**
+     * Champ de tri (clé = champ, valeur = 1 ou -1)
+     */
+    sortBy?: {
+        [k: string]: 1 | -1;
+    };
+    /**
+     * Indique si la recherche doit s'étendre au Fediverse (toujours désactivé)
+     */
+    fediverse?: boolean;
+    /**
+     * Indique si la recherche est effectuée à partir d'une carte (toujours désactivé)
+     */
+    mapUsed?: true;
+    /**
+     * Indique si on doit exclure les éléments avec une source
+     */
+    notSourceKey?: true;
+    /**
+     * ID du contexte de recherche (actuellement vide)
+     */
+    contextId?: string;
+    /**
+     * Type de contexte de recherche (actuellement vide)
+     */
+    contextType?: "projects" | "organizations";
+    /**
+     * Slug du costume utilisé pour la recherche
+     */
+    costumSlug?: string;
+    /**
+     * Alias historique de `contextId` — id du contexte costum. Le backend lit l'un OU l'autre (`isset($post['contextId']) ? ... : $post['costumId']`).
+     */
+    costumId?: string;
+    /**
+     * Alias historique de `contextType` — type du contexte costum.
+     */
+    costumType?: "projects" | "organizations";
+    /**
+     * Mode d'affichage / comportement côté backend. Valeurs observées : `table` (charge `creatorData`), `mapWithDirectory`. String libre.
+     */
+    mode?: string;
+    /**
+     * Clés de source pour la recherche
+     */
+    sourceKey?: string[];
+    /**
+     * Indique si le mode d'édition du costume est activé (toujours désactivé)
+     */
+    costumEditMode?: boolean;
+    options?: {
+        tags?: {
+            /**
+             * Verbe d'action pour le filtre de recherche
+             */
+            verb?: string;
+            [k: string]: unknown;
+        };
+        [k: string]: unknown;
+    };
+    /**
+     * Tri prioritaire (legacy $_POST['sort']) : {champ: 1|-1}. Contrairement à sortBy (première clé seulement), sort est passé tel quel à MongoDB — à préférer pour le tri des tables admin.
+     */
+    sort?: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[^\s]+$".
+         */
+        [k: string]: 1 | -1 | "1" | "-1";
+    };
+    pathParams?: {
+        /**
+         * Collection de l'élément contexte (hôte du costum)
+         */
+        type: "organizations" | "projects" | "events" | "citoyens";
+        /**
+         * ID de l'élément contexte
+         */
+        id: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
 export interface GetOrganizationsNoAdminData {
     /**
      * Nom ou terme recherché
@@ -6135,3 +6318,33 @@ export interface SetSourceData {
 export interface ModerateData {
     [k: string]: unknown;
 }
+export interface NewsModerateData {
+    /**
+     * Sous-action ($_REQUEST['subAction'] legacy)
+     */
+    subAction: "consolidateModerateNews" | "saveModerate" | "getNextIdToModerate";
+    /**
+     * ID de l'élément modéré (requis sauf getNextIdToModerate)
+     */
+    id?: string;
+    /**
+     * Vote (STRING 'true'|'false' — stocké/comparé en string, parité legacy). Requis pour saveModerate.
+     */
+    isAnAbuse?: "true" | "false";
+    [k: string]: unknown;
+}
+export interface CommentModerateData {
+    /**
+     * Sous-action ($_REQUEST['subAction'] legacy)
+     */
+    subAction: "consolidateModerateComment" | "saveModerate";
+    /**
+     * ID de l'élément modéré (requis sauf getNextIdToModerate)
+     */
+    id?: string;
+    /**
+     * Vote (STRING 'true'|'false' — stocké/comparé en string, parité legacy). Requis pour saveModerate.
+     */
+    isAnAbuse?: "true" | "false";
+    [k: string]: unknown;
+}