@communecter/cocolight-api-client 1.0.54 → 1.0.56

package/types/ApiClient.d.ts

@@ -1,9 +1,54 @@
+import { EventEmitter } from "events";
+import { type TokenStorageStrategy } from "./utils/TokenStorage.js";
+/**
+ * Résultat retourné quand une requête est **mise en file** (offline ou breaker).
+ * Permet de typer précisément les chemins « non-réseau » de `callEndpoint`.
+ */
+export interface ApiClientOfflineEnqueueResult {
+    data: null;
+    offline?: true;
+    breaker?: true;
+}
+/**
+ * Options de configuration pour ApiClient
+ */
+export interface ApiClientOptions {
+    baseURL: string;
+    accessToken?: string | null;
+    refreshToken?: string | null;
+    refreshUrl?: string;
+    endpoints?: any[];
+    timeout?: number;
+    debug?: boolean;
+    maxRetries?: number;
+    circuitBreakerThreshold?: number;
+    circuitBreakerResetTime?: number;
+    fromJSONValue?: boolean;
+    tokenStorageStrategy?: TokenStorageStrategy | null;
+}
+/**
+ * Structure des données pour les appels d'endpoint
+ */
+export interface CallEndpointData {
+    pathParams?: Record<string, any>;
+    [key: string]: any;
+}
+/**
+ * Résultat d'un appel d'endpoint réussi
+ */
+export interface CallEndpointResult<T = any> {
+    data: T;
+    offline?: never;
+    breaker?: never;
+}
+/**
+ * Union type pour tous les résultats possibles de callEndpoint
+ */
+export type CallEndpointResponse<T = any> = CallEndpointResult<T> | ApiClientOfflineEnqueueResult;
 /**
  * Client générique pour consommer une API REST avec validation AJV, gestion des tokens,
  * circuit breaker, retry automatique, et support offline.
  *
- * @extends EventEmitter
- *
  * @fires ApiClient#retryAttempt
  * @fires ApiClient#queuedOffline
  * @fires ApiClient#circuitBreakerOpen
@@ -15,148 +60,106 @@
  * @fires ApiClient#offlineModeChanged
  * @fires ApiClient#userLoggedIn
  */
-export default class ApiClient extends EventEmitter<[never]> {
-    static stripNullsInPlace(obj: any): any;
-    /**
-     * Converts an object to URL search parameters.
-     *
-     * @param {Object} obj - The object to be converted to URL search parameters.
-     * @param {Object} [options={}] - Optional settings for the conversion.
-     * @returns {URLSearchParams} The URL search parameters generated from the object.
-     */
-    static toURLSearchParams(obj: any, options?: any): URLSearchParams;
-    /**
-     * Builds parameters for an API request from a given object.
-     *
-     * @param {Object} obj - The object to be converted into parameters.
-     * @param {FormData|URLSearchParams} paramsInstance - The instance to which the parameters will be appended.
-     * @param {Object} [options={}] - Optional settings.
-     * @param {boolean} [options.dots=false] - Whether to use dots in the parameter keys.
-     * @param {boolean} [options.indexes=false] - Whether to include array indexes in the parameter keys.
-     * @param {boolean} [options.metaTokens=true] - Whether to include meta tokens in the parameter keys.
-     * @throws {TypeError} If the provided obj is not an object or is null.
-     * @returns {FormData|URLSearchParams} The instance with the appended parameters.
-     */
-    static _buildParams(obj: any, paramsInstance: FormData | URLSearchParams, options?: {
-        dots?: boolean;
-        indexes?: boolean;
-        metaTokens?: boolean;
-    }): FormData | URLSearchParams;
-    /**
-     * @param {ApiClientOptions} [options]
-     */
-    constructor({ baseURL, accessToken, refreshToken, refreshUrl, endpoints, timeout, debug, maxRetries, circuitBreakerThreshold, circuitBreakerResetTime, fromJSONValue, tokenStorageStrategy }?: ApiClientOptions);
-    __entityTag: string;
-    _baseURL: string;
-    _refreshUrl: string;
-    _endpoints: any[];
-    _debug: boolean;
-    _offlineClientManager: any;
-    _fromJSONValue: boolean;
-    _setUserId: (id: any) => void;
-    _ajv: any;
+export default class ApiClient extends EventEmitter {
+    readonly __entityTag: string;
+    readonly userId: string | null;
+    private readonly _baseURL;
+    private readonly _refreshUrl;
+    private readonly _endpoints;
+    private readonly _debug;
+    private readonly _fromJSONValue;
+    private readonly _tokenStorage;
+    private _offlineClientManager;
+    private _ajv;
     _logger: any;
-    _client: any;
-    _breakerThreshold: number;
-    _breakerResetTime: number;
-    _breakerErrorCount: number;
-    _breakerOpen: boolean;
-    /** @type {string|null} */
-    _lastBreakerOpenTime: string | null;
-    /** @type {string|null} */
-    _accessToken: string | null;
-    /** @type {string|null} */
-    _refreshToken: string | null;
-    /** @type {TokenStorageStrategy} */
-    _tokenStorage: TokenStorageStrategy;
+    private _client;
+    private readonly _breakerThreshold;
+    private readonly _breakerResetTime;
+    private _breakerErrorCount;
+    private _breakerOpen;
+    private _lastBreakerOpenTime;
+    private _accessToken;
+    private _refreshToken;
+    private _setUserId;
+    constructor({ baseURL, accessToken, refreshToken, refreshUrl, endpoints, timeout, debug, maxRetries, circuitBreakerThreshold, circuitBreakerResetTime, fromJSONValue, tokenStorageStrategy }: ApiClientOptions);
     /**
      * Sets the access token for the API client and updates the authorization header.
-     *
-     * @param {string|null} token - The access token to be set.
      */
     setToken(token: string | null): void;
     /**
      * Retrieves the current access token.
-     *
-     * @returns {string|null} The access token.
      */
     getToken(): string | null;
     /**
      * Sets the refresh token for the API client.
-     *
-     * @param  {string|null} token - The refresh token to be set.
      */
     setRefreshToken(token: string | null): void;
     /**
      * Retrieves the current refresh token.
-     *
-     * @returns {string|null} The refresh token.
      */
     getRefreshToken(): string | null;
     /**
      * Indique si le client est connecté.
      * On considère que le client est connecté si un token d'accès (_accessToken) est défini.
-     *
-     * @returns {boolean} True si connecté, false sinon.
      */
     get isConnected(): boolean;
     /**
-   * Extrait l'identifiant depuis un JWT.
-   *
-   * @param {string} token - Le token JWT (accessToken ou refreshToken).
-   * @returns {string|null} L'identifiant extrait ou null si non trouvé.
-   */
-    _getIdFromToken(token: string): string | null;
+     * Extrait l'identifiant depuis un JWT.
+     */
+    private _getIdFromToken;
     /**
      * Méthode simplifiée de refresh (en JSON).
      * Emet un event refreshSuccess si ça marche
      */
-    _refreshAccessToken(): Promise<boolean>;
+    private _refreshAccessToken;
     /**
      * checkCircuitBreaker : vérifie si on peut appeler l'API ou non
-     * si le breaker est \"open\", on regarde si on peut \"reset\"
+     * si le breaker est "open", on regarde si on peut "reset"
      */
-    _checkCircuitBreaker(): boolean;
+    private _checkCircuitBreaker;
     /**
      * updateCircuitBreaker : incremente le compteur d'erreurs
-     * si on dépasse le threshold, on \"open\" le breaker.
+     * si on dépasse le threshold, on "open" le breaker.
      */
-    _updateCircuitBreakerError(): void;
+    private _updateCircuitBreakerError;
     /**
      * resetCircuitBreaker : en cas de succès on reset le compteur
      */
-    _resetCircuitBreakerSuccess(): void;
-    _resolveSpecialValuesInPlace(obj: any, pathParams?: {}): any;
-    _cleanSchemaLeftoverAlias(obj: any): any;
+    private _resetCircuitBreakerSuccess;
+    static stripNullsInPlace(obj: any): any;
+    private _resolveSpecialValuesInPlace;
+    private _cleanSchemaLeftoverAlias;
     /**
      * Safely calls an asynchronous function and handles any errors that occur.
      * Logs the error message using the instance's logger before re-throwing the error.
      *
-     * @param {Function} fn - The asynchronous function to be called.
-     * @param {...any} args - The arguments to pass to the function.
-     * @returns {Promise<any>} The result of the asynchronous function.
+     * @param fn - The asynchronous function to be called.
+     * @param args - The arguments to pass to the function.
+     * @returns The result of the asynchronous function.
      * @throws {Error} Re-throws any error that occurs during the function execution.
      */
-    safeCall(fn: Function, ...args: any[]): Promise<any>;
+    safeCall(fn: (...args: any[]) => Promise<any>, ...args: any[]): Promise<any>;
     /**
-     * Calls an API endpoint with the specified parameters.
+     * Appelle un endpoint avec validations AJV, auth et circuit breaker.
+     * En cas d’indisponibilité (offline ou breaker), **met en file** l’action via
+     * `_offlineClientManager` si présent.
      *
-     * @param {string} constant - The constant representing the endpoint to call.
-     * @param {Object} [data={}] - The data to send with the request.
-     * @param {boolean|function} [transformResponseData=true] - Whether to transform the response data or a function to transform it.
-     * @param {boolean} [validateResponseSchema=true] - Whether to validate the response schema.
-     * @returns {Promise<Object>} The response from the API.
+     * @param constant - The constant representing the endpoint to call.
+     * @param data - Données envoyées (incluant éventuellement `pathParams`).
+     * @param transformResponseData - `true` (transforme via `_transformData`), `false`, ou une fonction `(data) => any`.
+     * @param validateResponseSchema - Whether to validate the response schema.
+     * @returns The response from the endpoint call, or an enqueue result if offline or breaker is active.
      * @throws {CircuitBreakerError} If the circuit breaker is activated.
      * @throws {ApiClientError} If the endpoint is not found, token is required but not provided, or validation fails.
      */
-    callEndpoint(constant: string, data?: any, transformResponseData?: boolean | Function, validateResponseSchema?: boolean): Promise<any>;
+    callEndpoint<T = any>(constant: string, data?: CallEndpointData, transformResponseData?: boolean | ((data: any) => any), validateResponseSchema?: boolean): Promise<CallEndpointResponse<T>>;
     /**
      * Converts AJV (Another JSON Schema Validator) errors into human-readable messages.
      *
-     * @param {Array} errors - An array of AJV validation error objects.
-     * @returns {Array<string>} An array of human-readable error messages extracted from the AJV errors.
+     * @param errors - An array of AJV validation error objects.
+     * @returns An array of human-readable error messages extracted from the AJV errors.
      */
-    _ajvErrorHuman(errors: any[]): Array<string>;
+    private _ajvErrorHuman;
     /**
      * Checks the API response for errors and throws an `ApiResponseError` if any are found.
      *
@@ -169,16 +172,11 @@ export default class ApiClient extends EventEmitter<[never]> {
      *
      * If no errors are found, the original `response` is returned.
      *
-     * @param {Object} response - The API response object to check.
-     * @param {Object} response.data - The data payload of the response.
-     * @param {number} response.status - The HTTP status code of the response.
+     * @param {import("axios").AxiosResponse | { data: any } } response
+     * @returns {import("axios").AxiosResponse | { data: any }}
      * @throws {ApiResponseError} If an error is detected in the response data.
-     * @returns {Object} The original `response` object if no errors are found.
      */
-    checkAndThrowApiResponseError(response: {
-        data: any;
-        status: number;
-    }): any;
+    checkAndThrowApiResponseError(response: any): any;
     /**
    * Réinitialise complètement la session de l'utilisateur :
    * - Token d'accès
@@ -189,12 +187,42 @@ export default class ApiClient extends EventEmitter<[never]> {
     resetSession(): void;
     /**
      * Retrieves the value from an object based on a dot-separated path.
+     */
+    private _getValueByPath;
+    /**
+     * Normalizes Date objects to ISO strings for AJV validation.
+     * This preserves the object structure while converting only Dates.
+     * Handles reactive Proxies by unwrapping them first.
+     *
+     * @param obj - The object to normalize
+     * @returns The normalized object with Dates as ISO strings
+     */
+    static normalizeDatesForValidation(obj: any): any;
+    /**
+     * Normalizes fields with format:"date" in schema to YYYY-MM-DD format.
+     * Extracts only the date part from ISO datetime strings.
      *
-     * @param {Object} obj - The object from which to retrieve the value.
-     * @param {string} path - The dot-separated path string indicating the value to retrieve.
-     * @returns {*} - The value found at the specified path, or undefined if the path is invalid.
+     * @param data - The data object to normalize
+     * @param schema - The JSON schema containing field definitions
+     * @returns The normalized data with date-only strings for format:"date" fields
      */
-    _getValueByPath(obj: any, path: string): any;
+    static normalizeSchemaDateFields(data: any, schema: any): any;
+    /**
+     * Converts an object to URL search parameters.
+     *
+     * @param obj - The object to be converted to URL search parameters.
+     * @param [options={}] - Optional settings for the conversion.
+     * @returns The URL search parameters generated from the object.
+     */
+    static toURLSearchParams(obj: any, options?: any): URLSearchParams;
+    /**
+     * Builds parameters for an API request from a given object.
+     */
+    static _buildParams(obj: any, paramsInstance: FormData | URLSearchParams, options?: {
+        dots?: boolean;
+        indexes?: boolean;
+        metaTokens?: boolean;
+    }): FormData | URLSearchParams;
     /**
        * Transforms the given data based on its structure.
        *
@@ -203,8 +231,8 @@ export default class ApiClient extends EventEmitter<[never]> {
        * nested structures like `resultGoods`, `resultErrors`, `results`, `news`,
        * `notif`, `citoyens`, `organizations`, `cities`, `newComment`, `map`, and `object`.
        *
-       * @param {Object|Array} data - The data to be transformed.
-       * @returns {Object|Array} - The transformed data.
+       * @param data - The data to be transformed.
+       * @returns - The transformed data.
        *
        * @private
        */
@@ -212,8 +240,8 @@ export default class ApiClient extends EventEmitter<[never]> {
     /**
        * Normalizes JSON data by transforming specific fields and ensuring URLs are complete.
        *
-       * @param {Object} item - The JSON object to be normalized.
-       * @returns {Object} - The normalized JSON object.
+       * @param item - The JSON object to be normalized.
+       * @returns - The normalized JSON object.
        *
        * The function performs the following transformations:
        * - Normalizes the ID field if it matches a specific pattern.
@@ -223,23 +251,23 @@ export default class ApiClient extends EventEmitter<[never]> {
        * - Removes the `timeAgo` field if it exists.
        * - Converts the object to EJSON format if necessary.
        */
-    _normalizeJsonData(item: any): any;
+    private _normalizeJsonData;
     /**
        * Ensures that the given image path is a full URL. If the image path is already a full URL
        * (i.e., it starts with "http://" or "https://"), it is returned as is. Otherwise, the image path
        * is concatenated with the base URL of the ApiClient instance.
        *
-       * @param {string} imagePath - The image path to ensure as a full URL.
-       * @returns {string} - The full URL of the image path.
+       * @param imagePath - The image path to ensure as a full URL.
+       * @returns - The full URL of the image path.
        */
-    _ensureFullURL(imagePath: string): string;
+    private _ensureFullURL;
     /**
    * Parcourt récursivement un objet pour normaliser les champs de date.
    * Pour chaque clé présente dans dateFields, si la valeur est un nombre ou un objet
    * contenant une propriété sec (nombre), la transforme en { $date: valeurEnMs }.
    *
-   * @param {Object} obj - L’objet à normaliser.
-   * @returns {Object} L’objet normalisé.
+   * @param obj - L’objet à normaliser.
+   * @returns L’objet normalisé.
    */
     /**
    * Parcourt récursivement un objet pour normaliser les chemins d'images.
@@ -247,65 +275,65 @@ export default class ApiClient extends EventEmitter<[never]> {
    * vérifie et convertit le chemin en URL complète à l’aide de _ensureFullURL.
    * Les cas particuliers (comme mediaImg.images ou mediaFile.files) sont également gérés.
    *
-   * @param {Object} obj - L’objet à normaliser.
-   * @returns {Object} L’objet normalisé.
+   * @param obj - L’objet à normaliser.
+   * @returns L’objet normalisé.
    */
     /**
    * Parcourt récursivement un objet ou un tableau pour normaliser les identifiants (ID).
    * Si un objet possède une propriété "_id" ou "id" contenant un sous-objet "$id" valide,
    * l'ID est normalisé et la propriété _id est convertie au format EJSON attendu.
    *
-   * @param {Object|Array} obj - L'objet ou le tableau à normaliser.
-   * @returns {Object|Array} L'objet ou le tableau normalisé.
+   * @param obj - L'objet ou le tableau à normaliser.
+   * @returns L'objet ou le tableau normalisé.
    */
     /**
    * Normalise récursivement les valeurs booléennes.
    * Si une valeur est une chaîne "true" ou "false", elle est convertie en booléen.
    *
-   * @param {any} data - L'objet, le tableau ou la valeur à normaliser.
-   * @returns {any} La donnée normalisée.
+   * @param data - L'objet, le tableau ou la valeur à normaliser.
+   * @returns La donnée normalisée.
    */
     /**
    * Transforme une chaîne "true" ou "false" en booléen.
    *
-   * @param {string} str - La chaîne à normaliser.
-   * @returns {boolean|string} La valeur booléenne ou la chaîne originale.
+   * @param str - La chaîne à normaliser.
+   * @returns La valeur booléenne ou la chaîne originale.
    */
-    _normalizeString(str: string): boolean | string;
+    private _normalizeString;
     /**
    * Normalise les identifiants dans un objet.
    * Si l'objet possède une propriété "_id" ou "id" contenant un sous-objet "$id" valide,
    * il met à jour l'objet en assignant la valeur de l'ID et en formattant _id en EJSON.
    *
-   * @param {Object} obj - L'objet à normaliser.
-   * @returns {Object} L'objet avec l'ID normalisé.
+   * @param obj - L'objet à normaliser.
+   * @returns L'objet avec l'ID normalisé.
    */
-    _normalizeId(obj: any): any;
+    private _normalizeId;
     /**
    * Normalise une valeur de date.
    * Si la valeur est un objet contenant "sec" (nombre) ou un nombre,
    * elle est convertie en { $date: valeurEnMs }.
    *
-   * @param {any} value - La valeur à normaliser.
-   * @returns {any} La valeur normalisée.
+   * @param value - La valeur à normaliser.
+   * @returns La valeur normalisée.
    */
-    _normalizeDate(value: any): any;
+    private _normalizeDate;
     /**
    * Normalise une URL d'image.
    * Si la valeur est une chaîne non vide, retourne l'URL complète via _ensureFullURL.
    *
-   * @param {any} value - La valeur à normaliser.
-   * @returns {any} La valeur normalisée.
+   * @param value - La valeur à normaliser.
+   * @returns La valeur normalisée.
    */
-    _normalizeImage(value: any): any;
+    private _normalizeImage;
     /**
    * Liste des champs d'image à normaliser.
    */
-    _imageFields: string[];
+    private _imageFields;
     /**
    * Liste des champs de date à normaliser.
    */
-    _dateFields: string[];
+    private _dateFields;
     /**
    * Normalise récursivement un objet, un tableau ou une valeur simple.
    * Cette fonction réalise en une seule passe les opérations suivantes :
@@ -315,63 +343,95 @@ export default class ApiClient extends EventEmitter<[never]> {
    * - Transformation récursive des objets et tableaux.
    * - Normalisation des identifiants.
    *
-   * @param {any} data - La donnée à normaliser.
-   * @returns {any} La donnée normalisée.
+   * @param data - La donnée à normaliser.
+   * @returns La donnée normalisée.
    */
-    _normalizeRecursively(data: any): any;
-    _startBeforeEndValidate: (schema: any, data: any) => boolean;
-    getRequestSchema(constant: any): any;
-    getPathSchema(constant: any): any;
+    private _normalizeRecursively;
+    private _startBeforeEndValidate;
+    /**
+     * Récupère le schéma de requête pour un endpoint donné.
+     * @param constant - Le nom de l'endpoint.
+     * @returns Le schéma de requête ou null si non trouvé.
+     */
+    getRequestSchema(constant: string): any;
+    /**
+     * Récupère le schéma de chemin pour un endpoint donné.
+     * @param constant - Le nom de l'endpoint.
+     * @returns Le schéma de chemin ou null si non trouvé.
+     */
+    getPathSchema(constant: string): any;
     /**
      * Permet d'écouter facilement un ensemble d'événements importants émis par l'ApiClient.
      *
-     * @param {Object} handlers - Un objet avec des fonctions à appeler selon l'événement.
-     * @param {Function} [handlers.retryAttempt] - Lors d'une tentative de retry axios.
-     * @param {Function} [handlers.queuedOffline] - Lorsqu'une requête est mise en file.
-     * @param {Function} [handlers.circuitBreakerOpen] - Quand le breaker s'ouvre.
-     * @param {Function} [handlers.circuitBreakerReset] - Quand le breaker se referme.
-     * @param {Function} [handlers.refreshSuccess] - Quand le token est rafraîchi.
-     * @param {Function} [handlers.refreshFailed] - Quand le refresh échoue.
-     * @param {Function} [handlers.sessionReset] - Quand la session est réinitialisée.
-     * @param {Function} [handlers.validationError] - Quand une validation échoue.
-     * @param {Function} [handlers.offlineModeChanged] - Quand le mode offline change.
-     * @param {Function} [handlers.userLoggedIn] - Quand un utilisateur se connecte.
+     * @param handlers - Un objet avec des fonctions à appeler selon l'événement.
+     * @param [handlers.retryAttempt] - Lors d'une tentative de retry axios.
+     * @param [handlers.queuedOffline] - Lorsqu'une requête est mise en file.
+     * @param [handlers.circuitBreakerOpen] - Quand le breaker s'ouvre.
+     * @param [handlers.circuitBreakerReset] - Quand le breaker se referme.
+     * @param [handlers.refreshSuccess] - Quand le token est rafraîchi.
+     * @param [handlers.refreshFailed] - Quand le refresh échoue.
+     * @param [handlers.sessionReset] - Quand la session est réinitialisée.
+     * @param [handlers.validationError] - Quand une validation échoue.
+     * @param [handlers.offlineModeChanged] - Quand le mode offline change.
+     * @param [handlers.userLoggedIn] - Quand un utilisateur se connecte.
      */
-    onEvent(handlers?: {
-        retryAttempt?: Function;
-        queuedOffline?: Function;
-        circuitBreakerOpen?: Function;
-        circuitBreakerReset?: Function;
-        refreshSuccess?: Function;
-        refreshFailed?: Function;
-        sessionReset?: Function;
-        validationError?: Function;
-        offlineModeChanged?: Function;
-        userLoggedIn?: Function;
-    }): void;
+    onEvent(handlers?: Record<string, (...args: any[]) => void>): void;
     /**
      * Retourne la liste des noms d'événements personnalisés déclarés dans les endpoints.
      * Utile pour introspection ou documentation.
      *
-     * @returns {string[]} Liste des événements émis dynamiquement via postActions.
+     * @returns Liste des événements émis dynamiquement via postActions.
      */
-    getDeclaredEvents(): string[];
+    getDeclaredEvents(): unknown[];
 }
-export type TokenStorageStrategy = import("./utils/TokenStorage.js").TokenStorageStrategy;
-export type MemoryStorageStrategy = import("./utils/TokenStorage.js").MemoryStorageStrategy;
-export type MultiServerTokenStorageStrategy = import("./utils/MultiServerTokenStorageStrategy.js").MultiServerTokenStorageStrategy;
-export type ApiClientOptions = {
-    baseURL: string;
-    accessToken?: string;
-    refreshToken?: string;
-    refreshUrl?: string;
-    endpoints?: any[];
-    timeout?: number;
-    debug?: boolean;
-    maxRetries?: number;
-    circuitBreakerThreshold?: number;
-    circuitBreakerResetTime?: number;
-    fromJSONValue?: boolean;
-    tokenStorageStrategy?: TokenStorageStrategy | null;
-};
-import { EventEmitter } from "events";
+/**
+ * @event ApiClient#retryAttempt
+ * @type {Object}
+ * @property {number} retryCount - Le numéro de tentative.
+ * @property {string} url - L'URL de la requête ayant échoué.
+ */
+/**
+ * @event ApiClient#queuedOffline
+ * @type {Object}
+ * @property {string} constant - Le nom de l'endpoint.
+ * @property {Object} data - Les données envoyées.
+ * @property {"offlineMode"|"circuitBreaker"} reason - La raison de la mise en file.
+ */
+/**
+ * @event ApiClient#circuitBreakerOpen
+ * @type {Object}
+ * @property {number} timestamp - Date (ms) à laquelle le breaker s'est ouvert.
+ */
+/**
+ * @event ApiClient#circuitBreakerReset
+ * @type {void}
+ */
+/**
+ * @event ApiClient#refreshSuccess
+ * @type {Object}
+ * @property {string} token - Le nouveau token d'accès.
+ * @property {string} [refreshToken] - Le nouveau refreshToken (optionnel).
+ */
+/**
+ * @event ApiClient#refreshFailed
+ * @type {Object}
+ * @property {string} error - Le message d’erreur de refresh.
+ */
+/**
+ * @event ApiClient#sessionReset
+ * @type {void}
+ */
+/**
+ * @event ApiClient#validationError
+ * @type {Object}
+ * @property {"pathParams"|"request"|"response"} stage - Étape de validation échouée.
+ * @property {Array<Object>} errors - Erreurs AJV brutes.
+ */
+/**
+ * @event ApiClient#offlineModeChanged
+ * @type {boolean} - true si le client est offline, false sinon.
+ */
+/**
+ * @event ApiClient#userLoggedIn
+ * @param user - Les données utilisateur extraites de la réponse.
+ */

package/types/ApiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiClient.d.ts","sourceRoot":"","sources":["../src/ApiClient.ts"],"names":[],"mappings":"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"}