@communecter/cocolight-api-client 1.0.84 → 1.0.86

package/package.json

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

package/src/api/Badge.ts

@@ -86,7 +86,7 @@ export class Badge extends BaseEntity<any> {
   }
 
 
-  async getEvents(): Promise<never> {
+  override async getEvents(): Promise<never> {
     throw new ApiError(`getEvents n'existe pas dans ${this.constructor.name}`, 501);
   }
 

package/src/api/BaseEntity.ts

@@ -43,7 +43,8 @@ import type {
   GetBadgesData,
   CoformAnswersSearchData,
   ProfilBannerData,
-  SearchMemberAutocompleteData
+  SearchMemberAutocompleteData,
+  GetEventsData
 } from "./EndpointApi.types.js";
 import type { GetElementsKeyResponse } from "../types/api-responses.js";
 import type { TransformsMap } from "../types/entities.js";
@@ -3046,6 +3047,33 @@ export class BaseEntity<TServerData = any> {
     return paginator.next() as Promise<PaginatorPage<Project>>;
   }
 
+  /**
+   * Récupérer les événements d'une entitée : liste des événements de l'entité ou elle est "organizer" ou "attendee".
+   * Constant : GET_EVENTS
+   * @param data - Paramètres (partiels) de recherche/pagination.
+   * @returns - Les données de réponse.
+   */
+  async getEvents(data: Partial<GetEventsData> = {}): Promise<PaginatorPage<EventEntity>> {
+    data.searchType = this._getDefaultFromEndpoint("GET_EVENTS", "searchType") as GetEventsData["searchType"];
+    const paginator = this._createPaginatorEngine({
+      initialData: data,
+      finalizer: async (finalData) => {
+        delete finalData?.pathParams;
+        finalData.filters = {
+          "$or": {
+            [`links.attendees.${this.id}`]: { "$exists": true },
+            [`organizer.${this.id}`]: { "$exists": true }
+          },
+          [`links.attendees.${this.id}`]: { "$exists": true }
+        };
+
+        return this.endpointApi.getEvents(finalData);
+      }
+    });
+
+    return paginator.next() as Promise<PaginatorPage<EventEntity>>;
+  }
+
   /**
    * 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

package/src/api/EndpointApi.ts

@@ -580,7 +580,7 @@ export class EndpointApi {
   }
     
   /**
-   * Afficher les votes d'une actualité : Récupère la liste des votes (like, love, etc.) sur une actualité.
+   * Afficher les votes d'une actualité/commentaire : Récupère la liste des votes (like, love, etc.) sur une actualité/commentaire.
    * Constant : SHOW_VOTE
    * @param data - Données envoyées à l'API
    * @returns Les données de réponse.

package/src/api/EndpointApi.types.ts

@@ -944,7 +944,7 @@ export interface ShowVoteData {
     /**
      * Type de l'élément
      */
-    type: "news";
+    type: "news" | "comments";
     /**
      * ID de l'élément dont on veut récupérer les votes
      */
@@ -3732,17 +3732,13 @@ export interface AssignBadgesData {
 
 
 export interface GetEventsData {
-  searchType: string[];
+  searchType: "events"[];
   indexMin: number;
   indexStep: number;
-  /**
-   * Timestamp de début
-   */
-  startDate: number;
   /**
    * Date de début (UTC)
    */
-  startDateUTC: string;
+  startDateUTC?: string;
   /**
    * Date de fin (UTC)
    */
@@ -3790,6 +3786,18 @@ export interface GetEventsData {
   count?: boolean;
   countType?: unknown[];
   fediverse: boolean;
+  /**
+   * Filtrer les événements récurrents (true/false)
+   */
+  recurrency?: boolean;
+  filters?: {
+    $or?: Record<string, unknown>;
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^links\.attendees\.(?:[a-f0-9]{24}|@\w+)$".
+     */
+    [k: string]: unknown;
+  };
   [k: string]: unknown;
 }
 

package/src/api/Event.ts

@@ -140,7 +140,7 @@ export class Event extends BaseEntity<EventItemNormalized> {
   }
 
 
-  async getEvents(): Promise<never> {
+  override async getEvents(): Promise<never> {
     throw new ApiError(`getEvents - les sous-events ne sont pas encore implémentés dans ${this.constructor.name}`, 501);
   }
 

package/src/api/Organization.ts

@@ -225,10 +225,14 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
     return super.getProjects(data);
   }
 
-  // /** @override @returns {Promise<never>} */
-  // async getEvents() {
-  //   throw new ApiError("getEvents pas encore implémenté dans Organization", 404);
-  // }
+  /**
+   * {@inheritDoc BaseEntity#getEvents}
+   *
+   * Récupère les événements de l'organisation.
+   */
+  override async getEvents(data: Parameters<BaseEntity<OrganizationItemNormalized>["getEvents"]>[0] = {}) {
+    return super.getEvents(data);
+  }
 
   /**
    * {@inheritDoc BaseEntity#getPois}

package/src/api/Poi.ts

@@ -116,7 +116,7 @@ export class Poi extends BaseEntity<any> {
     throw new ApiError(`getProjects n'existe pas dans ${this.constructor.name}`, 501);
   }
 
-  async getEvents(): Promise<never> {
+  override async getEvents(): Promise<never> {
     throw new ApiError(`getEvents n'existe pas dans ${this.constructor.name}`, 501);
   }
 

package/src/api/Project.ts

@@ -152,9 +152,13 @@ export class Project extends BaseEntity<ProjectItemNormalized> {
   }
   
 
-
-  async getEvents(): Promise<never> {
-    throw new ApiError(`getEvents pas encore implémenté dans ${this.constructor.name}`, 501);
+  /**
+   * {@inheritDoc BaseEntity#getEvents}
+   *
+   * Récupère les événements d'un projet.
+   */
+  override async getEvents(data: Parameters<BaseEntity<ProjectItemNormalized>["getEvents"]>[0] = {}) {
+    return super.getEvents(data);
   }
 
   /**

package/src/api/User.ts

@@ -412,6 +412,15 @@ export class User extends BaseEntity<UserItemNormalized> {
     return super.getProjects(data);
   }
 
+  /**
+   * {@inheritDoc BaseEntity#getEvents}
+   *
+   * Récupère les événements d'un utilisateur.
+   */
+  override async getEvents(data: Parameters<BaseEntity<UserItemNormalized>["getEvents"]>[0] = {}) {
+    return super.getEvents(data);
+  }
+    
   /**
    * {@inheritDoc BaseEntity#getPois}
    *