@communecter/cocolight-api-client 1.0.54 → 1.0.56

package/types/api/EntityRegistry.d.ts

@@ -1,22 +1,24 @@
-/**
- * Enregistre une entité dans la registry.
- * @param {string} tag - ex: "User", "Organization"
- * @param {Function} EntityClass - la classe constructeur
- */
-export function registerEntity(tag: string, EntityClass: Function): void;
+import type { CollectionType } from "../types/entities.js";
+export type EntityTag = "User" | "Organization" | "Project" | "Event" | "Poi" | "Badge" | "News" | "Comment";
+export type CollectionKey = CollectionType;
+type BaseEntity = import("./BaseEntity.js").BaseEntity<any>;
+type ApiClient = import("../ApiClient.js").default;
+type EndpointApiClass = typeof import("./EndpointApi.js").default;
+type EntityConstructor = new (...args: any[]) => BaseEntity;
+type EntityClass = EntityConstructor & {
+    fromJSON?: (json: unknown, parent?: ApiClient | BaseEntity | null, deps?: EntityDeps) => BaseEntity;
+};
+type EntityDeps = Partial<Record<EntityTag | "EndpointApi", EntityClass | EndpointApiClass | undefined>>;
+export declare const EntityRegistry: Map<EntityTag | "EndpointApi", EntityClass | EndpointApiClass>;
+export declare function registerEntity(tag: "EndpointApi", EntityClass: EndpointApiClass): void;
+export declare function registerEntity(tag: EntityTag, EntityClass: EntityClass): void;
 /**
  * Récupère une instance depuis un JSON générique.
- * @param {Object} json - doit contenir __entityTag
- * @param {Object} parent - ApiClient ou entité parent
- * @param {Object} deps - dépendances (comme dans le constructeur)
- * @returns {BaseEntity|null}
+ * Si la collection ou la métadonnée d'entité est absente, renvoie l'objet d'origine.
  */
-export function fromEntityJSON(json: any, parent?: any): BaseEntity | null;
+export declare function fromEntityJSON(json: unknown, parent?: ApiClient | BaseEntity | null): BaseEntity | unknown | null;
 /**
  * Crée une instance d'entité basée sur le seul nom de la collection.
- * @param {string} collection - ex: "citoyens", "projects", ...
- * @param {Object} parent - ApiClient ou entité parente
- * @returns {BaseEntity|null}
  */
-export function createFromCollection(collection: string, parent?: any, data?: {}): BaseEntity | null;
-export const EntityRegistry: Map<any, any>;
+export declare function createFromCollection(collection: CollectionKey, parent?: ApiClient | BaseEntity | null, data?: object): BaseEntity | null;
+export {};

package/types/api/EntityRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityRegistry.d.ts","sourceRoot":"","sources":["../../src/api/EntityRegistry.ts"],"names":[],"mappings":"AACA,KAAK,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAC1F,KAAK,aAAa,GAAG,UAAU,GAAG,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AACtG,KAAK,UAAU,GAAG,OAAO,iBAAiB,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;AAC5D,KAAK,SAAS,GAAG,OAAO,iBAAiB,EAAE,OAAO,CAAC;AAEnD,KAAK,gBAAgB,GAAG,cAAc,kBAAkB,EAAE,OAAO,CAAC;AAClE,KAAK,iBAAiB,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC;AAC5D,KAAK,WAAW,GAAG,iBAAiB,GAAG;IACrC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,KAAK,UAAU,CAAC;CACrG,CAAC;AACF,KAAK,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,aAAa,EAAE,WAAW,GAAG,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAC;AAoBzG,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,SAAS,GAAG,aAAa,EAAE,WAAW,GAAG,gBAAgB,CAAa,CAAC;AAGxG,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;AACxF,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;AAc/E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,SAAS,GAAG,UAAU,GAAG,IAAW,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAcvH;AA4CD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,GAAE,SAAS,GAAG,UAAU,GAAG,IAAW,EAAE,IAAI,GAAE,MAAW,GAAG,UAAU,GAAG,IAAI,CA2ClJ"}

package/types/api/Event.d.ts

@@ -1,38 +1,122 @@
-export class Event extends BaseEntity {
+import { BaseEntity, PaginatorPage } from "./BaseEntity.js";
+import type { AddEventData, GetAttendeesAdminData, GetAttendeesNoAdminData } from "./EndpointApi.types.js";
+import type { User } from "./User.js";
+import type { EventTransforms } from "../types/transforms.js";
+type EventItemNormalized = import("./serverDataType/Event.js").EventItemNormalized;
+export declare class Event extends BaseEntity<EventItemNormalized> {
     static entityType: string;
+    static entityTag: string;
     static SCHEMA_CONSTANTS: string[];
-    static ADD_BLOCKS: Map<string, string>;
-    static UPDATE_BLOCKS: Map<string, string>;
-    defaultFields: {
-        typeElement: string;
-    };
-    transforms: {
-        parent: (val: any) => {
-            [k: string]: {
-                type: any;
-                name: any;
-            };
-        };
-        organizer: (val: any) => {
-            [k: string]: {
-                type: any;
-                name: any;
-            };
-        };
-    };
-    _add(payload: any): Promise<void>;
-    _update(payload: any): Promise<boolean>;
-    addEvent(data?: {}): Promise<any>;
-    getOrganizations(): Promise<void>;
-    getProjects(): Promise<void>;
-    getEvents(): Promise<void>;
-    getPois(): Promise<void>;
-    getBadgesIssuer(): Promise<void>;
-    getNews(data?: {}): Promise<any>;
-    getSubscribers(data?: {}): Promise<any>;
-    project(): Promise<void>;
-    poi(): Promise<void>;
-    event(): Promise<void>;
-    badge(): Promise<void>;
+    static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "ADD_EVENT", "updateImageProfil" | "addEvent">;
+    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateSlug">;
+    defaultFields: Record<string, any>;
+    removeFields: string[];
+    transforms: EventTransforms;
+    _add: (payload: Record<string, any>) => Promise<void>;
+    _update: (payload: Record<string, any>) => Promise<boolean>;
+    addEvent(data?: Partial<AddEventData>): Promise<unknown>;
+    getOrganizations(): Promise<never>;
+    getProjects(): Promise<never>;
+    getEvents(): Promise<never>;
+    getPois(): Promise<never>;
+    getBadgesIssuer(): Promise<never>;
+    /**
+     * {@inheritDoc BaseEntity#getNews}
+     *
+     * Récupère les actualités de l'événement.
+     */
+    getNews(data?: Parameters<BaseEntity<EventItemNormalized>["getNews"]>[0]): Promise<import("./News.js").News[]>;
+    /**
+     * {@inheritDoc BaseEntity#getSubscribers}
+     *
+     * Récupère les abonnés de l'événement.
+     */
+    getSubscribers(data?: Parameters<BaseEntity<EventItemNormalized>["getSubscribers"]>[0]): Promise<PaginatorPage<User>>;
+    /**
+     * Récupérer les participants d'un événement.
+     * Constant : GET_ATTENDEES_NO_ADMIN
+     * @param data - Paramètres (partiels) de recherche/pagination.
+     * @param options - Options supplémentaires.
+     * @param options.toBeValidated - Indique si les participants doivent être validés.
+     * @param options.isAdmin - Indique si l'utilisateur est admin.
+     * @param options.isInviting - Indique si l'utilisateur est en attente d'invitation.
+     * @param options.roles - Liste des rôles à filtrer.
+     * @param isNext - Indique si c'est une recherche suivante (pagination).
+     * @returns - Un objet contenant le nombre de participants et la liste des participants.
+     * @throws {ApiResponseError} - Si une erreur se produit lors de la récupération des participants.
+     *
+     * @example
+     * // Récupérer tous les participants
+     * const participants = await project.getAttendees();
+     *
+     * // Récupérer les participants avec validation en attente
+     * const participantsToBeValidated = await project.getAttendees({}, { toBeValidated: true });
+     *
+     * // Récupérer les participants avec un rôle spécifique
+     * const contributorsWithRole = await project.getAttendees({}, { roles: ["admin"] });
+     *
+     * // Récupérer les participants administrateurs
+     * const adminParticipants = await project.getAttendees({}, { isAdmin: true });
+     *
+     * // Récupérer les participants en attente d'invitation
+     * const invitingParticipants = await project.getAttendees({}, { isInviting: true });
+     *
+     */
+    getAttendees(data?: Partial<GetAttendeesNoAdminData | GetAttendeesAdminData>, options?: {
+        toBeValidated?: boolean;
+        isAdmin?: boolean;
+        isAdminPending?: boolean;
+        isInviting?: boolean;
+        roles?: any[];
+    }): Promise<PaginatorPage<User>>;
+    project(): Promise<never>;
+    poi(): Promise<never>;
+    event(): Promise<never>;
+    badge(): Promise<never>;
+    /**
+     * {@inheritDoc BaseEntity#news}
+     *
+     * Crée une instance de news et la récupère si nécessaire.
+     */
+    news(newsData?: Parameters<BaseEntity<EventItemNormalized>["news"]>[0]): Promise<import("./News.js").News>;
+    /**
+     * ───────────────────────────────
+     *  Lien utilisateur ↔ event
+     *  (participation, abonnement)
+     * ───────────────────────────────
+     */
+    /**
+     * {@inheritDoc BaseEntity#requestToJoin}
+     *
+     * Rejoindre l'événement en tant que participant.
+     */
+    requestToJoin(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#acceptInvitation}
+     *
+     * Accepte une invitation à rejoindre l'événement.
+     * Cette action valide un lien en attente avec l'option `isInviting`.
+     */
+    acceptInvitation(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#leave}
+     *
+     * Quitte l'événement, que ce soit en tant que participant ou administrateur.
+     * Cette action supprime le lien entre l'utilisateur et l'événement.
+     */
+    leave(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#follow}
+     *
+     * Suivre un événement.
+     * Cette action permet à l'utilisateur de suivre un événement.
+     */
+    follow(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#unfollow}
+     *
+     * Se désabonne d'un événement.
+     */
+    unfollow(): Promise<unknown>;
 }
-import BaseEntity from "./BaseEntity.js";
+export {};

package/types/api/Event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Event.d.ts","sourceRoot":"","sources":["../../src/api/Event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,qBAAa,KAAM,SAAQ,UAAU;IACnC,MAAM,CAAC,UAAU,SAAY;IAC7B,MAAM,CAAC,SAAS,SAAW;IAE3B,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAQ/B;IAEF,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGnC;IAEH,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtC;IAEH,aAAa,EAAE,GAAG,CAEhB;IAEF,YAAY,EAAE,MAAM,EAAE,CAEpB;IAEF,UAAU,EAAE,eAAe,CAGzB;IAEF,IAAI,GAAU,SAAS,eAAe,KAAG,OAAO,CAAC,IAAI,CAAC,CAuBpD;IAEF,OAAO,GAAU,SAAS,kBAAkB,KAAG,OAAO,CAAC,OAAO,CAAC,CAwC9D;IAEK,QAAQ,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAahD,0CAA0C;IACpC,gBAAgB,IAAI,OAAO,CAAC,KAAK,CAAC;IAIxC,0CAA0C;IACpC,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;IAInC,0CAA0C;IACpC,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC;IAIjC,0CAA0C;IACpC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;IAI/B,0CAA0C;IACpC,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;IAIjC,OAAO,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC,CAAC;IAInG,cAAc,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC,CAAC;IAIhH,0CAA0C;IACpC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;IAI/B,0CAA0C;IACpC,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;IAI3B,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAI7B,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAI7B;;;;;;OAMG;IACG,IAAI,CAAC,QAAQ,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC;IAIjE;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;IAI5B;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;CAI/B"}

package/types/api/News.d.ts

@@ -1,45 +1,77 @@
-export class News extends BaseEntity {
+import { BaseEntity } from "./BaseEntity.js";
+import type { Comment } from "./Comment.js";
+import type { AddNewsData, UpdateNewsData } from "./EndpointApi.types.js";
+import type { NewsItemNormalized } from "./serverDataType/News.js";
+export declare class News extends BaseEntity<NewsItemNormalized> {
     static entityType: string;
+    static entityTag: string;
     static SCHEMA_CONSTANTS: string[];
-    static ADD_BLOCKS: Map<string, string>;
-    static UPDATE_BLOCKS: Map<string, string>;
-    defaultFields: {};
-    removeFields: any[];
+    static ADD_BLOCKS: Map<"ADD_NEWS", "addNews">;
+    static UPDATE_BLOCKS: Map<"ADD_NEWS", "updateNews">;
+    defaultFields: Record<string, any>;
+    removeFields: string[];
     transforms: {
         scope: (val: any) => any;
         mentions: (val: any) => any[];
         mediaImg: (val: any) => {
-            countImages: any;
-            images: any;
+            countImages: number;
+            images: string[];
         };
         mediaFile: (val: any) => {
-            countFiles: any;
-            files: any;
+            countFiles: number;
+            files: any[];
         };
     };
-    _add(payload: any): Promise<void>;
-    _update(payload: any): Promise<boolean>;
-    addNews(data?: {}): Promise<any>;
-    updateNews(data?: {}): Promise<any>;
+    /**
+     * Transforme les champs imbriqués (author, target, sharedBy, etc.) en instances d'entités.
+     * @param data - Les données brutes du serveur.
+     * @returns Les données transformées.
+     * @protected
+     */
+    protected _transformServerData(data: NewsItemNormalized): NewsItemNormalized;
+    /**
+     * Récupérer des actualités par IDs : Récupère des actualités à partir d'une liste d'identifiants.
+     * Constant : GET_NEWS_BY_ID
+     */
+    get(): Promise<Record<string, any>>;
+    _add: (payload: Record<string, any>) => Promise<void>;
+    _update: (payload: Record<string, any>) => Promise<boolean>;
+    addNews(data?: Partial<AddNewsData>): Promise<unknown>;
+    updateNews(data?: Partial<UpdateNewsData>): Promise<unknown>;
     addMention({ slug, id }: {
-        slug: any;
-        id: any;
-    }): Promise<any>;
+        slug?: string;
+        id?: string;
+    }): Promise<any[]>;
     /**
      * Ajouter une image à une actualité : Ajoute une images à une actualité.
      * Constant : ADD_IMAGE_NEWS
      */
-    addImage(image: any): Promise<any>;
+    addImage(image: File | Blob | Buffer | import("stream").Readable): Promise<{
+        id: string;
+        [key: string]: any;
+    }>;
     /**
      * Ajouter un fichier à une actualité : Ajoute un fichier à une actualité.
      * Constant : ADD_FILE_NEWS
      */
-    addFile(file: any): Promise<any>;
+    addFile(file: File | Blob | Buffer | import("stream").Readable): Promise<unknown>;
     /**
      * Supprimer une actualité : Supprime une actualité existante.
      * Constant : DELETE_NEWS
      */
     delete(): Promise<void>;
-    _isDeleted: boolean;
+    /**
+     * Créer une instance de commentaire pour cette news.
+     * @param commentData - Données du commentaire.
+     * @returns Instance de Comment.
+     */
+    comment(commentData?: Record<string, any>): Promise<Comment>;
+    /**
+     * Récupérer les commentaires : Récupère la liste de commentaires selon plusieurs critères.
+     * Constant : GET_COMMENTS
+     * @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.
+     */
+    getComments(): Promise<Comment[]>;
 }
-import BaseEntity from "./BaseEntity.js";

package/types/api/News.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"News.d.ts","sourceRoot":"","sources":["../../src/api/News.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,qBAAa,IAAK,SAAQ,UAAU,CAAC,GAAG,CAAC;IACvC,MAAM,CAAC,UAAU,SAAU;IAE3B,MAAM,CAAC,SAAS,SAAU;IAE1B,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAE/B;IAEF,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnC;IAEH,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtC;IAEH,aAAa,EAAE,GAAG,CAAM;IAExB,YAAY,EAAE,GAAG,EAAE,CAAM;IAEzB,UAAU,EAAE;QACV,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC;QACzB,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC;QAC9B,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK;YACtB,WAAW,EAAE,GAAG,CAAC;YACjB,MAAM,EAAE,GAAG,CAAC;SACb,CAAC;QACF,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK;YACvB,UAAU,EAAE,GAAG,CAAC;YAChB,KAAK,EAAE,GAAG,CAAC;SACZ,CAAC;KACH,CAcC;IAEF;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAgBzB,IAAI,GAAU,SAAS,GAAG,KAAG,OAAO,CAAC,IAAI,CAAC,CAsCxC;IAEF,OAAO,GAAU,SAAS,GAAG,KAAG,OAAO,CAAC,OAAO,CAAC,CA+C9C;IAEI,OAAO,CAAC,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpC,UAAU,CAAC,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvC,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,EAAE,EAAE,GAAG,CAAC;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAmCrE;;;OAGG;IACG,QAAQ,CAAC,KAAK,KAAA;IAapB;;;OAGG;IACG,OAAO,CAAC,IAAI,KAAA;IAalB;;;OAGG;IACG,MAAM;CAab"}

package/types/api/Organization.d.ts

@@ -1,44 +1,68 @@
-export class Organization extends BaseEntity {
+import { BaseEntity } from "./BaseEntity.js";
+import type { PaginatorPage } from "./BaseEntity.js";
+import type { AddOrganizationData, GetMembersAdminData, GetMembersNoAdminData } from "./EndpointApi.types.js";
+import type { User } from "./User.js";
+type OrganizationItemNormalized = import("./serverDataType/Organization.js").OrganizationItemNormalized;
+export declare class Organization extends BaseEntity<OrganizationItemNormalized> {
     static entityType: string;
+    static entityTag: string;
     static SCHEMA_CONSTANTS: string[];
-    static ADD_BLOCKS: Map<string, string>;
-    static UPDATE_BLOCKS: Map<string, string>;
-    defaultFields: {
-        typeElement: string;
-    };
-    transforms: {
-        github: (val: any, full: any) => any;
-        gitlab: (val: any, full: any) => any;
-        facebook: (val: any, full: any) => any;
-        twitter: (val: any, full: any) => any;
-        instagram: (val: any, full: any) => any;
-        diaspora: (val: any, full: any) => any;
-        mastodon: (val: any, full: any) => any;
-        telegram: (val: any, full: any) => any;
-        signal: (val: any, full: any) => any;
-    };
-    _add(payload: any): Promise<void>;
-    _update(payload: any): Promise<boolean>;
-    addOrganization(data?: {}): Promise<any>;
-    getOrganizations(): Promise<void>;
-    getProjects(data?: {}): Promise<any>;
-    getEvents(): Promise<void>;
-    getPois(data?: {}): Promise<any>;
-    getBadgesIssuer(data?: {}): Promise<any>;
-    getNews(data?: {}): Promise<any>;
-    getSubscribers(data?: {}): Promise<any>;
+    static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "ADD_ORGANIZATION", "addOrganization" | "updateImageProfil">;
+    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_SOCIAL" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateDescription" | "updateSocial" | "updateLocality" | "updateInfo" | "updateSlug">;
+    defaultFields: Record<string, any>;
+    removeFields: string[];
+    transforms: Record<string, (val: any, full: any) => any>;
+    _add: (payload: Record<string, any>) => Promise<void>;
+    _update: (payload: Record<string, any>) => Promise<boolean>;
+    /**
+     * Ajoute une organisation.
+     *
+     * @param data - Données de l'organisation à ajouter.
+     * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si l'entité n'est pas enregistrée.
+     */
+    addOrganization(data: AddOrganizationData): Promise<unknown>;
+    getOrganizations(): Promise<never>;
+    /**
+     * {@inheritDoc BaseEntity#getProjects}
+     *
+     * Récupère les projets de l'organisation.
+     */
+    getProjects(data?: Parameters<BaseEntity<OrganizationItemNormalized>["getProjects"]>[0]): Promise<PaginatorPage<import("./Project.js").Project>>;
+    /**
+     * {@inheritDoc BaseEntity#getPois}
+     *
+     * Récupère les points d'intérêt de l'organisation.
+     */
+    getPois(data?: Parameters<BaseEntity<OrganizationItemNormalized>["getPois"]>[0]): Promise<PaginatorPage<import("./Poi.js").Poi>>;
+    /**
+     * {@inheritDoc BaseEntity#getBadgesIssuer}
+     *
+     * Récupère les émetteurs de badges de l'organisation.
+     */
+    getBadgesIssuer(data?: Parameters<BaseEntity<OrganizationItemNormalized>["getBadgesIssuer"]>[0]): Promise<PaginatorPage<import("./Badge.js").Badge>>;
+    /**
+     * {@inheritDoc BaseEntity#getNews}
+     *
+     * Récupère les actualités de l'organisation.
+     */
+    getNews(data?: Parameters<BaseEntity<OrganizationItemNormalized>["getNews"]>[0]): Promise<import("./News.js").News[]>;
+    /**
+     * {@inheritDoc BaseEntity#getSubscribers}
+     *
+     * Récupère les abonnés de l'organisation.
+     */
+    getSubscribers(data?: Parameters<BaseEntity<OrganizationItemNormalized>["getSubscribers"]>[0]): Promise<PaginatorPage<User>>;
     /**
      * Récupérer les membres de l'organisation.
      * Constant : GET_MEMBERS_ADMIN / GET_MEMBERS_NO_ADMIN
-     * @param {Object} data - Les données de requête.
-     * @param {Object} options - Options supplémentaires.
-     * @param {boolean} options.toBeValidated - Indique si les membres doivent être validés.
-     * @param {boolean} options.isAdmin - Indique si l'utilisateur est admin.
-     * @param {boolean} options.isAdminPending - Indique si l'utilisateur est en attente de validation pour être admin.
-     * @param {boolean} options.isInviting - Indique si l'utilisateur est en attente d'invitation.
-     * @param {Array} options.roles - Liste des rôles à filtrer.
-     * @param {boolean} isNext - Indique si c'est une recherche suivante (pagination).
-     * @returns {Promise<Object>} - Un objet contenant le nombre de membres et la liste des membres.
+     * @param data - Paramètres (partiels) de recherche/pagination.
+     * @param options - Options supplémentaires.
+     * @param options.toBeValidated - Indique si les membres doivent être validés.
+     * @param options.isAdmin - Indique si l'utilisateur est admin.
+     * @param options.isAdminPending - Indique si l'utilisateur est en attente de validation pour être admin.
+     * @param options.isInviting - Indique si l'utilisateur est en attente d'invitation.
+     * @param options.roles - Liste des rôles à filtrer.
+     * @returns - Un objet contenant le nombre de membres et la liste des membres.
      * @throws {ApiResponseError} - Si une erreur se produit lors de la récupération des contributeurs.
      *
      * @example
@@ -68,20 +92,112 @@ export class Organization extends BaseEntity {
      *
      *
      */
-    getMembers(data?: any, options?: {
-        toBeValidated: boolean;
-        isAdmin: boolean;
-        isAdminPending: boolean;
-        isInviting: boolean;
-        roles: any[];
-    }): Promise<any>;
+    getMembers(data?: Partial<GetMembersAdminData | GetMembersNoAdminData>, options?: {
+        toBeValidated?: boolean;
+        isAdmin?: boolean;
+        isAdminPending?: boolean;
+        isInviting?: boolean;
+        roles?: any[];
+    }): Promise<PaginatorPage<User | Organization>>;
+    /**
+     * {@inheritDoc BaseEntity#getGallery}
+     *
+     * Récupère la galerie de l'organisation.
+     */
+    getGallery(data?: Parameters<BaseEntity<OrganizationItemNormalized>["getGallery"]>[0]): Promise<Record<string, any>>;
+    /**
+     * {@inheritDoc BaseEntity#project}
+     *
+     * Crée une instance de projet et récupère son profil si nécessaire.
+     */
+    project(projectData?: Parameters<BaseEntity<OrganizationItemNormalized>["project"]>[0]): Promise<import("./Project.js").Project>;
+    /**
+     * {@inheritDoc BaseEntity#poi}
+     *
+     * Crée une instance de POI et la récupère si nécessaire.
+     */
+    poi(poiData?: Parameters<BaseEntity<OrganizationItemNormalized>["poi"]>[0]): Promise<import("./Poi.js").Poi>;
+    /**
+     * {@inheritDoc BaseEntity#event}
+     *
+     * Crée une instance d'événement et la récupère si nécessaire.
+     */
+    event(eventData?: Parameters<BaseEntity<OrganizationItemNormalized>["event"]>[0]): Promise<import("./Event.js").Event>;
+    /**
+     * {@inheritDoc BaseEntity#badge}
+     *
+     * Crée une instance de badge et la récupère si nécessaire.
+     */
+    badge(badgeData?: Parameters<BaseEntity<OrganizationItemNormalized>["badge"]>[0]): Promise<import("./Badge.js").Badge>;
+    /**
+     * {@inheritDoc BaseEntity#news}
+     *
+     * Crée une instance de news et la récupère si nécessaire.
+     */
+    news(newsData?: Parameters<BaseEntity<OrganizationItemNormalized>["news"]>[0]): Promise<import("./News.js").News>;
+    /**
+     * ───────────────────────────────
+     *  Lien utilisateur ↔ organisation
+     *  (rejoindre, valider, quitter, devenir admin)
+     * ───────────────────────────────
+     */
+    /**
+     * {@inheritDoc BaseEntity#requestToJoin}
+     *
+     * Envoie une demande pour rejoindre l'organisation en tant que membre.
+     * L'action est soumise à validation par un administrateur de l'organisation.
+     */
+    requestToJoin(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#requestToJoinAdmin}
+     *
+     * Envoie une demande pour rejoindre l'organisation en tant qu'administrateur.
+     * L'action est soumise à validation par un administrateur existant.
+     */
+    requestToJoinAdmin(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#acceptInvitation}
+     *
+     * Accepte une invitation à rejoindre l'organisation.
+     * Cette action valide un lien en attente avec l'option `isInviting`.
+     */
+    acceptInvitation(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#leave}
+     *
+     * Quitte l'organisation, que ce soit en tant que membre ou administrateur.
+     * Cette action supprime le lien entre l'utilisateur et l'organisation.
+     */
+    leave(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#follow}
+     *
+     * Suivre une organisation.
+     * Cette action permet à l'utilisateur de suivre l'organisation.
+     */
+    follow(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#unfollow}
+     *
+     * Se désabonne d'une organisation.
+     */
+    unfollow(): Promise<unknown>;
+    /**
+     * ───────────────────────────────
+     *  costum
+     * ───────────────────────────────
+     */
+    /**
+     * {@inheritDoc BaseEntity#getCostumJson}
+     *
+     * Récupère le JSON personnalisé de l'organisation.
+     */
+    getCostumJson(): Promise<unknown>;
     /**
-     * recherche lié à l'organisation
+     * {@inheritDoc BaseEntity#searchCostum}
      *
-     * @param {Object} data - Les données de recherche.
-     * @returns {Promise<Object>} - Résultat de la recherche.
-     * @throws {ApiError} - Si le slug ou l'id de l'organisation n'est pas défini.
+     * Cette surcharge précise que la recherche est faite dans le contexte de l'organisation.
      */
-    searchCostum(data?: any): Promise<any>;
+    searchCostum(data: Parameters<BaseEntity<OrganizationItemNormalized>["searchCostum"]>[0]): Promise<PaginatorPage<any>>;
 }
-import BaseEntity from "./BaseEntity.js";
+export {};

package/types/api/Organization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Organization.d.ts","sourceRoot":"","sources":["../../src/api/Organization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,KAAK,0BAA0B,GAAG,OAAO,kCAAkC,EAAE,0BAA0B,CAAC;AACxG,qBAAa,YAAa,SAAQ,UAAU,CAAC,0BAA0B,CAAC;IACtE,MAAM,CAAC,UAAU,SAAmB;IAEpC,MAAM,CAAC,SAAS,SAAkB;IAElC,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAQ/B;IAEF,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGnC;IAEH,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtC;IAEH,aAAa,EAAE,GAAG,CAEhB;IAEF,YAAY,EAAE,MAAM,EAAE,CAEpB;IAIF,UAAU,EAAE,GAAG,CAUb;IAEF,IAAI,GAAU,YAAO,mBAuBnB;IAEF,OAAO,GAAU,YAAO,sBA2BtB;IAEF;;;;;;OAMG;IACG,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAI9C,0CAA0C;IACpC,gBAAgB,IAAI,OAAO,CAAC,KAAK,CAAC;IAIxC;;;;OAIG;IACG,WAAW,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,cAAc,EAAE,OAAO,CAAC,CAAC;IASnH;;;;;;;OAOG;IACG,OAAO,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,UAAU,EAAE,GAAG,CAAC,CAAC;IAIvG;;;;;;;OAOG;IACG,eAAe,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,YAAY,EAAE,KAAK,CAAC,CAAC;IAInH;;;;;;;OAOG;IACG,OAAO,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC,CAAC;IAIzG;;;;;;;OAOG;IACG,cAAc,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC,CAAC;IAKhH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACG,UAAU,CACd,IAAI,GAAE,OAAO,CAAC,OAAO,wBAAwB,EAAE,mBAAmB,GAAG,OAAO,wBAAwB,EAAE,qBAAqB,CAAM,EACjI,OAAO,GAAE;QACP,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;KACV,GACL,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,WAAW,EAAE,IAAI,GAAG,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAAC;IA0CxH;;;;;;;OAOG;IACG,UAAU,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAIvF;;;;;;;OAOG;IACG,OAAO,CAAC,WAAW,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,cAAc,EAAE,OAAO,CAAC;IAO7E;;;;;;;OAOG;IACG,GAAG,CAAC,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,UAAU,EAAE,GAAG,CAAC;IAO7D;;;;;;;OAOG;IACG,KAAK,CAAC,SAAS,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,YAAY,EAAE,KAAK,CAAC;IAOrE;;;;;;;OAOG;IACG,KAAK,CAAC,SAAS,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,YAAY,EAAE,KAAK,CAAC;IAOrE;;;;;;;OAOG;IACG,IAAI,CAAC,QAAQ,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC;IAKjE;;;;;OAKG;IAGH;;;;;;;OAOG;IACG,aAAa;IAInB;;;;;;;OAOG;IACG,kBAAkB;IAIxB;;;;;;;OAOG;IACG,gBAAgB;IAItB;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAI3B;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;IAI5B;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;IAI9B;;;;OAIG;IAEH;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC;IAInC;;;;;;;;OAQG;IACG,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAI5C"}

package/types/api/Poi.d.ts

@@ -1,25 +1,54 @@
-export class Poi extends BaseEntity {
+import { BaseEntity } from "./BaseEntity.js";
+import type { AddPoiData } from "./EndpointApi.types.js";
+export declare class Poi extends BaseEntity<any> {
     static entityType: string;
+    static entityTag: string;
     static SCHEMA_CONSTANTS: string[];
-    static ADD_BLOCKS: Map<string, string>;
-    static UPDATE_BLOCKS: Map<string, string>;
-    defaultFields: {
-        typeElement: string;
-    };
-    transforms: {};
-    _add(payload: any): Promise<void>;
-    _update(payload: any): Promise<boolean>;
-    addPoi(data?: {}): Promise<any>;
-    getOrganizations(): Promise<void>;
-    getProjects(): Promise<void>;
-    getEvents(): Promise<void>;
-    getPois(): Promise<void>;
-    getBadgesIssuer(): Promise<void>;
-    getNews(data?: {}): Promise<any>;
-    getSubscribers(data?: {}): Promise<any>;
-    project(): Promise<void>;
-    poi(): Promise<void>;
-    event(): Promise<void>;
-    badge(): Promise<void>;
+    static ADD_BLOCKS: Map<"PROFIL_IMAGE" | "ADD_POI", "updateImageProfil" | "addPoi">;
+    static UPDATE_BLOCKS: Map<"UPDATE_BLOCK_DESCRIPTION" | "UPDATE_BLOCK_INFO" | "UPDATE_BLOCK_LOCALITY" | "UPDATE_BLOCK_SLUG" | "PROFIL_IMAGE", "updateImageProfil" | "updateDescription" | "updateLocality" | "updateInfo" | "updateSlug">;
+    defaultFields: Record<string, any>;
+    removeFields: string[];
+    _add: (payload: Record<string, any>) => Promise<void>;
+    _update: (payload: Record<string, any>) => Promise<boolean>;
+    addPoi(data?: Partial<AddPoiData>): Promise<unknown>;
+    getOrganizations(): Promise<never>;
+    getProjects(): Promise<never>;
+    getEvents(): Promise<never>;
+    getPois(): Promise<never>;
+    getBadgesIssuer(): Promise<never>;
+    /**
+     * {@inheritDoc BaseEntity#getNews}
+     *
+     * Récupère les actualités du POI.
+     */
+    getNews(data?: Parameters<BaseEntity<any>["getNews"]>[0]): Promise<import("./News.js").News[]>;
+    /**
+     * {@inheritDoc BaseEntity#getSubscribers}
+     *
+     * Récupère les abonnés du POI.
+     */
+    getSubscribers(data?: Parameters<BaseEntity<any>["getSubscribers"]>[0]): Promise<import("./BaseEntity.js").PaginatorPage<import("./User.js").User>>;
+    project(): Promise<never>;
+    poi(): Promise<never>;
+    event(): Promise<never>;
+    badge(): Promise<never>;
+    /**
+     * {@inheritDoc BaseEntity#news}
+     *
+     * Crée une instance de news et la récupère si nécessaire.
+     */
+    news(newsData?: Parameters<BaseEntity<any>["news"]>[0]): Promise<import("./News.js").News>;
+    /**
+     * {@inheritDoc BaseEntity#follow}
+     *
+     * Suivre un POI.
+     * Cette action permet à l'utilisateur de suivre un POI.
+     */
+    follow(): Promise<unknown>;
+    /**
+     * {@inheritDoc BaseEntity#unfollow}
+     *
+     * Se désabonne d'un POI.
+     */
+    unfollow(): Promise<unknown>;
 }
-import BaseEntity from "./BaseEntity.js";

package/types/api/Poi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Poi.d.ts","sourceRoot":"","sources":["../../src/api/Poi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,qBAAa,GAAI,SAAQ,UAAU,CAAC,GAAG,CAAC;IACtC,MAAM,CAAC,UAAU,SAAS;IAE1B,MAAM,CAAC,SAAS,SAAS;IAEzB,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAO/B;IAEF,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGnC;IAEH,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMtC;IAEH,aAAa,EAAE;QACb,WAAW,EAAE,UAAU,GAAG,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;KAC/F,CAEC;IAEF,YAAY,EAAE,MAAM,EAAE,CAEpB;IAMF,IAAI,GAAU,SAAS,GAAG,KAAG,OAAO,CAAC,IAAI,CAAC,CAuBxC;IAEF,OAAO,GAAU,SAAS,GAAG,KAAG,OAAO,CAAC,OAAO,CAAC,CA0B9C;IAEI,MAAM,CAAC,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAanC,gBAAgB,IAAI,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAIzE,WAAW,IAAI,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAIpE,SAAS,IAAI,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAIlE,OAAO,IAAI,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAIhE,eAAe,IAAI,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAIxE,OAAO,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC,CAAC;IAInG,cAAc,CAAC,IAAI,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,iBAAiB,EAAE,aAAa,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC,CAAC;IAI1G,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;IAIvB,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAInB,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAIrB,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAIrB,IAAI,CAAC,QAAQ,GAAE,GAAQ,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC;IAIjE;;;;;;OAMG;IACG,MAAM;IAIZ;;;;;OAKG;IACG,QAAQ;CAKf"}