@communecter/cocolight-api-client 1.0.127 → 1.0.129

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";
@@ -231,6 +232,11 @@ export class Project extends BaseEntity<ProjectItemNormalized> {
    * // Récupérer les contributeurs en attente d'invitation
    * const invitingContributors = await project.getContributors({}, { isInviting: true });
    *
+   * // Restreindre la recherche : uniquement les citoyens
+   * const onlyCitoyens = await project.getContributors({}, { searchType: "citoyens" });
+   *
+   * // Restreindre la recherche : uniquement les organisations
+   * const onlyOrgas = await project.getContributors({}, { searchType: "organizations" });
    */
   async getContributors(
     data: Partial<GetContributorsAdminData | GetContributorsNoAdminData> = {},
@@ -240,11 +246,19 @@ export class Project extends BaseEntity<ProjectItemNormalized> {
       isAdminPending?: boolean;
       isInviting?: boolean;
       roles?: any[];
+      searchType?: "all" | "citoyens" | "organizations";
       restoredState?: PaginatorState;
     } = {}
   ): Promise<PaginatorPage<User | Organization>> {
-    data.searchType = this._getDefaultFromEndpoint("GET_CONTRIBUTORS_ADMIN", "searchType") as GetContributorsAdminData["searchType"];
-    // data.searchBy = "ALL";
+    const allTypes = this._getDefaultFromEndpoint("GET_CONTRIBUTORS_ADMIN", "searchType") as GetContributorsAdminData["searchType"];
+    if (options.searchType === "citoyens") {
+      data.searchType = ["citoyens"];
+    } else if (options.searchType === "organizations") {
+      data.searchType = allTypes.filter(t => t !== "citoyens") as GetContributorsAdminData["searchType"];
+    } else {
+      // "all" ou omis : on initialise explicitement (le paginator exige searchType avant la validation AJV)
+      data.searchType = allTypes;
+    }
 
     const paginator = this._createPaginatorEngine({
       initialData: data,
@@ -342,10 +356,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;

package/src/api/serverDataType/Action.ts

@@ -0,0 +1,177 @@
+import type {
+  IdObject,
+  LinkContributorsRef,
+  ParentsMap,
+  DateValue,
+} from "./common.js";
+import type EJSONType from "../../EJSONType.js";
+
+type ObjectIDCtor = typeof EJSONType["ObjectID"];
+type ObjectID = InstanceType<ObjectIDCtor>;
+
+/**
+ * Statuts supportés par une action (cf. COSTUM_PROJECT_ACTION_REQUEST_NEW).
+ */
+export const ACTION_STATUSES = [
+  "todo",
+  "done",
+  "tracking",
+  "discuter",
+  "next",
+  "totest",
+  "disabled",
+  "closed"
+] as const;
+
+export type ActionStatus = (typeof ACTION_STATUSES)[number];
+
+export interface ActionLinksBlock {
+  contributors?: Record<string, LinkContributorsRef>;
+  [k: string]: unknown;
+}
+
+export interface ActionMilestoneRef {
+  milestoneId: string;
+  startDate?: DateValue;
+  endDate?: DateValue;
+}
+
+export interface ActionCounts {
+  contributors?: number;
+  [k: string]: unknown;
+}
+
+/**
+ * Historique des changements de statut (alimenté par /set_status côté backend).
+ * `update` est un MongoDate (DateValue côté Json, Date côté Normalized).
+ */
+export interface ActionUpdateStatusEntryJson {
+  status: ActionStatus;
+  author: string;
+  update: DateValue;
+}
+
+export interface ActionUpdateStatusEntryNormalized {
+  status: ActionStatus;
+  author: string;
+  update: Date;
+}
+
+/**
+ * Sous-tâche d'une action. Stockée dans `tasks[]`.
+ */
+export interface ActionTaskJson {
+  taskId?: string;
+  task?: string;
+  checked?: boolean;
+  userId?: string;
+  contributors?: Record<string, unknown>;
+  timeSpent?: number;
+  createdAt?: DateValue;
+  checkedAt?: DateValue;
+  [key: string]: unknown;
+}
+
+export interface ActionTaskNormalized {
+  taskId?: string;
+  task?: string;
+  checked?: boolean;
+  userId?: string;
+  contributors?: Record<string, unknown>;
+  timeSpent?: number;
+  createdAt?: Date;
+  checkedAt?: Date;
+  [key: string]: unknown;
+}
+
+/**
+ * Bloc media : galerie d'images + fichiers attachés (par IDs de documents).
+ */
+export interface ActionMedia {
+  type?: string;
+  countImages?: number;
+  images?: string[];
+  files?: string[];
+  [k: string]: unknown;
+}
+
+export interface ActionMediaFile {
+  files?: string[];
+  [k: string]: unknown;
+}
+
+export interface ActionItemJson {
+  _id: IdObject;
+  collection: "actions";
+  name: string;
+  description?: string;
+  status?: ActionStatus;
+  created?: DateValue;
+  updated?: DateValue;
+  modified?: DateValue;
+  startDate?: DateValue;
+  endDate?: DateValue;
+  parentId: string;
+  parentType: string;
+  parent?: ParentsMap;
+  tags?: string[];
+  links?: ActionLinksBlock;
+  creator?: string;
+  idUserAuthor?: string;
+  credits?: string;
+  idParentRoom?: string;
+  milestone?: ActionMilestoneRef;
+  importance?: string;
+  counts?: ActionCounts;
+  url?: string;
+  min?: number;
+  max?: number;
+  timeSpent?: number;
+  tracking?: boolean;
+  updateStatus?: ActionUpdateStatusEntryJson[];
+  rc?: unknown[];
+  tasks?: ActionTaskJson[];
+  media?: ActionMedia;
+  mediaFile?: ActionMediaFile;
+  [key: string]: unknown;
+}
+
+export interface ActionItemNormalized {
+  id: string;
+  _id: ObjectID;
+  collection: "actions";
+  name: string;
+  description?: string;
+  status?: ActionStatus;
+  created?: Date;
+  updated?: Date;
+  modified?: Date;
+  startDate?: Date;
+  endDate?: Date;
+  parentId: string;
+  parentType: string;
+  parent?: ParentsMap;
+  tags?: string[];
+  links?: ActionLinksBlock;
+  creator?: string;
+  idUserAuthor?: string;
+  credits?: number;
+  idParentRoom?: string;
+  milestone?: Omit<ActionMilestoneRef, "startDate" | "endDate"> & {
+    startDate?: Date;
+    endDate?: Date;
+  };
+  importance?: string;
+  counts?: ActionCounts;
+  url?: string;
+  min?: number;
+  max?: number;
+  timeSpent?: number;
+  tracking?: boolean;
+  updateStatus?: ActionUpdateStatusEntryNormalized[];
+  rc?: unknown[];
+  tasks?: ActionTaskNormalized[];
+  media?: ActionMedia;
+  mediaFile?: ActionMediaFile;
+  [key: string]: unknown;
+}