@communecter/cocolight-api-client 1.0.51 → 1.0.54

package/types/api/BaseEntity.d.ts

@@ -0,0 +1,1017 @@
+/**
+ * @typedef {import("../ApiClient.js").default} ApiClient
+ * @typedef {import("./EndpointApi.js").default} EndpointApi
+ */
+/**
+ * Classe de base pour toutes les entités métiers : utilisateurs, projets, organisations, etc.
+ * Fournit un système de brouillon (draft), transformation, appel API sécurisé,
+ * et gestion de données côté client avec support du mode offline.
+ * @abstract
+ */
+export class BaseEntity {
+    static entityTag: string;
+    /**
+     * Crée une nouvelle instance d'entité à partir des données du serveur.
+     *
+     * @param {Object} data - Données du serveur.
+     * @param {BaseEntity} parent - Instance parente.
+     * @param {Object} deps - Dépendances injectées.
+     * @returns {BaseEntity} Nouvelle instance d'entité.
+     */
+    static fromServerData(data: any, parent: BaseEntity, deps: any): BaseEntity;
+    /**
+     * Restaure les données sérialisées en un objet d'origine.
+     *
+     * @param {Object} obj - L'objet à restaurer.
+     * @returns {Object} L'objet restauré.
+     */
+    static _revive(obj: any): any;
+    /**
+     * Crée une instance d'entité à partir de données JSON.
+     *
+     * @param {Object} json - Données JSON à utiliser.
+     * @param {Object} parent - Instance parente.
+     * @param {Object} deps - Dépendances injectées.
+     * @returns {object} Nouvelle instance d'entité.
+     */
+    static fromJSON(json: any, parent: any, deps: any): object;
+    /**
+     * Constructeur de l'entité.
+     * @param {Object} parent - L'ApiClient ou une entité parente.
+     * @param {Object} parent.apiClient - Instance de l'ApiClient.
+     * @param {Object} [parent.parent] - Instance parente.
+     * @param {Object} [data={}] - Données initiales.
+     * @param {Object} [deps={}] - Dépendances injectées (EndpointApi, autres entités).
+     * @param {Object|function} deps.EndpointApi - Instance de l'API.
+     * @param {function} deps.User - Classe d'entité utilisateur.
+     * @param {function} deps.Organization - Classe d'entité organisation.
+     * @param {function} deps.Project - Classe d'entité projet.
+     * @param {function} deps.Poi - Classe d'entité point d'intérêt.
+     * @param {function} deps.Event - Classe d'entité événement.
+     * @param {function} deps.Badge - Classe d'entité badge.
+     * @param {function} deps.News - Classe d'entité actualité.
+     * @param {string} [config.entityTag] - Tag d'entité (ex: "User", "Organization").
+     * @param {Object} [config={}] - Configuration optionnelle.
+     * @throws {ApiError} Si les dépendances ou parent sont invalides.
+     */
+    constructor(parent: {
+        apiClient: any;
+        parent?: any;
+    }, data?: any, deps?: {
+        EndpointApi: any | Function;
+        User: Function;
+        Organization: Function;
+        Project: Function;
+        Poi: Function;
+        Event: Function;
+        Badge: Function;
+        News: Function;
+    }, config?: any);
+    /** @type {Object} Données de brouillon modifiables */
+    _draftData: any;
+    /** @type {Object} Snapshot initial des données de brouillon */
+    _initialDraftData: any;
+    /** @type {Object|null} Données reçues du serveur */
+    _serverData: any | null;
+    /** @type {boolean} Indique si `save()` est en cours */
+    _calledFromSave: boolean;
+    /** @type {boolean} Indique si le draft est synchronisé avec le serveur */
+    _syncReactiveDraft: boolean;
+    __entityTag: any;
+    deps: {
+        EndpointApi: any | Function;
+        User: Function;
+        Organization: Function;
+        Project: Function;
+        Poi: Function;
+        Event: Function;
+        Badge: Function;
+        News: Function;
+    };
+    /** @type {ApiClient} */
+    apiClient: ApiClient;
+    parent: {
+        apiClient: any;
+        parent?: any;
+    };
+    userContext: any;
+    /** @type {EndpointApi} */
+    endpointApi: EndpointApi;
+    data: any;
+    getEntityTag: (__entityTag: any) => any;
+    /** @returns {string|null} Identifiant de l'entité */
+    get id(): string | null;
+    /** @returns {string|null} Slug de l'entité */
+    get slug(): string | null;
+    /** Définit un ID (utilisé en interne) */
+    _id(newId: any): void;
+    /** @returns {boolean} Indique si l'utilisateur est connecté */
+    get isConnected(): boolean;
+    /** @returns {string|null} Identifiant utilisateur associé */
+    get userId(): string | null;
+    /** @returns {Object} Données de brouillon courantes */
+    get draftData(): any;
+    /** @returns {Object} Données de brouillon initiales */
+    get initialDraftData(): any;
+    /** @returns {Object|null} Données brutes du serveur */
+    get serverData(): any | null;
+    /** @returns {boolean} Indique si cette entité représente l'utilisateur connecté */
+    get isMe(): boolean;
+    /** @returns {string} Type de l'entité (ex: 'citoyens') */
+    getEntityType(): string;
+    /**
+     * Indique si le draft contient des modifications par rapport aux données initiales.
+     * @returns {boolean}
+     */
+    hasChanges(): boolean;
+    /**
+     * Rafraîchit l'entité en rechargeant ses données depuis le serveur.
+     * @returns {Promise<Object>} Données mises à jour
+     */
+    refresh(): Promise<any>;
+    /**
+     * Sauvegarde les modifications locales vers le serveur (add ou update).
+     * @returns {Promise<Object>} Données serveur mises à jour
+     */
+    save(): Promise<any>;
+    /**
+     * Met à jour les données de l'entité avec de nouvelles données.
+     *
+     * @param {Object} newData - Les nouvelles données à appliquer.
+     * @returns {void}
+     * @private
+     */
+    private _setData;
+    _updateDraftPreservingUserChanges(draft: any): void;
+    _resetInitialDraftData(): void;
+    _toRawDeep(obj: any): any;
+    /**
+     * Champs à ajouter automatiquement à chaque draft (ex: `typeElement`).
+     * Souvent utilisés dans les conditions `if/then` du JSON Schema.
+     * @type {Object<string, any>}
+     */
+    defaultFields: {
+        [x: string]: any;
+    };
+    /**
+     * Champs à exclure explicitement du draft et des payloads.
+     * @type {string[]}
+     */
+    removeFields: string[];
+    /**
+     * Transformations à appliquer à certains champs lors de la lecture depuis le draft.
+     * Clé = champ, valeur = fonction (val, full) => valeur transformée.
+     * @type {Object<string, function(any, object): any>}
+     */
+    transforms: {
+        [x: string]: (arg0: any, arg1: object) => any;
+    };
+    /**
+     * ───────────────────────────────
+     * JSON
+     * ───────────────────────────────
+     */
+    /**
+     * Convertit l'instance en JSON pour l'envoi au serveur.
+     *
+     * @returns {Object} Représentation JSON de l'instance.
+     */
+    toJSON(): any;
+    _serialize(obj: any): any;
+    /**
+     * Supprime les propriétés non sérialisables d'un objet.
+     *
+     * @param {Object} obj - L'objet à nettoyer.
+     * @param {WeakSet} [seen] - Ensemble pour éviter les références circulaires.
+     * @returns {Object} L'objet nettoyé.
+     * @private
+     */
+    private _removeUnserializables;
+    /**
+     * ───────────────────────────────
+     * UtilMixin
+     * ───────────────────────────────
+     */
+    /**
+     * Appelle une méthode de l'API.
+     *
+     * @param {string} constant - Le nom de la méthode à appeler.
+     * @param {object} data - Les données à passer à la méthode.
+     * @returns {Promise<any>} - La promesse de la méthode appelée.
+     * @throws {ApiValidationError} - Si une erreur se produit lors de l'appel de l'API.
+     * @throws {ApiResponseError} - Si une erreur se produit lors de l'appel de l'API.
+     * @throws {ApiClientError} - Si l'utilisateur n'est pas authentifié.
+     */
+    call(constant: string, data?: object): Promise<any>;
+    /**
+     * Appelle une méthode de l'API si l'utilisateur n'est pas connecté.
+     *
+     * @param {string} constant - Le nom de la méthode à appeler.
+     * @param {object} data - Les données à passer à la méthode.
+     * @returns {Promise<any>} - La promesse de la méthode appelée.
+     * @throws {ApiAuthenticationError} - Si l'utilisateur est connecté.
+     * @throws {ApiValidationError} - Si une erreur se produit lors de l'appel de l'API.
+     * @throws {ApiResponseError} - Si une erreur se produit lors de l'appel de l'API.
+     * @throws {ApiClientError} - Si une erreur se produit lors de l'appel de l'API.
+     */
+    callNoConnected(constant: string, data?: object): Promise<any>;
+    /**
+     * Appelle une méthode de l'API si l'utilisateur est connecté.
+     *
+     * @param {string|function} param - Le nom de la méthode à appeler ou une fonction de rappel.
+     * @param {object} data - Les données à passer à la méthode.
+     * @returns {Promise<any>} - La promesse de la méthode appelée.
+     * @throws {ApiAuthenticationError} - Si l'utilisateur n'est pas connecté.
+     * @throws {ApiValidationError} - Si une erreur se produit lors de l'appel de l'API.
+     * @throws {ApiResponseError} - Si une erreur se produit lors de l'appel de l'API.
+     * @throws {ApiClientError} - Si une erreur se produit lors de l'appel de l'API.
+     */
+    callIsConnected(param: string | Function, data?: object): Promise<any>;
+    /**
+     * Appelle une méthode de l'API si l'utilisateur est lui-même.
+     *
+     * @param {string|function} param - Le nom de la méthode à appeler ou une fonction de rappel.
+     * @param {object} data - Les données à passer à la méthode.
+     * @returns {Promise<any>} - La promesse de la méthode appelée.
+     * @throws {ApiAuthenticationError} - Si l'utilisateur n'est pas lui-même.
+     * @throws {ApiValidationError} - Si une erreur se produit lors de l'appel de l'API.
+     * @throws {ApiResponseError} - Si une erreur se produit lors de l'appel de l'API.
+     * @throws {ApiClientError} - Si une erreur se produit lors de l'appel de l'API.
+     */
+    callIsMe(param: string | Function, data?: object): Promise<any>;
+    /**
+     * Valide une image d'entrée.
+     *
+     * @param {File|Blob|Buffer|ReadableStream} imageInput - L'image à valider.
+     * @returns {Promise<File|Buffer|ReadableStream>} - L'image validée.
+     * @private
+     */
+    private _validateImage;
+    /**
+     * Valide un fichier d'entrée.
+     *
+     * @param {File|Blob|Buffer|ReadableStream} fileInput - Le fichier à valider.
+     * @returns {Promise<File|Buffer|ReadableStream>} - Le fichier validé.
+     * @private
+     */
+    private _validateFile;
+    /**
+     * Valide les entrées d'upload de fichiers.
+     *
+     * @param {File|Blob|Buffer|ReadableStream} input - Le fichier à valider.
+     * @param {Object} options - Options de validation.
+     * @param {Array} options.allowedMimeTypes - Types MIME autorisés.
+     * @param {string} options.expectedType - Type de fichier attendu (ex: "image", "file").
+     * @returns {Promise<File|Buffer|ReadableStream>} - Le fichier validé.
+     * @throws {ApiValidationError} - Si le type de fichier est invalide.
+     * @throws {Error} - Si le type de fichier est inconnu.
+     * @private
+     */
+    private _validateUploadInput;
+    /**
+     * Transforme un Buffer en ReadableStream équivalent à fs.createReadStream
+     * @param {Buffer} buffer - Le buffer contenant les données binaires
+     * @param {string} filename - Nom de fichier (utilisé dans FormData)
+     * @param {string} mimeType - Type MIME (utilisé dans FormData)
+     * @returns {Object} - { stream, filename, mimeType }
+     * @private
+     */
+    private _createReadStreamFromBuffer;
+    /**
+     * Transforme un Buffer en ReadableStream.
+     *
+     * @param {Buffer} buffer - Le buffer à transformer.
+     * @returns {Promise<stream.Readable>} - Un ReadableStream.
+     * @throws {Error} - Si appelé dans le navigateur.
+     * @private
+     */
+    private _bufferToReadable;
+    /**
+     * Crée un PassThrough stream pour le traitement des fichiers.
+     *
+     * @returns {Promise<stream.PassThrough>} - Un PassThrough stream.
+     * @throws {Error} - Si appelé dans le navigateur.
+     * @private
+     */
+    private _passThrough;
+    /**
+     * Supprime les propriétés d'un objet en fonction d'une liste de clés.
+     *
+     * @param {Object} obj - L'objet source.
+     * @param {Array} propsToRemove - Liste des clés à supprimer
+     * @param {boolean} [deep=false] - Si vrai, supprime les propriétés de manière récursive.
+     * @returns {Object} - Un nouvel objet sans les propriétés supprimées.
+     * @private
+     */
+    private _omitProps;
+    /**
+     * Extrait les propriétés d'un objet en fonction d'une liste de clés.
+     *
+     * @param {Object} obj - L'objet source.
+     * @param {Array} keys - Liste des clés à extraire.
+     * @param {Object} [transforms={}] - Transformations à appliquer aux valeurs.
+     * @returns {Object} - Un nouvel objet contenant les propriétés extraites.
+     * @private
+     */
+    private _pickProps;
+    /**
+     * Vérifie si au moins une clé est présente dans l'objet et n'est pas nulle.
+     *
+     * @param {Object} obj - L'objet à vérifier.
+     * @param {Array} keys - Liste des clés à vérifier.
+     * @returns {boolean} - true si au moins une clé est présente et non nulle, sinon false.
+     * @private
+     */
+    private _hasAtLeastOne;
+    /**
+     * Crée un proxy filtré pour une liste d'entités.
+     * @param {Array} list - Liste d'entités.
+     * @returns {Proxy} Proxy filtré.
+     * @private
+     */
+    private _createFilteredProxy;
+    /**
+     * Génère un nouvel identifiant unique.
+     * @returns {string} Un identifiant unique.
+     * @private
+     */
+    private _newId;
+    /**
+     * ───────────────────────────────
+     * DraftStateMixin
+     * ───────────────────────────────
+     */
+    /**
+     * Crée un proxy combinant draft + serveur, avec transformations facultatives.
+     * @param {Object} server
+     * @param {Object} draft
+     * @param {Array} allowedFields - champs autorisés dans le draft
+     * @param {Object} [transforms={}] - transformateurs de lecture
+     * @param {Object} [options={}] - options
+     * @returns {Proxy}
+     * @private
+     */
+    private _createDraftProxy;
+    /**
+     * Extrait les champs modifiables d'un schéma JSON.
+     *
+     * @param {Object} schema - Le schéma JSON à analyser.
+     * @param {Object} data - Les données à comparer.
+     * @param {Object} ctx - Contexte d'extraction (pour la récursion).
+     * @param {Object} ctx.defs - Définitions de schéma.
+     * @param {Set} ctx.visited - Ensemble des schémas déjà visités.
+     * @returns {Array} - Liste des champs modifiables.
+     * @private
+     */
+    private _extractWritableFields;
+    /**
+     * Construit un brouillon et un proxy à partir des données et du schéma.
+     *
+     * @param {Object} options - Options de construction.
+     * @param {Object} options.data - Données à utiliser pour le brouillon.
+     * @param {Object} [options.serverData=null] - Données du serveur.
+     * @param {string|Array} options.constant - Nom de la constante ou tableau de constantes.
+     * @param {ApiClient} options.apiClient - Instance de l'API.
+     * @param {Object} [options.transforms={}] - Transformations à appliquer.
+     * @param {boolean} [options.throwOnError=true] - Si vrai, lève une erreur en cas de problème.
+     * @param {Array} [options.removeFields=[]] - Liste des champs à ignorer.
+     * @returns {Object} - Objet contenant le brouillon et le proxy.
+     * @private
+     */
+    private _buildDraftAndProxy;
+    /**
+     * Extrait les champs modifiés du schéma.
+     *
+     * @param {ApiClient} apiClient - Instance de l'API.
+     * @param {string} constant - Nom de la constante.
+     * @param {Object} data - Données à comparer.
+     * @param {Function} getInitialDraft - Fonction pour obtenir le brouillon initial.
+     * @param {Array} removeFields - Liste des champs à ignorer.
+     * @returns {Object|null} - Champs modifiés ou null.
+     * @private
+     */
+    private _extractChangedFieldsFromSchema;
+    /**
+     * Extrait tous les champs valides selon le schéma, et retourne uniquement ceux qui ont changé par rapport au draft initial.
+     * Contrairement à `_extractChangedFieldsFromSchema`, cette méthode retourne l'ensemble des champs valides (`updated`)
+     * uniquement s'il y a au moins un champ modifié (`changed`).
+     *
+     * ⚠️ Les champs sont filtrés en fonction :
+     * - des champs définis comme modifiables dans le schéma (`writeable`)
+     * - des champs non exclus dans `removeFields`
+     * - des champs définis dans `data` (les `undefined` sont ignorés)
+     *
+     * @param {ApiClient} apiClient - L’instance de client API contenant les schémas.
+     * @param {string} constant - Le nom de la constante de schéma (ex: "ADD_EVENT").
+     * @param {Object} data - Les nouvelles données à comparer avec le draft initial.
+     * @param {() => Object} getInitialDraft - Fonction qui retourne le draft initial (souvent `this.initialDraftData`).
+     * @param {string[]} [removeFields=[]] - Champs à ignorer même s’ils sont valides.
+     * @returns {Object|null} - Un objet `updated` avec les champs valides si au moins un champ a changé, sinon `null`.
+     * @private
+     */
+    private _extractAllValidFieldsFromSchema;
+    /**
+     * ───────────────────────────────
+     * MutualEntityMixin
+     * ───────────────────────────────
+     */
+    /**
+     * Résout l'identifiant de l'entité si seul le slug est fourni.
+     * @param {string} type - Le type d'entité (ex : "citoyens", "organizations", "projects").
+     * @returns {Promise<string>} L'identifiant résolu.
+     * @private
+     */
+    private _resolveId;
+    /**
+     * Récupère le profil public de l'entité.
+     *
+     * @returns {Promise<Object>} - Les données du profil public.
+     * @private
+     */
+    private _getPublicProfile;
+    /**
+     * Récupère la classe d'entité et ses dépendances à partir du type d'entité.
+     *
+     * @param {string} entityType - Le type d'entité.
+     * @return {{ entityClass: Function, deps: Object } | null}
+     * @private
+     */
+    private _getEntityMeta;
+    /**
+     * Lier des données d'entité à une instance d'entité.
+     *
+     * @param {string} entityType - Le type d'entité (ex : "citoyens", "organisations", "projets").
+     * @param {Object} entityData - Les données de l'entité à lier.
+     * @return {Object} L'entité liée.
+     * @private
+     */
+    private _linkEntity;
+    /**
+     * Récupère et lie une entité à partir de son ID.
+     *
+     * @param {string} entityType - Le type d'entité.
+     * @param {string} entityId - L'identifiant de l'entité.
+     * @param {Object} [options] - Options supplémentaires :
+     * @param {boolean} [options.skipGet] - Si true, ne pas appeler `get()` sur l'entité.
+     * @return {Promise<Object|null>} L'entité liée ou null.
+     * @private
+     */
+    private _linkEntityById;
+    /**
+     * Lie une liste d'entités à partir de leurs données.
+     *
+     * @param {Array<Object>} results - Liste de données d'entités.
+     * @return {Array<Object>} Liste d'entités liées.
+     * @private
+     */
+    private _linkEntities;
+    /**
+     * Lie des entités présentes dans `this.serverData` à partir de leurs IDs,
+     * en les filtrant dynamiquement et en optionnellement les transformant.
+     *
+     * @param {string} entityType - Le type d'entité (ex : "badges", "citoyens", etc.).
+     * @param {Object} filters - Clés/valeurs de filtres dynamiques. Les valeurs peuvent être :
+     *   - un littéral (comparaison stricte ou intelligente selon le type),
+     *   - une chaîne (utilise `includes` insensible à la casse),
+     *   - une RegExp (appliquée si la valeur est une chaîne),
+     *   - une fonction `(value) => boolean`.
+     * @param {Object} [options] - Options supplémentaires :
+     * @param {string} [options.key] - Le champ de `this.serverData` à utiliser (par défaut = entityType).
+     * @param {Function} [options.mapFn] - Fonction de transformation `(entity) => any` appliquée au résultat.
+     *
+     * @return {Promise<Array<Object>>} Liste des entités liées, filtrées et éventuellement transformées.
+     *
+     * @example
+     * // Tous les badges avec `name` contenant "codev"
+     * const badges = await this.linkEntitiesFromServerData("badges", { name: "codev" });
+     *
+     * @example
+     * // Badges non expirés et visibles
+     * const badges = await this.linkEntitiesFromServerData("badges", {
+     *   expiredOn: false,
+     *   show: "true"
+     * });
+     *
+     * @example
+     * // Badges émis après 2023
+     * const badges = await this.linkEntitiesFromServerData("badges", {
+     *   issuedOn: (v) => new Date(v) >= new Date("2023-01-01")
+     * });
+     *
+     * @example
+     * // Extraire uniquement les noms des badges
+     * const namesOnly = await this.linkEntitiesFromServerData("badges", {}, {
+     *   mapFn: (badge) => badge.meta.name
+     * });
+     */
+    linkEntitiesFromServerData(entityType: string, filters?: any, options?: {
+        key?: string;
+        mapFn?: Function;
+    }): Promise<Array<any>>;
+    /**
+     * Crée une instance d'entité à partir des données fournies.
+     * @param {string} entityType - Le type d'entité (ex : "citoyens", "organisations", "projets").
+     * @param {Object} entityData - Les données de l'entité.
+     * @return {Object} L'entité créée.
+     * @private
+     */
+    private _entityInstanceData;
+    /**
+     * Crée une instance d'entité, et déclenche get() si certaines propriétés sont présentes.
+     * @param {string} entityType
+     * @param {Object} entityData
+     * @return {Promise<Object>}
+     */
+    entity(entityType: string, entityData?: any): Promise<any>;
+    /**
+     * Récupère et lie une entité à partir de son slug.
+     * @param {string} slug - Le slug de l'entité.
+     * @return {Promise<Object|null>} L'entité liée ou null.
+     */
+    entityBySlug(slug: string): Promise<any | null>;
+    /**
+     * Construit dynamiquement des filtres sur un lien entre entités
+     *
+     * @param {string} id - L'ID de l'entité cible.
+     * @param {Object} options - Options de filtrage.
+     * @param {"memberOf" | "projects"} [options.linkType] - Le type de lien (ex: "memberOf", "projects", etc.).
+     * @param {boolean} [options.isAdmin] - Si défini, filtre selon l'existence de isAdmin.
+     * @param {boolean} [options.isAdminPending] - Si défini, filtre selon l'existence de isAdminPending.
+     * @param {boolean} [options.isInviting] - Si défini, filtre selon l'existence de isInviting.
+     * @param {boolean} [options.toBeValidated] - Si défini, filtre selon l'existence de toBeValidated.
+     * @param {Array<string>} [options.roles] - Rôles à filtrer.
+     * @returns {Object} - Un objet de filtres à passer à une requête.
+     * @throws {TypeError} - Si les types des paramètres ne sont pas valides.
+     * @private
+     */
+    private _buildLinkFilters;
+    /**
+     * Retourne les métadonnées de lien pour une entité :
+     * - `linkType` : clé dans `serverData.links`
+     * - `connectTypeConnect` : valeur envoyée pour `connect()`
+     * - `connectTypeDisconnect` : valeur envoyée pour `disconnect()`
+     * @typedef {Object} LinkMeta
+     * @property {string} linkType
+     * @property {string} connectTypeConnect
+     * @property {string} connectTypeDisconnect
+     * @returns {LinkMeta}
+     * @throws {ApiError} - Si le type d'entité est inconnu.
+     * @private
+     */
+    private _getLinkMeta;
+    /**
+     * Vérifie si l'entité prend en charge les opérations de lien (`connect`, `disconnect`, etc.).
+     * Utilise `_getLinkMeta()` comme source unique de vérité.
+     *
+     * @throws {ApiError} - Si l'entité ne supporte pas les liens.
+     * @private
+     */
+    private _checkLinkableEntity;
+    /**
+     * Retourne le lien de l'utilisateur connecté avec l'entité cible (dans `parent.serverData.links`)
+     * @private
+     */
+    private _getLinkFromConnectedUser;
+    /**
+     * Soumet une demande de connexion à une entité (ex : membre, contributeur),
+     * ou valide l'invitation si elle existe déjà.
+     *
+     * @returns {Promise<Object>} - Résultat de l'API
+     * @throws {ApiError} - En cas d'erreur de connexion ou d'invitation.
+     * @private
+     */
+    private _submitLinkRequest;
+    /**
+     * Soumet une demande pour devenir administrateur d'une entité.
+     *
+     * @returns {Promise<Object>}
+     * @throws {ApiError}
+     * @private
+     */
+    private _submitLinkRequestAdmin;
+    /**
+     * Accepte une demande de lien (ex : invitation à rejoindre un groupe).
+     *
+     * @returns {Promise<Object>} - Résultat de l'API
+     * @throws {ApiError} - En cas d'erreur de connexion ou d'invitation.
+     * @private
+     */
+    private _acceptLinkRequest;
+    /**
+     * Annule une demande de lien ou se déconnecte d'une entité.
+     *
+     * @returns {Promise<Object>} - Résultat de l'API
+     * @throws {ApiError} - En cas d'erreur de connexion ou d'invitation.
+     * @private
+     */
+    private _leaveLinkRequest;
+    /**
+     * ───────────────────────────────
+     * EntityMixin
+     * ───────────────────────────────
+     */
+    /**
+     * Récupérer le profil public de l'entité
+     *
+     * @returns {Promise<Object>} - Les données de réponse.
+     */
+    get(): Promise<any>;
+    /**
+     * Mettre à jour les paramètres d'un élément : Mise à jour des paramètres spécifiques d'un élément.
+     * Constant : UPDATE_SETTINGS
+     * @param {Object} data - Les données à envoyer.
+     * @param {string} data.type - data.type
+     * @param {undefined} data.value - data.value
+     * @returns {Promise<Object>} - 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.
+     */
+    updateSettings(data?: {
+        type: string;
+        value: undefined;
+    }): Promise<any>;
+    /**
+     * Mettre à jour la description d'un élément : Permet de mettre à jour la description courte et complète d'un élément.
+     * Constant : UPDATE_BLOCK_DESCRIPTION
+     * @param {Object} data - Les données à envoyer.
+     * @param {string} data.descMentions - Mentions dans la description (default: "")
+     * @param {string} data.shortDescription - Courte description
+     * @param {string} data.description - Description complète
+     * @returns {Promise<Object>} - 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.
+     */
+    updateDescription(data?: {
+        descMentions: string;
+        shortDescription: string;
+        description: string;
+    }): Promise<any>;
+    /**
+       * Mettre à jour les informations d'un élément : Permet de mettre à jour les informations générales d'un élément (nom, contacts, etc.).
+       * Constant : UPDATE_BLOCK_INFO
+       */
+    updateInfo(data?: {}): Promise<any>;
+    /**
+     * Mettre à jour les réseaux sociaux d'un élément : Permet de mettre à jour les liens vers les réseaux sociaux d'un élément.
+     * Constant : UPDATE_BLOCK_SOCIAL
+     */
+    updateSocial(data?: {}): Promise<any>;
+    /**
+     * Mettre à jour les localités d'un élément : Permet de mettre à jour l'adresse et les informations géographiques d'un élément.
+     * Constant : UPDATE_BLOCK_LOCALITY
+     */
+    updateLocality(data?: {}): Promise<any>;
+    /**
+     * Mettre à jour le slug d'un élément : Permet de mettre à jour le slug pour une URL simplifiée.
+     * Constant : UPDATE_BLOCK_SLUG
+     * @param {Object} data - Les données à envoyer.
+     * @param {string} data.slug - Le nouveau slug à appliquer.
+     * @returns {Promise<Object>} - Les données de réponse.
+     */
+    updateSlug({ slug }: {
+        slug: string;
+    }): Promise<any>;
+    /**
+     * Mettre à jour l'image de profil : Permet de mettre à jour l'image de profil d'un utilisateur ou d'une entité.
+     * Constant : PROFIL_IMAGE
+     * @param {Object} data - Les données à envoyer.
+     * @param {string} data.profil_avatar - L'image de profil à mettre à jour.
+     * @returns {Promise<Object>} - Les données de réponse.
+     */
+    updateImageProfil({ profil_avatar: image }: {
+        profil_avatar: string;
+    }): Promise<any>;
+    /**
+     * Crée une instance d'organisation et récupère son profil si nécessaire.
+     *
+     * @param {Object} organizationData - Les données nécessaires pour initialiser l'organisation.
+     * @returns {Promise<Organization>} Une promesse qui résout l'objet Organisation créé.
+     * @throws {Error} Si une erreur se produit lors de la création de l'organisation.
+     */
+    organization(organizationData?: any): Promise<Organization>;
+    /**
+     * Crée une instance de projet et récupère son profil si nécessaire.
+     *
+     * @param {Object} projectData - Les données nécessaires pour initialiser le projet.
+     * @returns {Promise<Project>} Une promesse qui résout l'objet Projet créé.
+     * @throws {Error} Si une erreur se produit lors de la création du projet.
+     */
+    project(projectData?: any): Promise<Project>;
+    /**
+     * Crée une instance de POI et la récupère si nécessaire.
+     *
+     * @param {Object} poiData - Les données nécessaires pour initialiser le POI.
+     * @returns {Promise<Poi>} Une promesse qui résout l'objet POI créé.
+     * @throws {Error} Si une erreur se produit lors de la création du POI.
+     */
+    poi(poiData?: any): Promise<Poi>;
+    /**
+     * Crée une instance d'événement et la récupère si nécessaire.
+     *
+     * @param {Object} eventData - Les données nécessaires pour initialiser l'événement.
+     * @returns {Promise<Event>} Une promesse qui résout l'objet Événement créé.
+     * @throws {Error} Si une erreur se produit lors de la création de l'événement.
+     */
+    event(eventData?: any): Promise<Event>;
+    /**
+     * Crée une instance de badge et la récupère si nécessaire.
+     *
+     * @param {Object} badgeData - Les données nécessaires pour initialiser le badge.
+     * @returns {Promise<Badge>} Une promesse qui résout l'objet Badge créé.
+     * @throws {Error} Si une erreur se produit lors de la création du badge.
+     */
+    badge(badgeData?: any): Promise<Badge>;
+    /**
+     * Crée une instance de news et la récupère si nécessaire.
+     *
+     * @param {Object} newsData - Les données nécessaires pour initialiser la news.
+     * @returns {Promise<News>} Une promesse qui résout l'objet News créé.
+     * @throws {Error} Si une erreur se produit lors de la création de la news.
+     */
+    news(newsData?: any): Promise<News>;
+    /**
+     * Récupérer les organisations d'une entitée : la liste des organisations dont l'entité est membre ou admin valide.
+     * Constant : GET_ORGANIZATIONS_ADMIN | GET_ORGANIZATIONS_NO_ADMIN
+     * @param {Object} data - Les données à envoyer.
+     * @param {boolean} isNext - Indique si c'est une recherche suivante (pagination).
+     * @returns {Promise<Object>} - Les données de réponse.
+     */
+    getOrganizations(data?: any): Promise<any>;
+    /**
+     * Récupérer les projets d'une entitée : liste des projets de l'entité ou elle est "parent" ou "contributeur".
+     * Constant : GET_PROJECTS_ADMIN | GET_PROJECTS_NO_ADMIN
+     * @param {Object} data - Les données à envoyer.
+     * @param {boolean} isNext - Indique si c'est une recherche suivante (pagination).
+     * @returns {Promise<Object>} - Les données de réponse.
+     */
+    getProjects(data?: any): Promise<any>;
+    /**
+     * Récupérer les POIs d'une entité : liste des POIs de l'entité ou elle est "parent".
+     * Constant : GET_POIS_NO_ADMIN / GET_POIS_ADMIN
+     * @param {Object} data - Les données à envoyer.
+     * @param {boolean} isNext - Indique si c'est une recherche suivante (pagination).
+     * @returns {Promise<Object>} - Les données de réponse.
+     */
+    getPois(data?: any): Promise<any>;
+    /**
+     * Récupérer les abonnés d'une entité
+     * Constant : GET_SUBSCRIBERS
+     * @param {Object} data - Les données à envoyer.
+     * @param {boolean} isNext - Indique si c'est une recherche suivante (pagination).
+     * @returns {Promise<Object>} - Les données de réponse.
+     */
+    getSubscribers(data?: any): Promise<any>;
+    /**
+     * Liste des badges créés par l'entité
+     * Constant : GET_BADGES
+     * @param {Object} data - Les données à envoyer.
+     * @param {boolean} isNext - Indique si c'est une recherche suivante (pagination).
+     * @returns {Promise<Object>} - Les données de réponse.
+     */
+    getBadgesIssuer(data?: any): Promise<any>;
+    /**
+     * Récupérer les actualités : Récupère la liste d’actualités selon plusieurs critères.
+     * Constant : GET_NEWS
+     * @param {Object} data - Les données à envoyer.
+     * @param {number} data.dateLimit - Limite de date timestamp ou 0 (default: 0)
+     * @param {object} data.search - data.search
+     * @param {string} data.search.name - Nom ou terme recherché (default: "")
+     * @param {number} data.indexStep - Nombre de résultats par page (default: 12)
+     * @returns {Promise<Object>} - 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.
+     */
+    getNews(data?: {
+        dateLimit: number;
+        search: {
+            name: string;
+        };
+        indexStep: number;
+    }): Promise<any>;
+    /**
+     * Récupérer la galerie d'une entité.
+     * Constant : GET_GALLERY
+     * @param {Object} data - Les données à envoyer.
+     * @param {string} data.pathParams.docType - Type de document (default: "image")
+     * @param {string} data.contentKey - Clé de contenu pour la galerie (default: "null")
+     * @param {string} data.folderId - ID du dossier pour la galerie (default: "null")
+     * @returns {Promise<Object>} - 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.
+     */
+    getGallery(data?: any): Promise<any>;
+    /**
+     * Soumet une demande pour rejoindre l'entité courante (ex. organisation, projet, événement...).
+     * Si une invitation est en attente, elle est automatiquement acceptée.
+     *
+     * @returns {Promise<Object>} - Résultat de la demande ou de la validation.
+     * @throws {ApiError} - Si l'entité ne supporte pas l'action ou si une demande est déjà en cours.
+     */
+    requestToJoin(): Promise<any>;
+    /**
+     * Soumet une demande pour devenir administrateur de l'entité courante.
+     * Si une invitation est en attente, elle est automatiquement validée.
+     *
+     * @returns {Promise<Object>} - Résultat de la demande ou de la validation.
+     * @throws {ApiError} - Si l'entité ne supporte pas l'action ou si une demande est déjà en cours.
+     */
+    requestToJoinAdmin(): Promise<any>;
+    /**
+     * Accepte une invitation à rejoindre l'entité courante.
+     * Ne fonctionne que si un lien avec `isInviting` est détecté.
+     *
+     * @returns {Promise<Object>} - Résultat de l'acceptation de l'invitation.
+     * @throws {ApiError} - Si aucune invitation n'est en attente ou si l'entité ne supporte pas cette action.
+     */
+    acceptInvitation(): Promise<any>;
+    /**
+     * Se désengage de l'entité courante : quitte un rôle (membre, contributeur, etc.).
+     *
+     * @returns {Promise<Object>} - Résultat de la déconnexion.
+     * @throws {ApiError} - Si l'entité ne supporte pas l'action ou si l'utilisateur n'est pas lié à cette entité.
+     */
+    leave(): Promise<any>;
+    /**
+     * S'abonne à l'entité courante.
+     *
+     * @returns {Promise<Object>} - Résultat de l'abonnement.
+     * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si l'entité n'est pas enregistrée.
+     */
+    follow(): Promise<any>;
+    /**
+     * Se désabonne de l'entité courante.
+     *
+     * @returns {Promise<Object>} - Résultat de la désinscription.
+     * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si l'entité n'est pas enregistrée.
+     */
+    unfollow(): Promise<any>;
+    /**
+     * Vérifie si l'utilisateur est connecté et a accès à l'entité.
+     *
+     * @param {string} action - Action à effectuer.
+     * @returns {void}
+     * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si l'entité n'est pas enregistrée.
+     * @private
+     */
+    private _checkAccess;
+    /**
+     * Vérifie si l'utilisateur a un lien valide avec l'entité.
+     *
+     * @param {Object} userLink - Lien de l'utilisateur avec l'entité.
+     * @param {boolean} userLink.toBeValidated - Indique si le lien est en attente de validation.
+     * @param {boolean} userLink.isInviting - Indique si l'utilisateur a été invité.
+     * @returns {boolean} - `true` si le lien est valide, `false` sinon.
+     * @private
+     */
+    private _validateUserLink;
+    /**
+     * Vérifie si l'entité est d'un type spécifique.
+     *
+     * @param {...string} types - Types d'entité attendus.
+     * @throws {ApiError} - Si l'entité n'est pas du type attendu.
+     * @private
+     */
+    private _assertEntityType;
+    /**
+     * Vérifie si l'entité est liée à un type de lien spécifique.
+     *
+     * @param {string} linkType - Type de lien à vérifier.
+     * @returns {boolean} - `true` si l'entité est liée, `false` sinon.
+     * @private
+     */
+    private _isLinked;
+    /**
+     * Vérifie si l'utilisateur est l'auteur de l'entité.
+     *
+     * @returns {boolean} - `true` si l'utilisateur est l'auteur, `false` sinon.
+     * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si les données du serveur ne sont pas disponibles.
+     */
+    isAuthor(): boolean;
+    /**
+     * Vérifie si l'utilisateur est administrateur de l'entité.
+     *
+     * @returns {boolean} - `true` si l'utilisateur est administrateur, `false` sinon.
+     * @throws {ApiError}
+     */
+    isAdmin(): boolean;
+    /**
+     * Vérifie si l'utilisateur est soit l'auteur, soit administrateur de l'entité.
+     *
+     * @returns {boolean} - `true` si l'utilisateur est l'auteur ou administrateur, `false` sinon.
+     * @throws {ApiError}
+     */
+    isAuthorOrAdmin(): boolean;
+    /**
+     * Vérifie si l'utilisateur est membre de l'entité.
+     *
+     * @returns {boolean} - `true` si l'utilisateur est membre, `false` sinon.
+     * @throws {ApiError}
+     */
+    isMember(): boolean;
+    /**
+     * Vérifie si l'utilisateur est contributeur de l'entité.
+     *
+     * @returns {boolean} - `true` si l'utilisateur est contributeur, `false` sinon.
+     * @throws {ApiError}
+     */
+    isContributor(): boolean;
+    /**
+     * Vérifie si l'utilisateur est participant de l'entité.
+     *
+     * @returns {boolean} - `true` si l'utilisateur est participant, `false` sinon.
+     * @throws {ApiError}
+     */
+    isAttendee(): boolean;
+    /**
+     * Vérifie si l'utilisateur suit l'entité.
+     *
+     * @returns {boolean} - `true` si l'utilisateur suit l'entité, `false` sinon.
+     * @throws {ApiError}
+     */
+    isFollower(): boolean;
+    /**
+     * Vérifie si l'utilisateur est abonné à l'entité.
+     *
+     * @returns {boolean} - `true` si l'utilisateur est abonné, `false` sinon.
+     * @throws {ApiError}
+     */
+    isFollowing(): boolean;
+    /**
+     * Récupère le JSON personnalisé de l'entité
+     *
+     * @returns {Promise<Object>} - Le JSON personnalisé de l'entité.
+     * @throws {ApiError} - Si le slug de l'entité n'est pas défini.
+     */
+    getCostumJson(): Promise<any>;
+    /**
+     * Génère des plages d'index pour la pagination.
+     *
+     * @param {Array<string>} searchType - Types de recherche.
+     * @param {number} indexStep - Pas d'index.
+     * @param {Object} previousRanges - Plages précédentes.
+     * @returns {Object} - Plages d'index générées.
+     * @private
+     */
+    private _generateRanges;
+    /**
+     * Normalise le compte des résultats.
+     *
+     * @param {Object} count - Compte des résultats.
+     * @returns {Object} - Compte normalisé.
+     * @private
+     */
+    private _normalizeCount;
+    /**
+     * Récupère une valeur par défaut depuis un endpoint donné.
+     *
+     * @param {string} constant - Le nom unique de l’endpoint (ex: "GET_ORGANIZATIONS_NO_ADMIN")
+     * @param {string} path - Le chemin vers la propriété (ex: "searchType")
+     * @returns {*} La valeur par défaut, ou undefined si non trouvée
+     */
+    _getDefaultFromEndpoint(constant: string, path: string): any;
+    /**
+     * Coeur de pagination stateless et réutilisable, sans logique métier.
+     *
+     * @param {Object} config
+     * @param {Object} config.initialData - Paramètres de départ
+     * @param {Function} config.finalizer - Fonction async qui retourne { results, count }
+     *
+     * @returns {Object} paginator avec .next() et .prev()
+     */
+    _createPaginatorEngine({ initialData, finalizer }: {
+        initialData: any;
+        finalizer: Function;
+    }): any;
+    /**
+   * Injection de contexte Communecter dans une requête finalizer.
+   *
+   * @param {Function} baseFinalizer - fonction async(data) => { results, count }
+   * @returns {Function} fonction enrichie
+   */
+    _withCostumContext(baseFinalizer: Function): Function;
+    /**
+     * ───────────────────────────────
+     *  custom
+     * ───────────────────────────────
+     */
+    /**
+     * Recherche liée à l'entité, version stateless.
+     *
+     * @param {Object} data - Données initiales de recherche.
+     * @returns {Object} - Un paginateur avec .next(), .prev(), etc.
+     */
+    searchCostum(data?: any): any;
+    costumEventRequestActors(data?: {}): Promise<any>;
+    costumEventRequestSubevents(data?: {}): Promise<any>;
+    costumEventRequestDates(data?: {}): Promise<any>;
+    costumEventRequestElementEvent(data?: {}): Promise<any>;
+    costumEventRequestCategories(data?: {}): Promise<any>;
+    costumEventRequestEvent(data?: {}): Promise<any>;
+    costumEventRequestLinkTlToEvent(data?: {}): Promise<any>;
+    costumEventRequestLoadContextTag(data?: {}): Promise<any>;
+}
+export default BaseEntity;
+export type ApiClient = import("../ApiClient.js").default;
+export type EndpointApi = import("./EndpointApi.js").default;