@communecter/cocolight-api-client 1.0.179 → 1.0.181

package/package.json

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

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, CostumListValuesData } 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
@@ -1539,5 +1578,32 @@ export declare class EndpointApi {
      * @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;

package/types/api/EndpointApi.types.d.ts

@@ -79,6 +79,21 @@ export interface PasswordRecoveryData {
     type: "password";
     [k: string]: unknown;
 }
+export interface PasswordResetData {
+    /**
+     * Identifiant (_id) du compte, extrait du lien de récupération
+     */
+    user: string;
+    /**
+     * Code de récupération, extrait du lien (usage unique, expire au bout de 24 h)
+     */
+    code: string;
+    /**
+     * Nouveau mot de passe (8 caractères minimum — même règle que CHANGE_PASSWORD)
+     */
+    newPassword: string;
+    [k: string]: unknown;
+}
 export interface ServerExchangeTokenData {
     /**
      * URL du serveur distant
@@ -494,6 +509,13 @@ export interface MulticonnectData {
     };
     [k: string]: unknown;
 }
+export interface RelaunchInvitationData {
+    /**
+     * _id du compte invité à relancer
+     */
+    id: string;
+    [k: string]: unknown;
+}
 export interface GetNewsData {
     /**
      * Limite de date timestamp ou 0
@@ -2737,6 +2759,39 @@ export interface ConnectData {
     connectType: "admin" | "member" | "contributor" | "attendee" | "friend" | "connect";
     [k: string]: unknown;
 }
+export interface CreateInvitationLinkData {
+    /**
+     * Type de l'élément cible
+     */
+    targetType: "organizations" | "projects" | "events";
+    /**
+     * _id de l'élément cible
+     */
+    targetId: string;
+    /**
+     * true → le lien confère le rôle admin ; défaut member
+     */
+    isAdmin?: boolean | string;
+    /**
+     * Rôles costum à poser sur le lien créé (optionnel)
+     */
+    roles?: unknown[] | string;
+    /**
+     * URL de redirection après rattachement (optionnel)
+     */
+    urlRedirection?: string;
+    [k: string]: unknown;
+}
+export interface ConnectByRefData {
+    pathParams?: {
+        /**
+         * Référence publique du lien (hex ; uniqid legacy 13 ou token Node 24) — segment d URL
+         */
+        ref: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
 export interface DisconnectData {
     /**
      * ID de l'élément à déconnecter (projet, organisation...)
@@ -6687,3 +6742,207 @@ export interface CostumListValuesData {
     limit?: number;
     [k: string]: unknown;
 }
+export interface DirectoryProposalData {
+    /**
+     * searchType[0] = la COLLECTION interrogée par tous les find/count (typiquement 'answers'). Obligatoire — absent = 500 legacy.
+     *
+     * @minItems 1
+     */
+    searchType: [string, ...string[]];
+    /**
+     * Recherche texte (SearchNew::searchText) : $or par défaut name/title/slug/sigle/shortDescription + éclatement multi-mots.
+     */
+    name?: string;
+    /**
+     * Chemin de recherche texte SUPPLÉMENTAIRE — il S'AJOUTE au $or par défaut, il ne le remplace pas.
+     */
+    textPath?: string;
+    /**
+     * Tags — opérateur toujours $in ; chaque valeur devient une regex ANCRÉE insensible casse/accents (/^…$/i).
+     */
+    searchTags?: string[];
+    /**
+     * Chemin des tags (défaut serveur : 'tags').
+     */
+    tagsPath?: string;
+    /**
+     * Restreint à user = <userId>.
+     */
+    userId?: string;
+    /**
+     * Map {champ: 1|-1} (valeurs castées int) OU liste de champs (⇒ 1). Défaut serveur : {updated:-1}.
+     */
+    sortBy?: {
+        [k: string]: 1 | -1;
+    } | string[];
+    /**
+     * Projection Mongo (défaut : documents complets).
+     */
+    fields?: string[];
+    /**
+     * Offset (défaut serveur 0).
+     */
+    indexMin?: number;
+    /**
+     * Taille de page (défaut serveur 100) ; 'all' = SANS limite (findAndSort limit 0).
+     */
+    indexStep?: number | "all";
+    /**
+     * La PRÉSENCE de la clé ajoute count.<searchType[0]>. Transport form-urlencoded : count:false se sérialise "false" (truthy PHP) → identique à true ; const:true empêche le faux ami côté client.
+     */
+    count?: true;
+    /**
+     * Filtres. Clés à traitement SPÉCIAL (consommées, dans cet ordre) : formStandalone (bool, extrait en premier — bypass du gate onlyAdminCanSeeList) ; oneSubOrganization/allSubOrganisation (AVANT form, qu'ils REMPLACENT — voir plus bas) ; form (string → $or 3 voies : form=<val>, answers.aapStep2.choose.<idParentDuForm>.value='selected', links.aacForm.<formId> $exists — LE scoping réel de l'annuaire) ; address (string → regex accent-insensible sur <mapping.address>.postalCode/.name) ; views (['seen'|'notSeen'] → views.<userId SESSION> $exists — réponse USER-SCOPÉE : la query key doit porter l'userId) ; quartiers (string[] → answers.aapStep1.interventionArea $in) ; toute clé contenant '.choose.' (string[] → $in ; la valeur 'notselected' ajoute une branche $exists:false) ; admissibility (['admissible'|'inadmissible'] — [0] seul lu ; communauté CITOYENS du porteur ; 'admissible' = $ne 'inadmissible' donc matche aussi les non-notées ; ignoré si communauté vide) ; answers.aapStep1.depense.financer.idAndName ('<id>-idAndName-<nom>', [0] seul → $or name/id) ; vote (truthy → vote.<userId SESSION> $exists — user-scopé) ; inproject (['inproject'|'inproposal'] cumulables → project.id $exists true/false ; ⚠ supprime silencieusement un éventuel filters['project.id']) ; status (si le tableau contient 'unnotified' : status $ne notified/notificationSent ; la clé n'est retirée que si c'est la SEULE valeur, sinon le tableau ENTIER repart en pass-through). Sous-organisations (fix 2026-08 appliqué L+B, BUG-L-226/227) : oneSubOrganization PRIME (string[], valeurs éclatées sur '-' → form $in ; consomme aussi allSubOrganisation et form), sinon allSubOrganisation (string[] → form $in [valeurs + filters.form si présent]) — les deux REMPLACENT le scoping $or 3 voies de form. ⚠ Sur un serveur legacy ANTÉRIEUR au fix (branche fix/aap-suborganisation-filters) : oneSubOrganization était mort (pass-through → liste VIDE) et allSubOrganisation ajoutait null au $in en prod (élargit) / 500 en dev. Toute autre clé : pass-through SearchNew::searchFilters (tableau → $in de regex partielles ; string → $or [valeur, bool]).
+     */
+    filters?: {
+        [k: string]: unknown;
+    };
+    pathParams?: {
+        /**
+         * Slug du costum (contexte). Le legacy accepte des appels sans source (purement contextuel via beforeAction) — le SDK le requiert : les usages site-json sont toujours sous costum.
+         */
+        source: string;
+        /**
+         * Id du FORM PARENT AAC. Effectivement requis (le legacy fait findOneById puis lit form.parent → 500 sans form valide). ⚠ Il ne filtre JAMAIS les résultats (scoping commenté, Aap.php:1201) : sans filters.form la requête balaie TOUTES les réponses de la collection — toujours poser filters.form.
+         */
+        form: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export interface DirectoryProposalCountData {
+    /**
+     * searchType[0] = la COLLECTION interrogée par tous les find/count (typiquement 'answers'). Obligatoire — absent = 500 legacy.
+     *
+     * @minItems 1
+     */
+    searchType: [string, ...string[]];
+    /**
+     * Recherche texte (SearchNew::searchText) : $or par défaut name/title/slug/sigle/shortDescription + éclatement multi-mots.
+     */
+    name?: string;
+    /**
+     * Chemin de recherche texte SUPPLÉMENTAIRE — il S'AJOUTE au $or par défaut, il ne le remplace pas.
+     */
+    textPath?: string;
+    /**
+     * Tags — opérateur toujours $in ; chaque valeur devient une regex ANCRÉE insensible casse/accents (/^…$/i).
+     */
+    searchTags?: string[];
+    /**
+     * Chemin des tags (défaut serveur : 'tags').
+     */
+    tagsPath?: string;
+    /**
+     * Restreint à user = <userId>.
+     */
+    userId?: string;
+    /**
+     * Map {champ: 1|-1} (valeurs castées int) OU liste de champs (⇒ 1). Défaut serveur : {updated:-1}.
+     */
+    sortBy?: {
+        [k: string]: 1 | -1;
+    } | string[];
+    /**
+     * Projection Mongo (défaut : documents complets).
+     */
+    fields?: string[];
+    /**
+     * Offset (défaut serveur 0).
+     */
+    indexMin?: number;
+    /**
+     * Taille de page (défaut serveur 100) ; 'all' = SANS limite (findAndSort limit 0).
+     */
+    indexStep?: number | "all";
+    /**
+     * La PRÉSENCE de la clé ajoute count.<searchType[0]>. Transport form-urlencoded : count:false se sérialise "false" (truthy PHP) → identique à true ; const:true empêche le faux ami côté client.
+     */
+    count?: true;
+    /**
+     * Filtres. Clés à traitement SPÉCIAL (consommées, dans cet ordre) : formStandalone (bool, extrait en premier — bypass du gate onlyAdminCanSeeList) ; oneSubOrganization/allSubOrganisation (AVANT form, qu'ils REMPLACENT — voir plus bas) ; form (string → $or 3 voies : form=<val>, answers.aapStep2.choose.<idParentDuForm>.value='selected', links.aacForm.<formId> $exists — LE scoping réel de l'annuaire) ; address (string → regex accent-insensible sur <mapping.address>.postalCode/.name) ; views (['seen'|'notSeen'] → views.<userId SESSION> $exists — réponse USER-SCOPÉE : la query key doit porter l'userId) ; quartiers (string[] → answers.aapStep1.interventionArea $in) ; toute clé contenant '.choose.' (string[] → $in ; la valeur 'notselected' ajoute une branche $exists:false) ; admissibility (['admissible'|'inadmissible'] — [0] seul lu ; communauté CITOYENS du porteur ; 'admissible' = $ne 'inadmissible' donc matche aussi les non-notées ; ignoré si communauté vide) ; answers.aapStep1.depense.financer.idAndName ('<id>-idAndName-<nom>', [0] seul → $or name/id) ; vote (truthy → vote.<userId SESSION> $exists — user-scopé) ; inproject (['inproject'|'inproposal'] cumulables → project.id $exists true/false ; ⚠ supprime silencieusement un éventuel filters['project.id']) ; status (si le tableau contient 'unnotified' : status $ne notified/notificationSent ; la clé n'est retirée que si c'est la SEULE valeur, sinon le tableau ENTIER repart en pass-through). Sous-organisations (fix 2026-08 appliqué L+B, BUG-L-226/227) : oneSubOrganization PRIME (string[], valeurs éclatées sur '-' → form $in ; consomme aussi allSubOrganisation et form), sinon allSubOrganisation (string[] → form $in [valeurs + filters.form si présent]) — les deux REMPLACENT le scoping $or 3 voies de form. ⚠ Sur un serveur legacy ANTÉRIEUR au fix (branche fix/aap-suborganisation-filters) : oneSubOrganization était mort (pass-through → liste VIDE) et allSubOrganisation ajoutait null au $in en prod (élargit) / 500 en dev. Toute autre clé : pass-through SearchNew::searchFilters (tableau → $in de regex partielles ; string → $or [valeur, bool]).
+     */
+    filters?: {
+        [k: string]: unknown;
+    };
+    pathParams?: {
+        /**
+         * Slug du costum (contexte). Le legacy accepte des appels sans source (purement contextuel via beforeAction) — le SDK le requiert : les usages site-json sont toujours sous costum.
+         */
+        source: string;
+        /**
+         * Id du FORM PARENT AAC. Effectivement requis (le legacy fait findOneById puis lit form.parent → 500 sans form valide). ⚠ Il ne filtre JAMAIS les résultats (scoping commenté, Aap.php:1201) : sans filters.form la requête balaie TOUTES les réponses de la collection — toujours poser filters.form.
+         */
+        form: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export interface DirectoryProposalNewCounterData {
+    /**
+     * searchType[0] = la COLLECTION interrogée par tous les find/count (typiquement 'answers'). Obligatoire — absent = 500 legacy.
+     *
+     * @minItems 1
+     */
+    searchType: [string, ...string[]];
+    /**
+     * Recherche texte (SearchNew::searchText) : $or par défaut name/title/slug/sigle/shortDescription + éclatement multi-mots.
+     */
+    name?: string;
+    /**
+     * Chemin de recherche texte SUPPLÉMENTAIRE — il S'AJOUTE au $or par défaut, il ne le remplace pas.
+     */
+    textPath?: string;
+    /**
+     * Tags — opérateur toujours $in ; chaque valeur devient une regex ANCRÉE insensible casse/accents (/^…$/i).
+     */
+    searchTags?: string[];
+    /**
+     * Chemin des tags (défaut serveur : 'tags').
+     */
+    tagsPath?: string;
+    /**
+     * Restreint à user = <userId>.
+     */
+    userId?: string;
+    /**
+     * Map {champ: 1|-1} (valeurs castées int) OU liste de champs (⇒ 1). Défaut serveur : {updated:-1}.
+     */
+    sortBy?: {
+        [k: string]: 1 | -1;
+    } | string[];
+    /**
+     * Projection Mongo (défaut : documents complets).
+     */
+    fields?: string[];
+    /**
+     * Offset (défaut serveur 0).
+     */
+    indexMin?: number;
+    /**
+     * Taille de page (défaut serveur 100) ; 'all' = SANS limite (findAndSort limit 0).
+     */
+    indexStep?: number | "all";
+    /**
+     * La PRÉSENCE de la clé ajoute count.<searchType[0]>. Transport form-urlencoded : count:false se sérialise "false" (truthy PHP) → identique à true ; const:true empêche le faux ami côté client.
+     */
+    count?: true;
+    /**
+     * Filtres. Clés à traitement SPÉCIAL (consommées, dans cet ordre) : formStandalone (bool, extrait en premier — bypass du gate onlyAdminCanSeeList) ; oneSubOrganization/allSubOrganisation (AVANT form, qu'ils REMPLACENT — voir plus bas) ; form (string → $or 3 voies : form=<val>, answers.aapStep2.choose.<idParentDuForm>.value='selected', links.aacForm.<formId> $exists — LE scoping réel de l'annuaire) ; address (string → regex accent-insensible sur <mapping.address>.postalCode/.name) ; views (['seen'|'notSeen'] → views.<userId SESSION> $exists — réponse USER-SCOPÉE : la query key doit porter l'userId) ; quartiers (string[] → answers.aapStep1.interventionArea $in) ; toute clé contenant '.choose.' (string[] → $in ; la valeur 'notselected' ajoute une branche $exists:false) ; admissibility (['admissible'|'inadmissible'] — [0] seul lu ; communauté CITOYENS du porteur ; 'admissible' = $ne 'inadmissible' donc matche aussi les non-notées ; ignoré si communauté vide) ; answers.aapStep1.depense.financer.idAndName ('<id>-idAndName-<nom>', [0] seul → $or name/id) ; vote (truthy → vote.<userId SESSION> $exists — user-scopé) ; inproject (['inproject'|'inproposal'] cumulables → project.id $exists true/false ; ⚠ supprime silencieusement un éventuel filters['project.id']) ; status (si le tableau contient 'unnotified' : status $ne notified/notificationSent ; la clé n'est retirée que si c'est la SEULE valeur, sinon le tableau ENTIER repart en pass-through). Sous-organisations (fix 2026-08 appliqué L+B, BUG-L-226/227) : oneSubOrganization PRIME (string[], valeurs éclatées sur '-' → form $in ; consomme aussi allSubOrganisation et form), sinon allSubOrganisation (string[] → form $in [valeurs + filters.form si présent]) — les deux REMPLACENT le scoping $or 3 voies de form. ⚠ Sur un serveur legacy ANTÉRIEUR au fix (branche fix/aap-suborganisation-filters) : oneSubOrganization était mort (pass-through → liste VIDE) et allSubOrganisation ajoutait null au $in en prod (élargit) / 500 en dev. Toute autre clé : pass-through SearchNew::searchFilters (tableau → $in de regex partielles ; string → $or [valeur, bool]).
+     */
+    filters?: {
+        [k: string]: unknown;
+    };
+    pathParams?: {
+        /**
+         * Slug du costum (contexte). Le legacy accepte des appels sans source (purement contextuel via beforeAction) — le SDK le requiert : les usages site-json sont toujours sous costum.
+         */
+        source: string;
+        /**
+         * Id du FORM PARENT AAC. Effectivement requis (le legacy fait findOneById puis lit form.parent → 500 sans form valide). ⚠ Il ne filtre JAMAIS les résultats (scoping commenté, Aap.php:1201) : sans filters.form la requête balaie TOUTES les réponses de la collection — toujours poser filters.form.
+         */
+        form: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}

package/types/api/Form.d.ts

@@ -1,7 +1,7 @@
 import { BaseEntity } from "./BaseEntity.js";
 import type { Answer } from "./Answer.js";
 import type { PaginatorPage, PaginatorState } from "./BaseEntity.js";
-import type { CoformAnswersSearchData } from "./EndpointApi.types.js";
+import type { CoformAnswersSearchData, DirectoryProposalCountData, DirectoryProposalData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
 import type { CoformCommonTableContributor, FormItemNormalized } from "./serverDataType/Form.js";
 /**
  * Une entrée de catalogue commonTable (une criteria agrégée cross-réponses).
@@ -29,6 +29,41 @@ export interface CommonTableCatalogEntry {
  * (`getCatalogs` normalise les `[]` PHP — catalogues vides — en `{}`).
  */
 export type CommonTableCatalogs = Record<string, Record<string, CommonTableCatalogEntry>>;
+/**
+ * Les 10 blocs latéraux batch-résolus de l'annuaire des communs AAP
+ * (directoryproposal). Chaque bloc VIDE se sérialise `[]` (array PHP vide),
+ * peuplé c'est une map keyée par id.
+ */
+export interface DirectoryProposalSideBlocks {
+    users: Record<string, unknown> | unknown[];
+    usersStatus: Record<string, unknown> | unknown[];
+    sousOrga: Record<string, unknown> | unknown[];
+    checkSeen: Record<string, unknown> | unknown[];
+    allActions: Record<string, unknown> | unknown[];
+    allImages: Record<string, unknown> | unknown[];
+    allDocuments: Record<string, unknown> | unknown[];
+    elements: Record<string, unknown> | unknown[];
+    inputs: Record<string, unknown> | unknown[];
+    allNotSeenComments: Record<string, unknown> | unknown[];
+}
+/**
+ * Réponse de `form.getProposals` (mode normal). `results` : lignes
+ * PRÉ-FORMATÉES par le serveur (parsePropositionData : `name`, `image`
+ * toujours présent, `tags` ré-indexés, `funds` agrégés, `user_count`,
+ * `interrest_count`…), normalisées map→tableau par le client (id injecté).
+ * À consommer BRUT — pour un détail/action, reviver l'Answer par id
+ * (`form.answer({ id })`), jamais via `_linkEntities` (les lignes ne sont
+ * pas des documents answers complets).
+ */
+export interface DirectoryProposalPage extends DirectoryProposalSideBlocks {
+    results: Array<Record<string, unknown>>;
+    /** Présent SEULEMENT si la clé `count` était posée dans la requête. */
+    count?: Record<string, number>;
+}
+/** Réponse de `form.countProposals` (mode countonly) : count sans results, blocs latéraux présents et vides. */
+export interface DirectoryProposalCountPage extends DirectoryProposalSideBlocks {
+    count: Record<string, number>;
+}
 export declare class Form extends BaseEntity<FormItemNormalized> {
     static entityType: string;
     static entityTag: string;
@@ -156,4 +191,50 @@ export declare class Form extends BaseEntity<FormItemNormalized> {
     getCatalogs(params: {
         inputKeys: string[];
     }): Promise<CommonTableCatalogs>;
+    /**
+     * Gardes communes des 3 wrappers directoryproposal + construction des
+     * pathParams `{source, form}` : `source` = slug du parent costum (le Form
+     * doit avoir été créé via `org.form({id})` / `project.form({id})`),
+     * `form` = id de ce Form (le form PARENT AAC).
+     */
+    private _proposalPathParams;
+    /**
+     * Annuaire des communs AAP (`co2/aap/directoryproposal`, mode normal).
+     *
+     * Wrapper de `endpointApi.directoryProposal` qui encapsule les invariants
+     * piégeux du legacy :
+     * - `pathParams.form` ne FILTRE JAMAIS les résultats → `filters.form = this.id`
+     *   est TOUJOURS injecté (sans lui, la requête balaierait toutes les réponses
+     *   de la collection) ;
+     * - `searchType: ["answers"]` par défaut (obligatoire côté serveur) ;
+     * - `source` = slug du parent costum, `form` = id de ce Form.
+     *
+     * Le retour est BRUT (lignes pré-formatées serveur) — voir
+     * {@link DirectoryProposalPage}. Pagination : passer `indexStep`/`indexMin` ;
+     * poser la clé `count` (ex. `count: true`) pour recevoir `count.answers`.
+     * ⚠ `filters.views`/`filters.vote` scopent la réponse à l'utilisateur de
+     * SESSION — toute query key de cache doit alors porter l'userId.
+     *
+     * @example
+     * const org = await api.organization({ slug: "coSindniSmarterre" });
+     * const form = await org.form({ id: AAC_FORM_ID });
+     * const page = await form.getProposals({ indexStep: 30, indexMin: 0, count: true });
+     * page.results;       // lignes pré-formatées (name, image, tags, funds…)
+     * page.count?.answers; // total
+     */
+    getProposals(data?: Partial<DirectoryProposalData>): Promise<DirectoryProposalPage>;
+    /**
+     * Annuaire des communs AAP — compte seul (mode countonly).
+     * Mêmes gardes et injections que {@link Form#getProposals} ; la réponse porte
+     * `count.<searchType[0]>` SANS `results` (blocs latéraux présents, vides `[]`).
+     */
+    countProposals(data?: Partial<DirectoryProposalCountData>): Promise<DirectoryProposalCountPage>;
+    /**
+     * Annuaire des communs AAP — compteur de non-vus (mode newcounter).
+     * Réponse `{ newCounter: int }` seule ; compteur de l'utilisateur de SESSION
+     * (0 si non connecté) — query key de cache à scoper par userId.
+     */
+    getProposalsNewCounter(data?: Partial<DirectoryProposalNewCounterData>): Promise<{
+        newCounter: number;
+    }>;
 }