@communecter/cocolight-api-client 1.0.56 → 1.0.58

package/package.json

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

package/src/Api.ts

@@ -1,4 +1,5 @@
 // Api.ts
+import { Answer } from "./api/Answer.js";
 import { Badge } from "./api/Badge.js";
 import { Comment } from "./api/Comment.js";
 import EndpointApi from "./api/EndpointApi.js";
@@ -15,6 +16,7 @@ import { ApiAuthenticationError, ApiClientError, ApiError, ApiResponseError } fr
 import type ApiClient from "./ApiClient.js";
 import type { ApiClientOptions } from "./ApiClient.js";
 import type { GetElementsKeyResponse } from "./types/api-responses.js";
+import type { EntityData, EntityTypes } from "./types/entities.js";
 
 registerEntity("User", User);
 registerEntity("Organization", Organization);
@@ -26,20 +28,9 @@ registerEntity("EndpointApi", EndpointApi);
 // registerEntity("UserApi", UserApi);
 registerEntity("News", News);
 registerEntity("Comment", Comment);
+registerEntity("Answer", Answer);
 
-/**
- * Union type for all possible entity types
- */
-type EntityTypes = User | Organization | Project | Event | Poi | Badge | News | Comment;
 
-/**
- * Type pour récupérer une entité existante via l'API publique.
- * Nécessite soit un id, soit un slug.
- * Les propriétés additionnelles sont autorisées mais ignorées lors de la récupération.
- */
-type EntityData =
-  | { id: string; slug?: string; [key: string]: any }
-  | { slug: string; id?: string; [key: string]: any };
 
 export default class Api {
   private _loggedUser: User | null;
@@ -153,7 +144,7 @@ export default class Api {
    */
   async organization(organizationData: EntityData): Promise<Organization> {
     try {
-      const organization = new Organization(this._client, organizationData, { EndpointApi, User, Project, Event, Poi, Badge, News, Comment });
+      const organization = new Organization(this._client, organizationData, { EndpointApi, User, Project, Event, Poi, Badge, News, Comment, Answer });
       if (!organizationData.id && !organizationData.slug) {
         throw new Error("Vous devez fournir un id ou un slug pour créer une instance Organization.");
       }
@@ -199,6 +190,23 @@ export default class Api {
     }
   }
 
+  /**
+   * Creates a new Answer instance and optionally retrieves answer data.
+   */
+  async answer(answerData: { id: string }): Promise<Answer> {
+    try {
+      const answer = new Answer(this._client, answerData, { EndpointApi, User, Organization, Project, Event, Poi, Badge, News, Comment });
+      if (!answerData.id) {
+        throw new Error("Vous devez fournir un id pour créer une instance Answer.");
+      }
+      await answer.get();
+      return answer;
+    } catch (error) {
+      console.error("[Api.answer] Erreur lors de la création d'un objet Answer :", (error as Error).message);
+      throw error;
+    }
+  }
+
   /**
    * Retourne une entité à partir d'un slug.
    */

package/src/ApiClient.ts

@@ -844,10 +844,11 @@ export default class ApiClient extends EventEmitter {
         headers,
         [lowerMethod === "get" ? "params" : "data"]: payload
       });
-  
+      
       if (validateResponseSchema) {
         const statusStr = String(response.status);
         const schema = responses?.[statusStr];
+        
         if (schema) {
           const validateResponse: ValidateFunction = this._ajv.compile(schema);
           const valid = validateResponse(response.data);

package/src/api/Answer.ts

@@ -0,0 +1,69 @@
+import { BaseEntity } from "./BaseEntity.js";
+import { ApiError } from "../error.js";
+
+import type { AnswerItemNormalized } from "./serverDataType/Answer.js";
+
+export class Answer extends BaseEntity<AnswerItemNormalized> {
+  static override entityType = "answers";
+
+  static override entityTag = "Answer";
+  static override SCHEMA_CONSTANTS: string[] = [
+  ];
+
+  static ADD_BLOCKS: Map<string, string> = new Map([
+  ]);
+  static UPDATE_BLOCKS: Map<string, string> = new Map([
+  ]);
+  override defaultFields: Record<string, any> = {
+  };
+  override removeFields: string[] = [];
+
+  /**
+   * Transforme les champs imbriqués (user, context etc.) en instances d'entités.
+   * @param data - Les données brutes du serveur.
+   * @returns Les données transformées.
+   * @protected
+   */
+  protected override _transformServerData(data: AnswerItemNormalized): AnswerItemNormalized {
+
+    // Transformer user en instance User
+    if(data.user && typeof data.user === "object" && "id" in data.user) {
+      data.user = this._linkNestedEntity({ id: (data.user as any).id, type: "citoyens" });
+    }
+
+    // Transformer context en instance Organization/Project
+    // if (data.context && typeof data.context === "object" && !("id" in data.context)) {
+    //   // context est un ParentsMap: { "id1": {type: "organizations", name: "..."}, "id2": {...} }
+    //   // On transforme chaque entrée en instance d'entité
+    //   const transformedContext: Record<string, any> = {};
+    //   for (const [id, parentRef] of Object.entries(data.context)) {
+    //     if (parentRef && typeof parentRef === "object" && "type" in parentRef) {
+    //       transformedContext[id] = this._linkNestedEntity({ id, type: parentRef.type });
+    //     }
+    //   }
+    //   data.context = transformedContext;
+    // }
+
+    return data;
+  }
+
+  /**
+     * Rafraîchit les données de l'entité depuis l'API.
+     * Constant : COFORM_ANSWERS_BY_ID
+     */
+  override async get(): Promise<Record<string, any>> {
+    if (!this.id) throw new ApiError("Impossible de rafraîchir sans ID.", 400);
+    const answerId = this.id; // Type narrowing
+
+    const answer = await this.endpointApi.coformAnswersById({
+      answerId
+    });
+
+    if (answer?.data?.id) {
+      this._setData(answer.data as AnswerItemNormalized, { forceInitialDraftReset: true });
+      return this.serverData;
+    }
+    throw new ApiError(`Aucune réponse trouvée pour l'ID ${this.id}`, 404);
+  }
+    
+}

package/src/api/BaseEntity.ts

@@ -39,7 +39,8 @@ import type {
   GetPoisAdminData,
   GetPoisNoAdminData,
   GetSubscribersData,
-  GetBadgesData
+  GetBadgesData,
+  CoformAnswersSearchData
 } from "./EndpointApi.types.js";
 import type { GetElementsKeyResponse } from "../types/api-responses.js";
 import type { TransformsMap } from "../types/entities.js";
@@ -74,9 +75,10 @@ type Poi = import("./Poi.js").Poi;
 type News = import("./News.js").News;
 type Badge = import("./Badge.js").Badge;
 type Comment = import("./Comment.js").Comment;
+type Answer = import("./Answer.js").Answer;
 
 // Types d'union
-type AnyEntity = User | Organization | Project | Poi | EventEntity | Badge | News | Comment;
+type AnyEntity = User | Organization | Project | Poi | EventEntity | Badge | News | Comment | Answer;
 type ParentLike = BaseEntity<any> & { apiClient: ApiClient, userContext?: User | null };
 
 // Types pour les dépendances
@@ -93,6 +95,7 @@ interface Deps {
   Badge?: any;
   News?: any;
   Comment?: any;
+  Answer?: any;
 }
 
 interface BaseEntityConfig {
@@ -109,6 +112,7 @@ interface EntityTypeMap {
   news: News;
   badges: Badge;
   comments: Comment;
+  answers: Answer;
 }
 
 // Types pour les streams et uploads
@@ -158,7 +162,7 @@ interface LinkMeta {
 // Type du constructeur de BaseEntity avec ses propriétés statiques
 type BaseEntityCtor = typeof BaseEntity & {
   entityTag: string;
-  entityType: "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments";
+  entityType: "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers";
   SCHEMA_CONSTANTS: string | string[];
 };
 
@@ -261,7 +265,7 @@ interface FinalizerResult<TOut> {
 }
 
 // Types pour les entités
-type EntityType = "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news";
+type EntityType = "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers";
 
 // ============================================================================
 
@@ -440,7 +444,7 @@ export class BaseEntity<TServerData = any> {
   }
 
   /** @returns Type de l'entité (ex: 'citoyens') */
-  getEntityType(): "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" {
+  getEntityType(): "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" {
     return this._getCtor().entityType;
   }
 
@@ -1693,6 +1697,7 @@ export class BaseEntity<TServerData = any> {
       Badge: selfTag === "Badge" ? selfClass : this.deps.Badge,
       News: selfTag === "News" ? selfClass : this.deps.News,
       Comment: selfTag === "Comment" ? selfClass : this.deps.Comment,
+      Answer: selfTag === "Answer" ? selfClass : this.deps.Answer,
     };
 
     const map = {
@@ -1709,6 +1714,7 @@ export class BaseEntity<TServerData = any> {
         Project: commonDeps.Project
       } },
       comments:     { entityClass: commonDeps.Comment,      deps: { ...commonDeps } },
+      answers:      { entityClass: commonDeps.Answer,       deps: { ...commonDeps } },
     };
 
     return (map as Record<string, EntityMeta | undefined>)[entityType] || null;
@@ -1939,6 +1945,7 @@ export class BaseEntity<TServerData = any> {
         news: ["id"],
         badges: ["id"],
         comments: [], // Pas de get() pour les commentaires
+        answers: ["id"],
       };
 
       const fetchKeys = (fetchKeysByEntity as Record<string, string[] | undefined>)[entityType];
@@ -2565,7 +2572,7 @@ export class BaseEntity<TServerData = any> {
 
     // Réduit le type de l'entité aux seuls autorisés par UpdateBlockLocalityData
     const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "comments") {
+    if (t === "badges" || t === "news" || t === "comments" || t === "answers") {
       throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
     }
 
@@ -2646,7 +2653,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "comments") {
+    if (t === "badges" || t === "news" || t === "comments" || t === "answers") {
       throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
     }
 
@@ -2959,7 +2966,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "poi" || t === "events" || t === "comments") {
+    if (t === "badges" || t === "news" || t === "poi" || t === "events" || t === "comments" || t === "answers") {
       throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par GET_NEWS.`, 400);
     }
 
@@ -3001,7 +3008,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     const t = this.getEntityType();
-    if (t === "badges" || t === "news" || t === "poi" || t === "events" || t === "comments") {
+    if (t === "badges" || t === "news" || t === "poi" || t === "events" || t === "comments" || t === "answers") {
       throw new ApiError(`Le type d'entité "${t}" n'est pas supporté par UPDATE_BLOCK_LOCALITY.`, 400);
     }
 
@@ -3884,6 +3891,16 @@ export class BaseEntity<TServerData = any> {
     return wrappedFinalizer(fullData);
   }
 
+  
+  async coformAnswersSearch(data: Partial<CoformAnswersSearchData> = {}): Promise<PaginatorPage<any>> {
+    const paginator = this._createPaginatorEngine({
+      initialData: data,
+      finalizer: this._withCostumContext(
+        (finalData: CoformAnswersSearchData) => this.endpointApi.coformAnswersSearch(finalData)
+      ),
+    });
+    return paginator.next() as Promise<PaginatorPage<any>>;
+  }
 
 }
 

package/src/api/EndpointApi.ts

@@ -2,7 +2,7 @@
 import { ApiAuthenticationError } from "../error.js";
 
 import type ApiClient from "../ApiClient.js";
-import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData } from "./EndpointApi.types.js";
+import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData } from "./EndpointApi.types.js";
 
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
@@ -1594,6 +1594,36 @@ export class EndpointApi {
     return this.callIsConnected("GET_ATTENDEES_ADMIN", data);
   }
     
+  /**
+   * Recherche des reponses des formulaires basées sur un coform : Effectue une recherche des reponses des formulaires basées sur un coform
+   * Constant : COFORM_ANSWERS_SEARCH
+   * @param data - Données envoyées à l'API
+   * @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.
+   */
+  async coformAnswersSearch(data: CoformAnswersSearchData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COFORM_ANSWERS_SEARCH", data);
+  }
+    
+  /**
+   * Récuperer une réponse de formulaire par son ID : Récuperer une réponse de formulaire par son ID
+   * Constant : COFORM_ANSWERS_BY_ID
+   * @param data - Données envoyées à l'API
+   * @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.
+   */
+  async coformAnswersById(data: CoformAnswersByIdData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("COFORM_ANSWERS_BY_ID", data);
+  }
+    
 }
 
 export default EndpointApi;

package/src/api/EndpointApi.types.ts

@@ -413,7 +413,7 @@ export interface GetElementsAboutData {
     /**
      * Type d'entité
      */
-    type: "citoyens" | "projects" | "organizations" | "events" | "poi" | "badges";
+    type: "citoyens" | "projects" | "organizations" | "events" | "poi" | "badges" | "answers";
     /**
      * ID de l'utilisateur ou de l'entité
      */
@@ -4607,3 +4607,163 @@ export interface GetAttendeesAdminData {
   };
   [k: string]: unknown;
 }
+
+
+export interface CoformAnswersSearchData {
+  /**
+   * Nom ou mot-clé de la recherche
+   */
+  name?: string;
+  /**
+   * Liste des localités ciblées avec leur identifiant et leur type (city ou level1)
+   */
+  locality?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^[^\s]+$".
+     */
+    [k: string]: {
+      /**
+       * Identifiant de la localité
+       */
+      id: string;
+      /**
+       * Type de la localité : 'cities' pour une ville ou 'level1' pour une région
+       */
+      type: "cities" | "level1";
+    };
+  };
+  /**
+   * Types d'entités à inclure dans la recherche
+   */
+  searchType: "answers"[];
+  /**
+   * Balises (tags) à utiliser pour filtrer la recherche
+   */
+  searchTags?: string[];
+  /**
+   * Liste fixe des types à compter dans les résultats
+   */
+  countType: "answers"[];
+  /**
+   * Critère de recherche (actuellement vide)
+   */
+  searchBy?: "ALL";
+  /**
+   * Index de départ global pour la pagination
+   */
+  indexMin: number;
+  /**
+   * Index de fin global pour la pagination
+   */
+  indexMax?: number;
+  /**
+   * Nombre d’éléments à récupérer (limite de pagination)
+   */
+  indexStep: number;
+  /**
+   * Configuration des plages de résultats pour chaque type de recherche
+   */
+  ranges?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^[^\s]+$".
+     */
+    [k: string]: {
+      /**
+       * Index de départ pour la pagination
+       */
+      indexMin: number;
+      /**
+       * Index de fin pour la pagination
+       */
+      indexMax: number;
+    };
+  };
+  /**
+   * Type initial de la recherche, vide par défaut
+   */
+  initType: "";
+  /**
+   * Indique si les types doivent être comptés dans les résultats
+   */
+  count: true;
+  /**
+   * Filtres additionnels appliqués à la recherche (objet ou chaîne vide)
+   */
+  filters?:
+    | {
+        [k: string]: unknown;
+      }
+    | "";
+  /**
+   * Liste des champs à retourner
+   */
+  fields?: string[];
+  /**
+   * Champ de tri (clé = champ, valeur = 1 ou -1)
+   */
+  sortBy?: {
+    [k: string]: 1 | -1;
+  };
+  /**
+   * Indique si la recherche doit s'étendre au Fediverse (toujours désactivé)
+   */
+  fediverse: boolean;
+  /**
+   * Indique si la recherche est effectuée à partir d'une carte (toujours désactivé)
+   */
+  mapUsed?: true;
+  /**
+   * Indique si on doit exclure les éléments avec une source
+   */
+  notSourceKey?: true;
+  /**
+   * 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;
+  options?: {
+    tags?: {
+      /**
+       * Verbe d'action pour le filtre de recherche
+       */
+      verb?: string;
+      [k: string]: unknown;
+    };
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
+export interface CoformAnswersByIdData {
+  /**
+   * ID de la réponse à récupérer
+   */
+  answerId: string;
+  /**
+   * Chemin du finder utilisé pour la recherche (actuellement vide)
+   */
+  finderPath?: string;
+  /**
+   * Liste des champs à retourner
+   */
+  fields?: string[];
+  [k: string]: unknown;
+}

package/src/api/EntityRegistry.ts

@@ -1,7 +1,7 @@
 // TypeScript native types
 import type { CollectionType } from "../types/entities.js";
 
-export type EntityTag = "User" | "Organization" | "Project" | "Event" | "Poi" | "Badge" | "News" | "Comment";
+export type EntityTag = "User" | "Organization" | "Project" | "Event" | "Poi" | "Badge" | "News" | "Comment" | "Answer";
 export type CollectionKey = CollectionType; // Alias pour compatibilité
 type BaseEntity = import("./BaseEntity.js").BaseEntity<any>;
 type ApiClient = import("../ApiClient.js").default;
@@ -86,6 +86,7 @@ function _getEntityMeta(entityType: CollectionKey, __entityTag: EntityTag): Enti
     Badge: selfTag === "Badge" ? selfClass : EntityRegistry.get("Badge"),
     News: selfTag === "News" ? selfClass : EntityRegistry.get("News"),
     Comment: selfTag === "Comment" ? selfClass : EntityRegistry.get("Comment"),
+    Answer: selfTag === "Answer" ? selfClass : EntityRegistry.get("Answer"),
   };
 
   const map: Record<CollectionKey, EntityMeta> = {
@@ -101,7 +102,8 @@ function _getEntityMeta(entityType: CollectionKey, __entityTag: EntityTag): Enti
       Organization: commonDeps.Organization, 
       Project: commonDeps.Project 
     } },
-    comments:     { entityClass: commonDeps.Comment as EntityClass,      deps: { ...commonDeps } }
+    comments:     { entityClass: commonDeps.Comment as EntityClass,      deps: { ...commonDeps } },
+    answers:      { entityClass: commonDeps.Answer as EntityClass,       deps: { ...commonDeps } },
   };
   
   return map[entityType] || null;
@@ -148,6 +150,10 @@ export function createFromCollection(collection: CollectionKey, parent: ApiClien
     comments: {
       entityTag: "Comment",
       meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    answers: {
+      entityTag: "Answer",
+      meta: tag => _buildMeta(tag, { remove: [] })
     }
   };
   const entry = _collectionMap[collection];
@@ -179,6 +185,7 @@ function _buildMeta(tag: EntityTag, options: { remove: string[] }): EntityMeta {
     Badge: EntityRegistry.get("Badge"),
     News: EntityRegistry.get("News"),
     Comment: EntityRegistry.get("Comment"),
+    Answer: EntityRegistry.get("Answer")
   };
   // inject self
   (allDeps as any)[tag] = EntityClass;
@@ -190,7 +197,7 @@ function _buildMeta(tag: EntityTag, options: { remove: string[] }): EntityMeta {
 /**
  * Cas spécifique des badges : seules certaines dépendances.
  */
-function _buildCustomMeta(tag: "Badge"): EntityMeta {
+function _buildCustomMeta(tag: "Badge" | "Answer"): EntityMeta {
   const EntityClass = EntityRegistry.get(tag) as EntityClass;
   const deps: EntityDeps = {
     EndpointApi: EntityRegistry.get("EndpointApi"),

package/src/api/News.ts

@@ -91,10 +91,8 @@ export class News extends BaseEntity<NewsItemNormalized> {
     if (!this.id) throw new ApiError("Impossible de rafraîchir sans ID.", 400);
     const id = this.id; // Type narrowing
 
-    const newsArray = await this.callIsConnected(() =>
-      this.endpointApi.getNewsById({ ids: [id] })
-    );
-    
+    const newsArray = await this.endpointApi.getNewsById({ ids: [id] });
+
     if (newsArray && Array.isArray(newsArray) && newsArray.length === 1) {
       const data = newsArray[0];
       this._setData(data, { forceInitialDraftReset: true });

package/src/api/Organization.ts

@@ -7,9 +7,9 @@ import type {
   GetMembersAdminData,
   GetMembersNoAdminData
 } from "./EndpointApi.types.js";
+import type { OrganizationItemNormalized } from "./serverDataType/Organization.js";
 import type { User } from "./User.js";
 
-type OrganizationItemNormalized = import("./serverDataType/Organization.js").OrganizationItemNormalized;
 
 export class Organization extends BaseEntity<OrganizationItemNormalized> {
   static override entityType = "organizations";
@@ -430,4 +430,13 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
     return super.searchCostum(data);
   }
 
+  /**
+    * {@inheritDoc BaseEntity#coformAnswersSearch}
+    * 
+    * Cette méthode est redéfinie ici pour fournir des types spécifiques à l'entité Answer.
+    */
+  override async coformAnswersSearch(data: Parameters<BaseEntity<OrganizationItemNormalized>["coformAnswersSearch"]>[0]) {
+    return super.coformAnswersSearch(data);
+  }
+
 }

package/src/api/User.ts

@@ -1,5 +1,6 @@
-import { ApiError } from "../error.js";
+import { ApiError, ApiResponseError } from "../error.js";
 import { BaseEntity } from "./BaseEntity.js";
+import { createFromCollection } from "./EntityRegistry.js";
 import { UserMixin } from "../mixin/UserMixin.js";
 
 import type { Badge } from "./Badge.js";
@@ -18,6 +19,8 @@ import type {
   GetFriendsAdminData
 } from "./EndpointApi.types.js";
 import type { Organization } from "./Organization.js";
+import type { GetElementsKeyResponse } from "@/types/api-responses.js";
+import type { EntityTypes } from "@/types/entities.js";
 
 type ApiClient = import("../ApiClient.js").default;
 type UserItemNormalized = import("./serverDataType/User.js").UserItemNormalized;
@@ -861,6 +864,44 @@ export class User extends BaseEntity<UserItemNormalized> {
     this._assertEntityType("citoyens");
     return this._isLinked("follows");
   }
+
+  /**
+   * Retourne une entité à partir d'un slug.
+   */
+  async entitySlug(slug: string): Promise<EntityTypes> {
+    if(!this.isMe){
+      throw new ApiError("Vous devez être connecté et être l'utilisateur pour créer cet entité.", 401);
+    }
+    if (!slug) {
+      throw new ApiError("slug requis", 400);
+    }
+    try {
+      const data = await this.endpointApi.getElementsKey({
+        pathParams:{
+          slug: slug
+        }
+      }) as GetElementsKeyResponse;
+  
+      if(data.contextId && data.contextType) {
+        const entity = createFromCollection(data.contextType, this, { id: data.contextId });
+        if (!entity) {
+          throw new ApiResponseError(`Le type d'entité pour le slug ${slug} n'est pas reconnu`, 200, data as object);
+        }
+        await entity.get();
+        // On sait que c'est l'un des types concrets → on caste
+        return entity as EntityTypes;
+      } else {
+        throw new ApiResponseError(`Le slug ${slug} n'est pas valide`, 200, data as object);
+      }
+    } 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;
+      }
+    }
+  
+  }
 }
 
 // Incorporation des mixins dans User