@communecter/cocolight-api-client 1.0.123 → 1.0.125

package/src/api/BaseEntity.ts

@@ -49,7 +49,16 @@ import type {
   GetCountriesData,
   SearchZonesData,
   CoformAnswersByFormsData,
-  FundingEnvelopeData
+  FundingEnvelopeData,
+  LinkDiscourseAccountData,
+  UnlinkDiscourseAccountData,
+  DiscourseProfileData,
+  DiscourseCheckEmailData,
+  DiscourseDismissLinkData,
+  LinkMediawikiAccountData,
+  UnlinkMediawikiAccountData,
+  GetMediawikiContributionsData,
+  CoremuOperationData
 } from "./EndpointApi.types.js";
 import type { GetElementsKeyResponse } from "../types/api-responses.js";
 import type { TransformsMap } from "../types/entities.js";
@@ -65,6 +74,7 @@ type OrganizationInput = { id: string } | { slug: string } | Record<string, any>
 type ProjectInput = { id: string } | { slug: string } | Record<string, any>;
 type PoiInput = { id: string } | { slug: string } | Record<string, any>;
 type EventInput = { id: string } | { slug: string } | Record<string, any>;
+type ClassifiedInput = { id: string } | Record<string, any>;
 type BadgeInput = { id: string } | Record<string, any>;
 type NewsInput = { id: string } | Record<string, any>;
 
@@ -73,7 +83,7 @@ type NewsInput = { id: string } | Record<string, any>;
  * possédant au moins .toHexString().
  * (peu importe la d.ts du module, on impose notre contrat minimal)
  */
-const createObjectId: (arg?: number|string|number[]|Buffer) => { toHexString(): string } = objectId as any;
+const createObjectId: (arg?: number | string | number[] | Buffer) => { toHexString(): string } = objectId as any;
 
 // Types TypeScript importés
 type ApiClient = import("../ApiClient.js").default;
@@ -88,9 +98,10 @@ type Badge = import("./Badge.js").Badge;
 type Comment = import("./Comment.js").Comment;
 type Answer = import("./Answer.js").Answer;
 type Form = import("./Form.js").Form;
+type Classified = import("./Classified.js").Classified;
 
 // Types d'union
-type AnyEntity = User | Organization | Project | Poi | EventEntity | Badge | News | Comment | Answer | Form;
+type AnyEntity = User | Organization | Project | Poi | EventEntity | Badge | News | Comment | Answer | Form | Classified;
 type ParentLike = BaseEntity<any> & { apiClient: ApiClient, userContext?: User | null };
 
 // Types pour les dépendances
@@ -109,6 +120,7 @@ interface Deps {
   Comment?: any;
   Answer?: any;
   Form?: any;
+  Classified?: any
 }
 
 interface BaseEntityConfig {
@@ -127,6 +139,7 @@ interface EntityTypeMap {
   comments: Comment;
   answers: Answer;
   forms: Form;
+  classifieds: Classified;
 }
 
 // Types pour les streams et uploads
@@ -135,6 +148,15 @@ type UploadInput = File | Blob | Buffer | import("stream").Readable;
 type ValidatedUpload = File | Buffer | ReadableWithMeta;
 
 // Type de retour pour fundingEnvelope
+//
+// Note: `projects` est un tableau d'enveloppes de financement.
+// Chaque enveloppe contient les métadonnées (totalFinancement, depenses, actions, etc.)
+// + un sous-champ `project` qui porte l'entité projet réelle.
+export type FundingEnvelopeProjectItem = {
+  project?: AnyEntity | object;
+  [k: string]: unknown;
+};
+
 export type FundingEnvelopeResult = {
   contextData?: AnyEntity | object;
   context?: AnyEntity | object;
@@ -142,11 +164,22 @@ export type FundingEnvelopeResult = {
   form?: object;
   paymentMethods?: object;
   nopropProject?: AnyEntity[] | object;
-  projects?: AnyEntity[] | any[];
+  projects?: FundingEnvelopeProjectItem[];
   userOrga?: AnyEntity[] | object;
   [k: string]: unknown;
 };
 
+// Champs auto-injectés par `_withCostumContext` dans le finalData reçu par le finalizer.
+// Permet de typer correctement le param finalData côté callers sans cast `as any`.
+export type CostumContextFields = {
+  costumSlug: string;
+  contextId: string;
+  contextType: EntityType;
+  sourceKey: string[];
+};
+
+export type WithCostumContext<T> = T & CostumContextFields;
+
 // Type pour le curseur de pagination utilisé dans _createPaginatorEngine
 type PaginationCursor = {
   searchType?: string[];
@@ -203,8 +236,8 @@ export interface PaginatorPage<T> {
  */
 export type ExtractMethodNames<T> = T extends Map<any, infer V>
   ? V extends readonly (readonly [any, infer M])[]
-    ? M
-    : never
+  ? M
+  : never
   : never;
 
 // LinkMeta interface
@@ -217,7 +250,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" | "answers";
+  entityType: "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds";
   SCHEMA_CONSTANTS: string | string[];
 };
 
@@ -311,7 +344,7 @@ interface FinalizerResult<TOut> {
 }
 
 // Types pour les entités
-type EntityType = "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers";
+export type EntityType = "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds";
 
 // ============================================================================
 
@@ -488,11 +521,11 @@ export class BaseEntity<TServerData = any> {
 
   /** @returns Indique si cette entité représente l'utilisateur connecté */
   get isMe(): boolean {
-    return !!(this.isConnected && this.userId && this.userContext?.id && typeof this.userId=== "string" && typeof this.userContext?.id === "string" && this.userId === this.userContext?.id);
+    return !!(this.isConnected && this.userId && this.userContext?.id && typeof this.userId === "string" && typeof this.userContext?.id === "string" && this.userId === this.userContext?.id);
   }
 
   /** @returns Type de l'entité (ex: 'citoyens') */
-  getEntityType(): "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" {
+  getEntityType(): "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds" {
     return this._getCtor().entityType;
   }
 
@@ -533,7 +566,7 @@ export class BaseEntity<TServerData = any> {
         await this._add(payload);
         this._resetInitialDraftData();
         // on refresh le contexte utilisateur si besoin
-        if(this.userContext) {
+        if (this.userContext) {
           await this.userContext?.refresh();
         }
         return await this.refresh();
@@ -658,9 +691,9 @@ export class BaseEntity<TServerData = any> {
       const initialValue = this._initialDraftData?.[key];
 
       const isModified =
-      current !== undefined &&
-      initialValue !== undefined &&
-      this._serialize(this._toRawDeep(current)) !== this._serialize(initialValue);
+        current !== undefined &&
+        initialValue !== undefined &&
+        this._serialize(this._toRawDeep(current)) !== this._serialize(initialValue);
 
       if (!isModified) {
         this._draftData[key] = draft[key];
@@ -862,8 +895,8 @@ export class BaseEntity<TServerData = any> {
 
       if (
         typeof val === "function" ||
-      typeof val === "symbol" ||
-      typeof val === "undefined"
+        typeof val === "symbol" ||
+        typeof val === "undefined"
       ) {
         continue;
       }
@@ -991,7 +1024,7 @@ export class BaseEntity<TServerData = any> {
    * @throws {ApiClientError} - Si une erreur se produit lors de l'appel de l'API.
    */
   async callNoConnected(constant: string, data: object = {}): Promise<unknown> {
-    if(this.isConnected) {
+    if (this.isConnected) {
       throw new ApiAuthenticationError("Vous devez ne devez pas être connecté pour faire cette action.", 403);
     }
     return this.call(constant, data);
@@ -1009,7 +1042,7 @@ export class BaseEntity<TServerData = any> {
    * @throws {ApiClientError} - Si une erreur se produit lors de l'appel de l'API.
    */
   async callIsConnected(param: string | (() => Promise<any>), data: object = {}): Promise<unknown> {
-    if(!this.isConnected) {
+    if (!this.isConnected) {
       throw new ApiAuthenticationError("Vous devez être connecté pour faire cette action.", 401);
     }
     // Si le premier paramètre est une fonction, on l'exécute en tant que callback
@@ -1086,12 +1119,12 @@ export class BaseEntity<TServerData = any> {
     if (!input) {
       throw new ApiValidationError("Le fichier est requis.", 400, ["Le fichier est requis"]);
     }
-  
+
     const isNode = typeof window === "undefined" && typeof process !== "undefined";
 
     let output: ValidatedUpload | null = null;
     let mimeType = "";
-  
+
     // Navigateur : File
     if (typeof File !== "undefined" && input instanceof File) {
       mimeType = input.type;
@@ -1100,19 +1133,19 @@ export class BaseEntity<TServerData = any> {
       }
       output = input;
     }
-  
+
     // Navigateur : Blob
     else if (typeof Blob !== "undefined" && input instanceof Blob) {
       mimeType = input.type;
       if (!allowedMimeTypes.includes(mimeType)) {
         throw new ApiValidationError("Le type du fichier est invalide.", 400, ["Le type du fichier est invalide"]);
       }
-  
+
       const ext = mimeType.split("/")[1] || "bin";
       const fileName = `${Date.now()}.${ext}`;
       output = new File([input], fileName, { type: mimeType });
     }
-  
+
     // Node.js : Buffer
     else if (isNode && Buffer.isBuffer(input)) {
       const fileTypeResult = await fromBuffer(input);
@@ -1120,13 +1153,13 @@ export class BaseEntity<TServerData = any> {
       if (!fileTypeResult) {
         throw new ApiValidationError("Le type du fichier est invalide.", 400, ["Le type du fichier est invalide"]);
       }
-      
+
       mimeType = fileTypeResult.mime;
-  
+
       if (!allowedMimeTypes.includes(mimeType)) {
         throw new ApiValidationError("Le type du fichier est invalide.", 400, ["Le type du fichier est invalide"]);
       }
-  
+
       // Pour un fichier image, on transforme en stream
       if (expectedType === "image") {
         const ext = fileTypeResult.ext;
@@ -1136,7 +1169,7 @@ export class BaseEntity<TServerData = any> {
         output = input;
       }
     }
-  
+
     // Node.js : ReadableStream
     else if (isNode && isNodeReadable(input)) {
       const readableIn = input as import("stream").Readable;
@@ -1175,11 +1208,11 @@ export class BaseEntity<TServerData = any> {
 
       output = resultStream as ReadableWithMeta;
     }
-  
+
     else {
       throw new ApiValidationError("Type de fichier non reconnu.", 400, ["Type de fichier non reconnu."]);
     }
-  
+
     return output!;
   }
 
@@ -1214,7 +1247,7 @@ export class BaseEntity<TServerData = any> {
       throw new Error("bufferToReadable ne doit pas être appelé dans le navigateur");
     }
   }
-  
+
   /**
    * Crée un PassThrough stream pour le traitement des fichiers.
    *
@@ -1330,7 +1363,7 @@ export class BaseEntity<TServerData = any> {
       }
     });
   }
-  
+
   /**
    * Génère un nouvel identifiant unique.
    * @returns Un identifiant unique.
@@ -1543,7 +1576,7 @@ export class BaseEntity<TServerData = any> {
    */
   private _buildDraftAndProxy({ data = {}, serverData = null, previousDraft = null, constant, apiClient, transforms = {}, throwOnError = true, removeFields = [] }: { data?: Record<string, unknown>; serverData?: Record<string, unknown> | null; previousDraft?: Record<string, unknown> | null; constant: string | string[]; apiClient: ApiClient; transforms?: TransformsMap; throwOnError?: boolean; removeFields?: string[] }): { draft: ReactiveData; proxy: Record<string, unknown>; initial: Record<string, unknown> } {
     const constants = Array.isArray(constant) ? constant : [constant];
-    const combinedSchema: {allOf: JsonSchema[], $defs: Record<string, JsonSchema>} = {
+    const combinedSchema: { allOf: JsonSchema[], $defs: Record<string, JsonSchema> } = {
       allOf: [],
       $defs: {}
     };
@@ -1601,7 +1634,7 @@ export class BaseEntity<TServerData = any> {
           ? transforms[key](raw, data)
           : raw;
         return [key, transformed];
-       
+
       }).filter(([_, v]) => v !== undefined)
     );
 
@@ -1618,7 +1651,7 @@ export class BaseEntity<TServerData = any> {
 
     const proxy = this._createDraftProxy(apiClient, reactiveServer, draft, allowed, transforms, { throwOnError });
 
-    return { draft, proxy, initial};
+    return { draft, proxy, initial };
   }
 
   /**
@@ -1844,20 +1877,20 @@ export class BaseEntity<TServerData = any> {
     if (!this.id && this.slug) {
       try {
         const data = await this.endpointApi.getElementsKey({
-          pathParams:{
+          pathParams: {
             slug: this.slug
           }
         }) as GetElementsKeyResponse;
 
-        if(data.contextId && data.contextType === type) {
+        if (data.contextId && data.contextType === type) {
           this._id(data.contextId);
         } else {
           throw new ApiResponseError(`Le slug ${this.slug} ne correspond pas à un ${type}`, 200, data as object);
         }
       } catch (error) {
-        if(error instanceof ApiResponseError) {
+        if (error instanceof ApiResponseError) {
           const errorResponseData = error.responseData as Record<string, unknown>;
-          if(errorResponseData.contextType !== type) {
+          if (errorResponseData.contextType !== type) {
             throw error;
           } else {
             throw new ApiResponseError(`Impossible de récupérer l'identifiant pour le slug ${this.slug}`, error.status, error.responseData);
@@ -1872,7 +1905,7 @@ export class BaseEntity<TServerData = any> {
     }
     return this.id;
   }
-  
+
   /**
    * Récupère le profil public de l'entité.
    *
@@ -1887,9 +1920,9 @@ export class BaseEntity<TServerData = any> {
     const type = this.getEntityType();
 
     if (type === "news" || type === "comments") {
-      throw new ApiError("getElementsAbout ne supporte pas le type 'news'.", 400);
+      throw new ApiError(`getElementsAbout ne supporte pas le type '${type}'.`, 400);
     }
-    return this.endpointApi.getElementsAbout({ pathParams: { id: this.id, type: type }, tpl: "ficheInfoElement" });
+    return this.endpointApi.getElementsAbout({ pathParams: { id: this.id, type }, tpl: "ficheInfoElement" });
   }
 
   /**
@@ -1913,24 +1946,28 @@ export class BaseEntity<TServerData = any> {
       Comment: selfTag === "Comment" ? selfClass : this.deps.Comment,
       Answer: selfTag === "Answer" ? selfClass : this.deps.Answer,
       Form: selfTag === "Form" ? selfClass : this.deps.Form,
+      Classified: selfTag === "Classified" ? selfClass : this.deps.Classified,
     };
 
     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
-      } },
-      comments:     { entityClass: commonDeps.Comment,      deps: { ...commonDeps } },
-      answers:      { entityClass: commonDeps.Answer,       deps: { ...commonDeps } },
-      forms:        { entityClass: commonDeps.Form,         deps: { ...commonDeps } },
+      classifieds:  { entityClass: commonDeps.Classified,    deps: { ...commonDeps } },
+      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
+        }
+      },
+      comments: { entityClass: commonDeps.Comment, deps: { ...commonDeps } },
+      answers: { entityClass: commonDeps.Answer, deps: { ...commonDeps } },
+      forms: { entityClass: commonDeps.Form, deps: { ...commonDeps } },
     };
 
     return (map as Record<string, EntityMeta | undefined>)[entityType] || null;
@@ -1980,11 +2017,11 @@ export class BaseEntity<TServerData = any> {
    * @return L'entité liée ou null.
    * @private
    */
-  async _linkEntityById(entityType: string, entityId: string, options?: { skipGet?: boolean }): Promise<AnyEntity|null> {
+  async _linkEntityById(entityType: string, entityId: string, options?: { skipGet?: boolean }): Promise<AnyEntity | null> {
     const meta = this._getEntityMeta(entityType);
     if (!meta) return null;
 
-     
+
     const parent: ParentLike = this as ParentLike;
 
     const entity = new meta.entityClass(parent, { id: entityId }, meta.deps) as AnyEntity;
@@ -2162,6 +2199,7 @@ export class BaseEntity<TServerData = any> {
         badges: ["id"],
         comments: [], // Pas de get() pour les commentaires
         answers: ["id"],
+        classifieds: ["id"],
       };
 
       const fetchKeys = (fetchKeysByEntity as Record<string, string[] | undefined>)[entityType];
@@ -2190,12 +2228,12 @@ export class BaseEntity<TServerData = any> {
     }
     try {
       const data = await this.endpointApi.getElementsKey({
-        pathParams:{
+        pathParams: {
           slug: slug
         }
       }) as GetElementsKeyResponse;
 
-      if(data.contextId && data.contextType) {
+      if (data.contextId && data.contextType) {
         const entity = await this.entity(data.contextType, { id: data.contextId });
 
         // Corriger le userContext si nécessaire
@@ -2206,7 +2244,7 @@ export class BaseEntity<TServerData = any> {
         throw new ApiResponseError(`Le slug ${slug} n'est pas valide`, 200, data as object);
       }
     } catch (error) {
-      if(error instanceof ApiResponseError) {
+      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;
@@ -2351,7 +2389,7 @@ export class BaseEntity<TServerData = any> {
     let hierarchyField: Record<string, any> | undefined;
     if (entityType === "events") {
       hierarchyField = entityData?.organizer;
-    } else if (entityType === "projects" || entityType === "poi") {
+    } else if (entityType === "projects" || entityType === "poi" || entityType === "classifieds") {
       hierarchyField = entityData?.parent;
     } else {
       // Organizations et autres types n'ont pas de hiérarchie parent
@@ -2406,8 +2444,8 @@ export class BaseEntity<TServerData = any> {
 
     const parentLink = parentLinks[parentId];
     return this._validateUserLink(parentLink) &&
-           parentLink?.isAdmin === true &&
-           !parentLink?.isAdminPending;
+      parentLink?.isAdmin === true &&
+      !parentLink?.isAdminPending;
   }
 
   /**
@@ -2476,7 +2514,7 @@ export class BaseEntity<TServerData = any> {
       filters[`${path}.isAdmin`] = { $exists: true };
     }
 
-    if(isAdminPending === true) {
+    if (isAdminPending === true) {
       filters[`${path}.isAdminPending`] = { $exists: true };
     }
 
@@ -2552,7 +2590,7 @@ export class BaseEntity<TServerData = any> {
    */
   protected _getLinkFromConnectedUser() {
     const { linkType } = this._getLinkMeta();
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
     return this?.userContext?.serverData?.links?.[linkType]?.[this.id] || null;
@@ -2572,7 +2610,7 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    if(!this.userId) {
+    if (!this.userId) {
       throw new ApiError("L'utilisateur connecté n'est pas défini.", 400);
     }
 
@@ -2759,7 +2797,7 @@ export class BaseEntity<TServerData = any> {
       // Normalement en auto dans le schema mais je le met quand même
       connectType: connectTypeDisconnect
     };
-    
+
     // TODO : reflechir au moyen de remplir parent.serverData et this.serverData avec les data de retour pour eviter un refresh
     const retour = await this.callIsMe(() => this.endpointApi.disconnect(data));
     await this.userContext?.refresh();
@@ -2784,7 +2822,7 @@ export class BaseEntity<TServerData = any> {
       return data;
     });
   }
-  
+
   /**
    * Mettre à jour les paramètres d'un élément : Mise à jour des paramètres spécifiques d'un élément.
    * Constant : UPDATE_SETTINGS
@@ -2819,7 +2857,7 @@ export class BaseEntity<TServerData = any> {
 
     return this.callIsConnected(() => this.endpointApi.updateSettings(payload));
   }
-  
+
   /**
    * Mettre à jour la description d'un élément : Permet de mettre à jour la description courte et complète d'un élément.
    * Constant : UPDATE_BLOCK_DESCRIPTION
@@ -2848,7 +2886,7 @@ export class BaseEntity<TServerData = any> {
 
     return this.callIsConnected(() => this.endpointApi.updateBlockDescription(payload));
   }
-    
+
   /**
    * Mettre à jour les informations d'un élément : Permet de mettre à jour les informations générales d'un élément (nom, contacts, etc.).
    * Constant : UPDATE_BLOCK_INFO
@@ -2876,7 +2914,7 @@ export class BaseEntity<TServerData = any> {
     };
     return this.callIsConnected(() => this.endpointApi.updateBlockInfo(payload));
   }
-    
+
   /**
    * Mettre à jour les réseaux sociaux d'un élément : Permet de mettre à jour les liens vers les réseaux sociaux d'un élément.
    * Constant : UPDATE_BLOCK_SOCIAL
@@ -2924,9 +2962,9 @@ export class BaseEntity<TServerData = any> {
    */
   private _isGeo(a: any): a is Geo {
     return !!a
-        && typeof a === "object"
-        && (typeof a.latitude === "number" || typeof a.latitude === "string")
-        && (typeof a.longitude === "number" || typeof a.longitude === "string");
+      && typeof a === "object"
+      && (typeof a.latitude === "number" || typeof a.latitude === "string")
+      && (typeof a.longitude === "number" || typeof a.longitude === "string");
   }
 
   /**
@@ -2934,13 +2972,13 @@ export class BaseEntity<TServerData = any> {
    */
   private _isGeoPosition(a: any): a is GeoPosition {
     return !!a
-        && typeof a === "object"
-        && a.type === "Point"
-        && Array.isArray(a.coordinates)
-        && a.coordinates.length === 2
-        && (typeof a.coordinates[0] === "number" || typeof a.coordinates[0] === "string")
-        && (typeof a.coordinates[1] === "number" || typeof a.coordinates[1] === "string")
-        && a.float === true;
+      && typeof a === "object"
+      && a.type === "Point"
+      && Array.isArray(a.coordinates)
+      && a.coordinates.length === 2
+      && (typeof a.coordinates[0] === "number" || typeof a.coordinates[0] === "string")
+      && (typeof a.coordinates[1] === "number" || typeof a.coordinates[1] === "string")
+      && a.float === true;
   }
 
   /**
@@ -2982,13 +3020,13 @@ export class BaseEntity<TServerData = any> {
       typeElement,
       address: addr,
       // On ne recopie que les champs autorisés pour éviter de casser le typage
-      ...( "geo" in data && this._isGeo(data.geo) ? { geo: data.geo } : {} ),
-      ...( "geoPosition" in data && this._isGeoPosition(data.geoPosition) ? { geoPosition: data.geoPosition } : {} ),
-      ...( "locality" in data ? { locality: data.locality } : {} ),
+      ...("geo" in data && this._isGeo(data.geo) ? { geo: data.geo } : {}),
+      ...("geoPosition" in data && this._isGeoPosition(data.geoPosition) ? { geoPosition: data.geoPosition } : {}),
+      ...("locality" in data ? { locality: data.locality } : {}),
     };
     return this.callIsConnected(() => this.endpointApi.updateBlockLocality(payload));
   }
-    
+
   /**
    * Mettre à jour le slug d'un élément : Permet de mettre à jour le slug pour une URL simplifiée.
    * Constant : UPDATE_BLOCK_SLUG
@@ -3009,7 +3047,7 @@ export class BaseEntity<TServerData = any> {
     try {
       await this.endpointApi.check({ block: "info", type, id: this.id, slug });
     } catch (error) {
-      if(error instanceof ApiResponseError) {
+      if (error instanceof ApiResponseError) {
         throw new ApiResponseError("Erreur lors de la vérification du slug.", error.status, error.responseData);
       }
       throw error;
@@ -3027,7 +3065,7 @@ export class BaseEntity<TServerData = any> {
    * @param data.profil_avatar - L'image de profil à mettre à jour.
    * @returns - Les données de réponse.
    */
-  async updateImageProfil({ profil_avatar: image  }: { profil_avatar: UploadInput }): Promise<unknown> {
+  async updateImageProfil({ profil_avatar: image }: { profil_avatar: UploadInput }): Promise<unknown> {
 
     if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
@@ -3039,7 +3077,7 @@ export class BaseEntity<TServerData = any> {
 
     image = await this._validateImage(image);
 
-    const data: ProfilImageData = { pathParams: { folder, ownerId: this.id },  profil_avatar: image as unknown as Record<string, unknown>, };
+    const data: ProfilImageData = { pathParams: { folder, ownerId: this.id }, profil_avatar: image as unknown as Record<string, unknown>, };
     return this.callIsConnected(() => this.endpointApi.profilImage(data));
   }
 
@@ -3054,7 +3092,7 @@ export class BaseEntity<TServerData = any> {
    * @param data.cropY - Position Y du recadrage.
    * @returns - Les données de réponse.
    */
-  async updateImageBanner({ banner: image, cropW, cropH, cropX, cropY  }: { banner: UploadInput, cropW: number, cropH: number, cropX: number, cropY: number }): Promise<unknown> {
+  async updateImageBanner({ banner: image, cropW, cropH, cropX, cropY }: { banner: UploadInput, cropW: number, cropH: number, cropX: number, cropY: number }): Promise<unknown> {
 
     if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
@@ -3080,7 +3118,7 @@ export class BaseEntity<TServerData = any> {
    * @throws {Error} Si une erreur se produit lors de la création de l'organisation.
    */
   async organization(organizationData: OrganizationInput = {}): Promise<Organization> {
-    if(!("id" in organizationData) && !("slug" in organizationData) && !this.isMe){
+    if (!("id" in organizationData) && !("slug" in organizationData) && !this.isMe) {
       throw new ApiError("Vous devez être connecté et être l'utilisateur pour créer une organisation.", 403);
     }
     const entity = await this.entity("organizations", organizationData);
@@ -3098,7 +3136,7 @@ export class BaseEntity<TServerData = any> {
    */
   async project(projectData: ProjectInput = {}): Promise<Project> {
     // TODO: Vérifier si l'utilisateur est admin de l'organisation
-    if(!("id" in projectData) && !("slug" in projectData) && !this.isConnected){
+    if (!("id" in projectData) && !("slug" in projectData) && !this.isConnected) {
       throw new ApiError("Vous devez être connecté pour créer un projet.", 401);
     }
 
@@ -3117,7 +3155,7 @@ export class BaseEntity<TServerData = any> {
    */
   async poi(poiData: PoiInput = {}): Promise<Poi> {
     // TODO: Vérifier si l'utilisateur est admin de l'organisation
-    if(!("id" in poiData) && !("slug" in poiData) && !this.isConnected){
+    if (!("id" in poiData) && !("slug" in poiData) && !this.isConnected) {
       throw new ApiError("Vous devez être connecté pour créer un POI.", 401);
     }
 
@@ -3125,6 +3163,24 @@ export class BaseEntity<TServerData = any> {
     return entity as Poi;
   }
 
+  /**
+   * Crée une instance de ressource classifiée (besoin ou offre).
+   *
+   * @param classifiedData - Les données pour initialiser la ressource.
+   *                       - Si { id } : récupère la ressource existante (GET)
+   *                       - Sinon : crée une nouvelle instance (CREATE)
+   * @returns Une promesse qui résout l'objet Classified créé.
+   * @throws {Error} Si une erreur se produit lors de la création.
+   */
+  async classified(classifiedData: ClassifiedInput = {}): Promise<Classified> {
+    if (!("id" in classifiedData) && !this.isConnected) {
+      throw new ApiError("Vous devez être connecté pour créer une ressource.", 401);
+    }
+
+    const entity = await this.entity("classifieds", classifiedData);
+    return entity as Classified;
+  }
+
   /**
    * Crée une instance d'événement et la récupère si nécessaire.
    *
@@ -3136,7 +3192,7 @@ export class BaseEntity<TServerData = any> {
    */
   async event(eventData: EventInput = {}): Promise<EventEntity> {
     // TODO: Vérifier si l'utilisateur est admin de l'organisation
-    if(!("id" in eventData) && !("slug" in eventData) && !this.isConnected){
+    if (!("id" in eventData) && !("slug" in eventData) && !this.isConnected) {
       throw new ApiError("Vous devez être connecté pour créer un événement.", 401);
     }
     const entity = await this.entity("events", eventData);
@@ -3154,7 +3210,7 @@ export class BaseEntity<TServerData = any> {
    */
   async badge(badgeData: BadgeInput = {}): Promise<Badge> {
     // TODO: Vérifier si l'utilisateur est admin de l'organisation
-    if(!("id" in badgeData) && !this.isConnected){
+    if (!("id" in badgeData) && !this.isConnected) {
       throw new ApiError("Vous devez être connecté pour créer un badge.", 401);
     }
     const entity = await this.entity("badges", badgeData);
@@ -3171,7 +3227,7 @@ export class BaseEntity<TServerData = any> {
    * @throws {Error} Si une erreur se produit lors de la création de la news.
    */
   async news(newsData: NewsInput = {}): Promise<News> {
-    if(!newsData?.id && !this.isConnected){
+    if (!newsData?.id && !this.isConnected) {
       throw new ApiError("Vous devez être connecté.", 401);
     }
 
@@ -3197,14 +3253,14 @@ export class BaseEntity<TServerData = any> {
       methodName: "getOrganizations",
       restoredState: options?.restoredState,
       finalizer: async (finalData) => {
-        if(this.isMe){
+        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 }
-        // };
+          // 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 = {
@@ -3213,7 +3269,7 @@ export class BaseEntity<TServerData = any> {
             [`links.members.${this.id}.isInviting`]: { "$exists": false }
           };
         }
-  
+
         const fetchFn = this.isMe
           ? () => this.callIsMe(() => this.endpointApi.getOrganizationsAdmin(finalData))
           : () => this.endpointApi.getOrganizationsNoAdmin(finalData);
@@ -3243,7 +3299,7 @@ export class BaseEntity<TServerData = any> {
       methodName: "getProjects",
       restoredState: options?.restoredState,
       finalizer: async (finalData) => {
-        if(this.isMe){
+        if (this.isMe) {
           finalData.pathParams = { type: this.getEntityType(), id: this.id };
           finalData.filters = {
             "$or": {
@@ -3262,7 +3318,7 @@ export class BaseEntity<TServerData = any> {
             [`links.contributors.${this.id}`]: { "$exists": true }
           };
         }
-    
+
         const fetchFn = this.isMe
           ? () => this.callIsMe(() => this.endpointApi.getProjectsAdmin(finalData))
           : () => this.endpointApi.getProjectsNoAdmin(finalData);
@@ -3323,7 +3379,7 @@ export class BaseEntity<TServerData = any> {
       methodName: "getPois",
       restoredState: options?.restoredState,
       finalizer: async (finalData) => {
-        if(this.isMe){
+        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 = {
@@ -3335,7 +3391,7 @@ export class BaseEntity<TServerData = any> {
             [`parent.${this.id}`]: { "$exists": true },
           };
         }
-  
+
         const fetchFn = this.isMe
           ? () => this.callIsMe(() => this.endpointApi.getPoisAdmin(finalData))
           : () => this.endpointApi.getPoisNoAdmin(finalData);
@@ -3367,7 +3423,7 @@ export class BaseEntity<TServerData = any> {
       finalizer: async (finalData) => {
         delete finalData?.pathParams;
 
-        finalData.filters =  {
+        finalData.filters = {
           [`links.follows.${this.id}`]: { "$exists": true },
           [`links.follows.${this.id}.toBeValidated`]: { "$exists": false },
           [`links.follows.${this.id}.isInviting`]: { "$exists": false }
@@ -3399,7 +3455,7 @@ export class BaseEntity<TServerData = any> {
       restoredState: options?.restoredState,
       finalizer: async (finalData) => {
         delete finalData?.pathParams;
-  
+
         finalData.filters = finalData.filters || { "preferences.private": false };
         finalData.filters["$or"] = {};
         finalData.filters["$or"][`issuer.${this.id}`] = { "$exists": true };
@@ -3440,8 +3496,8 @@ export class BaseEntity<TServerData = any> {
       ...search
     };
 
-    const arrayObjet =  await this.endpointApi.getNews(payload);
-    if(!Array.isArray(arrayObjet)){
+    const arrayObjet = await this.endpointApi.getNews(payload);
+    if (!Array.isArray(arrayObjet)) {
       throw new ApiResponseError("Erreur lors de la récupération des actualités.", 500, arrayObjet as object);
     }
 
@@ -3472,7 +3528,7 @@ export class BaseEntity<TServerData = any> {
       pathParams: { type, id: this.id, docType: data.pathParams?.docType || "image" }
     };
 
-    const arrayObjet =  await this.endpointApi.getGallery(payload);
+    const arrayObjet = await this.endpointApi.getGallery(payload);
 
     return arrayObjet as Record<string, any>;
   }
@@ -3530,7 +3586,7 @@ export class BaseEntity<TServerData = any> {
     const rawList = this._linkEntities(result);
     return rawList;
   }
-  
+
   /**
    * Soumet une demande pour rejoindre l'entité courante (ex. organisation, projet, événement...).
    * Si une invitation est en attente, elle est automatiquement acceptée.
@@ -3581,7 +3637,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     this._checkLinkableEntity();
-    
+
     if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
@@ -3673,7 +3729,7 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    if(!this.userId) {
+    if (!this.userId) {
       throw new ApiError("Utilisateur non connecté.", 401);
     }
 
@@ -3715,7 +3771,7 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    if(!this.userId) {
+    if (!this.userId) {
       throw new ApiError("Utilisateur non connecté.", 401);
     }
 
@@ -3741,7 +3797,7 @@ export class BaseEntity<TServerData = any> {
 
     throw new ApiError("Vous n'êtes pas abonné à cette entité.", 404);
   }
-  
+
 
   /**
    * Vérifie si l'utilisateur est connecté et a accès à l'entité.
@@ -3840,7 +3896,7 @@ export class BaseEntity<TServerData = any> {
    * @protected
    */
   protected _isLinked(linkType: string): boolean {
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
     const links = this.userContext?.serverData?.links;
@@ -3894,7 +3950,7 @@ export class BaseEntity<TServerData = any> {
   isAdmin(options?: { checkHierarchy?: boolean; silent?: boolean }): boolean {
     const userLink = this._getValidatedUserLink(
       "vérifier l'administrateur",
-      ["organizations", "projects", "events"],
+      ["organizations", "projects", "events", "classifieds"],
       { silent: options?.silent }
     );
 
@@ -4286,12 +4342,7 @@ export class BaseEntity<TServerData = any> {
    * Injection de contexte Communecter dans une requête finalizer.
    */
   _withCostumContext<TIn extends Record<string, unknown>, TOut>(
-    baseFinalizer: (data: TIn & {
-      costumSlug: string,
-      contextId: string,
-      contextType: EntityType,
-      sourceKey: string[]
-    }) => Promise<TOut>
+    baseFinalizer: (data: TIn & CostumContextFields) => Promise<TOut>
   ): (data: TIn) => Promise<TOut> {
     return async (data: TIn) => {
       if (!this.serverData) {
@@ -4317,12 +4368,7 @@ export class BaseEntity<TServerData = any> {
         contextId: sd.id,
         contextType: this.getEntityType(),
         sourceKey: [...inSourceKey, sd.slug] as string[]
-      } as TIn & {
-        costumSlug: string;
-        contextId: string;
-        contextType: EntityType;
-        sourceKey: string[];
-      };
+      } as TIn & CostumContextFields;
 
       return baseFinalizer(finalData);
     };
@@ -4390,7 +4436,7 @@ export class BaseEntity<TServerData = any> {
    */
   async costumEventRequestActors(data: Partial<Omit<CostumEventRequestActorsData, "pathParams">> = {}): Promise<unknown> {
 
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
@@ -4438,7 +4484,7 @@ export class BaseEntity<TServerData = any> {
    */
   async costumEventRequestSubevents(data: Partial<Omit<CostumEventRequestSubeventsData, "pathParams">> = {}): Promise<unknown> {
 
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
@@ -4468,7 +4514,7 @@ export class BaseEntity<TServerData = any> {
    */
   async costumEventRequestDates(data: Partial<Omit<CostumEventRequestDatesData, "pathParams">> = {}): Promise<unknown> {
 
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
@@ -4498,7 +4544,7 @@ export class BaseEntity<TServerData = any> {
    */
   async costumEventRequestElementEvent(data: Partial<Omit<CostumEventRequestElementEventData, "pathParams">> = {}): Promise<unknown> {
 
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
@@ -4528,7 +4574,7 @@ export class BaseEntity<TServerData = any> {
    */
   async costumEventRequestCategories(data: Partial<Omit<CostumEventRequestCategoriesData, "pathParams">> = {}): Promise<unknown> {
 
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
@@ -4558,7 +4604,7 @@ export class BaseEntity<TServerData = any> {
    */
   async costumEventRequestEvent(data: Partial<Omit<CostumEventRequestEventData, "pathParams">> = {}): Promise<unknown> {
 
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
@@ -4588,18 +4634,18 @@ export class BaseEntity<TServerData = any> {
    */
   async costumEventRequestLinkTlToEvent(
     data: Pick<CostumEventRequestLinkTlToEventData, "tl" | "event"> &
-          Partial<Omit<CostumEventRequestLinkTlToEventData, "tl" | "event" | "pathParams">>
+      Partial<Omit<CostumEventRequestLinkTlToEventData, "tl" | "event" | "pathParams">>
   ): Promise<unknown> {
 
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    if(!data.tl && !data.event) {
+    if (!data.tl && !data.event) {
       throw new ApiError("Les paramètres 'tl' et 'event' sont requis.", 400);
     }
 
-    if(typeof data.tl !== "string" || typeof data.event !== "string") {
+    if (typeof data.tl !== "string" || typeof data.event !== "string") {
       throw new ApiError("Les paramètres 'tl' et 'event' doivent être des chaînes de caractères.", 400);
     }
 
@@ -4629,7 +4675,7 @@ export class BaseEntity<TServerData = any> {
    */
   async costumEventRequestLoadContextTag(data: Partial<Omit<CostumEventRequestLoadContextTagData, "pathParams">> = {}): Promise<unknown> {
 
-    if(!this.id) {
+    if (!this.id) {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
@@ -4648,7 +4694,7 @@ export class BaseEntity<TServerData = any> {
     return wrappedFinalizer(fullData);
   }
 
-  
+
   /**
    * Recherche paginée des réponses CoForm liées à l'entité courante.
    * Injecte automatiquement le contexte (costumSlug, contextId, contextType) via `_withCostumContext`,
@@ -4714,8 +4760,8 @@ export class BaseEntity<TServerData = any> {
    */
   async searchAnswersByForms(
     data: Partial<CoformAnswersByFormsData> = {},
-  ): Promise<{ answers: Answer[]; documents: any[]; [k: string]: unknown }[]> {
-    if(!data.forms || Array.isArray(data.forms) || Object.keys(data.forms).length === 0){
+  ): Promise<{ answers: Answer[]; documents: any[];[k: string]: unknown }[]> {
+    if (!data.forms || Array.isArray(data.forms) || Object.keys(data.forms).length === 0) {
       throw new ApiError("Le paramètre 'forms' est requis et doit être un objet non vide.", 400);
     }
     const result = await this.endpointApi.coformAnswersByForms(data);
@@ -4761,7 +4807,20 @@ export class BaseEntity<TServerData = any> {
       ...(result.contextData && { contextData: this._linkEntity(result.contextData.collection, result.contextData) ?? result.contextData }),
       ...(result.context && { context: this._linkEntity(result.context.collection, result.context) ?? result.context }),
       ...(result.nopropProject && { nopropProject: this._linkEntities(Object.values(result.nopropProject)) ?? result.nopropProject }),
-      ...(result.projects && { projects: this._linkEntities(result.projects) ?? result.projects }),
+      // `result.projects` est un tableau d'enveloppes — la vraie entité projet est à
+      // `result.projects[i].project`, pas à la racine de l'item (qui ne porte que les
+      // métadonnées de financement). On linke chaque sous-champ `project` individuellement
+      // pour récupérer des instances d'entités réactives, tout en préservant les méta.
+      ...(result.projects && {
+        projects: (result.projects as FundingEnvelopeProjectItem[]).map((envelope) => {
+          const inner = envelope?.project as { collection?: string } | undefined;
+          if (inner && typeof inner === "object") {
+            const linked = this._linkEntity(inner.collection ?? "projects", inner);
+            return { ...envelope, project: linked ?? envelope.project };
+          }
+          return envelope;
+        })
+      }),
       ...(result.userOrga && { userOrga: this._linkEntities(Object.values(result.userOrga)) ?? result.userOrga })
     };
   }
@@ -4814,7 +4873,7 @@ export class BaseEntity<TServerData = any> {
   async searchZone(
     data: SearchZonesData,
   ): Promise<ZoneItemNormalized[]> {
-    if(!data.countryCode?.length || !data.level?.length){
+    if (!data.countryCode?.length || !data.level?.length) {
       throw new ApiError("countryCode et level sont requis.", 400);
     }
     const wrappedFinalizer = this._withCostumContext(
@@ -4854,10 +4913,286 @@ export class BaseEntity<TServerData = any> {
     if (!formId || typeof formId !== "string") {
       throw new ApiError("formId est requis et doit être une chaîne de caractères.", 400);
     }
-    const result = await this.endpointApi.generateAnswerFromForm({pathParams: { formId }, action: "new" });
+    const result = await this.endpointApi.generateAnswerFromForm({ pathParams: { formId }, action: "new" });
     return this._linkEntity?.(result.collection, result) ?? result;
   }
 
+  /**
+   * Associe un compte Discourse à l'utilisateur courant dans le contexte de l'instance.
+   * Injecte automatiquement le `costumSlug` via `_withCostumContext`.
+   *
+   * @param username - Nom d'utilisateur Discourse à associer
+   * @returns Résultat de la liaison avec les informations du compte Discourse trouvé
+   * @throws {ApiError} Si `username` est absent ou invalide
+   *
+   * @example
+   * const result = await user.linkDiscourseAccount("john_doe");
+   * if (result.result) {
+   *   console.log(result.profileUrl); // URL du profil Discourse
+   * } else {
+   *   console.error(result.error);
+   * }
+   */
+  async linkDiscourseAccount(
+    username: string,
+  ): Promise<{
+    result: boolean,
+    error?: string
+    username?: string
+    profileUrl?: string
+  }> {
+    if (!username || typeof username !== "string") {
+      throw new ApiError("username est requis et doit être une chaîne de caractères.", 400);
+    }
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: WithCostumContext<{ username: string }>) =>
+        this.endpointApi.linkDiscourseAccount({
+          ...finalData,
+          costumId: finalData.contextId,
+          costumType: finalData.contextType,
+        } as LinkDiscourseAccountData)
+    );
+    return wrappedFinalizer({ username });
+  }
+
+  /**
+   * Dissocie le compte Discourse de l'utilisateur courant dans le contexte de l'instance.
+   * Injecte automatiquement le `costumSlug` via `_withCostumContext`.
+   *
+   * @returns Résultat du délien du compte Discourse
+   *
+   * @example
+   * const result = await user.unlinkDiscourseAccount();
+   * result.result; // true si succès
+   */
+  async unlinkDiscourseAccount(): Promise<{
+    result: boolean;
+    error?: string;
+  }> {
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: WithCostumContext<Record<string, never>>) =>
+        this.endpointApi.unlinkDiscourseAccount({
+          ...finalData,
+          costumId: finalData.contextId,
+          costumType: finalData.contextType,
+        } as UnlinkDiscourseAccountData)
+    );
+    return wrappedFinalizer({});
+  }
+
+  /**
+   * Récupère le profil Discourse d'un utilisateur dans le contexte de l'instance.
+   * Injecte automatiquement le `costumSlug` via `_withCostumContext`.
+   *
+   * @param username - Nom d'utilisateur Discourse cible
+   * @returns Profil Discourse avec `summary` et `profileUrl`, ou `error` en cas d'échec
+   * @throws {ApiError} Si `username` est absent ou invalide
+   *
+   * @example
+   * const result = await user.getDiscourseProfile("john_doe");
+   * result.profileUrl; // "https://forum.example.org/u/john_doe/summary"
+   */
+  async getDiscourseProfile(
+    username: string,
+  ): Promise<{
+    summary?: Record<string, unknown>;
+    profileUrl?: string;
+    error?: string;
+  }> {
+    if (!username || typeof username !== "string") {
+      throw new ApiError("username est requis et doit être une chaîne de caractères.", 400);
+    }
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: WithCostumContext<{ username: string }>) =>
+        this.endpointApi.discourseProfile({
+          ...finalData,
+          costumId: finalData.contextId,
+          costumType: finalData.contextType,
+        } as DiscourseProfileData)
+    );
+    return wrappedFinalizer({ username });
+  }
+
+  /**
+   * Vérifie si l'email de l'utilisateur connecté correspond à un compte Discourse.
+   * Injecte automatiquement le `costumSlug` via `_withCostumContext`.
+   * L'email utilisé est celui de l'utilisateur connecté (géré côté serveur).
+   *
+   * @returns `{ found: true, user }` si un compte correspondant existe, `{ found: false }` sinon
+   *
+   * @example
+   * const result = await user.checkDiscourseEmailMatch();
+   * if (result.found) {
+   *   console.log(result.user); // infos du compte Discourse trouvé
+   * }
+   */
+  async checkDiscourseEmailMatch(): Promise<{
+    found: boolean;
+    user?: Record<string, unknown>;
+  }> {
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: WithCostumContext<Record<string, never>>) =>
+        this.endpointApi.discourseCheckEmail({
+          ...finalData,
+          costumId: finalData.contextId,
+          costumType: finalData.contextType,
+        } as DiscourseCheckEmailData)
+    );
+    return wrappedFinalizer({});
+  }
+
+  /**
+   * Ignore la suggestion de liaison de compte Discourse pour l'instance courante.
+   * Persiste le refus côté serveur (`interop.discourse[costumSlug] = false`).
+   * Injecte automatiquement le `costumSlug` via `_withCostumContext`.
+   *
+   * @returns `{ result: true }` si le dismiss a réussi
+   *
+   * @example
+   * const result = await user.dismissDiscourseLink();
+   * result.result; // true
+   */
+  async dismissDiscourseLink(): Promise<{
+    result: boolean;
+    error?: string;
+  }> {
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: WithCostumContext<Record<string, never>>) =>
+        this.endpointApi.discourseDismissLink({
+          ...finalData,
+          costumId: finalData.contextId,
+          costumType: finalData.contextType,
+        } as DiscourseDismissLinkData)
+    );
+    return wrappedFinalizer({});
+  }
+
+  /**
+   * Associe un compte MediaWiki à l'entité courante dans le contexte de l'instance.
+   * Injecte automatiquement le `costumSlug` via `_withCostumContext`.
+   *
+   * @param username - Nom d'utilisateur MediaWiki à associer
+   * @returns Résultat de la liaison avec les informations du compte MediaWiki trouvé
+   * @throws {ApiError} Si `username` est absent ou invalide
+   *
+   * @example
+   * const result = await user.linkMediaWikiAccount("John_Doe");
+   * if (result.result) {
+   *   console.log(result.username); // nom d'utilisateur confirmé
+   * } else {
+   *   console.error(result.error);
+   * }
+   */
+  async linkMediaWikiAccount(
+    username: string,
+  ): Promise<{
+    result: boolean;
+    error?: string;
+    username?: string;
+    msg?: string;
+  }> {
+    if (!username || typeof username !== "string") {
+      throw new ApiError("username est requis et doit être une chaîne de caractères.", 400);
+    }
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: WithCostumContext<{ username: string }>) =>
+        this.endpointApi.linkMediawikiAccount({
+          ...finalData,
+          costumId: finalData.contextId,
+          costumType: finalData.contextType,
+        } as LinkMediawikiAccountData)
+    );
+    return wrappedFinalizer({ username });
+  }
+
+  /**
+   * Dissocie le compte MediaWiki de l'entité courante dans le contexte de l'instance.
+   * Injecte automatiquement le `costumSlug` via `_withCostumContext`.
+   *
+   * @returns Résultat du délien du compte MediaWiki
+   *
+   * @example
+   * const result = await user.unlinkMediaWikiAccount();
+   * result.result; // true si succès
+   */
+  async unlinkMediaWikiAccount(): Promise<{
+    result: boolean;
+    error?: string;
+    msg?: string;
+  }> {
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: WithCostumContext<Record<string, never>>) =>
+        this.endpointApi.unlinkMediawikiAccount({
+          ...finalData,
+          costumId: finalData.contextId,
+          costumType: finalData.contextType,
+        } as UnlinkMediawikiAccountData)
+    );
+    return wrappedFinalizer({});
+  }
+
+  /**
+   * Récupère les contributions MediaWiki d'un utilisateur dans le contexte de l'instance.
+   * Injecte automatiquement le `costumSlug` via `_withCostumContext`.
+   *
+   * @param username - Nom d'utilisateur MediaWiki cible
+   * @param limit - Nombre maximum de contributions à retourner (optionnel)
+   * @returns Liste des contributions MediaWiki, ou `error` en cas d'échec
+   * @throws {ApiError} Si `username` est absent ou invalide
+   *
+   * @example
+   * const result = await user.getMediaWikiContributions("John_Doe", 10);
+   * result.contribs; // objet contenant les contributions
+   */
+  async getMediaWikiContributions(
+    username: string,
+    limit?: number,
+  ): Promise<{
+    result: boolean;
+    contribs?: Record<string, unknown>;
+  }> {
+    if (!username || typeof username !== "string") {
+      throw new ApiError("username est requis et doit être une chaîne de caractères.", 400);
+    }
+    const wrappedFinalizer = this._withCostumContext(
+      (finalData: WithCostumContext<{ username: string; limit?: number }>) =>
+        this.endpointApi.getMediawikiContributions({
+          ...finalData,
+          costumId: finalData.contextId,
+          costumType: finalData.contextType,
+        } as GetMediawikiContributionsData)
+    );
+    return wrappedFinalizer({ username, limit });
+  }
+
+  /**
+   * Wrapper pour l'endpoint COREMU_OPERATION : génère une proposition à partir
+   * d'un formulaire et d'un projet. Cette méthode injecte les `const` du schéma
+   * (`answer: "new"`, `action: "generateproposition"`) et délègue à l'EndpointApi.
+   *
+   * @param data.form - ID Mongo (24 hex) du formulaire
+   * @param data.project - ID Mongo (24 hex) du projet
+   * @returns Résultat brut de l'API (ou entité liée si `collection` est présent)
+   * @throws {ApiError} Si les paramètres sont manquants ou invalides
+   */
+  async coremuOperation(data: Pick<CoremuOperationData, "form" | "project">): Promise<any> {
+    if (!data.form || typeof data.form !== "string") {
+      throw new ApiError("form est requis et doit être une chaîne de caractères.", 400);
+    }
+    if (!data.project || typeof data.project !== "string") {
+      throw new ApiError("project est requis et doit être une chaîne de caractères.", 400);
+    }
+
+    const payload: CoremuOperationData = {
+      ...data,
+      answer: "new",
+      action: "generateproposition",
+    };
+
+    const result = await this.endpointApi.coremuOperation(payload);
+    return this._linkEntity(result?.collection, result) ?? result;
+  }
+
   /**
    * ───────────────────────────────
    * Pagination restoration methods