@communecter/cocolight-api-client 1.0.161 → 1.0.163

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.161",
+    "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.
@@ -1853,6 +1882,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, 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 } 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
  */
@@ -1482,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

@@ -6318,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;
+}