@communecter/cocolight-api-client 1.0.126 → 1.0.128

package/package.json

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

package/src/Api.ts

@@ -1,4 +1,5 @@
 // Api.ts
+import { Action } from "./api/Action.js";
 import { Answer } from "./api/Answer.js";
 import { Badge } from "./api/Badge.js";
 import { Classified } from "./api/Classified.js";
@@ -33,6 +34,7 @@ registerEntity("Comment", Comment);
 registerEntity("Answer", Answer);
 registerEntity("Form", Form);
 registerEntity("Classified", Classified);
+registerEntity("Action", Action);
 
 
 
@@ -130,9 +132,9 @@ export default class Api {
   async user(userData: EntityData): Promise<User> {
     try {
       if (!userData.id && !userData.slug) {
-        return new User(this._client, userData, { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Classified });
+        return new User(this._client, userData, { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Classified, Action });
       } else {
-        const user = new User(this._client, userData, { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Classified });
+        const user = new User(this._client, userData, { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Classified, Action });
         await user.get();
         return user;
       }
@@ -148,7 +150,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, Answer, Classified });
+      const organization = new Organization(this._client, organizationData, { EndpointApi, User, Project, Event, Poi, Badge, News, Comment, Answer, Classified, Action });
       if (!organizationData.id && !organizationData.slug) {
         throw new Error("Vous devez fournir un id ou un slug pour créer une instance Organization.");
       }
@@ -165,7 +167,7 @@ export default class Api {
    */
   async project(projectData: EntityData): Promise<Project> {
     try {
-      const project = new Project(this._client, projectData, { EndpointApi, User, Organization, Event, Poi, Badge, News, Comment, Classified });
+      const project = new Project(this._client, projectData, { EndpointApi, User, Organization, Event, Poi, Badge, News, Comment, Classified, Action });
       if (!projectData.id && !projectData.slug) {
         throw new Error("Vous devez fournir un id ou un slug pour créer une instance Project.");
       }

package/src/ApiClient.ts

@@ -1659,7 +1659,7 @@ export default class ApiClient extends EventEmitter {
  * via x-www-form-urlencoded ; sans cette coercion, JSON.stringify diff
  * produit des faux positifs dans `hasChanges()`).
  */
-  private _numberFields = ["buildingSurfaceArea", "siteSurfaceArea"];
+  private _numberFields = ["buildingSurfaceArea", "siteSurfaceArea", "credits", "min", "max", "timeSpent"];
 
   /**
  * Normalise récursivement un objet, un tableau ou une valeur simple.

package/src/api/Action.ts

@@ -0,0 +1,76 @@
+import { ApiError } from "../error.js";
+import { BaseEntity } from "./BaseEntity.js";
+
+import type { CostumProjectActionRequestNewData } from "./EndpointApi.types.js";
+import type { ActionItemNormalized } from "./serverDataType/Action.js";
+
+/**
+ * Entité Action — tâche/jalon attaché à un Project.
+ *
+ * Toujours liée à un Project parent (parentType="projects" est const côté backend).
+ * S'instancie via `project.action(...)` plutôt que directement.
+ *
+ * Endpoints utilisés :
+ * - `get()` : hérité (GET_ELEMENTS_ABOUT via `/co2/element/about/type/actions/id/{id}`)
+ * - `_add()` : COSTUM_PROJECT_ACTION_REQUEST_NEW (parentId/parentType injectés depuis le parent)
+ */
+export class Action extends BaseEntity<ActionItemNormalized> {
+  static override entityType = "actions";
+
+  static override entityTag = "Action";
+
+  static override SCHEMA_CONSTANTS: string[] = [
+    "COSTUM_PROJECT_ACTION_REQUEST_NEW"
+  ];
+
+  static ADD_BLOCKS = new Map([
+    ["COSTUM_PROJECT_ACTION_REQUEST_NEW", "addAction"]
+  ] as const);
+
+  override defaultFields: Record<string, any> = {
+    parentType: "projects"
+  };
+
+  override removeFields: string[] = [];
+
+  override _add = async (payload: Record<string, any>): Promise<void> => {
+    if (!this._calledFromSave) {
+      throw new ApiError("utilisation invalide de _add, utilisez save", 400);
+    }
+
+    if (!this.parent?.id) {
+      throw new ApiError("Le parent (Project) doit être défini pour créer une action.", 400);
+    }
+
+    if (this.parent.getEntityType() !== "projects") {
+      throw new ApiError(`Une Action ne peut être créée que depuis un Project (parent reçu: ${this.parent.getEntityType()}).`, 400);
+    }
+
+    payload.parentId = this.parent.id;
+
+    for (const [constant, methodName] of Array.from(Action.ADD_BLOCKS)) {
+      const blockData = this._extractChangedFieldsFromSchema(
+        this.apiClient,
+        constant,
+        { ...payload, ...this.defaultFields },
+        () => {}
+      );
+      if (blockData && Object.keys(blockData).length > 0) {
+        const data = await this._invokeBlockMethod(Action.ADD_BLOCKS, methodName, blockData);
+        const content = data?.content;
+        if (!this.id && content?.id) {
+          this._draftData.id = content.id;
+          this._setData(content as ActionItemNormalized, { forceInitialDraftReset: true });
+        }
+      }
+    }
+  };
+
+  /**
+   * Crée une nouvelle action via /costum/project/action/request/new.
+   * Méthode de bas niveau — utiliser `save()` après modification du draft à la place.
+   */
+  async addAction(data: Partial<CostumProjectActionRequestNewData> = {}): Promise<unknown> {
+    return this.callIsConnected(() => this.endpointApi.costumProjectActionRequestNew(data as CostumProjectActionRequestNewData));
+  }
+}

package/src/api/BaseEntity.ts

@@ -77,6 +77,7 @@ 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>;
+type ActionInput = { id: string } | Record<string, any>;
 
 /**
  * On force le type de l'import comme une fabrique qui renvoie un objet
@@ -99,9 +100,10 @@ type Comment = import("./Comment.js").Comment;
 type Answer = import("./Answer.js").Answer;
 type Form = import("./Form.js").Form;
 type Classified = import("./Classified.js").Classified;
+type Action = import("./Action.js").Action;
 
 // Types d'union
-type AnyEntity = User | Organization | Project | Poi | EventEntity | Badge | News | Comment | Answer | Form | Classified;
+type AnyEntity = User | Organization | Project | Poi | EventEntity | Badge | News | Comment | Answer | Form | Classified | Action;
 type ParentLike = BaseEntity<any> & { apiClient: ApiClient, userContext?: User | null };
 
 // Types pour les dépendances
@@ -120,7 +122,8 @@ interface Deps {
   Comment?: any;
   Answer?: any;
   Form?: any;
-  Classified?: any
+  Classified?: any;
+  Action?: any;
 }
 
 interface BaseEntityConfig {
@@ -140,6 +143,7 @@ interface EntityTypeMap {
   answers: Answer;
   forms: Form;
   classifieds: Classified;
+  actions: Action;
 }
 
 // Types pour les streams et uploads
@@ -250,7 +254,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" | "forms" | "classifieds";
+  entityType: "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds" | "actions";
   SCHEMA_CONSTANTS: string | string[];
 };
 
@@ -344,7 +348,7 @@ interface FinalizerResult<TOut> {
 }
 
 // Types pour les entités
-export type EntityType = "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds";
+export type EntityType = "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds" | "actions";
 
 // ============================================================================
 
@@ -525,7 +529,7 @@ export class BaseEntity<TServerData = any> {
   }
 
   /** @returns Type de l'entité (ex: 'citoyens') */
-  getEntityType(): "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds" {
+  getEntityType(): "citoyens" | "organizations" | "projects" | "events" | "poi" | "badges" | "news" | "comments" | "answers" | "forms" | "classifieds" | "actions" {
     return this._getCtor().entityType;
   }
 
@@ -1947,6 +1951,7 @@ export class BaseEntity<TServerData = any> {
       Answer: selfTag === "Answer" ? selfClass : this.deps.Answer,
       Form: selfTag === "Form" ? selfClass : this.deps.Form,
       Classified: selfTag === "Classified" ? selfClass : this.deps.Classified,
+      Action: selfTag === "Action" ? selfClass : this.deps.Action,
     };
 
     const map = {
@@ -1968,6 +1973,7 @@ export class BaseEntity<TServerData = any> {
       comments: { entityClass: commonDeps.Comment, deps: { ...commonDeps } },
       answers: { entityClass: commonDeps.Answer, deps: { ...commonDeps } },
       forms: { entityClass: commonDeps.Form, deps: { ...commonDeps } },
+      actions: { entityClass: commonDeps.Action, deps: { ...commonDeps } },
     };
 
     return (map as Record<string, EntityMeta | undefined>)[entityType] || null;
@@ -2200,6 +2206,7 @@ export class BaseEntity<TServerData = any> {
         comments: [], // Pas de get() pour les commentaires
         answers: ["id"],
         classifieds: ["id"],
+        actions: ["id"],
       };
 
       const fetchKeys = (fetchKeysByEntity as Record<string, string[] | undefined>)[entityType];
@@ -2622,7 +2629,7 @@ export class BaseEntity<TServerData = any> {
     if (!userLink) {
 
       // 1) Garde runtime pour exclure les types non pris en charge par ConnectData
-      this._assertNotEntityType("connect", ["poi", "badges", "news"]);
+      this._assertNotEntityType("connect", ["poi", "badges", "news", "actions"]);
 
       // 2) Narrow de type pour TypeScript
       const parentType = this.getEntityType() as ConnectData["parentType"];
@@ -2678,7 +2685,7 @@ export class BaseEntity<TServerData = any> {
     if (!userLink) {
 
       // 1) Garde runtime pour exclure les types non pris en charge par ConnectData
-      this._assertNotEntityType("connect", ["poi", "badges", "news"]);
+      this._assertNotEntityType("connect", ["poi", "badges", "news", "actions"]);
 
       // 2) Narrow de type pour TypeScript
       const parentType = this.getEntityType() as ConnectData["parentType"];
@@ -2737,7 +2744,7 @@ export class BaseEntity<TServerData = any> {
 
     if (userLink && (userLink.isInviting || userLink.isAdminInviting)) {
       // 1) Garde runtime pour exclure les types non pris en charge par LinkValidateData
-      this._assertNotEntityType("linkValidate", ["poi", "badges", "news"]);
+      this._assertNotEntityType("linkValidate", ["poi", "badges", "news", "actions"]);
 
       // 2) Narrow de type pour TypeScript
       const parentType = this.getEntityType() as LinkValidateData["parentType"];
@@ -2784,7 +2791,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     // 1) Garde runtime pour exclure les types non pris en charge par DisconnectData
-    this._assertNotEntityType("disconnect", ["poi", "badges", "news"]);
+    this._assertNotEntityType("disconnect", ["poi", "badges", "news", "actions"]);
 
     // 2) Narrow de type pour TypeScript
     const parentType = this.getEntityType() as DisconnectData["parentType"];
@@ -2839,7 +2846,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     // Réduit le type de l'entité aux seuls autorisés par UpdateSettingsData
-    this._assertNotEntityType("updateSettings", ["poi", "badges", "news"]);
+    this._assertNotEntityType("updateSettings", ["poi", "badges", "news", "actions"]);
     const typeEntity = this.getEntityType() as UpdateSettingsData["typeEntity"];
 
     // Garde runtime pour s'assurer que 'type' et 'value' sont bien fournis
@@ -2874,7 +2881,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     // Réduit le type de l'entité aux seuls autorisés par UpdateBlockDescriptionData
-    this._assertNotEntityType("updateDescription", ["badges", "news"]);
+    this._assertNotEntityType("updateDescription", ["badges", "news", "actions"]);
     const typeElement = this.getEntityType() as UpdateBlockDescriptionData["typeElement"];
 
     const payload: UpdateBlockDescriptionData = {
@@ -2903,7 +2910,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     // Réduit le type de l'entité aux seuls autorisés par UpdateBlockInfoData
-    this._assertNotEntityType("updateInfo", ["badges", "news"]);
+    this._assertNotEntityType("updateInfo", ["badges", "news", "actions"]);
     const typeElement = this.getEntityType() as UpdateBlockInfoData["typeElement"];
 
     const payload: UpdateBlockInfoData = {
@@ -2930,7 +2937,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     // Réduit le type de l'entité aux seuls autorisés par UpdateBlockSocialData
-    this._assertNotEntityType("updateSocial", ["badges", "news", "poi", "events"]);
+    this._assertNotEntityType("updateSocial", ["badges", "news", "poi", "events", "actions"]);
     const typeElement = this.getEntityType() as UpdateBlockSocialData["typeElement"];
 
     const payload: UpdateBlockSocialData = {
@@ -2996,7 +3003,7 @@ export class BaseEntity<TServerData = any> {
     }
 
     // Réduit le type de l'entité aux seuls autorisés par UpdateBlockLocalityData
-    this._assertNotEntityType("updateLocality", ["badges", "news", "comments", "answers"]);
+    this._assertNotEntityType("updateLocality", ["badges", "news", "comments", "answers", "actions"]);
 
     // Garde runtime pour s'assurer que 'address' est bien fourni
     if (!("address" in data)) {
@@ -3040,7 +3047,7 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    this._assertNotEntityType("updateSlug", ["badges", "news", "poi", "comments"]);
+    this._assertNotEntityType("updateSlug", ["badges", "news", "poi", "comments", "actions"]);
 
     const type = this.getEntityType() as CheckData["type"];
 
@@ -3071,7 +3078,7 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    this._assertNotEntityType("updateImageProfil", ["badges", "news", "comments", "answers"]);
+    this._assertNotEntityType("updateImageProfil", ["badges", "news", "comments", "answers", "actions"]);
 
     const folder = this.getEntityType() as NonNullable<ProfilImageData["pathParams"]>["folder"];
 
@@ -3098,7 +3105,7 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    this._assertNotEntityType("updateImageBanner", ["badges", "news", "comments", "answers"]);
+    this._assertNotEntityType("updateImageBanner", ["badges", "news", "comments", "answers", "actions"]);
 
     const folder = this.getEntityType() as NonNullable<ProfilBannerData["pathParams"]>["folder"];
 
@@ -3235,6 +3242,20 @@ export class BaseEntity<TServerData = any> {
     return entity as News;
   }
 
+  /**
+   * Crée une instance d'Action et la récupère si nécessaire.
+   *
+   * Par défaut une action ne peut être créée que depuis un Project — les autres
+   * entités lèvent une erreur. Override sur Project pour activer le comportement.
+   *
+   * @param actionData - Les données pour initialiser l'action.
+   * @returns Une promesse qui résout l'objet Action créé.
+   * @throws {ApiError} Sur les entités non supportées.
+   */
+  async action(_actionData: ActionInput = {}): Promise<Action> {
+    throw new ApiError(`action n'existe pas dans ${this.constructor.name}`, 501);
+  }
+
   /**
    * Récupérer les organisations d'une entitée : la liste des organisations dont l'entité est membre ou admin valide.
    * Constant : GET_ORGANIZATIONS_ADMIN | GET_ORGANIZATIONS_NO_ADMIN
@@ -3481,7 +3502,7 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    this._assertNotEntityType("getNews", ["badges", "news", "poi", "events", "comments", "answers"]);
+    this._assertNotEntityType("getNews", ["badges", "news", "poi", "events", "comments", "answers", "actions"]);
 
     const type = this.getEntityType() as NonNullable<GetNewsData["pathParams"]>["type"];
 
@@ -3520,7 +3541,7 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError(`${this.constructor.name} non enregistrée.`, 404);
     }
 
-    this._assertNotEntityType("getGallery", ["badges", "news", "poi", "events", "comments", "answers"]);
+    this._assertNotEntityType("getGallery", ["badges", "news", "poi", "events", "comments", "answers", "actions"]);
 
     const type = this.getEntityType() as NonNullable<GetGalleryData["pathParams"]>["type"];
 
@@ -3573,7 +3594,7 @@ export class BaseEntity<TServerData = any> {
       return [];
     }
 
-    this._assertNotEntityType("searchMembers", ["badges", "news", "poi", "comments"]);
+    this._assertNotEntityType("searchMembers", ["badges", "news", "poi", "comments", "actions"]);
 
     result.forEach(item => {
       for (const key of Object.keys(item)) {
@@ -3733,7 +3754,7 @@ export class BaseEntity<TServerData = any> {
       throw new ApiError("Utilisateur non connecté.", 401);
     }
 
-    this._assertNotEntityType("follow", ["badges", "news", "poi", "comments"]);
+    this._assertNotEntityType("follow", ["badges", "news", "poi", "comments", "actions"]);
 
     const parentType = this.getEntityType() as FollowData["parentType"];
 
@@ -3777,7 +3798,7 @@ export class BaseEntity<TServerData = any> {
 
     const userLink = this.userContext?.serverData?.links?.["follows"]?.[this.id] || null;
 
-    this._assertNotEntityType("unfollow", ["badges", "news", "poi"]);
+    this._assertNotEntityType("unfollow", ["badges", "news", "poi", "actions"]);
 
     const parentType = this.getEntityType() as DisconnectData["parentType"];
 

package/src/api/EndpointApi.types.ts

@@ -442,7 +442,17 @@ export interface GetElementsAboutData {
     /**
      * Type d'entité
      */
-    type: "citoyens" | "projects" | "organizations" | "events" | "poi" | "badges" | "answers" | "classifieds" | "forms";
+    type:
+      | "citoyens"
+      | "projects"
+      | "organizations"
+      | "events"
+      | "poi"
+      | "badges"
+      | "answers"
+      | "classifieds"
+      | "forms"
+      | "actions";
     /**
      * ID de l'utilisateur ou de l'entité
      */
@@ -5269,9 +5279,15 @@ export interface UpdatePathValueData {
   /**
    * Valeur à mettre à jour (peut être un objet, un tableau, une chaîne, etc.)
    */
-  value: {
-    [k: string]: unknown;
-  };
+  value:
+    | string
+    | number
+    | boolean
+    | {
+        [k: string]: unknown;
+      }
+    | unknown[]
+    | null;
   [k: string]: unknown;
 }
 
@@ -5500,9 +5516,9 @@ export interface CostumProjectActionRequestNewData {
    */
   name: string;
   /**
-   * Statut de l'action
+   * Statut de l'action. Sert aussi de trigger côté backend : 'done' ajoute startDate/endDate auto, 'tracking' active le mode tracking, 'discuter'/'next'/'totest' ajoutent un tag.
    */
-  status: string;
+  status: "todo" | "done" | "tracking" | "discuter" | "next" | "totest" | "disabled" | "closed";
   /**
    * ID du projet parent
    */
@@ -5512,18 +5528,74 @@ export interface CostumProjectActionRequestNewData {
    */
   parentType: "projects";
   /**
-   * Montant financé
+   * Montant financé (default: 1)
    */
-  credits: number;
+  credits?: number;
   /**
    * Jalon associé à l'action
    */
-  milestone: {
+  milestone?: {
     /**
      * ID du jalon associé
      */
     milestoneId: string;
+    /**
+     * Date de début du jalon (ISO 8601, convertie en MongoDate UTC côté backend)
+     */
+    startDate?: string;
+    /**
+     * Date de fin du jalon (ISO 8601, convertie en MongoDate UTC côté backend)
+     */
+    endDate?: string;
   };
+  /**
+   * Date et heure de début (ISO 8601 avec offset)
+   */
+  startDate?: string;
+  /**
+   * Date et heure de fin (ISO 8601 avec offset)
+   */
+  endDate?: string;
+  /**
+   * Temps passé en minutes (utilisé pour calculer endDate quand status=done)
+   */
+  timeSpent?: number;
+  /**
+   * Nombre minimum de contributeurs
+   */
+  min?: number;
+  /**
+   * Nombre maximum de contributeurs (doit être >= min côté backend)
+   */
+  max?: number;
+  /**
+   * Niveau d'importance de l'action
+   */
+  importance?: string;
+  /**
+   * ID de la room parente. Si absent, auto-créée par Room::getOrCreateActionRoom côté backend
+   */
+  idParentRoom?: string;
+  /**
+   * Si true, ajoute l'auteur courant comme contributor admin. ATTENTION : écrasé si 'mentions' est aussi fourni.
+   */
+  is_contributor?: boolean;
+  /**
+   * userId à assigner comme contributor admin. ATTENTION : écrasé si 'mentions' est aussi fourni.
+   */
+  assign?: string;
+  /**
+   * URLs externes associées à l'action (tableau de strings, ou "" pour vider). Passthrough côté backend.
+   */
+  urls?: string[] | "";
+  /**
+   * Liste des contributeurs assignés à l'action par username. Résolu côté backend en links.contributors.{userId}. ATTENTION : ÉCRASE 'assign' et 'is_contributor' si fournis ensemble.
+   */
+  mentions?: string[];
+  /**
+   * Liste des tags associés à l'action. BUG CONNU BACKEND : les tags sont dupliqués dans la réponse (array_merge avec soi-même côté PHP).
+   */
+  tags?: 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" | "Answer" | "Form" | "Classified";
+export type EntityTag = "User" | "Organization" | "Project" | "Event" | "Poi" | "Badge" | "News" | "Comment" | "Answer" | "Form" | "Classified" | "Action";
 export type CollectionKey = CollectionType; // Alias pour compatibilité
 type BaseEntity = import("./BaseEntity.js").BaseEntity<any>;
 type ApiClient = import("../ApiClient.js").default;
@@ -113,7 +113,8 @@ function _getCollectionFromTag(tag: EntityTag): CollectionKey | null {
     "Comment": "comments",
     "Answer": "answers",
     "Form": "forms",
-    "Classified": "classifieds"
+    "Classified": "classifieds",
+    "Action": "actions"
   };
   return map[tag] || null;
 }
@@ -138,6 +139,7 @@ function _getEntityMeta(entityType: CollectionKey, __entityTag: EntityTag): Enti
     Answer: selfTag === "Answer" ? selfClass : EntityRegistry.get("Answer"),
     Form: selfTag === "Form" ? selfClass : EntityRegistry.get("Form"),
     Classified: selfTag === "Classified" ? selfClass : EntityRegistry.get("Classified"),
+    Action: selfTag === "Action" ? selfClass : EntityRegistry.get("Action"),
   };
 
   const map: Record<CollectionKey, EntityMeta> = {
@@ -147,16 +149,17 @@ function _getEntityMeta(entityType: CollectionKey, __entityTag: EntityTag): Enti
     events:       { entityClass: commonDeps.Event as EntityClass,        deps: { ...commonDeps, Badge: undefined } },
     poi:          { entityClass: commonDeps.Poi as EntityClass,          deps: { ...commonDeps, Badge: undefined, News: undefined, Comment: undefined } },
     news:         { entityClass: commonDeps.News as EntityClass,         deps: { ...commonDeps } },
-    badges:       { entityClass: commonDeps.Badge as EntityClass,        deps: { 
-      EndpointApi: commonDeps.EndpointApi, 
-      User: commonDeps.User, 
-      Organization: commonDeps.Organization, 
-      Project: commonDeps.Project 
+    badges:       { entityClass: commonDeps.Badge as EntityClass,        deps: {
+      EndpointApi: commonDeps.EndpointApi,
+      User: commonDeps.User,
+      Organization: commonDeps.Organization,
+      Project: commonDeps.Project
     } },
     comments:     { entityClass: commonDeps.Comment as EntityClass,      deps: { ...commonDeps } },
     answers:      { entityClass: commonDeps.Answer as EntityClass,       deps: { ...commonDeps } },
     forms:        { entityClass: commonDeps.Form as EntityClass,         deps: { ...commonDeps } },
     classifieds:  { entityClass: commonDeps.Classified as EntityClass,   deps: { ...commonDeps, Badge: undefined, News: undefined } },
+    actions:      { entityClass: commonDeps.Action as EntityClass,       deps: { ...commonDeps } },
   };
   
   return map[entityType] || null;
@@ -215,6 +218,10 @@ export function createFromCollection(collection: CollectionKey, parent: ApiClien
     classifieds: {
       entityTag: "Classified",
       meta: tag => _buildMeta(tag, { remove: ["Badge","News"] })
+    },
+    actions: {
+      entityTag: "Action",
+      meta: tag => _buildMeta(tag, { remove: [] })
     }
   };
   const entry = _collectionMap[collection];
@@ -248,7 +255,8 @@ function _buildMeta(tag: EntityTag, options: { remove: string[] }): EntityMeta {
     Comment: EntityRegistry.get("Comment"),
     Answer: EntityRegistry.get("Answer"),
     Form: EntityRegistry.get("Form"),
-    Classified: EntityRegistry.get("Classified")
+    Classified: EntityRegistry.get("Classified"),
+    Action: EntityRegistry.get("Action")
   };
   // inject self
   (allDeps as any)[tag] = EntityClass;

package/src/api/Project.ts

@@ -3,6 +3,7 @@ import { BaseEntity } from "./BaseEntity.js";
 import { createSocialTransform, transformEntityRefs } from "../types/transforms.js";
 
 
+import type { Action } from "./Action.js";
 import type { PaginatorPage, PaginatorState } from "./BaseEntity.js";
 import type { AddProjectData, GetContributorsAdminData, GetContributorsNoAdminData } from "./EndpointApi.types.js";
 import type { Organization } from "./Organization.js";
@@ -342,10 +343,25 @@ export class Project extends BaseEntity<ProjectItemNormalized> {
    * Crée une instance de news et la récupère si nécessaire.
    */
   override async news(newsData: Parameters<BaseEntity<ProjectItemNormalized>["news"]>[0] = {}) {
-    // TODO: qui peut créer une news sur le projet ?
+    if(!newsData?.id && !this.isContributor()){
+      throw new ApiError("Vous n'avez pas les droits pour créer une news dans ce projet", 403);
+    }
     return super.news(newsData);
   }
 
+  /**
+   * {@inheritDoc BaseEntity#action}
+   *
+   * Crée une instance d'Action liée à ce projet et la récupère si nécessaire.
+   */
+  override async action(actionData: Parameters<BaseEntity<ProjectItemNormalized>["action"]>[0] = {}) {
+    if(!actionData?.id && !this.isAdmin()){
+      throw new ApiError("Vous n'avez pas les droits pour créer une action dans ce projet", 403);
+    }
+    const entity = await this.entity("actions", actionData);
+    return entity as Action;
+  }
+  
   /**
    * ───────────────────────────────
    *  Lien utilisateur ↔ projet

package/src/api/User.ts

@@ -113,6 +113,7 @@ export class User extends BaseEntity<UserItemNormalized> {
       Comment: typeof import("./Comment.js").Comment;
       Answer: typeof import("./Answer.js").Answer;
       Classified?: typeof import("./Classified.js").Classified;
+      Action?: typeof import("./Action.js").Action;
     }
   ) {
     if(!deps.EndpointApi){

package/src/api/UserApi.ts

@@ -1,5 +1,6 @@
 import ApiClient from "../ApiClient.js";
 import { ApiError, ApiResponseError } from "../error.js";
+import { Action } from "./Action.js";
 import { Answer } from "./Answer.js";
 import { Badge } from "./Badge.js";
 import { Classified } from "./Classified.js";
@@ -68,7 +69,7 @@ export class UserApi {
       this.loggedUser = new User(
         this.client,
         response.data.user,
-        { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Classified }
+        { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Classified, Action }
       );
       return this.loggedUser;
     });
@@ -90,7 +91,7 @@ export class UserApi {
     this.loggedUser = new User(
       this.client,
       { id: this.client.userId },
-      { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Classified }
+      { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Classified, Action }
     );
 
     return this.loggedUser;