@communecter/cocolight-api-client 1.0.129 → 1.0.131

package/src/api/EndpointApi.ts

@@ -2,7 +2,7 @@
 import { ApiAuthenticationError } from "../error.js";
 
 import type ApiClient from "../ApiClient.js";
-import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, SaveCoformAnswerData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData } from "./EndpointApi.types.js";
+import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, SaveCoformAnswerData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData } from "./EndpointApi.types.js";
 
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
@@ -1920,6 +1920,86 @@ export class EndpointApi {
     return this.callIsConnected("COSTUM_PROJECT_ACTION_REQUEST_NEW", data);
   }
 
+  /**
+   * Change le statut d'une action (avec logique métier) : Change le status d'une action via l'endpoint dédié backend. Ajoute une entrée à updateStatus[], gère les tags (discuter/totest/next), auto-injecte startDate/endDate selon le status, gère tracking, envoie une notification Rocket.Chat au parent. NE PAS confondre avec UPDATE_PATH_VALUE qui bypass toute cette logique.
+   * Constant : COSTUM_PROJECT_ACTION_REQUEST_SET_STATUS
+   * @param data - Données envoyées à l'API
+   * @returns Les données de réponse.
+   * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+   * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async costumProjectActionRequestSetStatus(data: CostumProjectActionRequestSetStatusData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("COSTUM_PROJECT_ACTION_REQUEST_SET_STATUS", data);
+  }
+
+  /**
+   * Met à jour les dates d'une action : Met à jour startDate et/ou endDate d'une action via l'endpoint dédié. Supporte nativement l'effacement (envoyer chaîne vide → $unset). Parser de date robuste côté backend.
+   * Constant : COSTUM_PROJECT_ACTION_REQUEST_SET_DATE
+   * @param data - Données envoyées à l'API
+   * @returns Les données de réponse.
+   * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+   * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async costumProjectActionRequestSetDate(data: CostumProjectActionRequestSetDateData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("COSTUM_PROJECT_ACTION_REQUEST_SET_DATE", data);
+  }
+
+  /**
+   * Définit les contributeurs d'une action : Modifie links.contributors d'une action via 3 modes : (A) `contributors` array de userIds = remplace toute la liste ; (B) `contributor` + `participate=1` = ajoute un user ; (C) `contributor` + `participate=0` = retire un user. Valide les bornes `min`/`max` côté backend. Émet `.set-contributors{parentId}` et `.cd-int-contributors` aux clients socket.
+   * Constant : COSTUM_PROJECT_ACTION_REQUEST_SET_CONTRIBUTORS
+   * @param data - Données envoyées à l'API
+   * @returns Les données de réponse.
+   * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+   * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async costumProjectActionRequestSetContributors(data: CostumProjectActionRequestSetContributorsData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("COSTUM_PROJECT_ACTION_REQUEST_SET_CONTRIBUTORS", data);
+  }
+
+  /**
+   * Annule une action : Annule une action : status=closed + unset tracking + retire le tag 'totest'.
+   * Constant : COSTUM_PROJECT_ACTION_REQUEST_CANCEL
+   * @param data - Données envoyées à l'API
+   * @returns Les données de réponse.
+   * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+   * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async costumProjectActionRequestCancel(data: CostumProjectActionRequestCancelData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("COSTUM_PROJECT_ACTION_REQUEST_CANCEL", data);
+  }
+
+  /**
+   * Archive une action : Archive une action : status=disabled + unset tracking.
+   * Constant : COSTUM_PROJECT_ACTION_REQUEST_ARCHIVE
+   * @param data - Données envoyées à l'API
+   * @returns Les données de réponse.
+   * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+   * @throws {ApiAuthenticationError} - En cas d'erreur d'authentification.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async costumProjectActionRequestArchive(data: CostumProjectActionRequestArchiveData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.callIsConnected("COSTUM_PROJECT_ACTION_REQUEST_ARCHIVE", data);
+  }
+
   /**
    * Interoperabilité Discourse Lié un compte : Lier un compte Discourse
    * Constant : LINK_DISCOURSE_ACCOUNT

package/src/api/EndpointApi.types.ts

@@ -5620,6 +5620,79 @@ export interface CostumProjectActionRequestNewData {
 }
 
 
+export interface CostumProjectActionRequestSetStatusData {
+  /**
+   * ID de l'action
+   */
+  id: string;
+  /**
+   * Nouveau statut. Triggers backend : 'done' set endDate=now, 'tracking' set startDate=now+tracking:true, 'discuter'/'next'/'totest' ajoutent un tag et forcent status='todo', 'todo' unset startDate/endDate, 'closed' purge les tags discuter/totest/next, 'disabled' unset tracking.
+   */
+  status: "todo" | "done" | "tracking" | "discuter" | "next" | "totest" | "disabled" | "closed";
+  /**
+   * Optionnel : userId qui effectue le changement (utilisé pour updateStatus[].author et notification RC). Par défaut session userId.
+   */
+  user?: string;
+  [k: string]: unknown;
+}
+
+
+export interface CostumProjectActionRequestSetDateData {
+  /**
+   * ID de l'action
+   */
+  id: string;
+  /**
+   * Date de début ISO 8601, ou chaîne vide pour effacer ($unset)
+   */
+  startDate?: string;
+  /**
+   * Date de fin ISO 8601, ou chaîne vide pour effacer ($unset)
+   */
+  endDate?: string;
+  [k: string]: unknown;
+}
+
+
+export interface CostumProjectActionRequestSetContributorsData {
+  /**
+   * ID de l'action (côté backend lu via $_POST['action'], pas 'id')
+   */
+  action: string;
+  /**
+   * Mode A : remplace la liste complète des contributeurs par cet array de userIds.
+   */
+  contributors?: string[];
+  /**
+   * Mode B/C : userId à ajouter (participate=1) ou retirer (participate=0).
+   */
+  contributor?: string;
+  /**
+   * Mode B/C : 1=join, 0=quit. Couplé avec `contributor`.
+   */
+  participate?: 0 | 1;
+  [k: string]: unknown;
+}
+
+
+export interface CostumProjectActionRequestCancelData {
+  /**
+   * ID de l'action à annuler
+   */
+  id: string;
+  [k: string]: unknown;
+}
+
+
+export interface CostumProjectActionRequestArchiveData {
+  /**
+   * ID de l'action à archiver
+   */
+  id: string;
+  [k: string]: unknown;
+}
+
+
 export interface LinkDiscourseAccountData {
   /**
    * Nom d'utilisateur du compte Discourse

package/src/api/EntityRegistry.ts

@@ -98,6 +98,49 @@ export function fromEntityJSON(json: unknown, parent: ApiClient | BaseEntity | n
   return meta.entityClass.fromJSON(json, actualParent, meta.deps);
 }
 
+/**
+ * Walker récursif : parcourt un objet/tableau et ressuscite toutes les entités
+ * sérialisées (marqueurs `__isSerializedEntity` / `__entityTag`) rencontrées.
+ *
+ * Pensé pour les wrappers non-entité retournés par certains endpoints (ex: `fundingEnvelope`)
+ * ou pour réhydrater un état côté client après un transfert JSON (SSR, cache restore).
+ *
+ * Dates, RegExp et primitives sont préservées. Pour les entités, la chaîne de parents
+ * est reconstruite automatiquement depuis les méta embarquées par `toJSON()`.
+ *
+ * @param obj - L'objet à parcourir (wrapper, array, primitive…)
+ * @param parent - Parent racine (typiquement l'ApiClient côté client)
+ * @returns L'objet avec toutes les entités revived
+ *
+ * @example
+ * // Côté client SSR : revive l'état dehydraté
+ * const apiClient = new ApiClient({ baseURL });
+ * const envelope = reviveEntities(window.__INIT__.envelope, apiClient);
+ * envelope.projects[0].serverData.actions[0]; // Action instance
+ */
+export function reviveEntities<T = unknown>(
+  obj: unknown,
+  parent: ApiClient | BaseEntity | null = null
+): T {
+  if (obj === null || obj === undefined) return obj as T;
+  if (typeof obj !== "object") return obj as T;
+  if (obj instanceof Date || obj instanceof RegExp) return obj as T;
+
+  if (isEntityJSON(obj)) {
+    return fromEntityJSON(obj, parent) as T;
+  }
+
+  if (Array.isArray(obj)) {
+    return obj.map(item => reviveEntities(item, parent)) as T;
+  }
+
+  const result: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(obj as object)) {
+    result[key] = reviveEntities(value, parent);
+  }
+  return result as T;
+}
+
 /**
  * Mappe un EntityTag vers son CollectionKey correspondant.
  */

package/src/api/Organization.ts

@@ -478,12 +478,14 @@ export class Organization extends BaseEntity<OrganizationItemNormalized> {
       throw new ApiError("L'organisation n'a pas d'ID, impossible de mettre à jour les horaires d'ouverture.", 400);
     }
 
-    return this.endpointApi.updatePathValue({
+    const result = await this.endpointApi.updatePathValue({
       id: this.id,
       collection: "organizations",
       path: "openingHours",
       value: hours as unknown as { [k: string]: unknown }
     });
+    await this._refreshIfDirect();
+    return result;
   }
 
   /**

package/src/api/Project.ts

@@ -362,6 +362,20 @@ export class Project extends BaseEntity<ProjectItemNormalized> {
     return super.news(newsData);
   }
 
+  /**
+   * Vérifie qu'un milestoneId existe dans `serverData.oceco.milestones[]`.
+   * Sert à valider une référence avant d'attacher une entité (Action) à un milestone.
+   *
+   * @param milestoneId - L'ID du milestone à chercher.
+   * @returns `true` si trouvé, `false` sinon (y compris si oceco/milestones absents).
+   */
+  hasMilestone(milestoneId: string): boolean {
+    if (typeof milestoneId !== "string" || milestoneId.length === 0) return false;
+    const milestones = (this.serverData.oceco as { milestones?: Array<{ milestoneId?: string }> } | undefined)?.milestones;
+    if (!Array.isArray(milestones)) return false;
+    return milestones.some(m => m?.milestoneId === milestoneId);
+  }
+
   /**
    * {@inheritDoc BaseEntity#action}
    *