@communecter/cocolight-api-client 1.0.34 → 1.0.36

package/package.json

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

package/src/Api.js

@@ -186,6 +186,20 @@ export default class Api {
     }
   }
 
+  async event(eventData) {
+    try {
+      const event = new Event(this._client, eventData, { EndpointApi, User, Organization, Project, Poi, Badge, News });
+      if (!eventData.id && !eventData.slug) {
+        throw new Error("Vous devez fournir un id ou un slug pour créer une instance Event.");
+      }
+      await event.get();
+      return event;
+    } catch (error) {
+      console.error("[Api.event] Erreur lors de la création d'un objet événement :", error.message);
+      throw error;
+    }
+  }
+
   /**
    * Retourne l'instance d'ApiClient.
    *

package/src/api/BaseEntity.js

@@ -2485,6 +2485,145 @@ export class BaseEntity {
     };
   }
 
+  /**
+   * ───────────────────────────────
+   *  costum event
+   * ───────────────────────────────
+   */
+
+  async costumRequestActors(data = {}){
+
+    data = {
+      pathParams: {
+        id: this.id,
+        type: this.getEntityType()
+      },
+      ...data
+    };
+
+    const wrappedFinalizer = this._withCostumContext((finalData) => this.endpointApi.costumEventRequestActors(finalData));
+
+    const actors = await wrappedFinalizer(data);
+
+    // const transformedActors = actors
+    //   .filter(actor => {
+    //     const isValid = !!actor?.type;
+    //     if (!isValid) {
+    //       this.apiClient._logger?.warn?.(`Objet ignoré car sans 'type' : ${actor?.id}`);
+    //     }
+    //     return isValid;
+    //   })
+    //   .map(({ id, name, type, ...meta }) => ({
+    //     id,
+    //     name,
+    //     collection: type,
+    //     meta
+    //   }));
+
+    // const rawList = this._linkEntities(transformedActors);
+
+    return actors;
+  }
+
+  async costumRequestSubevents(data = {}){
+
+    data = {
+      pathParams: {
+        id: this.id,
+        type: this.getEntityType()
+      },
+      ...data
+    };
+
+    const wrappedFinalizer = this._withCostumContext((finalData) => this.endpointApi.costumEventRequestSubevents(finalData));
+
+    return wrappedFinalizer(data);
+  }
+
+  async costumRequestDates(data = {}){
+    data = {
+      pathParams: {
+        id: this.id,
+        type: this.getEntityType()
+      },
+      ...data
+    };
+
+    const wrappedFinalizer = this._withCostumContext((finalData) => this.endpointApi.costumEventRequestDates(finalData));
+
+    return wrappedFinalizer(data);
+  }
+
+  async costumRequestElementEvents(data = {}){
+    data = {
+      pathParams: {
+        id: this.id,
+        type: this.getEntityType()
+      },
+      ...data
+    };
+
+    const wrappedFinalizer = this._withCostumContext((finalData) => this.endpointApi.costumEventRequestElementEvent(finalData));
+
+    return wrappedFinalizer(data);
+  }
+
+  async costumRequestCategories(data = {}){
+    data = {
+      pathParams: {
+        id: this.id,
+        type: this.getEntityType()
+      },
+      ...data
+    };
+
+    const wrappedFinalizer = this._withCostumContext((finalData) => this.endpointApi.costumEventRequestCategories(finalData));
+
+    return wrappedFinalizer(data);
+  }
+
+  async costumRequestEvent(data = {}){
+    data = {
+      pathParams: {
+        id: this.id,
+        type: this.getEntityType()
+      },
+      ...data
+    };
+
+    const wrappedFinalizer = this._withCostumContext((finalData) => this.endpointApi.costumEventRequestEvent(finalData));
+
+    return wrappedFinalizer(data);
+  }
+
+  async costumRequestLinkTlToEvent(data = {}){
+    data = {
+      pathParams: {
+        id: this.id,
+        type: this.getEntityType()
+      },
+      ...data
+    };
+
+    const wrappedFinalizer = this._withCostumContext((finalData) => this.endpointApi.costumEventRequestLinkTlToEvent(finalData));
+
+    return wrappedFinalizer(data);
+  }
+
+  async costumRequestLoadContextTags(data = {}){
+    data = {
+      pathParams: {
+        id: this.id,
+        type: this.getEntityType()
+      },
+      ...data
+    };
+
+    const wrappedFinalizer = this._withCostumContext((finalData) => this.endpointApi.costumEventRequestLoadContextTag(finalData));
+
+    return wrappedFinalizer(data);
+  }
+
 
 }
 

package/src/api/EndpointApi.js

@@ -1378,6 +1378,126 @@ class EndpointApi {
     return this.call("GLOBAL_AUTOCOMPLETE_COSTUM", data);
   }
     
+  /**
+   * Récupérer les acteurs d'événement : Récupérer les acteurs (organizers, attendees, creators, animators) d'une entité événement.
+   * Constant : COSTUM_EVENT_REQUEST_ACTORS
+   * @param {import("./EndpointApi.types").CostumEventRequestActorsData} data - Données envoyées à l'API
+   * @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.
+   */
+  async costumEventRequestActors(data) {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COSTUM_EVENT_REQUEST_ACTORS", data);
+  }
+    
+  /**
+   * Récupérer les sous-événements d’un événement parent : Retourne les sous-événements filtrés par date, type, tags, région, timezone.
+   * Constant : COSTUM_EVENT_REQUEST_SUBEVENTS
+   * @param {import("./EndpointApi.types").CostumEventRequestSubeventsData} data - Données envoyées à l'API
+   * @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.
+   */
+  async costumEventRequestSubevents(data) {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COSTUM_EVENT_REQUEST_SUBEVENTS", data);
+  }
+    
+  /**
+   * Récupérer les événements liés à un élément : Retourne les événements liés à une entité (via links.events ou parent).
+   * Constant : COSTUM_EVENT_REQUEST_ELEMENT_EVENT
+   * @param {import("./EndpointApi.types").CostumEventRequestElementEventData} data - Données envoyées à l'API
+   * @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.
+   */
+  async costumEventRequestElementEvent(data) {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COSTUM_EVENT_REQUEST_ELEMENT_EVENT", data);
+  }
+    
+  /**
+   * Récupérer les catégories d’événements : Retourne la liste des types (catégories) d’événements enfants liés à l'entité.
+   * Constant : COSTUM_EVENT_REQUEST_CATEGORIES
+   * @param {import("./EndpointApi.types").CostumEventRequestCategoriesData} data - Données envoyées à l'API
+   * @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.
+   */
+  async costumEventRequestCategories(data) {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COSTUM_EVENT_REQUEST_CATEGORIES", data);
+  }
+    
+  /**
+   * Récupérer les dates de sous-événements : Retourne les dates des sous-événements à venir et passés, groupées par jour.
+   * Constant : COSTUM_EVENT_REQUEST_DATES
+   * @param {import("./EndpointApi.types").CostumEventRequestDatesData} data - Données envoyées à l'API
+   * @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.
+   */
+  async costumEventRequestDates(data) {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COSTUM_EVENT_REQUEST_DATES", data);
+  }
+    
+  /**
+   * Récupérer un événement par ID : Retourne les informations détaillées d’un événement par son ID.
+   * Constant : COSTUM_EVENT_REQUEST_EVENT
+   * @param {import("./EndpointApi.types").CostumEventRequestEventData} data - Données envoyées à l'API
+   * @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.
+   */
+  async costumEventRequestEvent(data) {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COSTUM_EVENT_REQUEST_EVENT", data);
+  }
+    
+  /**
+   * Associer une structure à un événement (adresse) : Associe une structure existante à un événement en copiant son adresse.
+   * Constant : COSTUM_EVENT_REQUEST_LINK_TL_TO_EVENT
+   * @param {import("./EndpointApi.types").CostumEventRequestLinkTlToEventData} data - Données envoyées à l'API
+   * @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.
+   */
+  async costumEventRequestLinkTlToEvent(data) {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COSTUM_EVENT_REQUEST_LINK_TL_TO_EVENT", data);
+  }
+    
+  /**
+   * Charger les tags de contexte d’un événement : Retourne les tags des sous-événements et des parents d’un événement, avec filtre optionnel.
+   * Constant : COSTUM_EVENT_REQUEST_LOAD_CONTEXT_TAG
+   * @param {import("./EndpointApi.types").CostumEventRequestLoadContextTagData} data - Données envoyées à l'API
+   * @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.
+   */
+  async costumEventRequestLoadContextTag(data) {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COSTUM_EVENT_REQUEST_LOAD_CONTEXT_TAG", data);
+  }
+    
 }
 
 export default EndpointApi;

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

@@ -4023,3 +4023,380 @@ export interface GlobalAutocompleteCostumData {
   };
   [k: string]: unknown;
 }
+
+
+export interface CostumEventRequestActorsData {
+  /**
+   * Types de liens à inclure (ex: organizer, attendees, creator, animator)
+   */
+  types?: (
+    | "organizer"
+    | "links.attendees"
+    | "creator"
+    | "links.creator"
+    | "links.organizer"
+    | "organizerName"
+    | "animator"
+  )[];
+  /**
+   * Limiter aux sous-événements liés directement
+   */
+  parent_only?: boolean;
+  /**
+   * ID du contexte de recherche (actuellement vide)
+   */
+  contextId?: string;
+  /**
+   * Type de contexte de recherche (actuellement vide)
+   */
+  contextType?: "projects" | "organizations";
+  /**
+   * Slug du costume utilisé pour la recherche
+   */
+  costumSlug?: string;
+  /**
+   * Clés de source pour la recherche
+   */
+  sourceKey?: string[];
+  /**
+   * Indique si le mode d'édition du costume est activé (toujours désactivé)
+   */
+  costumEditMode?: boolean;
+  pathParams?: {
+    /**
+     * ID de l'entité
+     */
+    id: string;
+    /**
+     * Type d'entité (ex: events)
+     */
+    type: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
+export interface CostumEventRequestSubeventsData {
+  /**
+   * Filtrage par type d’événement
+   */
+  type?: string;
+  /**
+   * Liste de tags à filtrer
+   */
+  tags?: string[];
+  /**
+   * Régions à filtrer
+   */
+  regions?: {
+    /**
+     * ID de la région
+     */
+    id: string;
+    [k: string]: unknown;
+  }[];
+  /**
+   * Si vrai, ne renvoie que les événements à venir
+   */
+  fromToday?: boolean;
+  /**
+   * Filtrage par date unique ou intervalle
+   */
+  date?:
+    | string
+    | {
+        between: {
+          start: string;
+          end: string;
+          [k: string]: unknown;
+        };
+        [k: string]: unknown;
+      };
+  /**
+   * Timezone à appliquer sur les dates
+   */
+  timezone?: string;
+  /**
+   * ID du contexte de recherche (actuellement vide)
+   */
+  contextId?: string;
+  /**
+   * Type de contexte de recherche (actuellement vide)
+   */
+  contextType?: "projects" | "organizations";
+  /**
+   * Slug du costume utilisé pour la recherche
+   */
+  costumSlug?: string;
+  /**
+   * Clés de source pour la recherche
+   */
+  sourceKey?: string[];
+  /**
+   * Indique si le mode d'édition du costume est activé (toujours désactivé)
+   */
+  costumEditMode?: boolean;
+  pathParams?: {
+    /**
+     * ID de l'entité
+     */
+    id: string;
+    /**
+     * Type d'entité (ex: events)
+     */
+    type: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
+export interface CostumEventRequestElementEventData {
+  /**
+   * ID du contexte de recherche (actuellement vide)
+   */
+  contextId?: string;
+  /**
+   * Type de contexte de recherche (actuellement vide)
+   */
+  contextType?: "projects" | "organizations";
+  /**
+   * Slug du costume utilisé pour la recherche
+   */
+  costumSlug?: string;
+  /**
+   * Clés de source pour la recherche
+   */
+  sourceKey?: string[];
+  /**
+   * Indique si le mode d'édition du costume est activé (toujours désactivé)
+   */
+  costumEditMode?: boolean;
+  pathParams?: {
+    /**
+     * ID de l'entité
+     */
+    id: string;
+    /**
+     * Type d'entité (ex: events)
+     */
+    type: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
+export interface CostumEventRequestCategoriesData {
+  /**
+   * ID du contexte de recherche (actuellement vide)
+   */
+  contextId?: string;
+  /**
+   * Type de contexte de recherche (actuellement vide)
+   */
+  contextType?: "projects" | "organizations";
+  /**
+   * Slug du costume utilisé pour la recherche
+   */
+  costumSlug?: string;
+  /**
+   * Clés de source pour la recherche
+   */
+  sourceKey?: string[];
+  /**
+   * Indique si le mode d'édition du costume est activé (toujours désactivé)
+   */
+  costumEditMode?: boolean;
+  pathParams?: {
+    /**
+     * ID de l'entité
+     */
+    id: string;
+    /**
+     * Type d'entité (ex: events)
+     */
+    type: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
+export interface CostumEventRequestDatesData {
+  /**
+   * Filtrage par type
+   */
+  type?: string;
+  /**
+   * Tags à filtrer
+   */
+  tags?: string[];
+  /**
+   * Régions géographiques à filtrer
+   */
+  regions?: {
+    /**
+     * ID de la région
+     */
+    id: string;
+    [k: string]: unknown;
+  }[];
+  /**
+   * ID du contexte de recherche (actuellement vide)
+   */
+  contextId?: string;
+  /**
+   * Type de contexte de recherche (actuellement vide)
+   */
+  contextType?: "projects" | "organizations";
+  /**
+   * Slug du costume utilisé pour la recherche
+   */
+  costumSlug?: string;
+  /**
+   * Clés de source pour la recherche
+   */
+  sourceKey?: string[];
+  /**
+   * Indique si le mode d'édition du costume est activé (toujours désactivé)
+   */
+  costumEditMode?: boolean;
+  pathParams?: {
+    /**
+     * ID de l'entité
+     */
+    id: string;
+    /**
+     * Type d'entité (ex: events)
+     */
+    type: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
+export interface CostumEventRequestEventData {
+  /**
+   * ID du contexte de recherche (actuellement vide)
+   */
+  contextId?: string;
+  /**
+   * Type de contexte de recherche (actuellement vide)
+   */
+  contextType?: "projects" | "organizations";
+  /**
+   * Slug du costume utilisé pour la recherche
+   */
+  costumSlug?: string;
+  /**
+   * Clés de source pour la recherche
+   */
+  sourceKey?: string[];
+  /**
+   * Indique si le mode d'édition du costume est activé (toujours désactivé)
+   */
+  costumEditMode?: boolean;
+  pathParams?: {
+    /**
+     * ID de l'entité
+     */
+    id: string;
+    /**
+     * Type d'entité (ex: events)
+     */
+    type: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
+export interface CostumEventRequestLinkTlToEventData {
+  /**
+   * ID de la structure à copier
+   */
+  tl: string;
+  /**
+   * ID de l’événement cible
+   */
+  event: string;
+  /**
+   * ID du contexte de recherche (actuellement vide)
+   */
+  contextId?: string;
+  /**
+   * Type de contexte de recherche (actuellement vide)
+   */
+  contextType?: "projects" | "organizations";
+  /**
+   * Slug du costume utilisé pour la recherche
+   */
+  costumSlug?: string;
+  /**
+   * Clés de source pour la recherche
+   */
+  sourceKey?: string[];
+  /**
+   * Indique si le mode d'édition du costume est activé (toujours désactivé)
+   */
+  costumEditMode?: boolean;
+  pathParams?: {
+    /**
+     * ID de l'entité
+     */
+    id: string;
+    /**
+     * Type d'entité (ex: events)
+     */
+    type: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
+export interface CostumEventRequestLoadContextTagData {
+  /**
+   * ID de l’événement
+   */
+  event: string;
+  /**
+   * Recherche textuelle dans les tags
+   */
+  search?: string;
+  /**
+   * ID du contexte de recherche (actuellement vide)
+   */
+  contextId?: string;
+  /**
+   * Type de contexte de recherche (actuellement vide)
+   */
+  contextType?: "projects" | "organizations";
+  /**
+   * Slug du costume utilisé pour la recherche
+   */
+  costumSlug?: string;
+  /**
+   * Clés de source pour la recherche
+   */
+  sourceKey?: string[];
+  /**
+   * Indique si le mode d'édition du costume est activé (toujours désactivé)
+   */
+  costumEditMode?: boolean;
+  pathParams?: {
+    /**
+     * ID de l'entité
+     */
+    id: string;
+    /**
+     * Type d'entité (ex: events)
+     */
+    type: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}

package/src/api/Event.js

@@ -169,5 +169,4 @@ export class Event extends BaseEntity {
     return super.unfollow();
   }
   
-
 }