@communecter/cocolight-api-client 1.0.146 → 1.0.148

package/types/api/BaseEntity.d.ts

@@ -648,6 +648,36 @@ export declare class BaseEntity<TServerData = any> {
      * await news.deleteFile(imageDocId);
      */
     deleteFile(docId: string): Promise<void>;
+    /**
+     * Vide les objets réactifs et marque l'entité comme supprimée (tombstone),
+     * sans casser la réactivité. Pattern partagé par tous les `delete()`.
+     *
+     * Après appel : `serverData`/`draftData` vidés et `_isDeleted = true` → toute
+     * opération serveur ultérieure lève le tombstone (cf. `_checkNotDeleted`).
+     * @protected
+     */
+    protected _markDeletedLocally(): void;
+    /**
+     * Suppression générique d'un élément via `DELETE_ELEMENT`
+     * (`/co2/element/delete/type/{type}/id/{id}`).
+     *
+     * **Garde client** : `isAuthorOrAdmin({ checkHierarchy })` — auteur (`creator`)
+     * OU administrateur (lien direct, ou via la hiérarchie parent org/projet
+     * résolue par `_isAdminViaHierarchy`). Le serveur reste la source de vérité.
+     *
+     * Après succès : `serverData`/`draftData` vidés + `_isDeleted = true`
+     * (via `_markDeletedLocally`).
+     *
+     * @param type - Type d'élément backend (typiquement `this.getEntityType()`).
+     * @param reason - Raison transmise au backend (audit).
+     * @param options.checkHierarchy - Propage la vérif admin à la hiérarchie parent. Défaut `true`.
+     * @throws {ApiError} 400 si l'entité n'a pas d'id.
+     * @throws {ApiError} 403 si ni auteur ni admin (selon la garde).
+     * @protected
+     */
+    protected _deleteViaElement(type: string, reason: string, { checkHierarchy }?: {
+        checkHierarchy?: boolean;
+    }): Promise<void>;
     /**
      * Met à jour un champ unique (ou multi-fields via `updatePartial`) sur cette
      * entité via `UPDATE_PATH_VALUE`.

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { 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, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, 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 } from "./EndpointApi.types.js";
+import type { 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, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, 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 } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -671,26 +671,6 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     addEvent(data: AddEventData): Promise<any>;
-    /**
-     * Supprimer un POI : Supprime un POI existant.
-     * Constant : DELETE_POI
-     * @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.
-     */
-    deletePoi(data: DeletePoiData): Promise<any>;
-    /**
-     * Supprimer un événement : Supprime un événement spécifique.
-     * Constant : DELETE_EVENT
-     * @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.
-     */
-    deleteEvent(data: DeleteEventData): Promise<any>;
     /**
      * Supprimer un élément : Supprime un élément existant.
      * Constant : DELETE_ELEMENT
@@ -1386,5 +1366,14 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     addClassified(data: AddClassifiedData): Promise<any>;
+    /**
+     * Activation d’un compte (lien email) : Valide l’adresse email d’un compte via le lien reçu par email. validationKey = sha256(user + email). Retire roles.tobeactivated et pose le consentement preferences.sendMail.source (port ActivateAction + Person::validateEmailAccount/validateUser).
+     * Constant : PERSON_ACTIVATE
+     * @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 {Error} - En cas d'erreur inattendue.
+     */
+    personActivate(data: PersonActivateData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -2627,22 +2627,6 @@ export interface AddOrganizationData {
         float: true;
         [k: string]: unknown;
     };
-    costum?: {
-        bannerImageUrl?: string;
-        bannerLogoUrl?: string;
-        bannerText?: string;
-        /**
-         * Pour bien indiquer que l'orga est un commune transparente
-         */
-        transparentCommune?: boolean;
-        /**
-         * Pour bien indiquer que l'orga est un centre ville
-         */
-        cocity?: boolean;
-        slug?: string;
-        typeCocity?: string;
-        [k: string]: unknown;
-    };
     /**
      * Thématiques de l’organisation
      */
@@ -2866,15 +2850,6 @@ export interface AddOrganizationData {
      * Description longue (markdown supporté)
      */
     description?: string;
-    /**
-     * Source d'insertion (costum)
-     */
-    source?: {
-        insertOrign?: string;
-        keys?: string[];
-        key?: string;
-        [k: string]: unknown;
-    };
     /**
      * Tag principal (ex: TiersLieux)
      */
@@ -2891,10 +2866,6 @@ export interface AddOrganizationData {
      * Type d'entité du costum (ex: projects)
      */
     costumType?: string;
-    /**
-     * Mode édition costum
-     */
-    costumEditMode?: boolean;
     [k: string]: unknown;
 }
 export interface AddProjectData {
@@ -3015,6 +2986,18 @@ export interface AddProjectData {
         streetAddress?: string;
     };
     scope: "";
+    /**
+     * Slug du costum d'origine
+     */
+    costumSlug?: string;
+    /**
+     * ID Mongo du costum d'origine
+     */
+    costumId?: string;
+    /**
+     * Type d'entité du costum (ex: projects)
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface AddPoiData {
@@ -3277,14 +3260,17 @@ export interface AddPoiData {
      */
     equip_utilisateur?: string[];
     /**
-     * Source d'insertion (costum)
+     * Slug du costum d'origine
      */
-    source?: {
-        insertOrign?: string;
-        keys?: string[];
-        key?: string;
-        [k: string]: unknown;
-    };
+    costumSlug?: string;
+    /**
+     * ID Mongo du costum d'origine
+     */
+    costumId?: string;
+    /**
+     * Type d'entité du costum (ex: projects)
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface AddEventData {
@@ -3585,34 +3571,18 @@ export interface AddEventData {
         streetAddress?: string;
     };
     scope: "";
-    [k: string]: unknown;
-}
-export interface DeletePoiData {
     /**
-     * Raison de la suppression
+     * Slug du costum d'origine
      */
-    reason: string;
-    pathParams?: {
-        /**
-         * ID de l'élément à supprimer
-         */
-        id: string;
-        [k: string]: unknown;
-    };
-    [k: string]: unknown;
-}
-export interface DeleteEventData {
+    costumSlug?: string;
     /**
-     * Raison de la suppression
+     * ID Mongo du costum d'origine
      */
-    reason: string;
-    pathParams?: {
-        /**
-         * ID de l'élément à supprimer
-         */
-        id: string;
-        [k: string]: unknown;
-    };
+    costumId?: string;
+    /**
+     * Type d'entité du costum (ex: projects)
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface DeleteElementData {
@@ -3880,6 +3850,18 @@ export interface AddBadgesData {
             name?: string;
         };
     };
+    /**
+     * Slug du costum d'origine
+     */
+    costumSlug?: string;
+    /**
+     * ID Mongo du costum d'origine
+     */
+    costumId?: string;
+    /**
+     * Type d'entité du costum (ex: projects)
+     */
+    costumType?: string;
     [k: string]: unknown;
 }
 export interface AssignBadgesData {
@@ -6105,5 +6087,28 @@ export interface AddClassifiedData {
         streetAddress?: string;
     };
     scope: "";
+    /**
+     * Slug du costum d'origine
+     */
+    costumSlug?: string;
+    /**
+     * ID Mongo du costum d'origine
+     */
+    costumId?: string;
+    /**
+     * Type d'entité du costum (ex: projects)
+     */
+    costumType?: string;
+    [k: string]: unknown;
+}
+export interface PersonActivateData {
+    /**
+     * Identifiant (_id) du compte à activer
+     */
+    user: string;
+    /**
+     * Clé de validation = sha256(user + email)
+     */
+    validationKey: string;
     [k: string]: unknown;
 }

package/types/api/Event.d.ts

@@ -15,6 +15,20 @@ export declare class Event extends BaseEntity<EventItemNormalized> {
     _add: (payload: Record<string, any>) => Promise<void>;
     _update: (payload: Record<string, any>) => Promise<boolean>;
     addEvent(data?: Partial<AddEventData>): Promise<unknown>;
+    /**
+     * Supprime cet événement via `DELETE_ELEMENT` (`type=events`).
+     *
+     * **Garde** : auteur de l'événement (`serverData.creator`) OU administrateur
+     * de l'organisation/projet organisateur (via `serverData.organizer` × hiérarchie).
+     * cf. {@link BaseEntity#_deleteViaElement}.
+     *
+     * Après succès : données vidées + `_isDeleted = true`.
+     *
+     * @param reason - Raison transmise au backend (audit). Défaut `"delete event"`.
+     * @throws {ApiError} 400 si l'événement n'a pas d'id.
+     * @throws {ApiError} 403 si ni auteur ni admin de l'organisateur.
+     */
+    delete(reason?: string): Promise<void>;
     getOrganizations(): Promise<never>;
     getProjects(): Promise<never>;
     getEvents(): Promise<never>;

package/types/api/Organization.d.ts

@@ -156,6 +156,23 @@ export declare class Organization extends BaseEntity<OrganizationItemNormalized>
      * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si l'entité n'est pas enregistrée.
      */
     addOrganization(data: AddOrganizationData): Promise<unknown>;
+    /**
+     * Supprime cette organisation via `DELETE_ELEMENT` (`type=organizations`).
+     *
+     * **Garde** : auteur (`serverData.creator`) OU administrateur direct de l'org
+     * (`userContext.links.memberOf[id].isAdmin`). Pas de hiérarchie parent (une org
+     * est racine). cf. {@link BaseEntity#_deleteViaElement}.
+     *
+     * ⚠️ **Destructif** : supprime l'organisation et potentiellement ses rattachements
+     * (projets/events/membres) côté serveur. À utiliser avec précaution.
+     *
+     * Après succès : données vidées + `_isDeleted = true`.
+     *
+     * @param reason - Raison transmise au backend (audit). Défaut `"delete organization"`.
+     * @throws {ApiError} 400 si l'org n'a pas d'id.
+     * @throws {ApiError} 403 si ni auteur ni admin.
+     */
+    delete(reason?: string): Promise<void>;
     getOrganizations(): Promise<never>;
     /**
      * {@inheritDoc BaseEntity#getProjects}

package/types/api/Poi.d.ts

@@ -49,6 +49,20 @@ export declare class Poi extends BaseEntity<PoiItemNormalized> {
      */
     protected _invokeCustomFieldHandler(methodName: string, value: any, fieldName: string): Promise<any>;
     addPoi(data?: Partial<AddPoiData>): Promise<unknown>;
+    /**
+     * Supprime ce POI via `DELETE_ELEMENT` (`type=poi`).
+     *
+     * **Garde** : auteur du POI (`serverData.creator`) OU administrateur de
+     * l'organisation/projet parent (via `serverData.parent` × hiérarchie).
+     * cf. {@link BaseEntity#_deleteViaElement}.
+     *
+     * Après succès : données vidées + `_isDeleted = true`.
+     *
+     * @param reason - Raison transmise au backend (audit). Défaut `"delete poi"`.
+     * @throws {ApiError} 400 si le POI n'a pas d'id.
+     * @throws {ApiError} 403 si ni auteur ni admin du parent.
+     */
+    delete(reason?: string): Promise<void>;
     getOrganizations(): Promise<never>;
     getProjects(): Promise<never>;
     getEvents(): Promise<never>;

package/types/api/Project.d.ts

@@ -32,6 +32,23 @@ export declare class Project extends BaseEntity<ProjectItemNormalized> {
      * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si l'entité n'est pas enregistrée.
      */
     addProject(data?: Partial<AddProjectData>): Promise<unknown>;
+    /**
+     * Supprime ce projet via `DELETE_ELEMENT` (`type=projects`).
+     *
+     * **Garde** : auteur (`serverData.creator`) OU administrateur — direct
+     * (`links.projects[id].isAdmin`) ou de l'organisation parente (via
+     * `serverData.parent` × hiérarchie). cf. {@link BaseEntity#_deleteViaElement}.
+     *
+     * ⚠️ **Destructif** : supprime le projet et potentiellement ses rattachements
+     * (actions/events/membres) côté serveur. À utiliser avec précaution.
+     *
+     * Après succès : données vidées + `_isDeleted = true`.
+     *
+     * @param reason - Raison transmise au backend (audit). Défaut `"delete project"`.
+     * @throws {ApiError} 400 si le projet n'a pas d'id.
+     * @throws {ApiError} 403 si ni auteur ni admin.
+     */
+    delete(reason?: string): Promise<void>;
     getOrganizations(): Promise<never>;
     /**
      * {@inheritDoc BaseEntity#getProjects}

package/types/api/UserApi.d.ts

@@ -61,4 +61,22 @@ export declare class UserApi {
      * @throws {ApiResponseError} Si l'API retourne un échec (`result === false`).
      */
     recoverPassword(email: string): Promise<any>;
+    /**
+     * Active (valide l'email) un compte via le lien reçu par email.
+     *
+     * Endpoint public (aucune authentification requise). La `validationKey`
+     * correspond à `sha256(user + email)`. En cas de succès, le rôle
+     * `tobeactivated` est retiré et le consentement `sendMail.source` posé.
+     *
+     * @param params
+     * @param params.user - Identifiant (`_id`) du compte à activer.
+     * @param params.validationKey - Clé de validation = `sha256(user + email)`.
+     * @returns Réponse brute de l'API (`{ result: true, msg: string }`).
+     * @throws {ApiError} En cas de mise en file (offline/circuit breaker).
+     * @throws {ApiResponseError} Si l'API retourne un échec (`result === false`).
+     */
+    activateAccount({ user, validationKey }: {
+        user: string;
+        validationKey: string;
+    }): Promise<any>;
 }