@communecter/cocolight-api-client 1.0.173 → 1.0.180

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
@@ -1155,15 +1177,15 @@ export interface GetProjectsNoAdminData {
      */
     countType: "projects"[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
-        $or?: Record<string, unknown>;
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^links\.contributors\.(?:[a-f0-9]{24}|@\w+)$".
-         */
+        $or: {};
         [k: string]: unknown;
     };
     /**
@@ -1233,15 +1255,15 @@ export interface GetProjectsAdminData {
      */
     countType: "projects"[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
-        $or?: Record<string, unknown>;
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^links\.contributors\.(?:[a-f0-9]{24}|@(?:\{[^}]+\}|[A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+)?))$".
-         */
+        $or: {};
         [k: string]: unknown;
     };
     /**
@@ -1322,17 +1344,15 @@ export interface GetPoisNoAdminData {
      */
     countType: "poi"[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^parent\.(?:[a-f0-9]{24}|@\w+)$".
-         */
-        [k: string]: {
-            $exists: true;
-        };
+        [k: string]: unknown;
     };
     /**
      * Localité vide ou spécifique
@@ -1401,17 +1421,15 @@ export interface GetPoisAdminData {
      */
     countType: "poi"[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^parent\.(?:[a-f0-9]{24}|@(?:\{[^}]+\}|[A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+)?))$".
-         */
-        [k: string]: {
-            $exists: true;
-        };
+        [k: string]: unknown;
     };
     /**
      * Localité vide ou spécifique
@@ -1674,10 +1692,16 @@ export interface GetOrganizationsNoAdminData {
      */
     countType: ("NGO" | "Cooperative" | "LocalBusiness" | "Group" | "GovernmentOrganization")[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
-    filters: {};
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
+    filters: {
+        [k: string]: unknown;
+    };
     /**
      * Localité vide ou spécifique
      */
@@ -1745,9 +1769,13 @@ export interface GetOrganizationsAdminData {
      */
     countType: ("NGO" | "Cooperative" | "LocalBusiness" | "Group" | "GovernmentOrganization")[];
     /**
-     * Flag pour ne pas filtrer sur une clé de source spécifique
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
      */
-    notSourceKey: true;
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
     filters: {
         [k: string]: unknown;
     };
@@ -1820,9 +1848,13 @@ export interface GetUserEligiblePlacesData {
      */
     countType?: string[];
     /**
-     * true = désactive le filtrage automatique par sourceKey du contexte (cf. SearchNew.php). Configurable dynamiquement selon la config du finder du formulaire.
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
+     */
+    notSourceKey?: boolean;
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
      */
-    notSourceKey: boolean;
+    sourceKey?: string[];
     /**
      * Filtres MongoDB arbitraires : tags, source.key, links.members.{id}, etc. Les valeurs peuvent être une string (match exact), un tableau (any-of), ou un objet ($exists/$in/$ne/etc).
      */
@@ -2727,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...)
@@ -4007,6 +4072,14 @@ export interface AssignBadgesData {
     [k: string]: unknown;
 }
 export interface GetEventsData {
+    /**
+     * Périmètre(s) costum. Le serveur en fait `$or[ source.keys ∈, reference.costum ∈ ]` (SearchNew::searchSourceKey) — les deux voies de rattachement comptent. N'a d'effet que si `notSourceKey` est ABSENT du corps.
+     */
+    sourceKey?: string[];
+    /**
+     * Périmètre RÉSEAU. PRÉSENT (quelle que soit sa valeur) = le filtrage par sourceKey est désactivé ; ABSENT = `sourceKey` s'applique. La garde serveur est un `empty()` (SearchNew.php:999) : en x-www-form-urlencoded un `false` part en chaîne "false", qui n'est pas vide — envoyer `false` désactiverait donc le périmètre, comme `true`. Sans `default` au contrat : le défaut historique (réseau) est posé par le finalizer, seul endroit d'où la clé peut aussi être OMISE.
+     */
+    notSourceKey?: boolean;
     searchType: "events"[];
     indexMin: number;
     indexStep: number;
@@ -4046,11 +4119,7 @@ export interface GetEventsData {
      */
     recurrency?: false;
     filters?: {
-        $or?: Record<string, unknown>;
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^links\.attendees\.(?:[a-f0-9]{24}|@\w+)$".
-         */
+        $or: {};
         [k: string]: unknown;
     };
     [k: string]: unknown;
@@ -6654,3 +6723,226 @@ export interface ZoneGetZonirisData {
     sourceKey?: string[];
     [k: string]: unknown;
 }
+export interface CostumListValuesData {
+    /**
+     * Slug du costum (élément porteur ou document `costum`).
+     */
+    slug: string;
+    /**
+     * Nom de la liste déclarée dans `costum.lists`.
+     */
+    list: string;
+    /**
+     * Recherche SERVEUR sur les valeurs. Comparaison canonique — minuscules, accents dépliés, ponctuation retirée — donc « economie » trouve « Économie ». C'est la MÊME normalisation que la clé de tri (`sansAccents` / `cleTri`), pour que les deux ports filtrent exactement le même ensemble. Sans `q`, la liste entière est rendue.
+     */
+    q?: string;
+    /**
+     * Nombre MAXIMAL de valeurs rendues, appliqué APRÈS `q`, le dédoublonnage et le tri — donc sur une liste déjà déterministe. Quand il coupe, la réponse porte `total` et `truncated`. Sans `limit`, la liste entière est rendue (comportement historique).
+     */
+    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;
+    }>;
 }