@communecter/cocolight-api-client 1.0.121 → 1.0.122

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/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;
+}