@communecter/cocolight-api-client 1.0.154 → 1.0.156

package/src/api/Organization.ts

@@ -1,771 +0,0 @@
-import { ApiError } from "../error.js";
-import { BaseEntity } from "./BaseEntity.js";
-import { createSocialTransform } from "../types/transforms.js";
-
-import type { PaginatorPage, PaginatorState } from "./BaseEntity.js";
-import type {
-  AddOrganizationData,
-  GetMembersAdminData,
-  GetMembersNoAdminData
-} from "./EndpointApi.types.js";
-import type { OpeningHoursEntry } from "./serverDataType/common.js";
-import type { OrganizationItemNormalized } from "./serverDataType/Organization.js";
-import type { User } from "./User.js";
-
-
-export class Organization extends BaseEntity<OrganizationItemNormalized> {
-  static override entityType = "organizations";
-
-  static override entityTag = "Organization";
-
-  /** Bloc de création où injecter les champs costum (CostumScope). */
-  static override COSTUM_ADD_CONSTANT = "ADD_ORGANIZATION";
-
-  static override SCHEMA_CONSTANTS: string[] = [
-    "ADD_ORGANIZATION",
-    "UPDATE_BLOCK_DESCRIPTION",
-    "UPDATE_BLOCK_INFO",
-    "UPDATE_BLOCK_SOCIAL",
-    "UPDATE_BLOCK_LOCALITY",
-    "UPDATE_BLOCK_SLUG",
-    "PROFIL_IMAGE",
-    "VIRTUAL_OPENING_HOURS",
-    "VIRTUAL_ORG_BASE_FIELDS"
-  ];
-
-  static override VIRTUAL_SCHEMAS = {
-    VIRTUAL_OPENING_HOURS: {
-      type: "object",
-      properties: {
-        openingHours: {
-          type: "array",
-          description: "Horaires d'ouverture (7 jours de la semaine)",
-          minItems: 7,
-          maxItems: 7,
-          items: {
-            oneOf: [
-              {
-                type: "string",
-                const: ""
-              },
-              {
-                type: "object",
-                properties: {
-                  dayOfWeek: {
-                    type: "string",
-                    enum: ["Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"],
-                    description: "Jour de la semaine"
-                  },
-                  hours: {
-                    type: "array",
-                    description: "Liste des créneaux horaires",
-                    items: {
-                      type: "object",
-                      properties: {
-                        opens: {
-                          type: "string",
-                          pattern: "^([01]\\d|2[0-3]):[0-5]\\d$",
-                          description: "Heure d'ouverture (HH:MM)"
-                        },
-                        closes: {
-                          type: "string",
-                          pattern: "^([01]\\d|2[0-3]):[0-5]\\d$",
-                          description: "Heure de fermeture (HH:MM)"
-                        }
-                      },
-                      required: ["opens", "closes"],
-                      additionalProperties: false
-                    }
-                  }
-                },
-                required: ["dayOfWeek", "hours"],
-                additionalProperties: false
-              }
-            ]
-          }
-        }
-      }
-    },
-    /**
-     * Champs de BASE (DATA_BINDING) sans `UPDATE_BLOCK_*` dédié : `telephone`/`video`. Déclarés ici
-     * pour être writable sur le draft, persistés à l'édition via CUSTOM_FIELD_HANDLERS → UPDATE_PATH_VALUE.
-     * (Les champs TIERS-LIEU costum — holderOrganization/manageModel/typePlace/buildingSurfaceArea/
-     * siteSurfaceArea/openingDate — sont désormais gérés par CostumScope/auto-derive, cf. inc1b/inc2.)
-     */
-    VIRTUAL_ORG_BASE_FIELDS: {
-      type: "object",
-      properties: {
-        telephone: { type: "string" },
-        video:     { type: "array", items: { type: "string" } }
-      }
-    }
-  };
-
-  static override CUSTOM_FIELD_HANDLERS = new Map([
-    ["openingHours", {
-      updateMethod: "updateOpeningHours",
-      schemaConstant: "VIRTUAL_OPENING_HOURS"
-    }],
-    ["telephone", { updateMethod: "updateTelephone", schemaConstant: "VIRTUAL_ORG_BASE_FIELDS" }],
-    ["video",     { updateMethod: "updateVideo",     schemaConstant: "VIRTUAL_ORG_BASE_FIELDS" }]
-  ] as const);
-
-  static ADD_BLOCKS = new Map([
-    ["ADD_ORGANIZATION", "addOrganization"],
-    ["UPDATE_BLOCK_SOCIAL", "updateSocial"],
-    ["PROFIL_IMAGE", "updateImageProfil"]
-  ] as const);
-
-  static UPDATE_BLOCKS = new Map([
-    ["UPDATE_BLOCK_DESCRIPTION", "updateDescription"],
-    ["UPDATE_BLOCK_SOCIAL", "updateSocial"],
-    ["UPDATE_BLOCK_LOCALITY", "updateLocality"],
-    ["UPDATE_BLOCK_INFO", "updateInfo"],
-    ["UPDATE_BLOCK_SLUG", "updateSlug"],
-    ["PROFIL_IMAGE", "updateImageProfil"]
-  ] as const);
-
-  override defaultFields: Record<string, any> = {
-    typeElement: this.getEntityType()
-  };
-
-  override removeFields: string[] = [
-    "typeElement"
-  ];
-
-  // role = admin c'est bizarre car en faite c'est gérer dans links sur user et l'orga
-  // links.members.${this.userId}.isAdmin === true
-  override transforms: Record<string, (val: any, full: any) => any> = {
-    github: createSocialTransform("github"),
-    gitlab: createSocialTransform("gitlab"),
-    facebook: createSocialTransform("facebook"),
-    twitter: createSocialTransform("twitter"),
-    instagram: createSocialTransform("instagram"),
-    diaspora: createSocialTransform("diaspora"),
-    mastodon: createSocialTransform("mastodon"),
-    telegram: createSocialTransform("telegram"),
-    signal: createSocialTransform("signal")
-  };
-
-  /**
-   * Transforme les Answer docs imbriqués dans `data.answers` (renvoyé par /costum/navigator/gettl)
-   * en instances d'entité Answer. Le payload backend fait un PHDB::find(Answer::COLLECTION, ...) brut,
-   * donc on injecte `collection: "answers"` avant linkage pour rester cohérent avec les autres entités.
-   *
-   * Structure : `data.answers = { [formId]: AnswerDoc[] }` → `{ [formId]: Answer[] }`
-   * (le formId reste une string ; charger le Form se fait via `api.form({ id: formId })`).
-   *
-   * @protected
-   */
-  protected override _transformServerData(data: OrganizationItemNormalized): OrganizationItemNormalized {
-    const rawAnswers = (data as Record<string, unknown>).answers as Record<string, unknown[]> | undefined;
-    if (rawAnswers && typeof rawAnswers === "object") {
-      const linkedAnswers: Record<string, unknown[]> = {};
-      for (const [formId, docs] of Object.entries(rawAnswers)) {
-        // Le backend renvoie tantôt un tableau `[doc, ...]`, tantôt une map indexée
-        // par id `{ answerId: doc }`. On normalise vers un tableau dans les deux cas.
-        const list = Array.isArray(docs)
-          ? docs
-          : (docs && typeof docs === "object" ? Object.values(docs) : []);
-        linkedAnswers[formId] = list.map((doc) =>
-          doc && typeof doc === "object"
-            ? this._linkEntity("answers", { ...(doc as Record<string, unknown>), collection: "answers" })
-            : doc
-        );
-      }
-      (data as Record<string, unknown>).answers = linkedAnswers;
-    }
-    return data;
-  }
-
-  override _add = async (payload: Record<string, any>): Promise<void> => {
-    if (!this._calledFromSave) {
-      throw new ApiError("utilisation invalide de _add, utilisez save", 400);
-    }
-
-    payload.id = this._newId?.();
-    if (payload.slug) delete payload.slug;
-
-    for (const [constant, methodName] of Array.from(Organization.ADD_BLOCKS)) {
-      const isCreateBlock = constant === "ADD_ORGANIZATION";
-
-      // Pour les blocks secondaires (UPDATE_BLOCK_SOCIAL, PROFIL_IMAGE), on aligne sur
-      // la logique de `_update` : on retire `id` du payload et on filtre via removeFields
-      // (typeElement). Ces auto-fields sont ré-injectés par la méthode block via `this.id`
-      // / `getEntityType()`. Sans ça, le block est invoqué dès qu'il y a un auto-field
-      // dans l'extraction et AJV rejette pour anyOf manquant (ex: UPDATE_BLOCK_SOCIAL
-      // sans aucun champ social).
-      const blockPayload: Record<string, any> = { ...payload, ...this.defaultFields };
-      if (!isCreateBlock) delete blockPayload.id;
-
-      const blockData = this._extractChangedFieldsFromSchema(
-        this.apiClient,
-        constant,
-        blockPayload,
-        () => {},
-        isCreateBlock ? [] : this.removeFields
-      );
-      if (blockData && Object.keys(blockData).length > 0) {
-        const data = await this._invokeBlockMethod(Organization.ADD_BLOCKS, methodName, blockData);
-        if (!this.id && data?.map?.id) {
-          this._draftData.id = data.map.id;
-          this._draftData.slug = data.map.slug;
-        }
-      }
-    }
-  };
-
-  override _update = async (payload: Record<string, any>): Promise<boolean> => {
-    if(!this.isAdmin()){
-      throw new ApiError("Vous n'avez pas les droits pour modifier cette organisation", 403);
-    }
-
-    if (!this._calledFromSave) {
-      throw new ApiError("utilisation invalide de _update, utilisez save", 400);
-    }
-
-    // Entité costum-scopée : tout l'UPDATE part en UN `element/save` (pendant de l'ADD, hooks costum). cf. BaseEntity.
-    if (this._costumCtx) return this._saveCostumViaElementSave(payload);
-
-    if (payload.id) delete payload.id;
-    let hasChanged = false;
-
-    // 1. Traiter les champs personnalisés AVANT les block updates
-    const customHandlers = Organization.CUSTOM_FIELD_HANDLERS;
-    if (customHandlers) {
-      const processedFields = new Set<string>();
-
-      for (const [fieldName, config] of customHandlers) {
-        if (fieldName in payload && this._hasFieldChanged(fieldName)) {
-          await this._invokeCustomFieldHandler(
-            config.updateMethod,
-            payload[fieldName],
-            fieldName
-          );
-          processedFields.add(fieldName);
-          hasChanged = true;
-        }
-      }
-
-      // Retirer les champs traités du payload pour éviter qu'ils soient traités par les blocks
-      processedFields.forEach(f => delete payload[f]);
-    }
-
-    // 2. Traiter les block updates normaux
-    for (const [constant, methodName] of Array.from(Organization.UPDATE_BLOCKS)) {
-      const blockData = this._extractChangedFieldsFromSchema(
-        this.apiClient,
-        constant,
-        { ...payload, ...this.defaultFields },
-        () => this.initialDraftData,
-        this.removeFields
-      );
-      if (blockData && Object.keys(blockData).length > 0) {
-        await this._invokeBlockMethod(Organization.UPDATE_BLOCKS, methodName, blockData);
-        hasChanged = true;
-      }
-    }
-
-    return hasChanged;
-  };
-
-  /**
-   * Ajoute une organisation.
-   *
-   * @param data - Données de l'organisation à ajouter.
-   * @throws {ApiError} - Si l'utilisateur n'est pas connecté ou si l'entité n'est pas enregistrée.
-   */
-  async addOrganization(data: AddOrganizationData): Promise<unknown> {
-    return this.callIsConnected(() => this.endpointApi.addOrganization(data));
-  }
-
-  /**
-   * Supprime cette organisation via `DELETE_ELEMENT` (`type=organizations`).
-   *
-   * **Garde** : auteur (`serverData.creator`) OU administrateur direct de l'org
-   * (`userContext.links.memberOf[id].isAdmin`). Pas de hiérarchie parent (une org
-   * est racine). cf. {@link BaseEntity#_deleteViaElement}.
-   *
-   * ⚠️ **Destructif** : supprime l'organisation et potentiellement ses rattachements
-   * (projets/events/membres) côté serveur. À utiliser avec précaution.
-   *
-   * Après succès : données vidées + `_isDeleted = true`.
-   *
-   * @param reason - Raison transmise au backend (audit). Défaut `"delete organization"`.
-   * @throws {ApiError} 400 si l'org n'a pas d'id.
-   * @throws {ApiError} 403 si ni auteur ni admin.
-   */
-  async delete(reason: string = "delete organization"): Promise<void> {
-    await this._deleteViaElement(this.getEntityType(), reason);
-  }
-
-  override async getOrganizations(): Promise<never> {
-    throw new ApiError("getOrganizations n'existe pas dans Organization", 404);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#getProjects}
-   *
-   * Récupère les projets de l'organisation.
-   */
-  override async getProjects(data: Parameters<BaseEntity<OrganizationItemNormalized>["getProjects"]>[0] = {}) {
-    return super.getProjects(data);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#getEvents}
-   *
-   * Récupère les événements de l'organisation.
-   */
-  override async getEvents(data: Parameters<BaseEntity<OrganizationItemNormalized>["getEvents"]>[0] = {}) {
-    return super.getEvents(data);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#getPois}
-   *
-   * Récupère les points d'intérêt de l'organisation.
-   */
-  override async getPois(data: Parameters<BaseEntity<OrganizationItemNormalized>["getPois"]>[0] = {}) {
-    return super.getPois(data);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#getBadgesIssuer}
-   *
-   * Récupère les émetteurs de badges de l'organisation.
-   */
-  override async getBadgesIssuer(data: Parameters<BaseEntity<OrganizationItemNormalized>["getBadgesIssuer"]>[0] = {}) {
-    return super.getBadgesIssuer(data);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#getNews}
-   *
-   * Récupère les actualités de l'organisation.
-   */
-  override async getNews(data: Parameters<BaseEntity<OrganizationItemNormalized>["getNews"]>[0] = {}) {
-    return super.getNews(data);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#getSubscribers}
-   *
-   * Récupère les abonnés de l'organisation.
-   */
-  override async getSubscribers(data: Parameters<BaseEntity<OrganizationItemNormalized>["getSubscribers"]>[0] = {}) {
-    return super.getSubscribers(data);
-  }
-
-
-  /**
-   * Récupérer les membres de l'organisation.
-   * Constant : GET_MEMBERS_ADMIN / GET_MEMBERS_NO_ADMIN
-   * @param data - Paramètres (partiels) de recherche/pagination.
-   * @param options - Options supplémentaires.
-   * @param options.toBeValidated - Indique si les membres doivent être validés.
-   * @param options.isAdmin - Indique si l'utilisateur est admin.
-   * @param options.isAdminPending - Indique si l'utilisateur est en attente de validation pour être admin.
-   * @param options.isInviting - Indique si l'utilisateur est en attente d'invitation.
-   * @param options.roles - Liste des rôles à filtrer.
-   * @returns - Un objet contenant le nombre de membres et la liste des membres.
-   * @throws {ApiResponseError} - Si une erreur se produit lors de la récupération des contributeurs.
-   * 
-   * @example
-   * // Récupérer tous les membres
-   * const members = await organization.getMembers();
-   * 
-   * // Récupérer les membres avec validation en attente
-   * const membersToBeValidated = await organization.getMembers({}, { toBeValidated: true });
-   * 
-   * // Récupérer les membres avec un rôle spécifique
-   * const membersWithRole = await organization.getMembers({}, { roles: ['admin'] });
-   * 
-   * // Récupérer les membres en attente d'invitation
-   * const invitingMembers = await organization.getMembers({}, { isInviting: true });
-   * 
-   * // Récupérer les membres admin
-   * const adminMembers = await organization.getMembers({}, { isAdmin: true });
-   * 
-   * // Récupérer les membres admin et en attente d'invitation
-   * const adminInvitingMembers = await organization.getMembers({}, { isAdmin: true, isInviting: true });
-   * 
-   * // Récupérer les membres avec validation en attente et admin
-   * const adminToBeValidatedMembers = await organization.getMembers({}, { toBeValidated: true, isAdmin: true });
-   * 
-   * // Récupérer les membres en attente de validation pour être admin
-   * const adminPendingMembers = await organization.getMembers({}, { isAdminPending: true });
-   *
-   * // Restreindre la recherche : uniquement les citoyens
-   * const onlyCitoyens = await organization.getMembers({}, { searchType: "citoyens" });
-   *
-   * // Restreindre la recherche : uniquement les organisations
-   * const onlyOrgas = await organization.getMembers({}, { searchType: "organizations" });
-   */
-  async getMembers(
-    data: Partial<GetMembersAdminData | GetMembersNoAdminData> = {},
-    options: {
-      toBeValidated?: boolean;
-      isAdmin?: boolean;
-      isAdminPending?: boolean;
-      isInviting?: boolean;
-      roles?: any[];
-      searchType?: "all" | "citoyens" | "organizations";
-      restoredState?: PaginatorState;
-    } = {}
-  ): Promise<PaginatorPage<User | Organization>> {
-
-    if(!this.id) {
-      throw new ApiError("L'organisation n'est pas définie, impossible de récupérer les membres", 400);
-    }
-
-    /** « Snapshot » local, typé string */
-    const orgId = this.id as string;
-
-    const allTypes = this._getDefaultFromEndpoint("GET_MEMBERS_ADMIN", "searchType") as GetMembersAdminData["searchType"];
-    if (options.searchType === "citoyens") {
-      data.searchType = ["citoyens"];
-    } else if (options.searchType === "organizations") {
-      data.searchType = allTypes.filter(t => t !== "citoyens") as GetMembersAdminData["searchType"];
-    } else {
-      data.searchType = allTypes;
-    }
-
-    const paginator = this._createPaginatorEngine({
-      initialData: data,
-      methodName: "getMembers",
-      restoredState: options?.restoredState,
-      finalizer: async (finalData) => {
-
-        const { toBeValidated, isAdmin, isAdminPending, isInviting, roles = [] } = options;
-
-        if(this.isMe){
-          finalData.pathParams = { id: this.id };
-          // finalData.filters = {
-          //   [`links.memberOf.${this.id}`]: { "$exists": true },
-          //   [`links.memberOf.${this.id}.toBeValidated`]: { "$exists": false },
-          //   [`links.memberOf.${this.id}.isInviting`]: { "$exists": false }
-          // };
-          finalData.filters = this._buildLinkFilters(orgId, { linkType: "memberOf", toBeValidated, isAdmin, isAdminPending, isInviting, roles });
-        } else {
-          delete finalData?.pathParams;
-          finalData.filters = this._buildLinkFilters(orgId, { linkType: "memberOf", toBeValidated: false, isAdmin, isInviting, roles });
-        }
-  
-        const fetchFn = this.isMe
-          ? () => this.callIsMe(() => this.endpointApi.getMembersAdmin(finalData))
-          : () => this.endpointApi.getMembersNoAdmin(finalData);
-
-        return fetchFn();
-      }
-    });
-
-    return paginator.next() as Promise<PaginatorPage<User | Organization>>;
-  }
-
-  /**
-   * Récupère les organisations dont **cette** organisation est membre
-   * (lien montant : réseau, fédération, collectif… dont l'orga fait partie).
-   *
-   * C'est le miroir de {@link Organization#getMembers} : `getMembers()` liste
-   * *qui* est membre de cette orga, tandis que `getMemberOf()` liste *les orgas
-   * dont cette orga est elle-même membre*.
-   *
-   * Contrairement à {@link BaseEntity#getOrganizations} (désactivée ici car pensée
-   * pour un citoyen via `GET_ORGANIZATIONS_*`), on passe par la recherche réseau
-   * globale `searchCostum` : on cible `searchType: ["organizations"]` et on filtre
-   * sur `links.members.{thisOrgId}`. Seules les adhésions **confirmées** sont
-   * retournées (les liens `toBeValidated` et `isInviting` sont exclus).
-   *
-   * La pagination (`hasNext`/`next()`) et la restauration via `restoredState`
-   * fonctionnent comme pour `searchCostum` : le filtre membership est conservé
-   * d'une page à l'autre.
-   *
-   * @param data - Paramètres de recherche/pagination additionnels (`name`, `indexStep`,
-   *   `sortBy`, `locality`, `filters` complémentaires…). Les `filters` fournis sont
-   *   fusionnés avec le filtre membership, ce dernier restant prioritaire.
-   * @param options - Options. `restoredState` pour reprendre une pagination sérialisée.
-   * @returns Première page paginée d'organisations.
-   * @throws {ApiError} Si l'organisation n'a pas d'`id`.
-   *
-   * @example
-   * // Toutes les orgas dont cette orga est membre
-   * const page = await org.getMemberOf();
-   * console.log(page.results, page.count.total);
-   *
-   * @example
-   * // Filtrer par nom + pagination plus large
-   * const page = await org.getMemberOf({ name: "réseau", indexStep: 50 });
-   * if (page.hasNext) await page.next();
-   */
-  async getMemberOf(
-    data: Parameters<BaseEntity<OrganizationItemNormalized>["searchCostum"]>[0] = {},
-    options: { restoredState?: PaginatorState } = {}
-  ): Promise<PaginatorPage<Organization>> {
-    if (!this.id) {
-      throw new ApiError("L'organisation n'est pas définie, impossible de récupérer ses adhésions", 400);
-    }
-
-    const path = `links.members.${this.id}`;
-    const membershipFilters = {
-      [path]: { $exists: true },
-      [`${path}.toBeValidated`]: { $exists: false },
-      [`${path}.isInviting`]: { $exists: false }
-    };
-    const callerFilters = (data?.filters && typeof data.filters === "object") ? data.filters : {};
-
-    const orgParam: Parameters<typeof this.searchCostum>[0] = {
-      indexMin: 0,
-      indexStep: 20,
-      notSourceKey: true,
-      ...data,
-      // Champs imposés (le caller ne peut pas casser la sémantique « adhésions »)
-      searchType: ["organizations"],
-      countType: ["organizations"],
-      count: true,
-      filters: { ...callerFilters, ...membershipFilters }
-    };
-
-    return this.searchCostum(orgParam, options) as Promise<PaginatorPage<Organization>>;
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#getGallery}
-   *
-   * Récupère la galerie de l'organisation.
-   */
-  override async getGallery(data: Parameters<BaseEntity<OrganizationItemNormalized>["getGallery"]>[0] = {}) {
-    return super.getGallery(data);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#project}
-   *
-   * Crée une instance de projet et récupère son profil si nécessaire.
-   */
-  override async project(projectData: Parameters<BaseEntity<OrganizationItemNormalized>["project"]>[0] = {}) {
-    if(!this.isAdmin()){
-      throw new ApiError("Vous n'avez pas les droits pour créer un projet dans cette organisation", 403);
-    }
-    return super.project(projectData);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#poi}
-   *
-   * Crée une instance de POI et la récupère si nécessaire.
-   */
-  override async poi(poiData: Parameters<BaseEntity<OrganizationItemNormalized>["poi"]>[0] = {}) {
-    if(!this.isAdmin()){
-      throw new ApiError("Vous n'avez pas les droits pour créer un poi dans cette organisation", 403);
-    }
-    return super.poi(poiData);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#event}
-   *
-   * Crée une instance d'événement et la récupère si nécessaire.
-   */
-  override async event(eventData: Parameters<BaseEntity<OrganizationItemNormalized>["event"]>[0] = {}) {
-    if(!this.isAdmin()){
-      throw new ApiError("Vous n'avez pas les droits pour créer un event dans cette organisation", 403);
-    }
-    return super.event(eventData);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#badge}
-   *
-   * Crée une instance de badge et la récupère si nécessaire.
-   */
-  override async badge(badgeData: Parameters<BaseEntity<OrganizationItemNormalized>["badge"]>[0] = {}) {
-    if(!this.isAdmin()){
-      throw new ApiError("Vous n'avez pas les droits pour créer un badge dans cette organisation", 403);
-    }
-    return super.badge(badgeData);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#news}
-   *
-   * Crée une instance de news et la récupère si nécessaire.
-   */
-  override async news(newsData: Parameters<BaseEntity<OrganizationItemNormalized>["news"]>[0] = {}) {
-    // TODO: qui peut créer une news sur l'organisation ?
-    return super.news(newsData);
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#form}
-   *
-   * Crée une instance de Form dans le contexte de cette organisation : le Form aura
-   * `this.parent = Organization`, ce qui permet à `form.getAnswers()` de déléguer
-   * `coformAnswersSearch` avec le bon costumContext.
-   */
-  override async form(formData: Parameters<BaseEntity<OrganizationItemNormalized>["form"]>[0] = {}) {
-    return super.form(formData);
-  }
-
-  /**
-   * Met à jour les horaires d'ouverture de l'organisation.
-   * Utilise UPDATE_PATH_VALUE pour modifier le champ openingHours.
-   *
-   * @param hours - Tableau de 7 entrées (une par jour de la semaine)
-   * @returns Résultat de l'appel API
-   * @throws {ApiError} Si l'organisation n'a pas d'ID
-   *
-   * @example
-   * const openingHours = [
-   *   { dayOfWeek: "Mo", hours: [{ opens: "09:00", closes: "18:00" }] },
-   *   { dayOfWeek: "Tu", hours: [{ opens: "09:00", closes: "18:00" }] },
-   *   // ... pour les 7 jours
-   * ];
-   * await org.updateOpeningHours(openingHours);
-   */
-  async updateOpeningHours(hours: OpeningHoursEntry[]): Promise<unknown> {
-    const result = await this.updateField("openingHours", hours);
-    await this._refreshIfDirect();
-    return result;
-  }
-
-  /**
-   * ───────────────────────────────
-   *  Champs de BASE sans `UPDATE_BLOCK_*` dédié : `telephone` / `video` (dispatch UPDATE_PATH_VALUE).
-   *  Les champs TIERS-LIEU costum (holderOrganization/manageModel/typePlace/buildingSurfaceArea/
-   *  siteSurfaceArea/openingDate) sont gérés par CostumScope (création) + auto-derive de `_costumCtx`
-   *  depuis `source.key` (chargement) → dispatch générique `_dispatchCostumFieldUpdates`. cf. inc1b/inc2.
-   * ───────────────────────────────
-   */
-
-  /** Met à jour `telephone` (téléphone de la structure, distinct des champs citoyen fixe/mobile). */
-  async updateTelephone(value: string): Promise<unknown> {
-    const result = await this.updateField("telephone", value);
-    await this._refreshIfDirect();
-    return result;
-  }
-
-  /** Met à jour `video` (liste d'URLs de vidéos de présentation). */
-  async updateVideo(value: string[]): Promise<unknown> {
-    if (!Array.isArray(value)) {
-      throw new ApiError(`video: attendu tableau d'URLs. Reçu: ${JSON.stringify(value)}`, 400);
-    }
-    const result = await this.updateField("video", value);
-    await this._refreshIfDirect();
-    return result;
-  }
-
-  /**
-   * ───────────────────────────────
-   *  Lien utilisateur ↔ organisation
-   *  (rejoindre, valider, quitter, devenir admin)
-   * ───────────────────────────────
-   */
-
-
-  /**
-   * {@inheritDoc BaseEntity#requestToJoin}
-   *
-   * Envoie une demande pour rejoindre l'organisation en tant que membre.
-   * L'action est soumise à validation par un administrateur de l'organisation.
-   */
-  override async requestToJoin() {
-    return super.requestToJoin();
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#requestToJoinAdmin}
-   *
-   * Envoie une demande pour rejoindre l'organisation en tant qu'administrateur.
-   * L'action est soumise à validation par un administrateur existant.
-   */
-  override async requestToJoinAdmin() {
-    return super.requestToJoinAdmin();
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#acceptInvitation}
-   *
-   * Accepte une invitation à rejoindre l'organisation.
-   * Cette action valide un lien en attente avec l'option `isInviting`.
-   */
-  override async acceptInvitation() {
-    return super.acceptInvitation();
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#requestPromoteToAdmin}
-   *
-   * Envoie une demande de promotion en tant qu'administrateur de l'organisation.
-   * L'utilisateur doit déjà être membre de l'organisation.
-   */
-  override requestPromoteToAdmin() {
-    return super.requestPromoteToAdmin();
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#leave}
-   *
-   * Quitte l'organisation, que ce soit en tant que membre ou administrateur.
-   * Cette action supprime le lien entre l'utilisateur et l'organisation.
-   */
-  override async leave() {
-    return super.leave();
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#follow}
-   *
-   * Suivre une organisation.
-   * Cette action permet à l'utilisateur de suivre l'organisation.
-   */
-  override async follow() {
-    return super.follow();
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#unfollow}
-   *
-   * Se désabonne d'une organisation.
-   */
-  override async unfollow() {
-    return super.unfollow();
-  }
-
-  /**
-   * ───────────────────────────────
-   *  costum
-   * ───────────────────────────────
-   */
-
-  /**
-   * {@inheritDoc BaseEntity#getCostumJson}
-   *
-   * Récupère le JSON personnalisé de l'organisation.
-   */
-  override async getCostumJson() {
-    return super.getCostumJson();
-  }
-
-  /**
-   * {@inheritDoc BaseEntity#searchCostum}
-   *
-   * Cette surcharge précise que la recherche est faite dans le contexte de l'organisation.
-   */
-  override async searchCostum(
-    data: Parameters<BaseEntity<OrganizationItemNormalized>["searchCostum"]>[0],
-    options?: Parameters<BaseEntity<OrganizationItemNormalized>["searchCostum"]>[1]
-  ) {
-    return super.searchCostum(data, options);
-  }
-
-  /**
-    * {@inheritDoc BaseEntity#coformAnswersSearch}
-    * 
-    * Cette méthode est redéfinie ici pour fournir des types spécifiques à l'entité Answer.
-    */
-  override async coformAnswersSearch(data: Parameters<BaseEntity<OrganizationItemNormalized>["coformAnswersSearch"]>[0]) {
-    return super.coformAnswersSearch(data);
-  }
-
-}