@communecter/cocolight-api-client 1.0.32 → 1.0.34

package/package.json

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

package/src/Api.js

@@ -1,6 +1,7 @@
 // Api.js
 import { Badge } from "./api/Badge.js";
 import EndpointApi from "./api/EndpointApi.js";
+import { registerEntity } from "./api/EntityRegistry.js";
 import { Event } from "./api/Event.js";
 import { News } from "./api/News.js";
 import { Organization } from "./api/Organization.js";
@@ -10,6 +11,16 @@ import { User } from "./api/User.js";
 import { UserApi } from "./api/UserApi.js";
 import { ApiAuthenticationError, ApiClientError, ApiError } from "./error.js";
 
+registerEntity("User", User);
+registerEntity("Organization", Organization);
+registerEntity("Project", Project);
+registerEntity("Event", Event);
+registerEntity("Poi", Poi);
+registerEntity("Badge", Badge);
+registerEntity("EndpointApi", EndpointApi);
+registerEntity("UserApi", UserApi);
+registerEntity("News", News);
+
 export default class Api {
   /**
    * Authentifie l'utilisateur et retourne une instance d'Api.

package/src/api/BaseEntity.js

@@ -1,6 +1,7 @@
 // BaseEntity.js
 import ObjectID from "bson-objectid";
 // import { fileTypeFromBuffer } from "file-type";
+import EJSON from "ejson";
 import pkg from "file-type";
 
 import { ApiAuthenticationError, ApiError, ApiResponseError, ApiValidationError } from "../error.js";
@@ -266,6 +267,114 @@ export class BaseEntity {
    */
   transforms = {};
 
+  /**
+   * ───────────────────────────────
+   * JSON
+   * ───────────────────────────────
+   */
+
+  /**
+   * Convertit l'instance en JSON pour l'envoi au serveur.
+   * 
+   * @returns {Object} Représentation JSON de l'instance.
+   */
+  toJSON() {
+    const parentMeta = {};
+    if (this.parent?.id) parentMeta.id = this.parent.id;
+    if (typeof this.parent?.getEntityType === "function") parentMeta.type = this.parent.getEntityType();
+    if (this.parent?.__entityTag) parentMeta.__entityTag = this.parent.__entityTag;
+    if (this.parent?.slug) parentMeta.slug = this.parent.slug;
+
+    return {
+      __entityTag: this.__entityTag,
+      __isSerializedEntity: true,
+      serverData: this._serialize(this._serverData),
+      parent: Object.keys(parentMeta).length > 0 ? parentMeta : null
+    };
+  }
+
+
+  _serialize(obj) {
+    try {
+      return JSON.parse(EJSON.stringify(this._removeUnserializables(obj)));
+    } catch (e) {
+      this.apiClient?._logger?.error?.("Erreur de sérialisation EJSON", e);
+      return null;
+    }
+  }
+
+  /**
+   * 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
+   */
+  _removeUnserializables(obj, seen = new WeakSet()) {
+    if (obj === null || typeof obj !== "object") return obj;
+
+    if (seen.has(obj)) return null;
+    seen.add(obj);
+
+    // Ignore les proxys réactifs
+    if (obj.__isReactive && typeof obj.__raw === "object") {
+      return this._removeUnserializables(obj.__raw, seen);
+    }
+
+    if (Array.isArray(obj)) {
+      return obj.map((el) => this._removeUnserializables(el, seen));
+    }
+
+    const clean = {};
+    for (const key of Object.keys(obj)) {
+      const val = obj[key];
+
+      if (
+        typeof val === "function" ||
+      typeof val === "symbol" ||
+      typeof val === "undefined"
+      ) {
+        continue;
+      }
+
+      try {
+        clean[key] = this._removeUnserializables(val, seen);
+      // eslint-disable-next-line no-unused-vars
+      } catch (e) {
+        clean[key] = null;
+      }
+    }
+
+    return clean;
+  }
+
+  /**
+   * 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) {
+    return EJSON.fromJSONValue(obj);
+  }
+
+  /**
+   * 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, parent, deps) {
+
+    const { serverData } = json;
+
+    const instance = this.fromServerData(this._revive(serverData), parent, deps);
+
+    return instance;
+  }
 
   /**
    * ───────────────────────────────
@@ -1685,30 +1794,6 @@ export class BaseEntity {
   async getOrganizations(data = {}) {
     data.searchType = this._getDefaultFromEndpoint("GET_ORGANIZATIONS_NO_ADMIN", "searchType");
     // data.searchBy = "ALL";
-    // return this._paginateWith(data, isNext, async (finalData) => {
-    //   if(this.isMe){
-    //     finalData.pathParams = { type: this.getEntityType(), id: this.id };
-    //     // NOTE : dans le schema je crois que si pas de finalData.filters alors le default ce fait avec finalData.pathParams
-    //     // finalData.filters = {
-    //     //   [`links.members.${this.id}`]: { "$exists": true },
-    //     //   [`links.members.${this.id}.toBeValidated`]: { "$exists": false },
-    //     //   [`links.members.${this.id}.isInviting`]: { "$exists": false }
-    //     // };
-    //   } else {
-    //     delete finalData?.pathParams;
-    //     finalData.filters = {
-    //       [`links.members.${this.id}`]: { "$exists": true },
-    //       [`links.members.${this.id}.toBeValidated`]: { "$exists": false },
-    //       [`links.members.${this.id}.isInviting`]: { "$exists": false }
-    //     };
-    //   }
-  
-    //   const fetchFn = this.isMe
-    //     ? () => this.callIsMe(() => this.endpointApi.getOrganizationsAdmin(finalData))
-    //     : () => this.endpointApi.getOrganizationsNoAdmin(finalData);
-
-    //   return fetchFn();
-    // });
 
     const paginator = this._createPaginatorEngine({
       initialData: data,
@@ -1751,34 +1836,7 @@ export class BaseEntity {
   async getProjects(data = {}) {
     data.searchType = this._getDefaultFromEndpoint("GET_PROJECTS_ADMIN", "searchType");
     // data.searchBy = "ALL";
-    // return this._paginateWith(data, isNext, async (finalData) => {
-    //   if(this.isMe){
-    //     finalData.pathParams = { type: this.getEntityType(), id: this.id };
-    //   // NOTE : dans le schema je crois que si pas de finalData.filters alors le default ce fait avec finalData.pathParams
-    //   // finalData.filters = {
-    //   //   "$or": {
-    //   //     [`links.contributors.${this.id}`]: { "$exists": true },
-    //   //     [`parent.${this.id}`]: { "$exists": true }
-    //   //   },
-    //   //   [`links.contributors.${this.id}`]: { "$exists": true }
-    //   // };
-    //   } else {
-    //     delete finalData?.pathParams;
-    //     finalData.filters = {
-    //       "$or": {
-    //         [`links.contributors.${this.id}`]: { "$exists": true },
-    //         [`parent.${this.id}`]: { "$exists": true }
-    //       },
-    //       [`links.contributors.${this.id}`]: { "$exists": true }
-    //     };
-    //   }
-    
-    //   const fetchFn = this.isMe
-    //     ? () => this.callIsMe(() => this.endpointApi.getProjectsAdmin(finalData))
-    //     : () => this.endpointApi.getProjectsNoAdmin(finalData);
 
-    //   return fetchFn();
-    // });
     const paginator = this._createPaginatorEngine({
       initialData: data,
       finalizer: async (finalData) => {
@@ -1824,26 +1882,6 @@ export class BaseEntity {
   async getPois(data = {}) {
     data.searchType = this._getDefaultFromEndpoint("GET_POIS_ADMIN", "searchType");
     // data.searchBy = "ALL";
-    // return this._paginateWith(data, isNext, async (finalData) => {
-    //   if(this.isMe){
-    //     finalData.pathParams = { type: this.getEntityType(), id: this.id };
-    //   // NOTE : dans le schema je crois que si pas de finalData.filters alors le default ce fait avec finalData.pathParams
-    //   // finalData.filters = {
-    //   //   [`parent.${this.id}`]: { "$exists": true },
-    //   // };
-    //   } else {
-    //     delete finalData?.pathParams;
-    //     finalData.filters = {
-    //       [`parent.${this.id}`]: { "$exists": true },
-    //     };
-    //   }
-  
-    //   const fetchFn = this.isMe
-    //     ? () => this.callIsMe(() => this.endpointApi.getPoisAdmin(finalData))
-    //     : () => this.endpointApi.getPoisNoAdmin(finalData);
-
-    //   return fetchFn();
-    // });
 
     const paginator = this._createPaginatorEngine({
       initialData: data,
@@ -1882,17 +1920,7 @@ export class BaseEntity {
   async getSubscribers(data = {}) {
     data.searchType = this._getDefaultFromEndpoint("GET_SUBSCRIBERS", "searchType");
     // data.searchBy = "ALL";
-    // return this._paginateWith(data, isNext, async (finalData) => {
-    //   delete finalData?.pathParams;
-
-    //   finalData.filters =  {
-    //     [`links.follows.${this.id}`]: { "$exists": true },
-    //     [`links.follows.${this.id}.toBeValidated`]: { "$exists": false },
-    //     [`links.follows.${this.id}.isInviting`]: { "$exists": false }
-    //   };
 
-    //   return this.endpointApi.getSubscribers(finalData);
-    // });
     const paginator = this._createPaginatorEngine({
       initialData: data,
       finalizer: async (finalData) => {
@@ -1921,15 +1949,7 @@ export class BaseEntity {
   async getBadgesIssuer(data = {}) {
     data.searchType = this._getDefaultFromEndpoint("GET_BADGES", "searchType");
     // data.searchBy = "ALL";
-    // return this._paginateWith(data, isNext, async (finalData) => {
-    //   delete finalData?.pathParams;
-  
-    //   finalData.filters = finalData.filters || {};
-    //   finalData.filters["$or"] = {};
-    //   finalData.filters["$or"][`issuer.${this.id}`] = { "$exists": true };
 
-    //   return this.endpointApi.getBadges(finalData);
-    // });
     const paginator = this._createPaginatorEngine({
       initialData: data,
       finalizer: async (finalData) => {
@@ -2306,122 +2326,6 @@ export class BaseEntity {
 
     return count;
   }
-  
-  /**
-   * Méthode générique de pagination contextuelle avec support next / prev.
-   *
-   * @param {Object} data - Données d'entrée
-   * @param {boolean} isNext - true si appel de page suivante
-   * @param {Function} finalizer - fonction qui transforme et envoie les données (exécute la requête)
-   * @returns {Promise<Object>} { count, results, next, prev }
-   * @throws {ApiError} - Si le slug ou l'id de l'entité n'est pas défini.
-   * @throws {ApiResponseError} - Si les résultats ne sont pas un tableau.
-   * @private
-   */
-  // async _paginateWith(data = {}, isNext = false, finalizer) {
-  //   if (!this.serverData.slug) throw new ApiError("slug de l'entité non défini");
-  //   if (!this.serverData.id) throw new ApiError("id de l'entité non défini");
-
-  //   const hasStep = (d) => d?.indexStep && d.indexStep > 0;
-
-  //   if (!this._paginationCursor || (!isNext && this._paginationHistory.length === 0)) {
-  //     this._paginationCount = 0;
-  //     this._paginationPageIndex = 0;
-  //     this._paginationHistory = [];
-  //     this._paginationPageSizes = [];
-  //     data.countType = data.searchType;
-
-  //     if (!data?.searchBy && hasStep(data)) {
-  //       data.ranges = this._generateRanges(data.searchType, data.indexStep);
-  //       data.indexMin = data.indexMin ?? 0;
-  //       data.indexMax = data.indexMax ?? data.indexStep;
-  //     } else if (data?.searchBy === "ALL" && hasStep(data)) {
-  //       data.indexMin = data.indexMin ?? 0;
-  //       data.indexMax = data.indexMax ?? data.indexStep;
-  //     }
-
-  //     this._paginationCursor = { ...data };
-  //   }
-
-  //   const cursor = this._paginationCursor;
-
-  //   if (isNext) {
-  //     this._paginationHistory.push({ ...cursor });
-
-  //     if (!cursor.searchBy && hasStep(cursor)) {
-  //       cursor.ranges = this._generateRanges(cursor.searchType, cursor.indexStep, cursor.ranges);
-  //       cursor.indexMin = cursor.indexMax ?? 0;
-  //       cursor.indexMax = (cursor.indexMax ?? 0) + cursor.indexStep;
-  //     } else if (cursor.searchBy === "ALL" && hasStep(cursor)) {
-  //       cursor.indexMin = cursor.indexMax ?? 0;
-  //       cursor.indexMax = (cursor.indexMax ?? 0) + cursor.indexStep;
-  //     }
-
-  //     this._paginationCursor = { ...cursor };
-  //   }
-
-  //   data = { ...this._paginationCursor };
-
-  //   if (!isNext && (!data?.searchType || !Array.isArray(data.searchType) || data.searchType.length === 0)) {
-  //     throw new ApiError("searchType non défini");
-  //   }
-
-  //   const result = await finalizer(data);
-  //   if (!Array.isArray(result.results)) {
-  //     throw new ApiResponseError("Erreur lors de la récupération des résultats", 500, result.results);
-  //   }
-
-  //   this._paginationCount += result.results.length;
-  //   this._paginationPageSizes.push(result.results.length);
-
-  //   if (isNext) {
-  //     this._paginationPageIndex++;
-  //   }
-  
-  //   const count = this._normalizeCount(result.count);
-  //   const rawList = this._linkEntities(result.results);
-  //   const hasNext = hasStep(data) && this._paginationCount < count.total;
-  //   const hasPrev = this._paginationHistory?.length > 0;
-
-  //   const response = {
-  //     count,
-  //     results: rawList,
-  //     pageIndex: this._paginationPageIndex,
-  //     pageNumber: this._paginationPageIndex + 1,
-  //     hasNext,
-  //     hasPrev
-  //   };
-
-  //   if (hasNext) {
-  //     response.next = async () => this._paginateWith({}, true, finalizer);
-  //   }
-
-  //   if (this._paginationHistory?.length > 0) {
-  //     response.prev = async () => {
-  //       const previous = this._paginationHistory.pop();
-  //       const lastPageSize = this._paginationPageSizes.pop() ?? 0;
-  //       this._paginationCount -= lastPageSize;
-  //       this._paginationPageIndex = Math.max(0, this._paginationPageIndex - 1);
-  //       this._paginationCursor = { ...previous };
-  //       return this._paginateWith({}, false, finalizer);
-  //     };
-  //   }
-
-  //   return response;
-  // }
-
-
-  /**
-   * Réinitialise l'état de pagination.
-   */
-  // resetPagination() {
-  //   this._paginationCursor = undefined;
-  //   this._paginationCount = 0;
-  //   this._paginationPageIndex = 0;
-  //   this._paginationHistory = [];
-  //   this._paginationPageSizes = [];
-  // }
-
 
   /**
    * Récupère une valeur par défaut depuis un endpoint donné.
@@ -2436,32 +2340,6 @@ export class BaseEntity {
     return endpoint.request.properties[path].default;
   }
 
-  /**
-   * recherche lié à l'entité.
-   *
-   * @param {Object} data - Les données de recherche.
-   * @param {boolean} isNext - Indique si c'est une recherche suivante (pagination).
-   * @returns {Promise<Object>} - Résultat de la recherche.
-   * @throws {ApiError} - Si le slug ou l'id de entité n'est pas défini.
-   */
-  // async searchCostum(data = {}, isNext = false) {
-  //   return this._paginateWith(data, isNext, async (finalData) => {
-  //     finalData = {
-  //       ...finalData,
-  //       costumSlug: this.serverData.slug,
-  //       contextId: this.serverData.id,
-  //       contextType: this.getEntityType()
-  //     };
-
-  //     if (finalData.sourceKey?.length) {
-  //       finalData.sourceKey = [...finalData.sourceKey, this.serverData.slug];
-  //     } else {
-  //       finalData.sourceKey = [this.serverData.slug];
-  //     }
-
-  //     return this.endpointApi.globalAutocompleteCostum(finalData);
-  //   });
-  // }
 
   /**
    * Recherche liée à l'entité, version stateless.

package/src/api/EntityRegistry.js

@@ -0,0 +1,66 @@
+export const EntityRegistry = new Map();
+
+/**
+ * Enregistre une entité dans la registry.
+ * @param {string} tag - ex: "User", "Organization"
+ * @param {Function} EntityClass - la classe constructeur
+ */
+export function registerEntity(tag, EntityClass) {
+  EntityRegistry.set(tag, EntityClass);
+}
+
+/**
+ * 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}
+ */
+export function fromEntityJSON(json, parent = null) {
+  if (!json?.__entityTag) return null;
+  if (!json.serverData?.collection) return json;
+  const meta = _getEntityMeta(json.serverData.collection, json.__entityTag);
+  if (!meta) return json;
+  if (!meta?.entityClass?.fromJSON) throw new Error(`Classe inconnue ou fromJSON manquant pour ${json.__entityTag}`);
+  return meta.entityClass.fromJSON(json, parent, meta.deps);
+}
+
+/**
+   * Récupère la classe d'entité et ses dépendances à partir du type d'entité.
+   * 
+   * @param {string} entityType - Le type d'entité.
+   * @param {string} __entityTag - Le tag de l'entité.
+   * @returns {Object|null} - Un objet contenant la classe d'entité et ses dépendances, ou null si le type d'entité n'est pas trouvé.
+   */
+function _getEntityMeta(entityType, __entityTag) {
+  const selfClass = EntityRegistry.get(__entityTag);
+  const selfTag = __entityTag;
+  
+  const commonDeps = {
+    EndpointApi: EntityRegistry.get("EndpointApi"),
+    User: selfTag === "User" ? selfClass : EntityRegistry.get("User"),
+    Organization: selfTag === "Organization" ? selfClass : EntityRegistry.get("Organization"),
+    Project: selfTag === "Project" ? selfClass : EntityRegistry.get("Project"),
+    Event: selfTag === "Event" ? selfClass : EntityRegistry.get("Event"),
+    Poi: selfTag === "Poi" ? selfClass : EntityRegistry.get("Poi"),
+    Badge: selfTag === "Badge" ? selfClass : EntityRegistry.get("Badge"),
+    News: selfTag === "News" ? selfClass : EntityRegistry.get("News")
+  };
+  
+  const map = {
+    citoyens:     { entityClass: commonDeps.User,         deps: commonDeps },
+    organizations:{ entityClass: commonDeps.Organization, deps: commonDeps },
+    projects:      { entityClass: commonDeps.Project,      deps: commonDeps },
+    events:       { entityClass: commonDeps.Event,        deps: { ...commonDeps, Badge: undefined } },
+    poi:          { entityClass: commonDeps.Poi,          deps: { ...commonDeps, Badge: undefined, News: undefined } },
+    news:         { entityClass: commonDeps.News,         deps: { ...commonDeps } },
+    badges:       { entityClass: commonDeps.Badge,        deps: { 
+      EndpointApi: commonDeps.EndpointApi, 
+      User: commonDeps.User, 
+      Organization: commonDeps.Organization, 
+      Project: commonDeps.Project 
+    } }
+  };
+  
+  return map[entityType] || null;
+}

package/src/api/Organization.js

@@ -183,29 +183,7 @@ export class Organization extends BaseEntity {
   async getMembers(data = {}, options = {}) {
     data.searchType = this._getDefaultFromEndpoint("GET_MEMBERS_ADMIN", "searchType");
     // data.searchBy = "ALL";
-    // return this._paginateWith(data, isNext, async (finalData) => {
-
-    //   const { toBeValidated, isAdmin, isAdminPending, isInviting, roles = [] } = options;
-
-    //   if(this.isMe){
-    //     finalData.pathParams = { type: this.getEntityType(), id: this.id };
-    //     // finalData.filters = {
-    //     //   [`links.memberOf.${this.id}`]: { "$exists": true },
-    //     //   [`links.memberOf.${this.id}.toBeValidated`]: { "$exists": false },
-    //     //   [`links.memberOf.${this.id}.isInviting`]: { "$exists": false }
-    //     // };
-    //     finalData.filters = this._buildLinkFilters(this.id, { linkType: "memberOf", toBeValidated, isAdmin, isAdminPending, isInviting, roles });
-    //   } else {
-    //     delete finalData?.pathParams;
-    //     finalData.filters = this._buildLinkFilters(this.id, { linkType: "memberOf", toBeValidated: false, isAdmin, isInviting, roles });
-    //   }
-  
-    //   const fetchFn = this.isMe
-    //     ? () => this.callIsMe(() => this.endpointApi.getMembersAdmin(finalData))
-    //     : () => this.endpointApi.getMembersNoAdmin(finalData);
 
-    //   return fetchFn();
-    // });
     const paginator = this._createPaginatorEngine({
       initialData: data,
       finalizer: async (finalData) => {

package/src/api/Project.js

@@ -193,30 +193,7 @@ export class Project extends BaseEntity {
   async getContributors(data = {}, options = {}) {
     data.searchType = this._getDefaultFromEndpoint("GET_CONTRIBUTORS_ADMIN", "searchType");
     // data.searchBy = "ALL";
-    // return this._paginateWith(data, isNext, async (finalData) => {
-
-    //   const { toBeValidated, isAdmin, isInviting, isAdminPending, roles = [] } = options;
-
-    //   if(this.isMe){
-    //     finalData.pathParams = { type: this.getEntityType(), id: this.id };
-    //     // NOTE : dans le schema je crois que si pas de finalData.filters alors le default ce fait avec finalData.pathParams
-    //     // finalData.filters = {
-    //     //   [`links.projects.${this.id}`]: { "$exists": true },
-    //     //   [`links.projects.${this.id}.toBeValidated`]: { "$exists": false },
-    //     //   [`links.projects.${this.id}.isInviting`]: { "$exists": false }
-    //     // };
-    //     finalData.filters = this._buildLinkFilters(this.id, { linkType: "projects", toBeValidated, isAdmin, isAdminPending, isInviting, roles });
-    //   } else {
-    //     delete finalData?.pathParams;
-    //     finalData.filters = this._buildLinkFilters(this.id, { linkType: "projects", toBeValidated: false, isAdmin, isInviting, roles });
-    //   }
-  
-    //   const fetchFn = this.isMe
-    //     ? () => this.callIsMe(() => this.endpointApi.getContributorsAdmin(finalData))
-    //     : () => this.endpointApi.getContributorsNoAdmin(finalData);
 
-    //   return fetchFn();
-    // });
     const paginator = this._createPaginatorEngine({
       initialData: data,
       finalizer: async (finalData) => {

package/src/api/User.js

@@ -1,4 +1,4 @@
-import { ApiError, ApiResponseError } from "../error.js";
+import { ApiError } from "../error.js";
 import BaseEntity from "./BaseEntity.js";
 import { UserMixin } from "../mixin/UserMixin.js";
 
@@ -287,23 +287,7 @@ export class User extends BaseEntity {
   async getOrganizations(data = {}) {
     data.searchType = this._getDefaultFromEndpoint("GET_ORGANIZATIONS_NO_ADMIN", "searchType");
     // data.searchBy = "ALL";
-    // return this._paginateWith(data, isNext, async (finalData) => {
-    //   delete finalData?.pathParams;
 
-    //   const fetchFn = this.isMe
-    //     ? () => this.callIsMe(() => this.endpointApi.getOrganizationsAdmin(finalData))
-    //     : () => this.endpointApi.getOrganizationsNoAdmin(finalData);
-  
-    //   if (!this.isMe && !finalData.filters) {
-    //     finalData.filters = {
-    //       [`links.members.${this.id}`]: { "$exists": true },
-    //       [`links.members.${this.id}.toBeValidated`]: { "$exists": false },
-    //       [`links.members.${this.id}.isInviting`]: { "$exists": false }
-    //     };
-    //   }
-
-    //   return fetchFn();
-    // });
     const paginator = this._createPaginatorEngine({
       initialData: data,
       finalizer: async (finalData) => {
@@ -359,25 +343,25 @@ export class User extends BaseEntity {
    * actuellement, c'est tous les utilisateurs connectés
    */
   async getFriends(data = {}) {
-    delete data?.pathParams;
-
-    if (!this.isMe){
-      // is not me add id
-      data.pathParams = { id: this.id };
-    }
+    data.searchType = this._getDefaultFromEndpoint("GET_FRIENDS_ADMIN", "searchType");
+    // data.searchBy = "ALL";
 
-    const arrayObjet = await this.endpointApi.getFriendsAdmin(data);
-    if (!Array.isArray(arrayObjet.results)){
-      throw new ApiResponseError("Erreur lors de la récupération des amis administrables.", 500, arrayObjet);
+    const paginator = this._createPaginatorEngine({
+      initialData: data,
+      finalizer: async (finalData) => {
 
-    }
+        delete finalData?.pathParams;
+  
+        if (!this.isMe){
+          // is not me add id
+          finalData.pathParams = { id: this.id };
+        }
 
-    const rawList = this._linkEntities(arrayObjet.results);
+        return this.endpointApi.getFriendsAdmin(finalData);;
+      }
+    });
 
-    return {
-      count: arrayObjet?.count?.citoyens ?? 0,
-      results: rawList
-    };
+    return paginator.next();
   }
 
   /**
@@ -387,22 +371,7 @@ export class User extends BaseEntity {
   async getSubscriptions(data = {}) {
     data.searchType = this._getDefaultFromEndpoint("GET_SUBSCRIPTIONS", "searchType");
     // data.searchBy = "ALL";
-    // return this._paginateWith(data, isNext, async (finalData) => {
 
-    //   delete finalData?.pathParams;
-  
-    //   const fetchFn = this.isMe
-    //     ? () => this.callIsMe(() => this.endpointApi.getSubscriptionsAdmin(finalData))
-    //     : () => this.endpointApi.getSubscriptions(finalData);
-  
-    //   if (!this.isMe && !finalData.filters) {
-    //     finalData.filters = {
-    //       [`links.followers.${this.id}`]: { "$exists": true },
-    //     };
-    //   }
-
-    //   return fetchFn();
-    // });
     const paginator = this._createPaginatorEngine({
       initialData: data,
       finalizer: async (finalData) => {

package/src/index.js

@@ -1,3 +1,4 @@
+import { fromEntityJSON } from "./api/EntityRegistry.js";
 import Api from "./Api.js";
 import ApiClient from "./ApiClient.js";
 import * as error from "./error.js";
@@ -25,6 +26,9 @@ export default {
     createDefaultMultiServerTokenStorageStrategy,
     MultiServerTokenStorageStrategy
   },
+  helper: {
+    fromEntityJSON
+  },
 
   OfflineClientManager
 };