@communecter/cocolight-api-client 1.0.158 → 1.0.160

package/package.json

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

package/types/api/BaseEntity.d.ts

@@ -1806,6 +1806,49 @@ export declare class BaseEntity<TServerData = any> {
         results: unknown[];
         fields: unknown;
     }>;
+    /**
+     * (Dé)VALIDE un élément POUR le costum de cette entité (VALIDATE_GROUP / ValidateGroupAction). Méthode
+     * haut niveau : `costumSlug` est dérivé du `_costumCtx` (source.key) — pas de paramètre costum à fournir.
+     * (Dé)pose `preferences.toBeValidated[slug]` sur l'élément AVEC CASCADE sur les enfants liés
+     * (`source.keys ∋ slug`, hors citoyens) et les classifieds `parent.<id>`.
+     *
+     * @param type - Collection de l'élément (organizations/projects/poi/events/citoyens…).
+     * @param id - ID de l'élément à (dé)valider.
+     * @param valid - `true` = valider (retire le flag) ; `false` = dévalider (repose le flag).
+     * @returns `{ result, elt (doc mis à jour), sub (map key→write-result des enfants) }`.
+     */
+    validateGroup(type: string, id: string, valid: boolean): Promise<{
+        result: boolean;
+        elt: unknown;
+        sub: Record<string, unknown>;
+    }>;
+    /**
+     * Rattache l'élément (type,id) au costum de cette entité : ajoute son slug dans `reference.costum`
+     * (référencement, en attente de validation). Port de SetSourceAction (add/reference). costumSlug dérivé du ctx.
+     */
+    addReference(type: string, id: string): Promise<{
+        result: boolean;
+        msg?: string;
+    }>;
+    /** Retire l'élément (type,id) de `reference.costum` du costum de cette entité + nettoie les liens. */
+    removeReference(type: string, id: string): Promise<{
+        result: boolean;
+        msg?: string;
+    }>;
+    /** Détache l'élément (type,id) de `source.keys` du costum de cette entité (dé-rattachement) + nettoie les liens. */
+    removeFromSource(type: string, id: string): Promise<{
+        result: boolean;
+        msg?: string;
+    }>;
+    /**
+     * File de modération (news + commentaires signalés `reportAbuse`, non déjà modérés par l'utilisateur
+     * courant). Port de ModerateAction (vue HTML → JSON). Niveau plateforme (ne dépend pas du costum).
+     */
+    getModerationQueue(): Promise<{
+        result: boolean;
+        news: unknown[];
+        comments: unknown[];
+    }>;
     /** 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 } 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, 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";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1442,5 +1442,35 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     geocodage(data: GeocodageData): Promise<any>;
+    /**
+     * Valider/dévalider un élément (statut costum) : (Dé)valide un élément pour le costum courant en (dé)posant preferences.toBeValidated[slug], avec cascade sur les enfants liés (source.keys ∋ slug) et les classifieds parent.<id>. Port de ValidateGroupAction.
+     * Constant : VALIDATE_GROUP
+     * @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.
+     */
+    validateGroup(data: ValidateGroupData): Promise<any>;
+    /**
+     * Rattacher/détacher un élément d'un costum (référencement) : Rattache (add) ou détache (remove) un élément d'un costum : ajoute/retire une clé dans reference.costum (set=reference) ou source.keys (set=remove/source), + nettoie les liens. Port de SetSourceAction/Admin.
+     * Constant : SET_SOURCE
+     * @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.
+     */
+    setSource(data: SetSourceData): Promise<any>;
+    /**
+     * File de modération (news + commentaires signalés) : File de modération : news et commentaires signalés (reportAbuse) non encore tranchés et non déjà modérés par l'utilisateur courant. Port de ModerateAction (vue HTML → JSON). Les commentaires dont la news parente est flaggée abus sont retirés.
+     * Constant : 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.
+     */
+    moderate(data: ModerateData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -6075,3 +6075,63 @@ export interface GeocodageData {
     data: string;
     [k: string]: unknown;
 }
+export interface ValidateGroupData {
+    /**
+     * Collection de l'élément (organizations, projects, poi, events, citoyens…).
+     */
+    type: string;
+    /**
+     * ID de l'élément à (dé)valider.
+     */
+    id: string;
+    /**
+     * "true" = valider (unset toBeValidated) ; sinon dévalider (repose le flag).
+     */
+    valid: "true" | "false";
+    /**
+     * Slug du costum courant (scope). Posé automatiquement par BaseEntity.validateGroup.
+     */
+    costumSlug?: string;
+    [k: string]: unknown;
+}
+export interface SetSourceData {
+    /**
+     * ID de l'élément.
+     */
+    id: string;
+    /**
+     * Collection de l'élément.
+     */
+    type: string;
+    /**
+     * Slug source (overridé par le costum courant).
+     */
+    sourceKey: string;
+    /**
+     * Slug du costum courant (scope). Posé automatiquement par BaseEntity.
+     */
+    costumSlug?: string;
+    /**
+     * ID du costum parent (nettoyage de liens). Optionnel.
+     */
+    costumId?: string;
+    /**
+     * Type du costum parent (nettoyage de liens). Optionnel.
+     */
+    costumType?: string;
+    pathParams?: {
+        /**
+         * add = référencer ; remove = retirer.
+         */
+        action: "add" | "remove";
+        /**
+         * reference (référencé) ou source (rattaché/validé).
+         */
+        set: "reference" | "source";
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export interface ModerateData {
+    [k: string]: unknown;
+}