@communecter/cocolight-api-client 1.0.42 → 1.0.44

package/package.json

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

package/src/Api.js

@@ -1,7 +1,7 @@
 // Api.js
 import { Badge } from "./api/Badge.js";
 import EndpointApi from "./api/EndpointApi.js";
-import { registerEntity } from "./api/EntityRegistry.js";
+import { createFromCollection, registerEntity } from "./api/EntityRegistry.js";
 import { Event } from "./api/Event.js";
 import { News } from "./api/News.js";
 import { Organization } from "./api/Organization.js";
@@ -9,7 +9,7 @@ import { Poi } from "./api/Poi.js";
 import { Project } from "./api/Project.js";
 import { User } from "./api/User.js";
 import { UserApi } from "./api/UserApi.js";
-import { ApiAuthenticationError, ApiClientError, ApiError } from "./error.js";
+import { ApiAuthenticationError, ApiClientError, ApiError, ApiResponseError } from "./error.js";
 
 registerEntity("User", User);
 registerEntity("Organization", Organization);
@@ -200,6 +200,31 @@ export default class Api {
     }
   }
 
+  async entitySlug(slug) {
+    if (slug) {
+      try {
+        const data = await this.endpointApi.getElementsKey({
+          pathParams:{
+            slug: slug
+          }
+        });
+        if(data?.contextId && data?.contextType) {
+          const entity = createFromCollection(data?.contextType, this._client, { id: data?.contextId });
+          await entity.get();
+          return entity;
+        } else {
+          throw new ApiResponseError(`Le slug ${slug} n'est pas valide`, 200, data);
+        }
+      } catch (error) {
+        if(error instanceof ApiResponseError) {
+          throw new ApiResponseError(`Impossible de récupérer l'identifiant pour le slug ${slug}`, error.status, error.responseData);
+        } else {
+          throw error;
+        }
+      }
+    }
+  }
+
   /**
    * Retourne l'instance d'ApiClient.
    *

package/src/ApiClient.js

@@ -102,6 +102,8 @@ export default class ApiClient extends EventEmitter {
     this._ajv = new Ajv({ strict: false, useDefaults: true, allErrors: true, verbose: true });
     addFormats(this._ajv);
 
+    this._ajv.addFormat("textarea", true);
+
     this._ajv.addKeyword({
       keyword: "startBeforeEnd",
       type: "object",
@@ -1512,7 +1514,7 @@ export default class ApiClient extends EventEmitter {
     if (!isValid) {
       this._startBeforeEndValidate.errors = [
         {
-          instancePath: "", // ou "." si tu veux le chemin actuel
+          instancePath: "/startDate", // ou "." si tu veux le chemin actuel
           schemaPath: "#/startBeforeEnd",
           keyword: "startBeforeEnd",
           params: {},

package/src/api/BaseEntity.js

@@ -1373,6 +1373,37 @@ export class BaseEntity {
     }
   }
 
+  /**
+   * 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.
+   */
+  async entityBySlug(slug) {
+    if (!slug) {
+      throw new ApiError("Le slug est requis.");
+    }
+    try {
+      const data = await this.endpointApi.getElementsKey({
+        pathParams:{
+          slug: slug
+        }
+      });
+      if(data?.contextId && data?.contextType) {
+        const entity = await this.entity(data.contextType, { id: data.contextId });
+        return entity;
+      } else {
+        throw new ApiResponseError(`Le slug ${slug} n'est pas valide`, 200, data);
+      }
+    } catch (error) {
+      if(error instanceof ApiResponseError) {
+        throw new ApiResponseError(`Impossible de récupérer l'identifiant pour le slug ${slug}`, error.status, error.responseData);
+      } else {
+        throw error;
+      }
+    }
+  }
+
+
   /**
    * Construit dynamiquement des filtres sur un lien entre entités
    *

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

@@ -3025,7 +3025,7 @@ export interface AddEventData {
     };
   };
   /**
-   * Nom du poi
+   * Nom de l'événement
    */
   name: string;
   /**

package/src/api/EntityRegistry.js

@@ -63,4 +63,90 @@ function _getEntityMeta(entityType, __entityTag) {
   };
   
   return map[entityType] || 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, parent = null, data = {}) {
+  const _collectionMap = {
+    citoyens: {
+      entityTag: "User",
+      meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    organizations: {
+      entityTag: "Organization",
+      meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    projects: {
+      entityTag: "Project",
+      meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    events: {
+      entityTag: "Event",
+      meta: tag => _buildMeta(tag, { remove: ["Badge"] })
+    },
+    poi: {
+      entityTag: "Poi",
+      meta: tag => _buildMeta(tag, { remove: ["Badge","News"] })
+    },
+    news: {
+      entityTag: "News",
+      meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    badges: {
+      entityTag: "Badge",
+      meta: tag => _buildCustomMeta(tag)
+    }
+  };
+  const entry = _collectionMap[collection];
+  if (!entry) {
+    console.warn(`Collection inconnue : '${collection}'`);
+    return null;
+  }
+  const { entityTag, meta } = entry;
+  const { entityClass, deps } = meta(entityTag);
+  return new entityClass(parent, data, deps);
+}
+
+/**
+ * Construit entityClass et deps pour une collection standard.
+ * @param {string} tag
+ * @param {{remove: string[]}} options
+ */
+function _buildMeta(tag, options) {
+  const EntityClass = EntityRegistry.get(tag);
+  const allDeps = {
+    EndpointApi: EntityRegistry.get("EndpointApi"),
+    User: EntityRegistry.get("User"),
+    Organization: EntityRegistry.get("Organization"),
+    Project: EntityRegistry.get("Project"),
+    Event: EntityRegistry.get("Event"),
+    Poi: EntityRegistry.get("Poi"),
+    Badge: EntityRegistry.get("Badge"),
+    News: EntityRegistry.get("News")
+  };
+  // inject self
+  allDeps[tag] = EntityClass;
+  // remove undesired
+  options.remove.forEach(dep => delete allDeps[dep]);
+  return { entityClass: EntityClass, deps: allDeps };
+}
+
+/**
+ * Cas spécifique des badges : seules certaines dépendances.
+ */
+function _buildCustomMeta(tag) {
+  const EntityClass = EntityRegistry.get(tag);
+  const deps = {
+    EndpointApi: EntityRegistry.get("EndpointApi"),
+    User: EntityRegistry.get("User"),
+    Organization: EntityRegistry.get("Organization"),
+    Project: EntityRegistry.get("Project")
+  };
+  deps[tag] = EntityClass;
+  return { entityClass: EntityClass, deps };
+}

package/src/api/Organization.js

@@ -237,7 +237,7 @@ export class Organization extends BaseEntity {
    */
   async poi(poiData = {}) {
     if(!this.isAdmin()){
-      throw new ApiError("Vous n'avez pas les droits pour créer un projet dans cette organisation", 403);
+      throw new ApiError("Vous n'avez pas les droits pour créer un poi dans cette organisation", 403);
     }
     return super.poi(poiData);
   }
@@ -251,7 +251,7 @@ export class Organization extends BaseEntity {
    */
   async event(eventData = {}) {
     if(!this.isAdmin()){
-      throw new ApiError("Vous n'avez pas les droits pour créer un projet dans cette organisation", 403);
+      throw new ApiError("Vous n'avez pas les droits pour créer un event dans cette organisation", 403);
     }
     return super.event(eventData);
   }
@@ -265,7 +265,7 @@ export class Organization extends BaseEntity {
    */
   async badge(badgeData = {}) {
     if(!this.isAdmin()){
-      throw new ApiError("Vous n'avez pas les droits pour créer un projet dans cette organisation", 403);
+      throw new ApiError("Vous n'avez pas les droits pour créer un badge dans cette organisation", 403);
     }
     return super.badge(badgeData);
   }