@communecter/cocolight-api-client 1.0.159 → 1.0.161

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.159",
+    "version": "1.0.161",
     "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`.
  *
@@ -1822,6 +1826,33 @@ export declare class BaseEntity<TServerData = any> {
         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, ValidateGroupData } 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 } 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
@@ -1452,5 +1462,25 @@ export declare class EndpointApi {
      * @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

@@ -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é
@@ -6094,3 +6277,44 @@ export interface ValidateGroupData {
     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;
+}