@communecter/cocolight-api-client 1.0.51 → 1.0.55

package/src/api/{EndpointApi.types.d.ts → EndpointApi.types.ts}

@@ -1,3 +1,7 @@
+// Fichier généré automatiquement
+// Types générés depuis endpoints-copie.json
+/* eslint-disable @typescript-eslint/no-empty-object-type */
+
 export interface PersonRegisterData {
   /**
    * Nom complet de l'utilisateur
@@ -787,7 +791,7 @@ export interface GetCommentsData {
 
 export interface AddCommentsData {
   /**
-   * ID du commentaire parent (optionnel)
+   * ID du commentaire parent (optionnel) ou chaîne vide
    */
   parentCommentId?: string;
   /**
@@ -1155,14 +1159,12 @@ export interface GetProjectsNoAdminData {
    */
   notSourceKey: true;
   filters: {
-    $or: {};
+    $or?: Record<string, unknown>;
     /**
      * This interface was referenced by `undefined`'s JSON-Schema definition
      * via the `patternProperty` "^links\.contributors\.(?:[a-f0-9]{24}|@\w+)$".
      */
-    [k: string]: {
-      $exists: true;
-    };
+    [k: string]: unknown;
   };
   /**
    * Localité vide ou spécifique
@@ -1237,14 +1239,12 @@ export interface GetProjectsAdminData {
    */
   notSourceKey: true;
   filters: {
-    $or: {};
+    $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_]+)?))$".
      */
-    [k: string]: {
-      $exists: true;
-    };
+    [k: string]: unknown;
   };
   /**
    * Localité vide ou spécifique
@@ -4450,3 +4450,160 @@ export interface GetGalleryData {
   };
   [k: string]: unknown;
 }
+
+
+export interface GetAttendeesNoAdminData {
+  /**
+   * Nom ou terme recherché
+   */
+  name?: string;
+  /**
+   * Types d'entités à inclure dans la recherche
+   */
+  searchType: "citoyens"[];
+  /**
+   * Critère de recherche (actuellement vide)
+   */
+  searchBy?: "ALL";
+  /**
+   * Index de départ global pour la pagination
+   */
+  indexMin: number;
+  /**
+   * Index de fin global pour la pagination
+   */
+  indexMax?: number;
+  /**
+   * Nombre d’éléments à récupérer (limite de pagination)
+   */
+  indexStep: number;
+  /**
+   * Configuration des plages de résultats pour chaque type de recherche
+   */
+  ranges?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^[^\s]+$".
+     */
+    [k: string]: {
+      /**
+       * Index de départ pour la pagination
+       */
+      indexMin: number;
+      /**
+       * Index de fin pour la pagination
+       */
+      indexMax: number;
+    };
+  };
+  /**
+   * Type initial de la recherche, vide par défaut
+   */
+  initType: "";
+  /**
+   * Indique si les types doivent être comptés dans les résultats
+   */
+  count: true;
+  /**
+   * Liste fixe des types à compter dans les résultats
+   */
+  countType: "citoyens"[];
+  /**
+   * Flag pour ne pas filtrer sur une clé de source spécifique
+   */
+  notSourceKey: true;
+  filters: {
+    [k: string]: unknown;
+  };
+  /**
+   * Localité vide ou spécifique
+   */
+  locality: "";
+  /**
+   * Indique si la recherche doit s'étendre au Fediverse (toujours désactivé)
+   */
+  fediverse: false;
+  [k: string]: unknown;
+}
+
+
+export interface GetAttendeesAdminData {
+  /**
+   * Nom ou terme recherché
+   */
+  name?: string;
+  /**
+   * Types d'entités à inclure dans la recherche
+   */
+  searchType: "citoyens"[];
+  /**
+   * Critère de recherche (actuellement vide)
+   */
+  searchBy?: "ALL";
+  /**
+   * Index de départ global pour la pagination
+   */
+  indexMin: number;
+  /**
+   * Index de fin global pour la pagination
+   */
+  indexMax?: number;
+  /**
+   * Nombre d’éléments à récupérer (limite de pagination)
+   */
+  indexStep: number;
+  /**
+   * Configuration des plages de résultats pour chaque type de recherche
+   */
+  ranges?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^[^\s]+$".
+     */
+    [k: string]: {
+      /**
+       * Index de départ pour la pagination
+       */
+      indexMin: number;
+      /**
+       * Index de fin pour la pagination
+       */
+      indexMax: number;
+    };
+  };
+  /**
+   * Type initial de la recherche, vide par défaut
+   */
+  initType: "";
+  /**
+   * Indique si les types doivent être comptés dans les résultats
+   */
+  count: true;
+  /**
+   * Liste fixe des types à compter dans les résultats
+   */
+  countType: "citoyens"[];
+  /**
+   * Flag pour ne pas filtrer sur une clé de source spécifique
+   */
+  notSourceKey: true;
+  filters: {
+    [k: string]: unknown;
+  };
+  /**
+   * Localité vide ou spécifique
+   */
+  locality: "";
+  /**
+   * Indique si la recherche doit s'étendre au Fediverse (toujours désactivé)
+   */
+  fediverse: false;
+  pathParams?: {
+    /**
+     * ID du projet
+     */
+    id: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}

package/src/api/EntityRegistry.ts

@@ -0,0 +1,208 @@
+// TypeScript native types
+import type { CollectionType } from "../types/entities.js";
+
+export type EntityTag = "User" | "Organization" | "Project" | "Event" | "Poi" | "Badge" | "News" | "Comment";
+export type CollectionKey = CollectionType; // Alias pour compatibilité
+type BaseEntity = import("./BaseEntity.js").BaseEntity<any>;
+type ApiClient = import("../ApiClient.js").default;
+
+type EndpointApiClass = typeof import("./EndpointApi.js").default;
+type EntityConstructor = new (...args: any[]) => BaseEntity;
+type EntityClass = EntityConstructor & {
+  fromJSON?: (json: unknown, parent?: ApiClient | BaseEntity | null, deps?: EntityDeps) => BaseEntity;
+};
+type EntityDeps = Partial<Record<EntityTag | "EndpointApi", EntityClass | EndpointApiClass | undefined>>;
+
+/**
+ * Métadonnées de construction d'entité.
+ */
+type EntityMeta = {
+  entityClass: EntityClass;
+  deps: EntityDeps;
+};
+
+/**
+ * Types minimaux pour le JSON d'entité
+ */
+type MinimalEntityJSON = {
+  __entityTag: EntityTag;
+  serverData?: {
+    collection?: CollectionKey;
+  };
+};
+
+export const EntityRegistry: Map<EntityTag | "EndpointApi", EntityClass | EndpointApiClass> = new Map();
+
+// Overloads for registerEntity
+export function registerEntity(tag: "EndpointApi", EntityClass: EndpointApiClass): void;
+export function registerEntity(tag: EntityTag, EntityClass: EntityClass): void;
+export function registerEntity(tag: EntityTag | "EndpointApi", EntityClass: EntityClass | EndpointApiClass): void {
+  EntityRegistry.set(tag, EntityClass);
+}
+
+
+/**
+ * Type guard: vérifie si la valeur ressemble à un JSON d'entité.
+ */
+function isEntityJSON(v: unknown): v is MinimalEntityJSON {
+  return !!v && typeof v === "object"
+    && "__entityTag" in (v as any);
+}
+
+/**
+ * Récupère une instance depuis un JSON générique.
+ * Si la collection ou la métadonnée d'entité est absente, renvoie l'objet d'origine.
+ */
+export function fromEntityJSON(json: unknown, parent: ApiClient | BaseEntity | null = null): BaseEntity | unknown | null {
+  // On gère null / non-objet / pas une entité → on renvoie tel quel (ou null si tu préfères)
+  if (!isEntityJSON(json)) return json;
+
+  // Ici, TS sait que json.__entityTag existe
+  if (!json.serverData?.collection) return json;
+
+  const meta = _getEntityMeta(json.serverData.collection, json.__entityTag);
+  if (!meta) return json;
+
+  if (!meta.entityClass?.fromJSON) {
+    throw new Error(`Classe inconnue ou fromJSON manquant pour ${json.__entityTag}`);
+  }
+  return meta.entityClass.fromJSON(json, parent, meta.deps);
+}
+
+/**
+ * Récupère la classe d'entité et ses dépendances à partir du type d'entité.
+ */
+function _getEntityMeta(entityType: CollectionKey, __entityTag: EntityTag): EntityMeta | null {
+  const selfClass = EntityRegistry.get(__entityTag);
+  const selfTag = __entityTag;
+
+  console.log("=== _getEntityMeta DEBUG ===");
+  console.log("entityType:", entityType);
+  console.log("__entityTag:", __entityTag);
+  console.log("EntityRegistry.get('Comment'):", EntityRegistry.get("Comment"));
+
+  const commonDeps: EntityDeps = {
+    EndpointApi: EntityRegistry.get("EndpointApi"),
+    User: selfTag === "User" ? selfClass : EntityRegistry.get("User"),
+    Organization: selfTag === "Organization" ? selfClass : EntityRegistry.get("Organization"),
+    Project: selfTag === "Project" ? selfClass : EntityRegistry.get("Project"),
+    Event: selfTag === "Event" ? selfClass : EntityRegistry.get("Event"),
+    Poi: selfTag === "Poi" ? selfClass : EntityRegistry.get("Poi"),
+    Badge: selfTag === "Badge" ? selfClass : EntityRegistry.get("Badge"),
+    News: selfTag === "News" ? selfClass : EntityRegistry.get("News"),
+    Comment: selfTag === "Comment" ? selfClass : EntityRegistry.get("Comment"),
+  };
+
+  const map: Record<CollectionKey, EntityMeta> = {
+    citoyens:     { entityClass: commonDeps.User as EntityClass,         deps: commonDeps },
+    organizations:{ entityClass: commonDeps.Organization as EntityClass, deps: commonDeps },
+    projects:     { entityClass: commonDeps.Project as EntityClass,      deps: commonDeps },
+    events:       { entityClass: commonDeps.Event as EntityClass,        deps: { ...commonDeps, Badge: undefined } },
+    poi:          { entityClass: commonDeps.Poi as EntityClass,          deps: { ...commonDeps, Badge: undefined, News: undefined } },
+    news:         { entityClass: commonDeps.News as EntityClass,         deps: { ...commonDeps } },
+    badges:       { entityClass: commonDeps.Badge as EntityClass,        deps: { 
+      EndpointApi: commonDeps.EndpointApi, 
+      User: commonDeps.User, 
+      Organization: commonDeps.Organization, 
+      Project: commonDeps.Project 
+    } },
+    comments:     { entityClass: commonDeps.Comment as EntityClass,      deps: { ...commonDeps } }
+  };
+  
+  return map[entityType] || null;
+}
+
+type CollectionMapEntry = {
+  entityTag: EntityTag;
+  meta: (tag: EntityTag) => EntityMeta;
+};
+
+/**
+ * Crée une instance d'entité basée sur le seul nom de la collection.
+ */
+export function createFromCollection(collection: CollectionKey, parent: ApiClient | BaseEntity | null = null, data: object = {}): BaseEntity | null {
+  const _collectionMap: Record<CollectionKey, CollectionMapEntry> = {
+    citoyens: {
+      entityTag: "User",
+      meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    organizations: {
+      entityTag: "Organization",
+      meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    projects: {
+      entityTag: "Project",
+      meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    events: {
+      entityTag: "Event",
+      meta: tag => _buildMeta(tag, { remove: ["Badge"] })
+    },
+    poi: {
+      entityTag: "Poi",
+      meta: tag => _buildMeta(tag, { remove: ["Badge","News"] })
+    },
+    news: {
+      entityTag: "News",
+      meta: tag => _buildMeta(tag, { remove: [] })
+    },
+    badges: {
+      entityTag: "Badge",
+      meta: () => _buildCustomMeta("Badge")
+    },
+    comments: {
+      entityTag: "Comment",
+      meta: tag => _buildMeta(tag, { remove: [] })
+    }
+  };
+  const entry = _collectionMap[collection];
+  if (!entry) {
+    console.warn(`Collection inconnue : '${collection}'`);
+    return null;
+  }
+  const { entityTag, meta } = entry;
+  const { entityClass, deps } = meta(entityTag);
+  if (!entityClass) {
+    throw new Error(`EntityClass introuvable pour ${entityTag}`);
+  }
+  const Ctor = entityClass as EntityConstructor;
+  return new Ctor(parent, data, deps);
+}
+
+/**
+ * Construit entityClass et deps pour une collection standard.
+ */
+function _buildMeta(tag: EntityTag, options: { remove: string[] }): EntityMeta {
+  const EntityClass = EntityRegistry.get(tag) as EntityClass;
+  const allDeps: EntityDeps = {
+    EndpointApi: EntityRegistry.get("EndpointApi"),
+    User: EntityRegistry.get("User"),
+    Organization: EntityRegistry.get("Organization"),
+    Project: EntityRegistry.get("Project"),
+    Event: EntityRegistry.get("Event"),
+    Poi: EntityRegistry.get("Poi"),
+    Badge: EntityRegistry.get("Badge"),
+    News: EntityRegistry.get("News"),
+    Comment: EntityRegistry.get("Comment"),
+  };
+  // inject self
+  (allDeps as any)[tag] = EntityClass;
+  // remove undesired
+  options.remove.forEach(dep => delete (allDeps as any)[dep]);
+  return { entityClass: EntityClass, deps: allDeps };
+}
+
+/**
+ * Cas spécifique des badges : seules certaines dépendances.
+ */
+function _buildCustomMeta(tag: "Badge"): EntityMeta {
+  const EntityClass = EntityRegistry.get(tag) as EntityClass;
+  const deps: EntityDeps = {
+    EndpointApi: EntityRegistry.get("EndpointApi"),
+    User: EntityRegistry.get("User"),
+    Organization: EntityRegistry.get("Organization"),
+    Project: EntityRegistry.get("Project")
+  };
+  (deps as any)[tag] = EntityClass;
+  return { entityClass: EntityClass, deps };
+}