@communecter/cocolight-api-client 1.0.121 → 1.0.123

package/src/index.ts

@@ -73,6 +73,7 @@ export type { Badge } from "./api/Badge.js";
 export type { News } from "./api/News.js";
 export type { Comment } from "./api/Comment.js";
 export type { Answer } from "./api/Answer.js";
+export type { Form } from "./api/Form.js";
 
 // Types ServerData (données normalisées reçues du serveur)
 export type * from "./api/serverDataType/User.js";
@@ -89,12 +90,13 @@ export type * from "./api/serverDataType/Poi.js";
 export type * from "./api/serverDataType/News.js";
 export type * from "./api/serverDataType/Comment.js";
 export type * from "./api/serverDataType/Answer.js";
+export type * from "./api/serverDataType/Form.js";
 export type * from "./api/serverDataType/common.js";
 export type * from "./api/serverDataType/Country.js";
 export type * from "./api/serverDataType/Zone.js";
 
 // Types utilitaires
-export type { PaginatorPage, PaginatorState } from "./api/BaseEntity.js";
+export type { PaginatorPage, PaginatorState, FundingEnvelopeResult } from "./api/BaseEntity.js";
 
 // Types de réponses, payloads, entités, et transforms
 export type * from "./types/index.js";

package/src/types/entities.ts

@@ -4,6 +4,7 @@ import type { Answer } from "../api/Answer.js";
 import type { Badge } from "../api/Badge.js";
 import type { Comment } from "../api/Comment.js";
 import type { Event } from "../api/Event.js";
+import type { Form } from "../api/Form.js";
 import type { News } from "../api/News.js";
 import type { Organization } from "../api/Organization.js";
 import type { Poi } from "../api/Poi.js";
@@ -13,7 +14,7 @@ import type { User } from "../api/User.js";
 /**
  * Union type for all possible entity types
  */
-export type EntityTypes = User | Organization | Project | Event | Poi | Badge | News | Comment | Answer;
+export type EntityTypes = User | Organization | Project | Event | Poi | Badge | News | Comment | Answer | Form;
 
 /**
  * Type union représentant les entités pouvant être retournées par une recherche.
@@ -33,7 +34,7 @@ export type EntityData =
 /**
  * Types de collection possibles
  */
-export type CollectionType = "citoyens" | "organizations" | "projects" | "events" | "poi" | "news" | "badges" | "comments" | "answers";
+export type CollectionType = "citoyens" | "organizations" | "projects" | "events" | "poi" | "news" | "badges" | "comments" | "answers" | "forms";
 
 /**
  * Types pour les références entre entités

package/types/Api.d.ts

@@ -1,6 +1,7 @@
 import { Answer } from "./api/Answer.js";
 import EndpointApi from "./api/EndpointApi.js";
 import { Event } from "./api/Event.js";
+import { Form } from "./api/Form.js";
 import { Organization } from "./api/Organization.js";
 import { Poi } from "./api/Poi.js";
 import { Project } from "./api/Project.js";
@@ -58,6 +59,12 @@ export default class Api {
     answer(answerData: {
         id: string;
     }): Promise<Answer>;
+    /**
+     * Creates a new Form instance and optionally retrieves form data.
+     */
+    form(formData: {
+        id: string;
+    }): Promise<Form>;
     /**
      * Retourne une entité à partir d'un slug.
      */

package/types/api/BaseEntity.d.ts

@@ -1,4 +1,4 @@
-import type { UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, GetNewsData, GetGalleryData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestDatesData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetOrganizationsAdminData, GetOrganizationsNoAdminData, GetProjectsAdminData, GetProjectsNoAdminData, GetPoisAdminData, GetPoisNoAdminData, GetSubscribersData, GetBadgesData, CoformAnswersSearchData, SearchMemberAutocompleteData, GetEventsData, CostumFilterCoformData, GetCountriesData, SearchZonesData } from "./EndpointApi.types.js";
+import type { UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, GetNewsData, GetGalleryData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestDatesData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetOrganizationsAdminData, GetOrganizationsNoAdminData, GetProjectsAdminData, GetProjectsNoAdminData, GetPoisAdminData, GetPoisNoAdminData, GetSubscribersData, GetBadgesData, CoformAnswersSearchData, SearchMemberAutocompleteData, GetEventsData, CostumFilterCoformData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, FundingEnvelopeData } from "./EndpointApi.types.js";
 import type { TransformsMap } from "../types/entities.js";
 import type { CountryItem } from "./serverDataType/Country.js";
 import type { ZoneItemNormalized } from "./serverDataType/Zone.js";
@@ -43,7 +43,8 @@ type News = import("./News.js").News;
 type Badge = import("./Badge.js").Badge;
 type Comment = import("./Comment.js").Comment;
 type Answer = import("./Answer.js").Answer;
-type AnyEntity = User | Organization | Project | Poi | EventEntity | Badge | News | Comment | Answer;
+type Form = import("./Form.js").Form;
+type AnyEntity = User | Organization | Project | Poi | EventEntity | Badge | News | Comment | Answer | Form;
 type ParentLike = BaseEntity<any> & {
     apiClient: ApiClient;
     userContext?: User | null;
@@ -63,6 +64,7 @@ interface Deps {
     News?: any;
     Comment?: any;
     Answer?: any;
+    Form?: any;
 }
 interface BaseEntityConfig {
     entityTag?: string;
@@ -77,6 +79,7 @@ interface EntityTypeMap {
     badges: Badge;
     comments: Comment;
     answers: Answer;
+    forms: Form;
 }
 type ReadableWithMeta = import("stream").Readable & {
     path?: string;
@@ -84,6 +87,17 @@ type ReadableWithMeta = import("stream").Readable & {
 };
 type UploadInput = File | Blob | Buffer | import("stream").Readable;
 type ValidatedUpload = File | Buffer | ReadableWithMeta;
+export type FundingEnvelopeResult = {
+    contextData?: AnyEntity | object;
+    context?: AnyEntity | object;
+    links?: object;
+    form?: object;
+    paymentMethods?: object;
+    nopropProject?: AnyEntity[] | object;
+    projects?: AnyEntity[] | any[];
+    userOrga?: AnyEntity[] | object;
+    [k: string]: unknown;
+};
 type PaginationCursor = {
     searchType?: string[];
     searchBy?: string;
@@ -1613,9 +1627,82 @@ export declare class BaseEntity<TServerData = any> {
      * @throws {Error}
      */
     costumEventRequestLoadContextTag(data?: Partial<Omit<CostumEventRequestLoadContextTagData, "pathParams">>): Promise<unknown>;
+    /**
+     * Recherche paginée des réponses CoForm liées à l'entité courante.
+     * Injecte automatiquement le contexte (costumSlug, contextId, contextType) via `_withCostumContext`,
+     * puis pagine via `_createPaginatorEngine`.
+     *
+     * `searchType` est pré-rempli à `["answers"]` si non fourni.
+     * Les autres champs required (`indexStep`, `count`, `initType`, `fediverse`)
+     * sont injectés automatiquement par AJV via les `default` du schema.
+     *
+     * @param data - Paramètres de recherche (partiels). Seuls `filters` et `fields` sont
+     *               généralement nécessaires côté appelant.
+     * @param options - Options de pagination
+     * @param options.restoredState - État de pagination à restaurer (pour reprendre une navigation)
+     * @returns Première page paginée avec `results` (Answer[]), `count`, `hasNext`, `hasPrev`, etc.
+     *
+     * @example
+     * const page = await organization.coformAnswersSearch({
+     *   filters: { form: "6927e9f0db22da724360303c" },
+     *   fields: ["vote", "voteCount", "user"],
+     *   sortBy: { created: -1 }
+     * });
+     * page.results;     // Answer[]
+     * page.count.total; // nombre total de résultats
+     * page.hasNext;     // true si une page suivante existe
+     */
     coformAnswersSearch(data?: Partial<CoformAnswersSearchData>, options?: {
         restoredState?: PaginatorState;
-    }): Promise<PaginatorPage<any>>;
+    }): Promise<PaginatorPage<Answer>>;
+    /**
+     * Récupère les réponses pour plusieurs formulaires CoForm.
+     * Chaque entrée du résultat contient les `answers` liées en entités
+     * et les `documents` associés.
+     *
+     * @param data - Paramètres de recherche
+     * @param data.forms - Objet `{ [formId]: pathDeRecherche }` — au moins une entrée requise.
+     *                     Chaque clé est un ObjectID de formulaire, chaque valeur est un chemin
+     *                     dot-notation vers le champ answers (ex: `"answers.xxx.finderxxx.orgId"`).
+     * @returns Tableau d'items par formulaire, avec `answers` transformées en entités
+     * @throws {ApiError} Si `forms` est absent, vide, ou n'est pas un objet
+     *
+     * @example
+     * const results = await organization.searchAnswersByForms({
+     *   forms: {
+     *     "646498a5f2b3d6423d74b7f6": "answers.formName.finderPath.orgId",
+     *     "645b300b6d70bb35426fc0e3": "answers.formName.finderPath.orgId"
+     *   }
+     * });
+     */
+    searchAnswersByForms(data?: Partial<CoformAnswersByFormsData>): Promise<{
+        answers: Answer[];
+        documents: any[];
+        [k: string]: unknown;
+    }[]>;
+    /**
+     * Récupère les informations d'enveloppes de financement pour l'entité courante.
+     * Injecte automatiquement le contexte (costumSlug, contextId, contextType) via `_withCostumContext`.
+     *
+     * Les champs `contextData`, `context`, `nopropProject`, `projects` et `userOrga`
+     * de la réponse sont automatiquement liés en entités quand possible.
+     *
+     * @param data - Paramètres optionnels de recherche
+     * @param data.action - Action à effectuer (`"getEnvelopeData"`, `"getFormData"`, etc.)
+     * @param data.formId - ID du formulaire cible (pour `action: "getFormData"`)
+     * @param data.financerId - ID du financeur pour filtrer
+     * @param data.financerType - Type du financeur (ex: `"citoyens"`)
+     * @param data.params - Paramètres supplémentaires (ex: `{ project: "all" }`)
+     * @returns Données d'enveloppe avec entités liées
+     *
+     * @example
+     * const envelope = await organization.fundingEnvelope({
+     *   action: "getEnvelopeData"
+     * });
+     * envelope.form;       // données du formulaire
+     * envelope.projects;   // Project[] liés
+     */
+    fundingEnvelope(data?: Partial<Omit<FundingEnvelopeData, "contextId" | "contextType">>): Promise<FundingEnvelopeResult>;
     /**
      * Récupère les filtres disponibles basés sur les réponses CoForm de l'entité courante.
      * Utilise le contexte Communecter (costumSlug, contextId, contextType) de l'entité.
@@ -1665,6 +1752,15 @@ export declare class BaseEntity<TServerData = any> {
      * countries[0].countryCode; // "FR"
      */
     getCountries(data?: Partial<GetCountriesData>): Promise<CountryItem[]>;
+    /**
+     * Generer un nouveau identifiant unique pour un answers basé sur un formulaire donnée
+     *
+     * @param formId - Identifiant du formulaire pour lequel générer un nouvel ID d'answers
+     * @returns Un nouvel answers avec le nouveau ID généré
+     * @throws {ApiError} Si formId est absent ou invalide
+     *
+     */
+    generateNewAnswerId(formId: string): Promise<any>;
     /**
      * ───────────────────────────────
      * Pagination restoration methods

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { 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, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DemoteAdminData, CostumFilterCoformData, GetCountriesData, SearchZonesData } from "./EndpointApi.types.js";
+import type { 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, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, SaveCoformAnswerData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -1009,6 +1009,45 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     coformAnswersById(data: CoformAnswersByIdData): Promise<any>;
+    /**
+     * Récupérer un formulaire par son ID : Récupère les informations complètes d'un formulaire CoForm par son ID parent
+     * Constant : GET_COFORM_BY_ID
+     * @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.
+     */
+    getCoformById(data: GetCoformByIdData): Promise<any>;
+    /**
+     * Uploader un fichier de réponse CoForm : Endpoint de pré-upload CoForm (image/document). Si answerId est absent, l'endpoint crée un MongoId de réponse, réutilise la logique d'upload document existante et retourne answerId + docPath.
+     * Constant : COFORM_UPLOAD_ANSWER_FILE
+     * @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.
+     */
+    coformUploadAnswerFile(data: CoformUploadAnswerFileData): Promise<any>;
+    /**
+     * Récupérer les fichiers d'une réponse CoForm : Récupère la liste des fichiers uploadés pour un input spécifique dans une réponse CoForm. Utilisé pour récupérer les fichiers de l'ancien système qui n'ont que 'updateDate' sans la clé 'files'.
+     * Constant : COFORM_GET_ANSWER_FILES
+     * @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.
+     */
+    coformGetAnswerFiles(data: CoformGetAnswerFilesData): Promise<any>;
+    /**
+     * Sauvegarder une réponse de formulaire CoForm : Enregistre ou met à jour les réponses d'un utilisateur pour un formulaire CoForm
+     * Constant : SAVE_COFORM_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.
+     */
+    saveCoformAnswer(data: SaveCoformAnswerData): Promise<any>;
     /**
      * Voter sur un élément (commentaire ou news) : Permet de voter sur un commentaire ou une news en spécifiant un statut de vote
      * Constant : ADD_VOTE
@@ -1049,6 +1088,16 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     deleteDocumentByContext(data: DeleteDocumentByContextData): Promise<any>;
+    /**
+     * Supprimer un document par son ID : Supprime un document (fichier ou image) par son identifiant MongoDB
+     * Constant : DELETE_DOCUMENT_BY_ID
+     * @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.
+     */
+    deleteDocumentById(data: DeleteDocumentByIdData): Promise<any>;
     /**
      * Rétirer les droits d’administrateur d’un membre : Rétirer les droits d’administrateur d’un membre d’une organisation ou d’un projet
      * Constant : DEMOTE_ADMIN
@@ -1086,5 +1135,32 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     searchZones(data: SearchZonesData): Promise<any>;
+    /**
+     * Recuperer la liste des reponses pour plusieurs formulaires : Recuperer la liste des reponses pour plusieurs formulaires
+     * Constant : COFORM_ANSWERS_BY_FORMS
+     * @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.
+     */
+    coformAnswersByForms(data: CoformAnswersByFormsData): Promise<any>;
+    /**
+     * Generer une nouvelle reponse à partir d'un formulaire : Generer une nouvelle reponse à partir d'un formulaire
+     * Constant : GENERATE_ANSWER_FROM_FORM
+     * @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.
+     */
+    generateAnswerFromForm(data: GenerateAnswerFromFormData): Promise<any>;
+    /**
+     * Trouver les informations sur les enveloppes d’un formulaire : Trouver les informations sur les enveloppes d’un formulaire
+     * Constant : FUNDING_ENVELOPE
+     * @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.
+     */
+    fundingEnvelope(data: FundingEnvelopeData): Promise<any>;
 }
 export default EndpointApi;

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

@@ -2543,6 +2543,36 @@ export interface AddOrganizationData {
         float: true;
         [k: string]: unknown;
     };
+    costum?: {
+        bannerImageUrl?: string;
+        bannerLogoUrl?: string;
+        bannerText?: string;
+        /**
+         * Pour bien indiquer que l'orga est un commune transparente
+         */
+        transparentCommune?: boolean;
+        /**
+         * Pour bien indiquer que l'orga est un centre ville
+         */
+        cocity?: boolean;
+        slug?: string;
+        typeCocity?: string;
+        [k: string]: unknown;
+    };
+    /**
+     * Thématiques de l’organisation
+     */
+    thematic?: string[];
+    /**
+     * Dictionnaire de filières par thématique
+     */
+    filiere?: {
+        [k: string]: {
+            name: string;
+            icon: string;
+            tags: string[];
+        };
+    };
     address?: {
         "@type": "PostalAddress";
         addressCountry: string;
@@ -4441,6 +4471,100 @@ export interface CoformAnswersByIdData {
      * Liste des champs à retourner
      */
     fields?: string[];
+    /**
+     * ID du formulaire parent (utilisé pour calculer les droits d'édition côté serveur)
+     */
+    formId?: string;
+    [k: string]: unknown;
+}
+export interface GetCoformByIdData {
+    /**
+     * ID du formulaire parent à récupérer
+     */
+    parentFormId: string;
+    [k: string]: unknown;
+}
+export interface CoformUploadAnswerFileData {
+    /**
+     * ID du formulaire parent (pour contrôles d'accès).
+     */
+    formId: string;
+    /**
+     * ID de réponse existant. Si absent, un MongoId est généré côté serveur.
+     */
+    answerId?: string;
+    /**
+     * Type de document à uploader.
+     */
+    docType?: "image" | "file";
+    /**
+     * Clé de contenu (ex: slider pour images).
+     */
+    contentKey?: string;
+    /**
+     * Sous-clé optionnelle pour rattachement du document.
+     */
+    subKey?: string;
+    /**
+     * UUID client du fichier (compat fine-uploader).
+     */
+    qquuid: string;
+    /**
+     * Nom original du fichier.
+     */
+    qqfilename: string;
+    /**
+     * Taille du fichier en octets.
+     */
+    qqtotalfilesize: number;
+    /**
+     * Fichier binaire multipart.
+     */
+    qqfile: {
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export interface CoformGetAnswerFilesData {
+    /**
+     * ID de la réponse CoForm
+     */
+    answerId: string;
+    /**
+     * Clé d'identification de l'input (ex: formId.inputId)
+     */
+    subKey: string;
+    /**
+     * Clé de contenu utilisée lors de l'upload
+     */
+    contentKey?: string;
+    /**
+     * Type de document à récupérer
+     */
+    docType?: "image" | "file";
+    [k: string]: unknown;
+}
+export interface SaveCoformAnswerData {
+    /**
+     * ID du formulaire parent
+     */
+    formId: string;
+    /**
+     * Réponses du formulaire sérialisées en JSON, organisées par subFormId > inputId > valeur
+     */
+    answers: string;
+    /**
+     * ID d'une réponse existante (pour mise à jour)
+     */
+    answerId?: string;
+    /**
+     * Options ajoutées dynamiquement sérialisées en JSON (pour multiCheckboxPlus avec addValue)
+     */
+    addedOptions?: string;
+    /**
+     * Links des champs Finder sérialisés en JSON (pour answer.links). Format: { "organizations": { "mongoId": { "name": "...", "type": "organizations" } } }
+     */
+    links?: string;
     [k: string]: unknown;
 }
 export interface AddVoteData {
@@ -4497,7 +4621,7 @@ export interface UpdatePathValueData {
     /**
      * Collection de l’entité
      */
-    collection: "citoyens" | "organizations" | "projects" | "events" | "poi";
+    collection: "citoyens" | "organizations" | "projects" | "events" | "poi" | "answers" | "forms";
     /**
      * Chemin de la valeur à mettre à jour
      */
@@ -4538,6 +4662,16 @@ export interface DeleteDocumentByContextData {
     };
     [k: string]: unknown;
 }
+export interface DeleteDocumentByIdData {
+    pathParams?: {
+        /**
+         * ID MongoDB du document à supprimer
+         */
+        id: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
 export interface DemoteAdminData {
     parentId: string;
     /**
@@ -4621,3 +4755,62 @@ export interface SearchZonesData {
     costumType?: string;
     [k: string]: unknown;
 }
+export interface CoformAnswersByFormsData {
+    /**
+     * Liste des IDs de formulaires pour lesquels récupérer les réponses et le champ de recherche
+     */
+    forms?: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[a-fA-F0-9]{24}$".
+         */
+        [k: string]: string;
+    };
+    [k: string]: unknown;
+}
+export interface GenerateAnswerFromFormData {
+    action?: string;
+    pathParams?: {
+        /**
+         * ID du formulaire pour lequel générer une nouvelle réponse
+         */
+        formId: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export interface FundingEnvelopeData {
+    /**
+     * ID du contexte de l’entité
+     */
+    contextId: string;
+    /**
+     * Type de contexte de l’entité
+     */
+    contextType: string;
+    /**
+     * ID du formulaire pour lequel générer une nouvelle réponse
+     */
+    formId?: string;
+    action?: string;
+    /**
+     * ID du projet
+     */
+    project?: string;
+    /**
+     * ID de la réponse
+     */
+    answer?: string;
+    /**
+     * ID du financeur
+     */
+    financerId?: string;
+    financerType?: string;
+    /**
+     * Paramètres supplémentaires pour la recherche d’enveloppes
+     */
+    params?: {
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}

package/types/api/EntityRegistry.d.ts

@@ -1,5 +1,5 @@
 import type { CollectionType } from "../types/entities.js";
-export type EntityTag = "User" | "Organization" | "Project" | "Event" | "Poi" | "Badge" | "News" | "Comment" | "Answer";
+export type EntityTag = "User" | "Organization" | "Project" | "Event" | "Poi" | "Badge" | "News" | "Comment" | "Answer" | "Form";
 export type CollectionKey = CollectionType;
 type BaseEntity = import("./BaseEntity.js").BaseEntity<any>;
 type ApiClient = import("../ApiClient.js").default;

package/types/api/Form.d.ts

@@ -0,0 +1,23 @@
+import { BaseEntity } from "./BaseEntity.js";
+import type { FormItemNormalized } from "./serverDataType/Form.js";
+export declare class Form extends BaseEntity<FormItemNormalized> {
+    static entityType: string;
+    static entityTag: string;
+    static SCHEMA_CONSTANTS: string[];
+    static ADD_BLOCKS: Map<string, string>;
+    static UPDATE_BLOCKS: Map<string, string>;
+    defaultFields: Record<string, any>;
+    removeFields: string[];
+    /**
+     * Transforme les champs imbriqués en instances d'entités si nécessaire.
+     * @param data - Les données brutes du serveur.
+     * @returns Les données transformées.
+     * @protected
+     */
+    protected _transformServerData(data: FormItemNormalized): FormItemNormalized;
+    /**
+     * Rafraîchit les données du formulaire depuis l'API.
+     * Constant : GET_COFORM_BY_ID
+     */
+    get(): Promise<Record<string, any>>;
+}

package/types/api/Organization.d.ts

@@ -295,5 +295,5 @@ export declare class Organization extends BaseEntity<OrganizationItemNormalized>
       *
       * Cette méthode est redéfinie ici pour fournir des types spécifiques à l'entité Answer.
       */
-    coformAnswersSearch(data: Parameters<BaseEntity<OrganizationItemNormalized>["coformAnswersSearch"]>[0]): Promise<PaginatorPage<any>>;
+    coformAnswersSearch(data: Parameters<BaseEntity<OrganizationItemNormalized>["coformAnswersSearch"]>[0]): Promise<PaginatorPage<import("./Answer.js").Answer>>;
 }

package/types/api/User.d.ts

@@ -44,6 +44,7 @@ export declare class User extends BaseEntity<UserItemNormalized> {
         Badge: typeof import("./Badge.js").Badge;
         News: typeof import("./News.js").News;
         Comment: typeof import("./Comment.js").Comment;
+        Answer: typeof import("./Answer.js").Answer;
     });
     get slug(): any;
     get isMe(): boolean;

package/types/api/serverDataType/Form.d.ts

@@ -0,0 +1,51 @@
+import { DateValue, IdObject, ParentsMap } from "./common.js";
+import type EJSONType from "../../EJSONType.js";
+type ObjectIDCtor = typeof EJSONType["ObjectID"];
+type ObjectID = InstanceType<ObjectIDCtor>;
+export interface FormSubFormInputField {
+    label?: string;
+    placeholder?: string;
+    info?: string;
+    type?: string;
+    positions?: Record<string, string>;
+    markdown?: boolean;
+    uploader?: Record<string, any>;
+    [key: string]: unknown;
+}
+export interface FormSubFormInputs {
+    name: string;
+    info?: string;
+    id: string;
+    formParent: string;
+    hasMultiEval?: boolean;
+    inputs: Record<string, FormSubFormInputField>;
+    [key: string]: unknown;
+}
+export interface FormItemJson {
+    _id: IdObject;
+    config?: string | null;
+    parent?: ParentsMap | null;
+    subForms?: string[] | null;
+    type: string;
+    created?: DateValue;
+    creator?: string;
+    params?: Record<string, unknown> | null;
+    updated?: DateValue;
+    inputs?: Record<string, FormSubFormInputs> | null;
+    [key: string]: unknown;
+}
+export interface FormItemNormalized {
+    id: string;
+    _id: ObjectID;
+    config?: string | null;
+    parent?: ParentsMap | null;
+    subForms?: string[] | null;
+    type: string;
+    created?: Date;
+    creator?: string;
+    params?: Record<string, unknown> | null;
+    updated?: Date;
+    inputs?: Record<string, FormSubFormInputs> | null;
+    [key: string]: unknown;
+}
+export {};