@communecter/cocolight-api-client 1.0.173 → 1.0.180

package/package.json

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

package/types/api/BaseEntity.d.ts

@@ -1999,12 +1999,20 @@ export declare class BaseEntity<TServerData = any> {
         result: boolean;
         msg?: string;
     }>;
-    /** Retire l'élément (type,id) de `reference.costum` du costum de cette entité + nettoie les liens. */
+    /**
+     * Retire l'élément (type,id) de `reference.costum` du costum de cette entité.
+     * ⚠ PAS de `costumId`/`costumType` : aucun caller legacy n'envoie ces clés (institutBleu/meir/
+     * essConnect admin.js postent `{id, type, origin, sourceKey}`), et leur présence déclenche la
+     * branche « Clean links » de `Admin::removeSourceFromElement` — fatale (500) pour les types
+     * absents de `Link::$linksTypes[parent]` (poi…), et destructrice pour les autres (elle
+     * déconnecterait de VRAIS liens membres entre le porteur et l'élément dé-référencé).
+     */
     removeReference(type: string, id: string): Promise<{
         result: boolean;
         msg?: string;
     }>;
-    /** Détache l'élément (type,id) de `source.keys` du costum de cette entité (dé-rattachement) + nettoie les liens. */
+    /** Détache l'élément (type,id) de `source.keys` du costum de cette entité (dé-rattachement). Même
+     *  parité de payload que `removeReference` : jamais `costumId`/`costumType`. */
     removeFromSource(type: string, id: string): Promise<{
         result: boolean;
         msg?: string;
@@ -2289,6 +2297,43 @@ export declare class BaseEntity<TServerData = any> {
     }): {
         next: () => Promise<PaginatorPage<TOut>>;
     };
+    /**
+     * PÉRIMÈTRE d'une lecture de RELATION (« mes organisations », « les événements de cette orga »…).
+     *
+     * Ces lectures étaient réseau-wide par construction : le contrat imposait `notSourceKey: true`
+     * (`const` + `default`), le client ne pouvait donc rien demander d'autre. Le contrat a été ouvert ;
+     * ce helper porte désormais la règle, pour les neuf méthodes concernées.
+     *
+     * TROIS CAS, et un seul est neuf :
+     *  • l'appelant a tranché lui-même (`notSourceKey` présent dans ses données) → on ne touche à rien ;
+     *  • il demande un périmètre costum (`sourceKey` non vide) → la clé reste ABSENTE du corps ;
+     *  • il ne demande rien → on repose `notSourceKey: true`, le défaut historique, à l'octet près.
+     *
+     * POURQUOI L'ABSENCE, et pas `notSourceKey: false`. La garde serveur est un `empty()`
+     * (`SearchNew.php:999-1002`, et son portage `shared/search.ts:389-391`) :
+     * `if (!empty(sourceKey) && empty(notSourceKey)) buildSourceKey(...)`. Or ces endpoints sont en
+     * `x-www-form-urlencoded` : un `false` part sur le fil en chaîne `"false"`, et `empty("false")` vaut
+     * FAUX. Envoyer `false` désactiverait donc le périmètre exactement comme `true` — la clé est active
+     * dès qu'elle est PRÉSENTE. C'est aussi pourquoi le `default` a dû quitter le contrat : l'AJV du
+     * client tourne en `useDefaults` et l'aurait réinjectée après le finalizer.
+     */
+    protected _applyRelationScope<T extends Record<string, unknown>>(finalData: T): T;
+    /**
+     * Fusionne la clause de RELATION (appartenance, contribution, parenté…) avec les `filters` de
+     * l'appelant, au lieu de l'écraser — et ne pose RIEN quand l'appelant n'envoie pas de `filters`, pour
+     * que le défaut du contrat (résolu par AJV) reste la source et que le corps émis ne bouge pas.
+     *
+     * L'écrasement était la règle jusqu'ici (`getProjects`, `getEvents`, branches non-`isMe`), et il rend
+     * le périmètre costum inutilisable : le `filters` métier de l'appelant emportait la clause. Le miroir
+     * inverse existait aussi — `User.getOrganizations` en `isMe` laissait le `filters` de l'appelant
+     * REMPLACER le défaut d'appartenance, et la liste devenait « toutes les entités » au lieu de
+     * « les miennes ». `getEligiblePlaces` était seul à fusionner ; c'est ce comportement qu'on généralise.
+     */
+    protected _mergeRelationFilters<T extends {
+        filters?: unknown;
+    }>(finalData: T, clause: Record<string, unknown>, options?: {
+        always?: boolean;
+    }): T;
     /**
      * Injection de contexte Communecter dans une requête finalizer.
      */

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 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, GlobalAutocompleteAdminCostumData, 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, InviteMembersData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, DeleteCoformAnswerFileData, 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, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData } from "./EndpointApi.types.js";
+import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GlobalAutocompleteAdminCostumData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, CreateInvitationLinkData, ConnectByRefData, 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, InviteMembersData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, DeleteCoformAnswerFileData, 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, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -101,6 +101,15 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     passwordRecovery(data: PasswordRecoveryData): Promise<any>;
+    /**
+     * Nouveau mot de passe via le lien de récupération : ÉTAPE 2 du flux « mot de passe oublié » : applique le nouveau mot de passe à partir du code reçu par email. L'ÉTAPE 1 est PASSWORD_RECOVERY (POST /co2/person/sendemail), qui pose le code et envoie le lien `/recover/<user>/<code>` — c'est ce lien qui amène ici. ⚠️ SANS ÉQUIVALENT LEGACY — divergence de mécanisme ASSUMÉE et plus sûre : le legacy PHP réinitialise le mot de passe AVANT toute preuve de possession de l'adresse et l'envoie EN CLAIR dans le mail (SendEmailAction.php:39-57), alors qu'ici seul le porteur du code reçu peut changer le mot de passe. Le code est à USAGE UNIQUE et expire (24 h) : la vérification et l'écriture se font dans une seule opération conditionnelle côté backend. Échecs (code faux / expiré / déjà consommé / mot de passe trop court) : HTTP 200 `{result:false, msg}` — le message ne distingue pas les cas (anti-énumération). Anti-brute-force : 10 essais / 10 min par compte visé, 30 / 10 min par IP.
+     * Constant : PASSWORD_RESET
+     * @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.
+     */
+    passwordReset(data: PasswordResetData): Promise<any>;
     /**
      * Échange de token avec un autre serveur : Permet de se connecter à un autre serveur Communecter en échangeant un token.
      * Constant : SERVER_EXCHANGE_TOKEN
@@ -240,6 +249,16 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     multiconnect(data: MulticonnectData): Promise<any>;
+    /**
+     * Relancer une invitation : Renvoie l'e-mail d'invitation à un compte encore en attente d'activation (roles.tobeactivated). Programme un mail 'relaunchInvitation' avec le lien d'activation. Garde : super-admin OU l'invitant du compte (invitedBy). ⚠ Le port NE reproduit PAS le legacy laxiste (qui répond toujours 200 text/html même en refus, sans garde d'accès réelle) : réponse JSON {result,msg}, garde réelle, anti-abus (3/10min par cible). Refus si le compte est déjà activé.
+     * Constant : RELAUNCH_INVITATION
+     * @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.
+     */
+    relaunchInvitation(data: RelaunchInvitationData): Promise<any>;
     /**
      * Récupérer les actualités : Récupère la liste d’actualités selon plusieurs critères.
      * Constant : GET_NEWS
@@ -602,6 +621,26 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     connect(data: ConnectData): Promise<any>;
+    /**
+     * Générer un lien d'invitation partageable : Génère une URL d'invitation partageable /co2/link/connect/ref/<ref> vers un élément (organizations/projects/events). Tout citoyen connecté qui suit le lien rejoint l'élément IMMÉDIATEMENT (member, ou admin si isAdmin). L'appelant doit être ADMIN de la cible (ou super-admin). ⚠ Durcissements vs legacy : whitelist stricte des champs (pas de mass-assignment du body), ref cryptographique (le legacy dérivait uniqid()). Deux appels (isAdmin=true / false) alimentent costum.invitationLink / costum.invitationLinkAsMember côté UI.
+     * Constant : CREATE_INVITATION_LINK
+     * @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.
+     */
+    createInvitationLink(data: CreateInvitationLinkData): Promise<any>;
+    /**
+     * Rejoindre un élément par lien d'invitation : Consomme un lien d'invitation partageable (créé par CREATE_INVITATION_LINK). Le citoyen connecté est rattaché IMMÉDIATEMENT à l'élément cible (pas de toBeValidated), avec inviteByLink:true. Idempotent (déjà membre non-admin → no-op). Le legacy expose aussi un GET server-rendered pour les non-connectés (redirect + cookie) — non porté ; ici seule la branche connectée en JSON.
+     * Constant : CONNECT_BY_REF
+     * @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.
+     */
+    connectByRef(data: ConnectByRefData): Promise<any>;
     /**
      * Se déconnecter d'un élément : Permet de supprimer le lien entre un utilisateur et un élément.
      * Constant : DISCONNECT
@@ -1530,5 +1569,41 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     zoneGetZoniris(data: ZoneGetZonirisData): Promise<any>;
+    /**
+     * Valeurs d'une liste de costum : Résout UNE liste DYNAMIQUE déclarée d'un costum (costum.lists.<nom>) et renvoie ses VALEURS. Ne sert QUE les dynamiques — {collection,distinct,where} ou {type:badges,category} — car elles seules manquent au client : Costum::getAndConvertLists n'est appelée qu'au rendu des pages PHP et son résultat part dans le costum mis en cache, tandis que getcostumjson livre la déclaration BRUTE. Une liste STATIQUE (tableau, ou map valeur→libellé) porte au contraire ses valeurs dans sa déclaration : elle voyage déjà dans le costum que le client a en mémoire, la demander ici serait un aller-retour pour rien — elle est donc REFUSÉE, avec un message qui dit où la lire. La résolution est faite à la demande, hors cache : les valeurs sont FRAÎCHES, donc une valeur saisie librement apparaît aux suivants. Le client ne choisit ni la collection ni le champ — il demande une liste par son NOM, et c'est la déclaration en base qui porte collection/champ/filtre : la surface exposée est exactement celle que le costum a publiée. Une liste d'ENTITÉS ({collection,where,fields}) est refusée, ses clés étant des ObjectId et non des valeurs.
+     * Constant : COSTUM_LIST_VALUES
+     * @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.
+     */
+    costumListValues(data: CostumListValuesData): Promise<any>;
+    /**
+     * Annuaire des communs (AAP) : Annuaire des communs AAP (port SDK de DirectoryProposalAction → Aap::globalAutocompleteProposal, citizenToolKit). Gates appliqués par le serveur : form.params.onlyAdminCanSeeList (restreint aux propres réponses + status='vote' sauf admin OU membre porteur de rôles dans les listes aapStep2.canEdit ET aapStep3.canEdit — bypass filters.formStandalone). MODE NORMAL (liste).
+     * Constant : DIRECTORY_PROPOSAL
+     * @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.
+     */
+    directoryProposal(data: DirectoryProposalData): Promise<any>;
+    /**
+     * Annuaire des communs (AAP) — compte seul : Annuaire des communs AAP (port SDK de DirectoryProposalAction → Aap::globalAutocompleteProposal, citizenToolKit). Gates appliqués par le serveur : form.params.onlyAdminCanSeeList (restreint aux propres réponses + status='vote' sauf admin OU membre porteur de rôles dans les listes aapStep2.canEdit ET aapStep3.canEdit — bypass filters.formStandalone). MODE COUNTONLY (compte sans résultats).
+     * Constant : DIRECTORY_PROPOSAL_COUNT
+     * @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.
+     */
+    directoryProposalCount(data: DirectoryProposalCountData): Promise<any>;
+    /**
+     * Annuaire des communs (AAP) — compteur de non-vus : Annuaire des communs AAP (port SDK de DirectoryProposalAction → Aap::globalAutocompleteProposal, citizenToolKit). Gates appliqués par le serveur : form.params.onlyAdminCanSeeList (restreint aux propres réponses + status='vote' sauf admin OU membre porteur de rôles dans les listes aapStep2.canEdit ET aapStep3.canEdit — bypass filters.formStandalone). MODE NEWCOUNTER (non-vus de l'utilisateur de session).
+     * Constant : DIRECTORY_PROPOSAL_NEW_COUNTER
+     * @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.
+     */
+    directoryProposalNewCounter(data: DirectoryProposalNewCounterData): Promise<any>;
 }
 export default EndpointApi;