@communecter/cocolight-api-client 1.0.150 → 1.0.152

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@communecter/cocolight-api-client",
-    "version": "1.0.150",
+    "version": "1.0.152",
     "description": "Client Axios simplifié pour l'API cocolight",
     "repository": {
         "type": "git",
@@ -45,7 +45,8 @@
         "generate:module:publish": "node ./scripts/transform-json-module.publish.js",
         "generate:doc": "node ./scripts/generate-doc.js",
         "generate:reponses": "node ./scripts/generate-constant-response-200.js",
-        "generate:methodeapi": "node ./scripts/generate-methode-api.js"
+        "generate:methodeapi": "node ./scripts/generate-methode-api.js",
+        "generate:costum": "node ./scripts/generate-costum-extensions.js"
     },
     "keywords": [
         "communecter",

package/src/api/BaseEntity.ts

@@ -48,6 +48,7 @@ import type {
   ProfilBannerData,
   SearchMemberAutocompleteData,
   GetEventsData,
+  SearchEventsCostumData,
   CostumFilterCoformData,
   CostumFilterCoformByPathData,
   GetCountriesData,
@@ -261,6 +262,18 @@ export type CostumContextFields = {
 
 export type WithCostumContext<T> = T & CostumContextFields;
 
+/**
+ * Bornes d'agenda acceptant un `Date` (coercé en ISO par la méthode avant l'envoi — le fil reste
+ * `type:string`). Partagé par `searchEventsCostum` et `getEvents`.
+ */
+type AgendaDateInputs = { startDateUTC?: Date | string; endDateUTC?: Date | string };
+/** Entrée de `searchEventsCostum` : la request, mais les bornes acceptent un `Date`. */
+export type SearchEventsCostumInput =
+  Omit<Partial<SearchEventsCostumData>, keyof AgendaDateInputs> & AgendaDateInputs;
+/** Entrée de `getEvents` : la request, mais les bornes acceptent un `Date`. */
+export type GetEventsInput =
+  Omit<Partial<GetEventsData>, keyof AgendaDateInputs> & AgendaDateInputs;
+
 /**
  * Une valeur distincte d'une thématique CoForm (retournée par `coformFilterByPath`).
  */
@@ -803,7 +816,11 @@ export class BaseEntity<TServerData = any> {
       const v = fullData[key];
       const isClear = v === null || v === "" || (Array.isArray(v) && v.length === 0);
       changed[key] = isClear ? "" : v; // clear → "" : survit à stripNulls, backend prepElementData → $unset
-      props[key] = this._lookupPropSchema(combined, key) ?? (costumProps[key] as unknown) ?? {};
+      // Schéma porté dans l'enveloppe (validation AJV de requête). Pour un EFFACEMENT, on envoie le sentinel
+      // "" : le schéma STRICT du champ (ex. socialNetwork = objet, openingHours = array) rejetterait "" →
+      // "Request validation failed". On porte donc un schéma PERMISSIF ({}) pour la clé effacée (le "" est le
+      // sentinel voulu ; le backend prepElementData fait le $unset). Sinon, schéma réel du champ.
+      props[key] = isClear ? {} : (this._lookupPropSchema(combined, key) ?? (costumProps[key] as unknown) ?? {});
     }
 
     let didSave = false;
@@ -2901,7 +2918,23 @@ export class BaseEntity<TServerData = any> {
    */
   async entity<T extends keyof EntityTypeMap>(entityType: T, entityData: object = {}, config: BaseEntityConfig = {}): Promise<EntityTypeMap[T]> {
     try {
-      const entity = this._entityInstanceData(entityType, entityData, config);
+      // Propagation du scope costum aux ENFANTS créés (chaîne `scope.org().project()` / parent-create
+      // `parent.poi()`) : si CE parent porte un `_costumCtx` et que l'appelant n'a PAS fourni de costumCtx
+      // explicite, l'enfant hérite de l'IDENTITÉ (slug/costumId/costumType = source.key) MAIS avec l'overlay
+      // de champs RE-RÉSOLU pour SA collection (un projet ne reçoit pas les champs d'une org). Création
+      // seulement (un load id/slug fait foi via _setData/source.key).
+      let effectiveConfig = config;
+      if (config.costumCtx === undefined && this._costumCtx && !this._hasAtLeastOne(entityData, ["id", "slug"])) {
+        const p = this._costumCtx;
+        const childCollection = entityType as unknown as Collection;
+        const childCtx: CostumRuntimeContext = resolveCostumCtxFromSource(p.slug, childCollection) ?? {
+          slug: p.slug, costumId: p.costumId, costumType: p.costumType, collection: childCollection,
+          schema: { type: "object", additionalProperties: true, properties: {} },
+          fields: [], presets: {}, hidden: [],
+        };
+        effectiveConfig = { ...config, costumCtx: childCtx };
+      }
+      const entity = this._entityInstanceData(entityType, entityData, effectiveConfig);
 
       const fetchKeysByEntity = {
         citoyens: ["id", "slug"],
@@ -4111,16 +4144,24 @@ export class BaseEntity<TServerData = any> {
   /**
    * Récupérer les événements d'une entitée : liste des événements de l'entité ou elle est "organizer" ou "attendee".
    * Constant : GET_EVENTS
+   * `startDateUTC`/`endDateUTC` acceptent un `Date` ou une string ISO (un `Date` est coercé en ISO).
+   * `recurrency` est typé `false` (garde parité, comme `searchEventsCostum`) : omettre (récurrents inclus
+   * en mode calendrier) ou passer `false` (exclure) ; jamais `true` (le legacy `=== true` l'exclurait → divergence).
    * @param data - Paramètres (partiels) de recherche/pagination.
    * @returns - Les données de réponse.
    */
   async getEvents(
-    data: Partial<GetEventsData> = {},
+    data: GetEventsInput = {},
     options?: { restoredState?: PaginatorState }
   ): Promise<PaginatorPage<EventEntity>> {
-    data.searchType = this._getDefaultFromEndpoint("GET_EVENTS", "searchType") as GetEventsData["searchType"];
+    // DX : `startDateUTC`/`endDateUTC` acceptent un `Date` → coercé en ISO (un Date brut échouerait l'AJV
+    // `type:string`). Cf. convention R0 de normalisation de champs.
+    const finalInput: Partial<GetEventsData> = { ...(data as Partial<GetEventsData>) };
+    if (data.startDateUTC instanceof Date) finalInput.startDateUTC = data.startDateUTC.toISOString();
+    if (data.endDateUTC instanceof Date) finalInput.endDateUTC = data.endDateUTC.toISOString();
+    finalInput.searchType = this._getDefaultFromEndpoint("GET_EVENTS", "searchType") as GetEventsData["searchType"];
     const paginator = this._createPaginatorEngine({
-      initialData: data,
+      initialData: finalInput,
       methodName: "getEvents",
       restoredState: options?.restoredState,
       finalizer: async (finalData) => {
@@ -5257,6 +5298,66 @@ export class BaseEntity<TServerData = any> {
     return page;
   }
 
+  /**
+   * Agenda costum-aware : events scopés au costum (`source.key`) — pendant de `searchCostum` pour les events.
+   * `_withCostumContext` injecte `costumSlug`/`contextId`/`contextType` + `sourceKey=[serverData.slug]` → les
+   * events DU site/hôte costum (au lieu du filtre attendees/organizer FORCÉ de `getEvents`). À appeler sur
+   * l'entité HÔTE du costum (ex. l'entité du déploiement). `sourceKey` surchargeable (agenda multi-sites / réseau).
+   *
+   * **Deux modes** (endpoint `/co2/search/agenda`), selon que tu passes une date ou non :
+   *
+   * 1. **CALENDRIER** — déclenché par `startDateUTC` et/ou `endDateUTC` (l'agenda d'une période) :
+   *    ramène **TOUT** ce qui matche la plage — ponctuels **+ récurrents** (`openingHours`, sauf `recurrency:false`) —
+   *    trié par **occurrence** (`startDateSort`/`startDateSortFormat` calculés côté serveur), résultat = **tableau**.
+   *    **Pas de pagination** serveur : une seule page (`next()`/`prev()` sans effet).
+   * 2. **LISTE** — déclenché par l'**absence** de date (flux paginé) :
+   *    **ponctuels uniquement** (récurrents exclus), triés par `startDate` **décroissant** (plus récents d'abord),
+   *    paginés via `indexMin`/`indexStep` (défaut 30) — `next()`/`prev()` fonctionnent. (Backend : objet keyé `_id`,
+   *    hydraté en tableau d'`Event` côté lib.)
+   *
+   * Le scope costum (`sourceKey`) s'applique dans les **deux** modes.
+   *
+   * `recurrency` est typé `false` (garde parité) : **omettre** (mode calendrier → récurrents inclus) ou passer
+   * `false` (exclure) ; **jamais `true`** — le legacy fait un test strict `=== true` qui exclurait les récurrents
+   * (divergence), valeur donc interdite au type **et** à l'AJV.
+   *
+   * `startDateUTC`/`endDateUTC` acceptent un **`Date` ou une string ISO** : un `Date` est coercé en ISO
+   * (`toISOString()`) avant l'envoi (le fil reste `type:string`). Évite le piège de l'ISO partielle
+   * (`"2026-06-01"` n'est pas un `date-time` AJV valide).
+   *
+  // Mode CALENDRIER — agenda du mois, avec de vrais Date
+   * const debut = new Date("2026-06-01T00:00:00Z");
+   * const page = await org.searchEventsCostum({ startDateUTC: debut, endDateUTC: new Date("2026-06-30T23:59:59Z") });
+   * page.results.forEach((e) => console.log(e.serverData.name, e.serverData.startDateSort));
+   *
+  // Mode LISTE — flux paginé (ponctuels, du plus récent)
+   * let p = await org.searchEventsCostum({ indexStep: 20 });
+   * if (p.hasNext) p = await p.next();
+   */
+  async searchEventsCostum(
+    data: SearchEventsCostumInput = {},
+    options?: { restoredState?: PaginatorState }
+  ): Promise<PaginatorPage<EventEntity>> {
+    // DX : coerce les `Date` en ISO (un objet Date échouerait la validation AJV `type:string`) — suit
+    // la convention de normalisation de champs de la lib (R0 : `Date` → `toISOString()`).
+    const finalInput: Partial<SearchEventsCostumData> = { ...(data as Partial<SearchEventsCostumData>) };
+    if (data.startDateUTC instanceof Date) finalInput.startDateUTC = data.startDateUTC.toISOString();
+    if (data.endDateUTC instanceof Date) finalInput.endDateUTC = data.endDateUTC.toISOString();
+    finalInput.searchType = this._getDefaultFromEndpoint("SEARCH_EVENTS_COSTUM", "searchType") as SearchEventsCostumData["searchType"];
+    const paginator = this._createPaginatorEngine({
+      initialData: finalInput,
+      methodName: "searchEventsCostum",
+      restoredState: options?.restoredState,
+      finalizer: this._withCostumContext(
+        (finalData: SearchEventsCostumData) => {
+          delete (finalData as { pathParams?: unknown }).pathParams;
+          return this.endpointApi.searchEventsCostum(finalData);
+        }
+      ),
+    });
+    return paginator.next() as Promise<PaginatorPage<EventEntity>>;
+  }
+
   /**
    * @param data
    *        Paramètres de recherche (partiels — les valeurs manquantes sont complétées

package/src/api/EndpointApi.ts

@@ -2,7 +2,7 @@
 import { ApiAuthenticationError } from "../error.js";
 
 import type ApiClient from "../ApiClient.js";
-import type { DocumentListData, 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, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData } from "./EndpointApi.types.js";
+import type { DocumentListData, 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, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData } from "./EndpointApi.types.js";
 
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
@@ -1366,6 +1366,21 @@ export class EndpointApi {
     return this.call("GET_EVENTS", data);
   }
 
+  /**
+   * Recherche d'events scopée costum (agenda) : Agenda costum-aware : events filtrés par sourceKey/costum + plage de dates. Même endpoint /co2/search/agenda que GET_EVENTS, mais surface costum (PAS le filtre attendees/organizer forcé de GET_EVENTS). Réponse = cible-co2-search-agenda.
+   * Constant : SEARCH_EVENTS_COSTUM
+   * @param data - Données envoyées à l'API
+   * @returns Les données de réponse.
+   * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+   * @throws {Error} - En cas d'erreur inattendue.
+   */
+  async searchEventsCostum(data: SearchEventsCostumData): Promise<any> {
+    if (!data || typeof data !== "object") {
+      throw new TypeError("Le paramètre data doit être un objet.");
+    }
+    return this.call("SEARCH_EVENTS_COSTUM", data);
+  }
+
   /**
    * Partager un événement : Partage un événement avec d’autres utilisateurs ou entités.
    * Constant : SHARE_EVENTS