@communecter/cocolight-api-client 1.0.189 → 1.0.190

package/package.json

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

package/types/api/Answer.d.ts

@@ -22,6 +22,27 @@ export interface AnswerChange {
     mutationType: "create" | "update" | "";
     changedFields: string[];
 }
+/** Options de `Answer.generateProject()` — équivalent `costum.contextId`/`costum.contextType` legacy. */
+export interface GenerateProjectOptions {
+    /** ID de l'entité parente (org/site porteur de l'appel). */
+    parentId: string;
+    /** Type de l'entité parente (ex: `"organizations"`). */
+    parentType: string;
+}
+/** Résultat de `Answer.generateProject()` — le backend renvoie la clé française `projet`. */
+export interface GenerateProjectResult {
+    projectId: string;
+    roomId: string;
+}
+/**
+ * Résultat de `Answer.generateMilestoneFromDepense()`. `milestoneId` peut être
+ * une chaîne VIDE si la clé de dépense passée ne correspond à aucune entrée du
+ * tableau `depense[]` — le backend renvoie quand même `{success:1}` dans ce cas
+ * (cf. DepenseMilestoneOperationAction.php:39-43).
+ */
+export interface GenerateMilestoneFromDepenseResult {
+    milestoneId: string;
+}
 /** Un axe du radar multi-eval (= un input radioNew d'une step donnée). */
 export interface MultiEvalAxis {
     key: string;
@@ -365,6 +386,60 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
      * new Date(history[0].at * 1000); // date de la dernière modif (at en SECONDES)
      */
     getHistory(): Promise<AnswerChange[]>;
+    /**
+     * Promeut cette Answer en Project + Room (génération **irréversible** — une
+     * fois `project.id` posé, un second appel échoue avec "Already have a
+     * project"). Construit le projet à partir du mapping `proposition`/
+     * `description`/`depense` du form de config AAP.
+     *
+     * Constant : `GENERATE_PROJECT_FROM_ANSWER` (POST
+     * `/survey/form/generateproject/answerId/{answerId}/parentId/{parentId}/parentType/{parentType}`,
+     * auth bearer — le backend pose `Yii::app()->session['userId']` comme
+     * créateur et pour la notification `PROPOSAL_TO_PROJECT`).
+     *
+     * @param opts.parentId - ID de l'entité parente (org/site porteur de l'appel).
+     * @param opts.parentType - Type de l'entité parente (ex: `"organizations"`).
+     * @returns `{ projectId, roomId }` — le backend renvoie la clé française `projet`.
+     * @throws {ApiError} 400 si Answer sans id, ou `parentId`/`parentType` manquants.
+     * @throws {ApiAuthenticationError} si non connecté.
+     * @throws {ApiError} 409 si un projet est déjà associé à cette réponse.
+     * @throws {ApiError} 422 si le mapping du form ne fournit pas de nom de projet exploitable.
+     *
+     * @example
+     * const result = await answer.generateProject({ parentId: costum.contextId, parentType: costum.contextType });
+     */
+    generateProject(opts: GenerateProjectOptions): Promise<GenerateProjectResult>;
+    /**
+     * Sync answer→project pour UNE dépense de cette réponse (endpoint
+     * `GENERATE_MILESTONE_FROM_DEPENSE`,
+     * `POST /survey/form/depensemilestoneoperation`, auth bearer) : si la
+     * dépense `depenseKey` n'a pas encore de `milestone`, en crée un sur
+     * `project.oceco.milestones` ET pose `depense[depenseKey].milestone`,
+     * atomiquement côté serveur.
+     *
+     * L'endpoint serveur est idempotent (no-op si `!empty($dep["milestone"])`,
+     * `Answer::generateMilestonneFromDepense`), mais **cette méthode ne l'est
+     * pas** : un second appel sur la même dépense renvoie `{success:1,
+     * milestoneId:""}` côté serveur, que ce wrapper traite comme une erreur 502.
+     * L'appelant doit donc filtrer `if (depense.milestone) continue;` avant
+     * d'appeler (cf. `site-json` `associateExistingProject.ts`).
+     *
+     * Contrairement à `generateProject()`, exige que cette réponse ait DÉJÀ un
+     * projet associé (`answer.project.id` posé) — sinon `ApiError 400`
+     * (`"Don't have a project"`).
+     *
+     * @param depenseKey - Clé (index) de la dépense dans `answers.<step>.depense[]` —
+     *   PAS un id Mongo. Une clé sans correspondance ne lève pas d'erreur côté
+     *   serveur (`{success:1, milestoneId:""}`) — cette méthode le traite comme
+     *   une erreur (502) plutôt que de renvoyer un id vide silencieusement.
+     * @throws {ApiError} 400 si Answer sans id, ou si aucun projet n'est associé.
+     * @throws {ApiAuthenticationError} si non connecté.
+     * @throws {ApiError} 502 si le serveur ne renvoie pas de `milestoneId` exploitable.
+     *
+     * @example
+     * const { milestoneId } = await answer.generateMilestoneFromDepense("0");
+     */
+    generateMilestoneFromDepense(depenseKey: string): Promise<GenerateMilestoneFromDepenseResult>;
     /**
      * Récupère les datasets agrégés des évaluations multiples (radar) de cette
      * Answer. Pour une réponse partagée contenant des inputs `radioNew` avec

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, ContactSendData, 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, CostumToolsCatalogData, CostumToolUsersData, CostumCommunInfoData, CostumSaveToolEnrichmentData, CostumCommunListData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, PersonValidateInvitationData, ValidateInvitationByMailData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, TransferSourceCheckData, TransferSourceApplyData, TransferSourceRollbackData, TransferSourceHistoryData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, CostumResolvedData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } 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, ContactSendData, 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, CostumToolsCatalogData, CostumToolUsersData, CostumCommunInfoData, CostumSaveToolEnrichmentData, CostumCommunListData, GenerateAnswerFromFormData, GenerateProjectFromAnswerData, GenerateMilestoneFromDepenseData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, PersonValidateInvitationData, ValidateInvitationByMailData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, TransferSourceCheckData, TransferSourceApplyData, TransferSourceRollbackData, TransferSourceHistoryData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, CostumResolvedData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -260,7 +260,7 @@ export declare class EndpointApi {
      */
     relaunchInvitation(data: RelaunchInvitationData): Promise<any>;
     /**
-     * Envoyer un message depuis un formulaire de contact public : Programme un mail 'contactForm' vers l'adresse d'administration du costum, depuis un formulaire de contact public — pendant du bloc CMS legacy 'contact' (modules/costum/views/tpls/blockCms/contact/*.php, qui postent tous sur cette route). Envoi ASYNCHRONE : le message est mis dans la file cron (Mail::schedule), pas expédié dans la requête. ⚠ Le DESTINATAIRE n'est PAS un paramètre : il est résolu SERVEUR depuis costum.admin.email (Mail.php:1891-1893, costum résolu par costumSlug — CacheHelper.php:73-76). Le contrat interdit donc tplMail/to/fromMail (additionalProperties:false) : la route legacy sous-jacente accepte un destinataire arbitraire sans aucune authentification (webhook Mailgun jamais implémenté, MailmanagementController.php:18-26) — ce contrat n'en expose QUE l'usage 'formulaire de contact'. ⚠ Si costum.admin.email est absent, le legacy retombe en cascade sur to puis replyTo, c'est-à-dire qu'il renvoie le message à SON PROPRE EXPÉDITEUR : vérifier que le costum porte bien cette adresse avant de brancher un formulaire. Le port Node, lui, REFUSE dans ce cas (et durcit : tpl en liste blanche, destinataire serveur, anti-abus par IP et par costum, longueurs bornées) — même esprit que RELAUNCH_INVITATION.
+     * Envoyer un message depuis un formulaire de contact public : Programme un mail 'contactForm' vers l'adresse d'administration du costum, depuis un formulaire de contact public — pendant du bloc CMS legacy 'contact' (modules/costum/views/tpls/blockCms/contact/*.php, qui postent tous sur cette route). Envoi ASYNCHRONE : le message est mis dans la file cron (Mail::schedule), pas expédié dans la requête. ⚠ Le ou les DESTINATAIRES ne sont PAS des paramètres : ils sont résolus SERVEUR, dans l'ordre de priorité du legacy — `costum.contactMail` d'abord, `costum.admin.email` seulement en repli (contactForm.php:606 ; costum résolu par costumSlug — CacheHelper.php:73-76). `contactMail` peut porter PLUSIEURS adresses, et chacune reçoit alors son propre mail, comme Mail::createAndSend qui éclate un tableau ou une chaîne à virgules (Mail.php:1901-1916) — cas réel : sportSanteBienetre en déclare deux quand son admin.email n'en porte qu'une. Le contrat interdit donc tplMail/to/fromMail (additionalProperties:false) : la route legacy sous-jacente accepte un destinataire arbitraire sans aucune authentification (webhook Mailgun jamais implémenté, MailmanagementController.php:18-26) — ce contrat n'en expose QUE l'usage 'formulaire de contact'. ⚠ Si ni contactMail ni admin.email ne sont configurés, le legacy retombe en cascade sur to puis replyTo, c'est-à-dire qu'il renvoie le message à SON PROPRE EXPÉDITEUR : vérifier que le costum porte bien une adresse avant de brancher un formulaire. Le port Node, lui, REFUSE dans ce cas (et durcit : tpl en liste blanche, destinataire serveur, anti-abus par IP et par costum, longueurs bornées) — même esprit que RELAUNCH_INVITATION.
      * Constant : CONTACT_SEND
      * @param data - Données envoyées à l'API
      * @returns Les données de réponse.
@@ -1333,6 +1333,26 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     generateAnswerFromForm(data: GenerateAnswerFromFormData): Promise<any>;
+    /**
+     * Générer un projet à partir d'une réponse AAP : Promeut une réponse (Answer) AAP en Project + Room à partir du mapping du form de config (proposition/description/dépenses). Contrôleur : modules/survey/controllers/ocecoform/GenerateprojectAction.php:16-113 (mappé par FormController.php action 'generateproject'). Auth bearer obligatoire : Answer::GenerateProjectFromAnswer (Answer.php:625-767) pose Yii::app()->session['userId'] comme creator/idUserAuthor, et notifySwitchToProject (GenerateprojectAction.php:115-148) lit Yii::app()->session['userId'/'user'] pour la notification PROPOSAL_TO_PROJECT — ne fonctionne pas en session anonyme.
+     * Constant : GENERATE_PROJECT_FROM_ANSWER
+     * @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.
+     */
+    generateProjectFromAnswer(data: GenerateProjectFromAnswerData): Promise<any>;
+    /**
+     * Générer un milestone projet à partir d'une dépense de réponse : Sync answer→project pour UNE dépense : si answers.aapStep1.depense[depid] n'a pas encore de milestone, en crée un sur project.oceco.milestones ET pose depense[depid].milestone, atomiquement côté serveur (idempotent — no-op si déjà lié). Contrôleur : modules/survey/controllers/ocecoform/DepenseMilestoneOperationAction.php:12-68 (mappé par FormController.php, action 'depensemilestoneoperation'), délègue à Answer::generateMilestonneFromDepense (Answer.php, cf. GenerateprojectAction qui l'appelle aussi en boucle après une génération de projet). Seule l'action 'generateMilestone' est modélisée ici — l'endpoint PHP supporte aussi 'closeMilestone' (réponse de forme différente, hors scope). auth bearer par prudence (mutation projet/financement) bien que ni l'action ni generateMilestonneFromDepense ne lisent Yii::app()->session (contrairement à GenerateprojectAction).
+     * Constant : GENERATE_MILESTONE_FROM_DEPENSE
+     * @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.
+     */
+    generateMilestoneFromDepense(data: GenerateMilestoneFromDepenseData): Promise<any>;
     /**
      * Trouver les informations sur les enveloppes d’un formulaire : Trouver les informations sur les enveloppes d’un formulaire
      * Constant : FUNDING_ENVELOPE

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

@@ -344,6 +344,14 @@ export interface UpdateBlockLocalityData {
          * Nom de l'EPCI. Peut être vide.
          */
         level5Name?: string;
+        /**
+         * NOM du decoupage infra-communal qui CONTIENT le point : bassin de vie, grand quartier, IRIS — tel que stocke dans `zoniris.name` (collection lue par `/co2/zone/getzoniris`). Ne se saisit pas : il est pose par calcul geometrique ($geoWithin du `geoPosition` dans le `geoShape` du contour, cf. `/co2/zone/associatezoniris`). C'est la valeur que filtrent les sites — `filters: {"address.zoniris": "Guillaume"}`, ou `$in` pour plusieurs bassins — et celle qu'emet une carte de contours cliquables. AUCUN rapport avec la chaine `levelN`, qui s'arrete a l'EPCI (level5) : `zoniris` descend SOUS la commune. Peut etre vide.
+         */
+        zoniris?: string;
+        /**
+         * `_id` (24 hex, en STRING) du document `zoniris` designe par `zoniris`. Meme role que `localityId` face a `addressLocality` : il survit au renommage d'un contour et permet a l'association de reconnaitre ses propres ecritures lors d'un rejeu. Peut etre vide.
+         */
+        zonirisId?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -518,7 +526,7 @@ export interface RelaunchInvitationData {
 }
 export interface ContactSendData {
     /**
-     * Slug du costum porteur — SEUL déterminant du destinataire (costum.admin.email).
+     * Slug du costum porteur — SEUL déterminant des destinataires (costum.contactMail, à défaut costum.admin.email).
      */
     costumSlug: string;
     /**
@@ -3034,6 +3042,14 @@ export interface AddOrganizationData {
          * Nom de l'EPCI. Peut être vide.
          */
         level5Name?: string;
+        /**
+         * NOM du decoupage infra-communal qui CONTIENT le point : bassin de vie, grand quartier, IRIS — tel que stocke dans `zoniris.name` (collection lue par `/co2/zone/getzoniris`). Ne se saisit pas : il est pose par calcul geometrique ($geoWithin du `geoPosition` dans le `geoShape` du contour, cf. `/co2/zone/associatezoniris`). C'est la valeur que filtrent les sites — `filters: {"address.zoniris": "Guillaume"}`, ou `$in` pour plusieurs bassins — et celle qu'emet une carte de contours cliquables. AUCUN rapport avec la chaine `levelN`, qui s'arrete a l'EPCI (level5) : `zoniris` descend SOUS la commune. Peut etre vide.
+         */
+        zoniris?: string;
+        /**
+         * `_id` (24 hex, en STRING) du document `zoniris` designe par `zoniris`. Meme role que `localityId` face a `addressLocality` : il survit au renommage d'un contour et permet a l'association de reconnaitre ses propres ecritures lors d'un rejeu. Peut etre vide.
+         */
+        zonirisId?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -3335,6 +3351,14 @@ export interface AddProjectData {
          * Nom de l'EPCI. Peut être vide.
          */
         level5Name?: string;
+        /**
+         * NOM du decoupage infra-communal qui CONTIENT le point : bassin de vie, grand quartier, IRIS — tel que stocke dans `zoniris.name` (collection lue par `/co2/zone/getzoniris`). Ne se saisit pas : il est pose par calcul geometrique ($geoWithin du `geoPosition` dans le `geoShape` du contour, cf. `/co2/zone/associatezoniris`). C'est la valeur que filtrent les sites — `filters: {"address.zoniris": "Guillaume"}`, ou `$in` pour plusieurs bassins — et celle qu'emet une carte de contours cliquables. AUCUN rapport avec la chaine `levelN`, qui s'arrete a l'EPCI (level5) : `zoniris` descend SOUS la commune. Peut etre vide.
+         */
+        zoniris?: string;
+        /**
+         * `_id` (24 hex, en STRING) du document `zoniris` designe par `zoniris`. Meme role que `localityId` face a `addressLocality` : il survit au renommage d'un contour et permet a l'association de reconnaitre ses propres ecritures lors d'un rejeu. Peut etre vide.
+         */
+        zonirisId?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -3475,6 +3499,14 @@ export interface AddPoiData {
          * Nom de l'EPCI. Peut être vide.
          */
         level5Name?: string;
+        /**
+         * NOM du decoupage infra-communal qui CONTIENT le point : bassin de vie, grand quartier, IRIS — tel que stocke dans `zoniris.name` (collection lue par `/co2/zone/getzoniris`). Ne se saisit pas : il est pose par calcul geometrique ($geoWithin du `geoPosition` dans le `geoShape` du contour, cf. `/co2/zone/associatezoniris`). C'est la valeur que filtrent les sites — `filters: {"address.zoniris": "Guillaume"}`, ou `$in` pour plusieurs bassins — et celle qu'emet une carte de contours cliquables. AUCUN rapport avec la chaine `levelN`, qui s'arrete a l'EPCI (level5) : `zoniris` descend SOUS la commune. Peut etre vide.
+         */
+        zoniris?: string;
+        /**
+         * `_id` (24 hex, en STRING) du document `zoniris` designe par `zoniris`. Meme role que `localityId` face a `addressLocality` : il survit au renommage d'un contour et permet a l'association de reconnaitre ses propres ecritures lors d'un rejeu. Peut etre vide.
+         */
+        zonirisId?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -3785,6 +3817,14 @@ export interface AddEventData {
          * Nom de l'EPCI. Peut être vide.
          */
         level5Name?: string;
+        /**
+         * NOM du decoupage infra-communal qui CONTIENT le point : bassin de vie, grand quartier, IRIS — tel que stocke dans `zoniris.name` (collection lue par `/co2/zone/getzoniris`). Ne se saisit pas : il est pose par calcul geometrique ($geoWithin du `geoPosition` dans le `geoShape` du contour, cf. `/co2/zone/associatezoniris`). C'est la valeur que filtrent les sites — `filters: {"address.zoniris": "Guillaume"}`, ou `$in` pour plusieurs bassins — et celle qu'emet une carte de contours cliquables. AUCUN rapport avec la chaine `levelN`, qui s'arrete a l'EPCI (level5) : `zoniris` descend SOUS la commune. Peut etre vide.
+         */
+        zoniris?: string;
+        /**
+         * `_id` (24 hex, en STRING) du document `zoniris` designe par `zoniris`. Meme role que `localityId` face a `addressLocality` : il survit au renommage d'un contour et permet a l'association de reconnaitre ses propres ecritures lors d'un rejeu. Peut etre vide.
+         */
+        zonirisId?: string;
         postalCode?: string;
         streetAddress?: string;
     };
@@ -6164,6 +6204,39 @@ export interface GenerateAnswerFromFormData {
     };
     [k: string]: unknown;
 }
+export interface GenerateProjectFromAnswerData {
+    pathParams?: {
+        /**
+         * ID de la réponse (collection answers) à promouvoir en projet. Vide → {success:0, content:'Empty answer id'} (GenerateprojectAction.php:17-21).
+         */
+        answerId: string;
+        /**
+         * ID de l'entité parente (costum.contextId legacy) sous laquelle le projet est rattaché (GenerateprojectAction.php:40-46).
+         */
+        parentId: string;
+        /**
+         * Type de l'entité parente (costum.contextType legacy, ex: 'organizations') (GenerateprojectAction.php:40-46).
+         */
+        parentType: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export interface GenerateMilestoneFromDepenseData {
+    /**
+     * ID de la réponse (collection answers) portant la dépense. Vide → {success:0, content:'Empty answer id'} (DepenseMilestoneOperationAction.php:23-27). Sans project.id déjà posé sur l'answer → {success:0, content:"Don't have a project"} (:29-33) — cet endpoint est conçu pour être appelé APRÈS association/génération d'un projet, jamais avant.
+     */
+    answerId: string;
+    /**
+     * Clé (index) de la dépense dans answers.aapStep1.depense[] — PAS un id Mongo. Une clé qui ne matche aucune entrée du tableau ne déclenche pas d'erreur : la réponse reste {success:1} avec milestoneId vide (DepenseMilestoneOperationAction.php:39-43, $milestoneId non réaffecté dans ce cas).
+     */
+    depid: string;
+    /**
+     * Seule valeur modélisée par ce contrat (DepenseMilestoneOperationAction.php:36-50). Une valeur non reconnue, ou un answer sans aucune dépense, retombe sur le fallback {error:0} (:66, $args initial jamais modifié).
+     */
+    action: "generateMilestone";
+    [k: string]: unknown;
+}
 export interface FundingEnvelopeData {
     /**
      * ID du contexte de l’entité
@@ -6244,7 +6317,7 @@ export interface CostumProjectActionRequestNewData {
      */
     milestone?: {
         /**
-         * ID du jalon associé
+         * ID du jalon (project.oceco.milestones[].milestoneId) — chaîne LIBRE, aucun format garanti : ObjectId 24 hex (créé côté client via generateMilestoneId), uniqid() PHP 13 hex (Answer::generateMilestonneFromDepense, boucle de GenerateprojectAction sur les dépenses d'une réponse AAC promue en projet), ou identifiants legacy non-hex. Le backend ActionAction::run() case 'new' ne valide pas le format ; la seule vérif d'existence est Project.hasMilestone (appartenance à oceco.milestones[]).
          */
         milestoneId: string;
         /**
@@ -6568,6 +6641,14 @@ export interface AddClassifiedData {
         level4Name?: string;
         level5?: string;
         level5Name?: string;
+        /**
+         * NOM du decoupage infra-communal qui CONTIENT le point : bassin de vie, grand quartier, IRIS — tel que stocke dans `zoniris.name` (collection lue par `/co2/zone/getzoniris`). Ne se saisit pas : il est pose par calcul geometrique ($geoWithin du `geoPosition` dans le `geoShape` du contour, cf. `/co2/zone/associatezoniris`). C'est la valeur que filtrent les sites — `filters: {"address.zoniris": "Guillaume"}`, ou `$in` pour plusieurs bassins — et celle qu'emet une carte de contours cliquables. AUCUN rapport avec la chaine `levelN`, qui s'arrete a l'EPCI (level5) : `zoniris` descend SOUS la commune. Peut etre vide.
+         */
+        zoniris?: string;
+        /**
+         * `_id` (24 hex, en STRING) du document `zoniris` designe par `zoniris`. Meme role que `localityId` face a `addressLocality` : il survit au renommage d'un contour et permet a l'association de reconnaitre ses propres ecritures lors d'un rejeu. Peut etre vide.
+         */
+        zonirisId?: string;
         postalCode?: string;
         streetAddress?: string;
     };