@communecter/cocolight-api-client 1.0.154 → 1.0.156

package/src/Api.ts

@@ -1,348 +0,0 @@
-// Api.ts
-import { Action } from "./api/Action.js";
-import { Answer } from "./api/Answer.js";
-import { Badge } from "./api/Badge.js";
-import { Classified } from "./api/Classified.js";
-import { Comment } from "./api/Comment.js";
-import EndpointApi from "./api/EndpointApi.js";
-import { createFromCollection, registerEntity } from "./api/EntityRegistry.js";
-import { Event } from "./api/Event.js";
-import { Form } from "./api/Form.js";
-import { News } from "./api/News.js";
-import { Organization } from "./api/Organization.js";
-import { Poi } from "./api/Poi.js";
-import { Project } from "./api/Project.js";
-import { User } from "./api/User.js";
-import { UserApi } from "./api/UserApi.js";
-import { ApiAuthenticationError, ApiClientError, ApiError, ApiResponseError } from "./error.js";
-
-import type { SearchTagsData } from "./api/EndpointApi.types.js";
-import type ApiClient from "./ApiClient.js";
-import type { ApiClientOptions } from "./ApiClient.js";
-import type { GetElementsKeyResponse } from "./types/api-responses.js";
-import type { EntityData, EntityTypes } from "./types/entities.js";
-
-registerEntity("User", User);
-registerEntity("Organization", Organization);
-registerEntity("Project", Project);
-registerEntity("Event", Event);
-registerEntity("Poi", Poi);
-registerEntity("Badge", Badge);
-registerEntity("EndpointApi", EndpointApi);
-// registerEntity("UserApi", UserApi);
-registerEntity("News", News);
-registerEntity("Comment", Comment);
-registerEntity("Answer", Answer);
-registerEntity("Form", Form);
-registerEntity("Classified", Classified);
-registerEntity("Action", Action);
-
-
-
-export default class Api {
-  private _loggedUser: User | null;
-  private _client: ApiClient;
-
-  /**
-   * Authentifie l'utilisateur et retourne une instance d'Api.
-   */
-  static async userLogin(
-    email: string,
-    password: string,
-    options: ApiClientOptions | ApiClient
-  ): Promise<Api> {
-    const userApi = Api.userApi(options);
-    return await Api.userApiLogin(userApi, email, password);
-  }
-
-  /**
-   * Crée une instance de UserApi avec les options fournies.
-   */
-  static userApi(options: ApiClientOptions | ApiClient): UserApi {
-    try {
-      const userApi = new UserApi(options);
-      return userApi;
-    } catch (error) {
-      console.error("[Api.userApi] Erreur lors de la création d'un objet utilisateur :", (error as Error).message);
-      throw error;
-    }
-  }
-  
-  /**
-   * Connecte un utilisateur avec un UserApi existant.
-   */
-  static async userApiLogin(
-    userApi: UserApi,
-    email: string,
-    password: string
-  ): Promise<Api> {
-    try {
-
-      if (!userApi) {
-        throw new ApiError("userApi is not defined", 500);
-      }
-      if(!userApi.client) {
-        throw new ApiError("userApi.client is not defined", 500);
-      }
-
-      if(userApi.client.isConnected) {
-        // Si l'utilisateur est déjà connecté, on le récupère
-        // et on ne fait pas de login
-        const loggedUser = await userApi.meIsconnected();
-        return new Api(loggedUser, userApi.client);
-      } else {
-        if (!email || !password) {
-          throw new ApiError("email and password are required", 400);
-        }
-        const loggedUser = await userApi.login(email, password);
-        return new Api(loggedUser, userApi.client);
-      }
-
-    } catch (error) {
-      if(error instanceof ApiClientError) {
-        if(error?.details?.error) {
-          throw new ApiAuthenticationError(error.details.error, error.status, error.details);
-        }
-      }
-      throw error;
-    }
-  }
-    
-  /**
-   * Construit une instance d'Api.
-   */
-  constructor(loggedUser: User | null, client: ApiClient) {
-    this._loggedUser = loggedUser;
-    this._client = client;
-  }
-
-  /**
-   * Retourne l'utilisateur connecté.
-   */
-  async me(): Promise<User> {
-    if (!this._loggedUser) {
-      throw new ApiAuthenticationError("Accès refusé : utilisateur non authentifié.", 401);
-    }
-    await this._loggedUser.get();
-    return this._loggedUser;
-  }
-
-  /**
-   * Crée une instance User (autre que le connecté).
-   */
-  async user(userData: EntityData): Promise<User> {
-    try {
-      if (!userData.id && !userData.slug) {
-        return new User(this._client, userData, { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Form, Classified, Action });
-      } else {
-        const user = new User(this._client, userData, { EndpointApi, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Form, Classified, Action });
-        await user.get();
-        return user;
-      }
-    } catch (error) {
-      console.error("[Api.user] Erreur lors de la création d'un objet utilisateur public :", (error as Error).message);
-      throw error;
-    }
-  }
-
-
-  /**
-   * Creates an Organization object and optionally retrieves its profile.
-   */
-  async organization(organizationData: EntityData): Promise<Organization> {
-    try {
-      const organization = new Organization(this._client, organizationData, { EndpointApi, User, Project, Event, Poi, Badge, News, Comment, Answer, Form, Classified, Action });
-      if (!organizationData.id && !organizationData.slug) {
-        throw new Error("Vous devez fournir un id ou un slug pour créer une instance Organization.");
-      }
-      await organization.get();
-      return organization;
-    } catch (error) {
-      console.error("[Api.organization] Erreur lors de la création d'un objet organisation :", (error as Error).message);
-      throw error;
-    }
-  }
-
-  /**
-   * Creates a new Project instance and optionally retrieves its profile.
-   */
-  async project(projectData: EntityData): Promise<Project> {
-    try {
-      const project = new Project(this._client, projectData, { EndpointApi, User, Organization, Event, Poi, Badge, News, Comment, Answer, Form, Classified, Action });
-      if (!projectData.id && !projectData.slug) {
-        throw new Error("Vous devez fournir un id ou un slug pour créer une instance Project.");
-      }
-      await project.get();
-      return project;
-    } catch (error) {
-      console.error("[Api.project] Erreur lors de la création d'un objet projet :", (error as Error).message);
-      throw error;
-    }
-  }
-
-  /**
-   * Creates a new Event instance and optionally retrieves its profile.
-   */
-  async event(eventData: EntityData): Promise<Event> {
-    try {
-      const event = new Event(this._client, eventData, { EndpointApi, User, Organization, Project, Poi, Badge, News, Comment, Answer, Form, Classified, Action });
-      if (!eventData.id && !eventData.slug) {
-        throw new Error("Vous devez fournir un id ou un slug pour créer une instance Event.");
-      }
-      await event.get();
-      return event;
-    } catch (error) {
-      console.error("[Api.event] Erreur lors de la création d'un objet événement :", (error as Error).message);
-      throw error;
-    }
-  }
-
-  /**
-   * Creates a new Poi instance and optionally retrieves its profile.
-   */
-  async poi(poiData: EntityData): Promise<Poi> {
-    try {
-      const poi = new Poi(this._client, poiData, { EndpointApi, User, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Form, Classified, Action });
-      if (!poiData.id && !poiData.slug) {
-        throw new Error("Vous devez fournir un id ou un slug pour créer une instance Poi.");
-      }
-      await poi.get();
-      return poi;
-    } catch (error) {
-      console.error("[Api.poi] Erreur lors de la création d'un objet poi :", (error as Error).message);
-      throw error;
-    }
-  }
-
-  /**
-   * Creates a new Answer instance and optionally retrieves answer data.
-   */
-  async answer(answerData: { id: string }): Promise<Answer> {
-    try {
-      const answer = new Answer(this._client, answerData, { EndpointApi, User, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Form, Classified, Action });
-      if (!answerData.id) {
-        throw new Error("Vous devez fournir un id pour créer une instance Answer.");
-      }
-      await answer.get();
-      return answer;
-    } catch (error) {
-      console.error("[Api.answer] Erreur lors de la création d'un objet Answer :", (error as Error).message);
-      throw error;
-    }
-  }
-
-  /**
-   * Creates a new Form instance and optionally retrieves form data.
-   */
-  async form(formData: { id: string }): Promise<Form> {
-    try {
-      const form = new Form(this._client, formData, { EndpointApi, User, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Form, Classified, Action });
-      if (!formData.id) {
-        throw new Error("Vous devez fournir un id pour créer une instance Form.");
-      }
-      await form.get();
-      return form;
-    } catch (error) {
-      console.error("[Api.form] Erreur lors de la création d'un objet Form :", (error as Error).message);
-      throw error;
-    }
-  }
-
-  async classified(classifiedData: EntityData): Promise<Classified> {
-    try {
-      const classified = new Classified(this._client, classifiedData, { EndpointApi, User, Organization, Project, Event, Poi, Badge, News, Comment, Answer, Form, Classified, Action });
-      if (!classifiedData.id && !classifiedData.slug) {
-        throw new Error("Vous devez fournir un id ou un slug pour créer une instance Classified.");
-      }
-      await classified.get();
-      return classified;
-    } catch (error) {
-      console.error("[Api.classified] Erreur lors de la création d'un objet Classified :", (error as Error).message);
-      throw error;
-    }
-  }
-
-  /**
-   * Retourne une entité à partir d'un slug.
-   */
-  async entitySlug(slug: string): Promise<EntityTypes> {
-    if (!slug) {
-      throw new ApiError("slug requis", 400);
-    }
-    try {
-      const data = await this.endpointApi.getElementsKey({
-        pathParams:{
-          slug: slug
-        }
-      }) as GetElementsKeyResponse;
-
-      if(data.contextId && data.contextType) {
-        const entity = createFromCollection(data.contextType, this._client, { id: data.contextId });
-        if (!entity) {
-          throw new ApiResponseError(`Le type d'entité pour le slug ${slug} n'est pas reconnu`, 200, data as object);
-        }
-        await entity.get();
-        // On sait que c'est l'un des types concrets → on caste
-        return entity as EntityTypes;
-      } else {
-        throw new ApiResponseError(`Le slug ${slug} n'est pas valide`, 200, data as object);
-      }
-    } catch (error) {
-      if(error instanceof ApiResponseError) {
-        throw new ApiResponseError(`Impossible de récupérer l'identifiant pour le slug ${slug}`, error.status, error.responseData);
-      } else {
-        throw error;
-      }
-    }
-
-  }
-
-  /**
-   * Retourne l'instance d'ApiClient.
-   */
-  get client(): ApiClient {
-    return this._client;
-  }
-
-  /**
-   * Retourne l'instance d'EndpointApi.
-   */
-  get endpointApi(): EndpointApi {
-    return new EndpointApi(this._client);
-  }
-
-  /**
-   * Recherche des tags correspondant à un mot-clé.
-   *
-   * Wrap de `SEARCH_TAGS` (auth=none) — accessible même non connecté.
-   * Méthode exposée sur la facade `Api` (pas d'entité hôte naturelle pour
-   * un index global de tags).
-   *
-   * @param q - Mot-clé de recherche (au moins 1 caractère).
-   * @returns Tableau de résultats : soit `[{tag}]` si aucun match (echo du
-   *          terme), soit `[{_id, tag, field_length}, ...]` avec les tags
-   *          existants triés par `field_length`.
-   * @throws {ApiError} 400 si `q` vide.
-   *
-   * @example
-   * const results = await api.searchTags("permac");
-   * results.forEach(t => console.log(t.tag, t.field_length));
-   */
-  async searchTags(q: string): Promise<unknown> {
-    if (typeof q !== "string" || q.length === 0) {
-      throw new ApiError("Le mot-clé `q` est requis pour searchTags.", 400);
-    }
-    const payload: SearchTagsData = { pathParams: { q } };
-    return this.endpointApi.searchTags(payload);
-  }
-
-  /**
-   * Déconnecte l'utilisateur et réinitialise la session.
-   */
-  logout(): void {
-    this._loggedUser = null;
-    this._client.resetSession();
-    this._client._logger.info("UserApi: User logged out");
-  }
-  
-}