@communecter/cocolight-api-client 1.0.51 → 1.0.55

package/types/ApiClient.d.ts

@@ -0,0 +1,437 @@
+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.
+ *
+ * @fires ApiClient#retryAttempt
+ * @fires ApiClient#queuedOffline
+ * @fires ApiClient#circuitBreakerOpen
+ * @fires ApiClient#circuitBreakerReset
+ * @fires ApiClient#refreshSuccess
+ * @fires ApiClient#refreshFailed
+ * @fires ApiClient#sessionReset
+ * @fires ApiClient#validationError
+ * @fires ApiClient#offlineModeChanged
+ * @fires ApiClient#userLoggedIn
+ */
+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;
+    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.
+     */
+    setToken(token: string | null): void;
+    /**
+     * Retrieves the current access token.
+     */
+    getToken(): string | null;
+    /**
+     * Sets the refresh token for the API client.
+     */
+    setRefreshToken(token: string | null): void;
+    /**
+     * Retrieves the current 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.
+     */
+    get isConnected(): boolean;
+    /**
+     * Extrait l'identifiant depuis un JWT.
+     */
+    private _getIdFromToken;
+    /**
+     * Méthode simplifiée de refresh (en JSON).
+     * Emet un event refreshSuccess si ça marche
+     */
+    private _refreshAccessToken;
+    /**
+     * checkCircuitBreaker : vérifie si on peut appeler l'API ou non
+     * si le breaker est "open", on regarde si on peut "reset"
+     */
+    private _checkCircuitBreaker;
+    /**
+     * updateCircuitBreaker : incremente le compteur d'erreurs
+     * si on dépasse le threshold, on "open" le breaker.
+     */
+    private _updateCircuitBreakerError;
+    /**
+     * resetCircuitBreaker : en cas de succès on reset le compteur
+     */
+    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 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: (...args: any[]) => Promise<any>, ...args: any[]): Promise<any>;
+    /**
+     * 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 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<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 errors - An array of AJV validation error objects.
+     * @returns An array of human-readable error messages extracted from the AJV errors.
+     */
+    private _ajvErrorHuman;
+    /**
+     * Checks the API response for errors and throws an `ApiResponseError` if any are found.
+     *
+     * This method examines the `response.data` object to determine if it contains
+     * error information. It handles both standard and nested error cases:
+     *
+     * - Standard case: If `data.result` is a boolean and is `false`, an error is thrown.
+     * - Nested case: If `data.resultErrors` exists and contains a `result` property
+     *   that is a boolean and is `false`, an error is thrown.
+     *
+     * If no errors are found, the original `response` is returned.
+     *
+     * @param {import("axios").AxiosResponse | { data: any } } response
+     * @returns {import("axios").AxiosResponse | { data: any }}
+     * @throws {ApiResponseError} If an error is detected in the response data.
+     */
+    checkAndThrowApiResponseError(response: any): any;
+    /**
+   * Réinitialise complètement la session de l'utilisateur :
+   * - Token d'accès
+   * - Token de rafraîchissement
+   * - userId
+   * - En-têtes Axios
+   */
+    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 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
+     */
+    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.
+       *
+       * This method normalizes various structures of data into a consistent format.
+       * It handles different types of data including objects, arrays, and specific
+       * nested structures like `resultGoods`, `resultErrors`, `results`, `news`,
+       * `notif`, `citoyens`, `organizations`, `cities`, `newComment`, `map`, and `object`.
+       *
+       * @param data - The data to be transformed.
+       * @returns - The transformed data.
+       *
+       * @private
+       */
+    private _transformData;
+    /**
+       * Normalizes JSON data by transforming specific fields and ensuring URLs are complete.
+       *
+       * @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.
+       * - Converts date fields from seconds to milliseconds.
+       * - Ensures URLs in specific fields are complete.
+       * - Filters and normalizes nested objects and arrays.
+       * - Removes the `timeAgo` field if it exists.
+       * - Converts the object to EJSON format if necessary.
+       */
+    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 imagePath - The image path to ensure as a full URL.
+       * @returns - The full URL of the image path.
+       */
+    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 obj - L’objet à normaliser.
+   * @returns L’objet normalisé.
+   */
+    /**
+   * Parcourt récursivement un objet pour normaliser les chemins d'images.
+   * Pour chaque propriété correspondant à un champ d'image (dans imageFields),
+   * 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 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 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 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 str - La chaîne à normaliser.
+   * @returns La valeur booléenne ou la chaîne originale.
+   */
+    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 obj - L'objet à normaliser.
+   * @returns L'objet avec l'ID normalisé.
+   */
+    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 value - La valeur à normaliser.
+   * @returns La valeur normalisée.
+   */
+    private _normalizeDate;
+    /**
+   * Normalise une URL d'image.
+   * Si la valeur est une chaîne non vide, retourne l'URL complète via _ensureFullURL.
+   *
+   * @param value - La valeur à normaliser.
+   * @returns La valeur normalisée.
+   */
+    private _normalizeImage;
+    /**
+   * Liste des champs d'image à normaliser.
+   */
+    private _imageFields;
+    /**
+   * Liste des champs de date à normaliser.
+   */
+    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 :
+   * - Conversion des chaînes "true"/"false" en booléens.
+   * - Normalisation des dates (pour les champs spécifiés).
+   * - Normalisation des images (pour les champs spécifiés).
+   * - Transformation récursive des objets et tableaux.
+   * - Normalisation des identifiants.
+   *
+   * @param data - La donnée à normaliser.
+   * @returns La donnée normalisée.
+   */
+    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 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?: 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 Liste des événements émis dynamiquement via postActions.
+     */
+    getDeclaredEvents(): unknown[];
+}
+/**
+ * @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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"}

package/types/EJSONType.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Interface pour le module MongoID
+ */
+export interface MongoIDModule {
+    _looksLikeObjectID: (str: string) => boolean;
+    ObjectID: typeof ObjectID;
+}
+/**
+ * Représentation minimaliste d'un ObjectID Mongo (stocke l'hex en interne).
+ */
+declare class ObjectID {
+    private _str?;
+    /**
+     * @param hexString - Chaîne hexadécimale (24 chars). Si omise, l'instance est vide.
+     * @throws {Error} Si `hexString` est fournie mais invalide.
+     */
+    constructor(hexString?: string);
+    /**
+     * Compare à un autre ObjectID.
+     */
+    equals(other: unknown): boolean;
+    /**
+     * Représentation lisible (style Mongo shell).
+     */
+    toString(): string;
+    /**
+     * Clone l'ObjectID.
+     */
+    clone(): ObjectID;
+    /**
+     * Nom de type EJSON.
+     */
+    typeName(): "oid";
+    /**
+     * Timestamp (secondes) extrait des 4 premiers octets.
+     * @returns Nombre de secondes depuis l'époque Unix.
+     */
+    getTimestamp(): number;
+    /**
+     * Valeur primitive (hex).
+     */
+    valueOf(): string | undefined;
+    /**
+     * Valeur JSON (hex).
+     */
+    toJSONValue(): string | undefined;
+    /**
+     * Chaîne hexadécimale (24 chars).
+     */
+    toHexString(): string | undefined;
+}
+declare const MongoID: MongoIDModule;
+export default MongoID;

package/types/EJSONType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EJSONType.d.ts","sourceRoot":"","sources":["../src/EJSONType.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,QAAQ,EAAE,OAAO,QAAQ,CAAC;CAC3B;AAOD;;GAEG;AACH,cAAM,QAAQ;IACZ,OAAO,CAAC,IAAI,CAAC,CAAS;IAEtB;;;OAGG;gBACS,SAAS,CAAC,EAAE,MAAM;IAc9B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI/B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,KAAK,IAAI,QAAQ;IAIjB;;OAEG;IACH,QAAQ,IAAI,KAAK;IAIjB;;;OAGG;IACH,YAAY,IAAI,MAAM;IAMtB;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,SAAS;IAI7B;;OAEG;IACH,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC;;OAEG;IACH,WAAW,IAAI,MAAM,GAAG,SAAS;CAGlC;AAED,QAAA,MAAM,OAAO,EAAE,aAGd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/types/api/Badge.d.ts

@@ -0,0 +1,24 @@
+import { BaseEntity } from "./BaseEntity.js";
+export declare class Badge extends BaseEntity<any> {
+    static entityType: string;
+    static entityTag: string;
+    static SCHEMA_CONSTANTS: string[];
+    static ADD_BLOCKS: Map<string, string>;
+    static UPDATE_BLOCKS: Map<string, string>;
+    defaultFields: Record<string, any>;
+    removeFields: string[];
+    _add: (payload: Record<string, any>) => Promise<void>;
+    _update: (payload: Record<string, any>) => Promise<boolean>;
+    getOrganizations(): Promise<never>;
+    getProjects(): Promise<never>;
+    getEvents(): Promise<never>;
+    getPois(): Promise<never>;
+    getBadgesIssuer(): Promise<never>;
+    getNews(): Promise<never>;
+    getSubscribers(): Promise<never>;
+    project(): Promise<never>;
+    poi(): Promise<never>;
+    event(): Promise<never>;
+    badge(): Promise<never>;
+    news(): Promise<never>;
+}

package/types/api/Badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../src/api/Badge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5D,qBAAa,KAAM,SAAQ,UAAU,CAAC,GAAG,CAAC;IACxC,MAAM,CAAC,UAAU,SAAY;IAE7B,MAAM,CAAC,SAAS,SAAW;IAE3B,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAE/B;IAEF,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnC;IAEH,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CACtC;IAEH,aAAa,EAAE,GAAG,CAEhB;IAEF,YAAY,EAAE,MAAM,EAAE,CAAM;IAM5B,IAAI,GAAU,SAAS,GAAG,KAAG,OAAO,CAAC,IAAI,CAAC,CAsBxC;IAEF,OAAO,GAAU,SAAS,GAAG,KAAG,OAAO,CAAC,OAAO,CAAC,CAuB9C;IACF,gBAAgB;IACV,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAIrD,gBAAgB;IACV,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAIhD,gBAAgB;IACV,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAI9C,gBAAgB;IACV,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAI5C,gBAAgB;IACV,eAAe,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAIpD,0CAA0C;IACpC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;IAI/B,0CAA0C;IACpC,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC;IAItC,0CAA0C;IACpC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;IAI/B,0CAA0C;IACpC,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;IAI3B,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAI7B,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAI7B,0CAA0C;IACpC,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;CAI7B"}