@communecter/cocolight-api-client 1.0.120 → 1.0.122

package/src/api/EndpointApi.types.ts

@@ -4829,6 +4829,108 @@ 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;
 }
 
@@ -4891,7 +4993,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
    */
@@ -4936,6 +5038,18 @@ export interface DeleteDocumentByContextData {
 }
 
 
+export interface DeleteDocumentByIdData {
+  pathParams?: {
+    /**
+     * ID MongoDB du document à supprimer
+     */
+    id: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}
+
+
 export interface DemoteAdminData {
   parentId: string;
   /**
@@ -4973,6 +5087,27 @@ export interface CostumFilterCoformData {
 }
 
 
+export interface GetCountriesData {
+  /**
+   * Slug personnalisé
+   */
+  costumSlug?: string;
+  /**
+   * Mode édition personnalisé (boolean, string ou number)
+   */
+  costumEditMode?: ("true" | "false") | (0 | 1) | boolean;
+  /**
+   * ID personnalisé (format ObjectID MongoDB)
+   */
+  costumId?: string;
+  /**
+   * Type de collection
+   */
+  costumType?: "organizations" | "projects" | "events" | "citoyens" | "poi";
+  [k: string]: unknown;
+}
+
+
 export interface SearchZonesData {
   /**
    * Code du pays pour la recherche
@@ -5004,3 +5139,68 @@ 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/src/api/EntityRegistry.ts

@@ -1,7 +1,7 @@
 // TypeScript native types
 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; // Alias pour compatibilité
 type BaseEntity = import("./BaseEntity.js").BaseEntity<any>;
 type ApiClient = import("../ApiClient.js").default;
@@ -111,7 +111,8 @@ function _getCollectionFromTag(tag: EntityTag): CollectionKey | null {
     "News": "news",
     "Badge": "badges",
     "Comment": "comments",
-    "Answer": "answers"
+    "Answer": "answers",
+    "Form": "forms"
   };
   return map[tag] || null;
 }
@@ -134,6 +135,7 @@ function _getEntityMeta(entityType: CollectionKey, __entityTag: EntityTag): Enti
     News: selfTag === "News" ? selfClass : EntityRegistry.get("News"),
     Comment: selfTag === "Comment" ? selfClass : EntityRegistry.get("Comment"),
     Answer: selfTag === "Answer" ? selfClass : EntityRegistry.get("Answer"),
+    Form: selfTag === "Form" ? selfClass : EntityRegistry.get("Form"),
   };
 
   const map: Record<CollectionKey, EntityMeta> = {
@@ -151,6 +153,7 @@ function _getEntityMeta(entityType: CollectionKey, __entityTag: EntityTag): Enti
     } },
     comments:     { entityClass: commonDeps.Comment as EntityClass,      deps: { ...commonDeps } },
     answers:      { entityClass: commonDeps.Answer as EntityClass,       deps: { ...commonDeps } },
+    forms:        { entityClass: commonDeps.Form as EntityClass,         deps: { ...commonDeps } },
   };
   
   return map[entityType] || null;
@@ -201,6 +204,10 @@ export function createFromCollection(collection: CollectionKey, parent: ApiClien
     answers: {
       entityTag: "Answer",
       meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    forms: {
+      entityTag: "Form",
+      meta: tag => _buildMeta(tag, { remove: [] })
     }
   };
   const entry = _collectionMap[collection];
@@ -232,7 +239,8 @@ function _buildMeta(tag: EntityTag, options: { remove: string[] }): EntityMeta {
     Badge: EntityRegistry.get("Badge"),
     News: EntityRegistry.get("News"),
     Comment: EntityRegistry.get("Comment"),
-    Answer: EntityRegistry.get("Answer")
+    Answer: EntityRegistry.get("Answer"),
+    Form: EntityRegistry.get("Form")
   };
   // inject self
   (allDeps as any)[tag] = EntityClass;

package/src/api/Form.ts

@@ -0,0 +1,60 @@
+import { BaseEntity } from "./BaseEntity.js";
+import { ApiError } from "../error.js";
+
+import type { FormItemNormalized } from "./serverDataType/Form.js";
+
+export class Form extends BaseEntity<FormItemNormalized> {
+  static override entityType = "forms";
+
+  static override entityTag = "Form";
+  static override SCHEMA_CONSTANTS: string[] = [];
+
+  static ADD_BLOCKS: Map<string, string> = new Map([]);
+  static UPDATE_BLOCKS: Map<string, string> = new Map([]);
+  
+  override defaultFields: Record<string, any> = {};
+  override 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 override _transformServerData(data: FormItemNormalized): FormItemNormalized {
+    // Pour l'instant, on ne transforme pas les relations parent
+    // car elles peuvent être des Organizations ou Projects
+    // On pourrait ajouter cette transformation plus tard si nécessaire
+    
+    return data;
+  }
+
+  /**
+   * Rafraîchit les données du formulaire depuis l'API.
+   * Constant : GET_COFORM_BY_ID
+   */
+  override async get(): Promise<Record<string, any>> {
+    if (!this.id) throw new ApiError("Impossible de rafraîchir sans ID.", 400);
+    const parentFormId = this.id; // Type narrowing
+
+    const form = await this.endpointApi.getCoformById({
+      parentFormId
+    });
+
+    if (form?.data?.id || form?.data?._id) {
+      // Normaliser les valeurs nulles en objets/tableaux vides pour cohérence
+      const normalizedData = {
+        ...form.data,
+        inputs: form.data.inputs ?? {},
+        params: form.data.params ?? {},
+        subForms: form.data.subForms ?? [],
+        parent: form.data.parent ?? undefined,
+        config: form.data.config ?? undefined,
+      } as FormItemNormalized;
+      
+      this._setData(normalizedData, { forceInitialDraftReset: true });
+      return this.serverData;
+    }
+    throw new ApiError(`Aucun formulaire trouvé pour l'ID ${this.id}`, 404);
+  }
+}

package/src/api/User.ts

@@ -111,6 +111,7 @@ export 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;
     }
   ) {
     if(!deps.EndpointApi){
@@ -126,6 +127,7 @@ export class User extends BaseEntity<UserItemNormalized> {
     if (!deps.Poi) throw new ApiError("Poi class must be injected.", 500);
     if (!deps.Badge) throw new ApiError("Badge class must be injected.", 500);
     if (!deps.News) throw new ApiError("News class must be injected.", 500);
+    if (!deps.Answer) throw new ApiError("Answer class must be injected.", 500);
 
     super(parent, data, deps);
   }

package/src/api/UserApi.ts

@@ -1,5 +1,6 @@
 import ApiClient from "../ApiClient.js";
 import { ApiError, ApiResponseError } from "../error.js";
+import { Answer } from "./Answer.js";
 import { Badge } from "./Badge.js";
 import { Comment } from "./Comment.js";
 import EndpointApi from "./EndpointApi.js";
@@ -66,7 +67,7 @@ export class UserApi {
       this.loggedUser = new User(
         this.client,
         response.data.user,
-        { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment }
+        { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer }
       );
       return this.loggedUser;
     });
@@ -88,7 +89,7 @@ export class UserApi {
     this.loggedUser = new User(
       this.client,
       { id: this.client.userId },
-      { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment }
+      { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer }
     );
 
     return this.loggedUser;

package/src/api/serverDataType/Country.ts

@@ -0,0 +1 @@
+export type { ZoneItemNormalized as CountryItem } from "./Zone.js";

package/src/api/serverDataType/Form.ts

@@ -0,0 +1,56 @@
+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;
+}