@communecter/cocolight-api-client 1.0.131 → 1.0.133

package/types/api/Action.d.ts

@@ -297,4 +297,5 @@ export declare class Action extends BaseEntity<ActionItemNormalized> {
      * Vérifie un format ISO 8601 date-time strict (avec T et option timezone Z ou ±HH:MM).
      */
     private _isIsoDateTime;
+    form(): Promise<never>;
 }

package/types/api/Answer.d.ts

@@ -1,12 +1,89 @@
 import { BaseEntity } from "./BaseEntity.js";
 import type { AnswerItemNormalized } from "./serverDataType/Answer.js";
+import type { FormItemNormalized } from "./serverDataType/Form.js";
+type UploadInput = File | Blob | Buffer | import("stream").Readable;
+/**
+ * Format des données utilisateur d'un CoForm — `{ subFormId: { inputId: value } }`.
+ * Générique : la lib ne fait aucune supposition sur le type des valeurs.
+ */
+export type AllStepsData = Record<string, Record<string, unknown>>;
+/**
+ * Valeur d'un upload en attente — objet `{ name?, data: "data:...;base64,..." }`
+ * inséré par les inputs uploader avant le pré-upload backend.
+ */
+export interface PendingUploadValue {
+    name?: string;
+    data: string;
+}
+/**
+ * Un pending upload détecté dans la structure `allData` — chemin imbriqué +
+ * type d'input dérivé du schéma (`formData.inputs[subFormId].inputs[inputId].type`).
+ */
+export interface PendingUpload {
+    value: PendingUploadValue;
+    path: (string | number)[];
+    inputType?: string;
+}
+/**
+ * Options de `Answer.processUploads()`.
+ */
+export interface ProcessUploadsOptions {
+    /**
+     * Schéma du Form (pour déduire `inputType` des champs uploader/simpleTable).
+     * Auto-récupéré via `this.parent.serverData` si parent est un Form.
+     */
+    formData?: FormItemNormalized;
+    /** Nombre d'uploads parallèles par batch. Défaut : 4. */
+    batchSize?: number;
+}
+/**
+ * Options pour `Answer.uploadFile()`. Tous les champs sont optionnels — les
+ * défauts reproduisent les valeurs backend (`docType: "image"`, `contentKey: "slider"`).
+ */
+export interface UploadAnswerFileOptions {
+    /** Type de document : `image` (défaut) ou `file` (PDF, DOCX, etc.). */
+    docType?: "image" | "file";
+    /** Clé de contenu côté backend. `"slider"` (défaut) pour images, `"presentation"` pour inputs uploader. */
+    contentKey?: string;
+    /** Sous-clé optionnelle (ex: `"subFormId.inputId"` pour les inputs `*.uploader`). */
+    subKey?: string;
+    /** UUID client (compat fine-uploader). Auto-généré si absent. */
+    qquuid?: string;
+    /** Nom du fichier. Auto-déduit (File.name, stream.path, ou fallback) si absent. */
+    qqfilename?: string;
+    /**
+     * Taille du fichier en octets. Auto-déduite pour `File` (`.size`), `Blob`
+     * (`.size`), `Buffer` (`.length`), ou `Readable` annoté (`.size`).
+     *
+     * **À fournir explicitement pour un `Readable` non annoté** (ex:
+     * `fs.createReadStream(path)` → faire `fs.statSync(path).size` au préalable),
+     * sinon `0` est envoyé et le backend peut rejeter le multipart.
+     */
+    qqtotalfilesize?: number;
+}
+/**
+ * Retour normalisé de `Answer.uploadFile()`.
+ */
+export interface UploadAnswerFileResult {
+    /** ID du document MongoDB (à stocker dans `{docId, docPath}` pour les inputs uploader). */
+    docId: string;
+    /** Chemin du document. URL absolue côté backend, à nettoyer en chemin relatif si besoin (cf. `cleanUploaderUrls` site-json). */
+    docPath: string;
+    /** ID de l'Answer (créée par cet upload si premier, sinon `= this.id`). */
+    answerId: string;
+}
 export declare class Answer extends BaseEntity<AnswerItemNormalized> {
     static entityType: string;
     static entityTag: string;
     static SCHEMA_CONSTANTS: string[];
-    static ADD_BLOCKS: Map<string, string>;
-    static UPDATE_BLOCKS: Map<string, string>;
+    static ADD_BLOCKS: Map<"SAVE_COFORM_ANSWER", "saveCoformAnswer">;
+    static UPDATE_BLOCKS: Map<"SAVE_COFORM_ANSWER", "saveCoformAnswer">;
     defaultFields: Record<string, any>;
+    /**
+     * Champs `serverData` à ne pas renvoyer au serveur dans le payload de save.
+     * `answers`, `addedOptions`, `links`, `form` sont conservés (envoyés au serveur).
+     * Les autres sont calculés/posés par le backend.
+     */
     removeFields: string[];
     /**
      * Transforme les champs imbriqués (user, context etc.) en instances d'entités.
@@ -20,4 +97,221 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
        * Constant : COFORM_ANSWERS_BY_ID
        */
     get(): Promise<Record<string, any>>;
+    form(): Promise<never>;
+    /**
+     * Supprime cette Answer côté serveur via `DELETE_ELEMENT`
+     * (`type=answers`, `id=this.id`).
+     *
+     * Après succès :
+     *  - `serverData` et `draftData` sont vidés (sans casser la réactivité)
+     *  - `_isDeleted = true` → toute mutation ultérieure (`save`, `get`, etc.) throw
+     *
+     * @param reason - Raison libre transmise au backend (audit). Défaut : `"delete coform answer"`.
+     * @throws {ApiError} 400 si l'Answer n'a pas d'id (jamais sauvegardée).
+     *
+     * @example
+     * const answer = await form.answer({ id: "..." });
+     * await answer.delete();
+     * answer._isDeleted; // true
+     */
+    delete(reason?: string): Promise<void>;
+    /**
+     * Upload un fichier rattaché à cette Answer via `COFORM_UPLOAD_ANSWER_FILE`.
+     *
+     * **Cas premier upload (Answer sans id)** : le backend crée l'Answer et
+     * renvoie `answerId`. La méthode pose alors `this._draftData.id = answerId`
+     * — les uploads suivants utiliseront cet id, et un `save()` ultérieur passera
+     * en update.
+     *
+     * **Cas uploads suivants (Answer avec id)** : `answerId: this.id` est envoyé.
+     *
+     * Compatible browser (File/Blob) et Node (Buffer/Readable) via
+     * `BaseEntity._prepareUploadFile()` — le multipart encoder du package
+     * `form-data` (utilisé en Node) ignore les Buffer bruts, donc conversion en
+     * stream annoté.
+     *
+     * @param file - Fichier à uploader (File/Blob côté browser, Buffer/Readable côté Node)
+     * @param opts - `docType`, `contentKey`, `subKey`, `qquuid`, `qqfilename`
+     * @returns `{ docId, docPath, answerId }` — toujours fournis par le backend.
+     * @throws {ApiError} si `formId` introuvable, ou réponse invalide.
+     *
+     * @example
+     * // Browser (depuis un <input type="file">)
+     * const form = await org.form({ id: formId });
+     * const answer = await form.answer();   // draft
+     * const { docId, docPath } = await answer.uploadFile(htmlFile, {
+     *   contentKey: "presentation",
+     *   subKey: `${subFormId}.${inputId}`,
+     * });
+     * // answer.id désormais défini → uploads suivants utilisent cet id.
+     *
+     * @example
+     * // Node (depuis un Buffer)
+     * const buffer = await fs.promises.readFile("./photo.jpg");
+     * const result = await answer.uploadFile(buffer, { docType: "image" });
+     */
+    uploadFile(file: UploadInput, opts?: UploadAnswerFileOptions): Promise<UploadAnswerFileResult>;
+    /**
+     * Orchestre l'upload de tous les fichiers pendants (`data:URI`) trouvés dans
+     * `allData`, puis renvoie la structure transformée prête pour `answer.save()`.
+     *
+     * **Pipeline complet** :
+     *  1. Walk récursif de `allData` → collecte les `data:URI` avec leur path + inputType
+     *  2. Premier upload (si Answer sans id) → backend crée l'Answer + pose `this.id`
+     *  3. Uploads restants en batches parallèles (défaut 4)
+     *  4. Remplacement dans la structure :
+     *     - inputs `*.uploader` → `{ docId, docPath }`
+     *     - autres → `docPath` string
+     *  5. Normalisation legacy uploader : `Array<{docId, docPath}>` → `{ updateDate, files }`
+     *  6. Nettoyage URLs absolues → chemins relatifs (uploader/simpleTable uniquement)
+     *
+     * Ne touche PAS `addedOptions` ni `links` — caller les pose séparément avant `save()`.
+     *
+     * @param allData - Données utilisateur `{ subFormId: { inputId: value } }`
+     * @param options - `formData` (auto via parent Form), `batchSize` (défaut 4)
+     * @returns `allData` transformé, prêt à être affecté à `answer.data.answers`
+     *
+     * @example
+     * const form = await org.form({ id: formId });
+     * const answer = await form.answer();   // ou form.answer({ id }) en édition
+     *
+     * const prepared = await answer.processUploads(allStepsDataFromForm);
+     * answer.data.answers = prepared;
+     * answer.data.addedOptions = addedOptions;   // optionnel
+     * answer.data.links = finderLinks;           // optionnel
+     * await answer.save();
+     */
+    processUploads(allData: AllStepsData, options?: ProcessUploadsOptions): Promise<AllStepsData>;
+    /**
+     * UUID v4 compatible browser + Node.
+     * Utilise `crypto.randomUUID()` si dispo, sinon fallback Math.random.
+     * @private
+     */
+    private _generateUuid;
+    /**
+     * Sauvegarde une nouvelle Answer (sans `id`) via `SAVE_COFORM_ANSWER`.
+     *
+     * Le payload caller-side attendu (dans `draftData`) :
+     *  - `answers` (requis) — objet `{ subFormId: { inputId: value } }`
+     *  - `form` ou parent Form (requis indirectement) — pour résoudre `formId`
+     *  - `addedOptions` (optionnel) — multiCheckboxPlus dynamiques
+     *  - `links` (optionnel) — sélections Finder à attacher à l'answer
+     *
+     * Sérialise automatiquement `answers`/`addedOptions`/`links` en JSON
+     * (le wire-format `application/x-www-form-urlencoded` exige des strings).
+     *
+     * Après succès, l'ID retourné par le serveur est posé dans `_draftData.id`
+     * → le `refresh()` de `BaseEntity.save()` peut alors récupérer l'Answer canonique.
+     *
+     * @protected — utiliser `answer.save()` (BaseEntity dispatch automatiquement).
+     */
+    _add: (payload: Record<string, any>) => Promise<void>;
+    /**
+     * Met à jour une Answer existante via `SAVE_COFORM_ANSWER` (avec `answerId`).
+     *
+     * Si `payload.answers` est `undefined` (le caller a modifié uniquement
+     * `addedOptions` ou `links`), on retombe sur `serverData.answers` pour ne
+     * pas envoyer un payload vide qui écraserait les réponses existantes.
+     *
+     * @protected — utiliser `answer.save()`.
+     */
+    _update: (payload: Record<string, any>) => Promise<boolean>;
+    /**
+     * Résout le `formId` à envoyer à `saveCoformAnswer`.
+     *
+     * Priorité :
+     *   1. `payload.form` (posé via `draftData.form` par `form.answer()`)
+     *   2. `serverData.form` (Answer chargée via `get()`)
+     *   3. `this.parent.id` si le parent est un `Form`
+     *
+     * @throws {ApiError} 400 si aucune source ne fournit un formId valide.
+     * @private
+     */
+    private _resolveFormId;
+    /**
+     * Construit le payload `SaveCoformAnswerData` en sérialisant les champs JSON
+     * requis par le wire-format `application/x-www-form-urlencoded`.
+     *
+     * Si `payload.answers` est absent en update, retombe sur `serverData.answers`
+     * (cf. design point 6.5 — indulgent envers le caller).
+     *
+     * @private
+     */
+    private _buildSavePayload;
+    /**
+     * Récupère `formData` (schéma du Form) depuis le parent si c'est un Form.
+     * Renvoie `undefined` si pas exploitable — `processUploads` continuera mais
+     * sans détection automatique d'`inputType` (pas de normalisation uploader,
+     * pas de clean URLs).
+     * @private
+     */
+    private _resolveFormData;
+    private _isObjectRecord;
+    private _isDataUri;
+    private _isPendingUploadValue;
+    private _parseMimeType;
+    private _inferExtensionFromMimeType;
+    private _sanitizeBaseName;
+    /**
+     * Convertit un `PendingUploadValue` (data:URI) en `{file, docType, filename}`
+     * exploitable par `uploadFile()`. Compatible browser + Node :
+     *  - Browser → `File` natif
+     *  - Node → `Buffer` (sera converti en stream par `_prepareUploadFile()`)
+     * @private
+     */
+    private _dataUriToFile;
+    /**
+     * Parcourt récursivement `allData` pour trouver tous les `data:URI` à uploader.
+     * Renvoie chaque pending avec son `path` (chemin imbriqué) et `inputType`
+     * (déduit du schéma `formData` si fourni).
+     * @private
+     */
+    private _collectPendingUploads;
+    /**
+     * Détermine `contentKey` et `subKey` pour un upload selon le type d'input :
+     *  - `*.uploader` → `presentation` + subKey `"subFormId.inputId"`
+     *  - autres → `slider` sans subKey
+     * @private
+     */
+    private _getUploadKeys;
+    private _getValueAtPath;
+    private _setValueAtPath;
+    /**
+     * Normalise une valeur d'input uploader vers le format legacy backend :
+     *   `{ updateDate: ["DD/MM/YYYY"], files: { "<docId>": "<docPath>", ... } }`
+     * @private
+     */
+    private _normalizeUploaderValue;
+    private _cleanUrlToRelativePath;
+    /**
+     * Suffixes de types d'inputs dont les valeurs contiennent des URLs de fichiers
+     * à nettoyer avant envoi au serveur.
+     * @private
+     */
+    private static readonly INPUT_TYPES_TO_CLEAN_URLS;
+    /**
+     * Nettoie les URLs absolues → chemins relatifs **uniquement** sur les champs
+     * uploader/simpleTable. Les autres champs (finder, text…) peuvent contenir
+     * des URLs légitimes qu'il ne faut pas tronquer.
+     * @private
+     */
+    private _cleanUploaderUrls;
+    /**
+     * Upload par batches parallèles (défaut : 4 fichiers simultanés).
+     * @private
+     */
+    private _uploadInBatches;
+    /**
+     * Upload un PendingUpload, retourne la valeur de remplacement à insérer
+     * dans `allData` (`{docId, docPath}` pour uploader, `docPath` string sinon).
+     * @private
+     */
+    private _uploadPendingItem;
+    /**
+     * Upload un PendingUpload + remplace immédiatement dans `prepared` à son path.
+     * Utilisé pour le premier upload (séquentiel) qui crée l'Answer.
+     * @private
+     */
+    private _uploadAndReplace;
 }
+export {};

package/types/api/Badge.d.ts

@@ -21,4 +21,5 @@ export declare class Badge extends BaseEntity<any> {
     event(): Promise<never>;
     badge(): Promise<never>;
     news(): Promise<never>;
+    form(): Promise<never>;
 }

package/types/api/BaseEntity.d.ts

@@ -38,6 +38,12 @@ type NewsInput = {
 type ActionInput = {
     id: string;
 } | Record<string, any>;
+type FormInput = {
+    id: string;
+} | Record<string, any>;
+type AnswerInput = {
+    id: string;
+} | Record<string, any>;
 type ApiClient = import("../ApiClient.js").default;
 type EndpointApi = import("./EndpointApi.js").default;
 type User = import("./User.js").User;
@@ -57,6 +63,15 @@ type ParentLike = BaseEntity<any> & {
     apiClient: ApiClient;
     userContext?: User | null;
 };
+/**
+ * Variantes d'endpoint disponibles pour `searchCostum`.
+ * Tous les variants doivent accepter le même schéma de requête/réponse que
+ * `GLOBAL_AUTOCOMPLETE_COSTUM` (drop-in remplacement).
+ *
+ * - `default`   → `/co2/search/globalautocomplete`
+ * - `navigator-tl` → `/costum/navigator/gettl`
+ */
+export type SearchCostumVariant = "default" | "navigator-tl";
 type EndpointApiCtor = {
     new (apiClient: ApiClient): EndpointApi;
 };
@@ -96,6 +111,7 @@ interface EntityTypeMap {
 type ReadableWithMeta = import("stream").Readable & {
     path?: string;
     mimeType?: string;
+    size?: number;
 };
 type UploadInput = File | Blob | Buffer | import("stream").Readable;
 type ValidatedUpload = File | Buffer | ReadableWithMeta;
@@ -118,6 +134,8 @@ export type CostumContextFields = {
     costumSlug: string;
     contextId: string;
     contextType: EntityType;
+    costumId: string;
+    costumType: EntityType;
     sourceKey: string[];
 };
 export type WithCostumContext<T> = T & CostumContextFields;
@@ -143,6 +161,12 @@ export type PaginatorState = {
     index: number;
     history: PaginationCursor[];
     sizes: number[];
+    /**
+     * Métadonnées libres survivant à la sérialisation JSON. Permet aux méthodes paginées
+     * de stocker des paramètres spécifiques (ex. `variant` pour `searchCostum`) qui doivent
+     * être restaurés lors d'un `restorePaginationFromJSON`.
+     */
+    meta?: Record<string, unknown>;
 };
 export interface PaginatorPage<T> {
     count: {
@@ -507,6 +531,37 @@ export declare class BaseEntity<TServerData = any> {
      * @private
      */
     protected _validateFile(fileInput: UploadInput): Promise<ValidatedUpload>;
+    /**
+     * Prépare un fichier pour un upload multipart **sans restriction MIME**.
+     *
+     * Diffère de `_validateImage` / `_validateFile` (liste MIME blanche stricte) :
+     * accepte tout MIME et garantit la conversion `Buffer → annotated stream` en
+     * Node (le multipart encoder du package `form-data` ignore les Buffer bruts ;
+     * il a besoin de `path` + `mimeType` sur un Readable).
+     *
+     * Pensé pour les endpoints d'upload large-spectre (ex: coform où l'utilisateur
+     * peut uploader PNG, GIF, WebP, PDF, DOCX, XLSX, etc. — c'est le backend qui
+     * filtre selon la config du Form, pas le client).
+     *
+     * Compatible browser + Node :
+     *  - Browser `File`    → pass-through
+     *  - Browser `Blob`    → wrap en `File` (génère nom + extension via MIME)
+     *  - Node `Buffer`     → détecte MIME via `file-type`, convertit en `Readable`
+     *                        annoté (`path`, `mimeType`)
+     *  - Node `Readable`   → pass-through si annoté, sinon utilise `fallbackName`
+     *
+     * @param input - Fichier à uploader (Buffer/File/Blob/Readable)
+     * @param fallbackName - Nom à utiliser si l'input n'en porte pas. Défaut `upload-<ts>`.
+     * @returns `{ qqfile, qqfilename, qqtotalfilesize }` prêt pour multipart.
+     * @throws {ApiError} si le type de l'input n'est pas reconnu.
+     *
+     * @protected
+     */
+    protected _prepareUploadFile(input: UploadInput, fallbackName?: string): Promise<{
+        qqfile: ValidatedUpload;
+        qqfilename: string;
+        qqtotalfilesize: number;
+    }>;
     /**
      * Valide les entrées d'upload de fichiers.
      *
@@ -519,14 +574,17 @@ export declare class BaseEntity<TServerData = any> {
      */
     private _validateUploadInput;
     /**
-     * Transforme un Buffer en ReadableStream équivalent à fs.createReadStream
+     * Transforme un Buffer en ReadableStream équivalent à fs.createReadStream.
+     *
+     * Note : passé `protected` car réutilisé par `_prepareUploadFile()` (Answer).
+     *
      * @param buffer - Le buffer contenant les données binaires
      * @param [filename="file.bin"] - Nom de fichier (utilisé dans FormData)
      * @param [mimeType="application/octet-stream"] - Type MIME (utilisé dans FormData)
      * @returns - Readable doté de `path` et `mimeType`
-     * @private
+     * @protected
      */
-    private _createReadStreamFromBuffer;
+    protected _createReadStreamFromBuffer(buffer: Buffer, filename?: string, mimeType?: string): Promise<ReadableWithMeta>;
     /**
      * Transforme un Buffer en ReadableStream.
      *
@@ -1158,6 +1216,38 @@ export declare class BaseEntity<TServerData = any> {
      * @throws {ApiError} Sur les entités non supportées.
      */
     action(_actionData?: ActionInput): Promise<Action>;
+    /**
+     * Crée une instance de Form **dans le contexte costum de l'entité courante**.
+     *
+     * Méthode autorisée uniquement sur `Organization` et `Project` (les entités qui
+     * portent un costumContext). Les autres entités la bloquent via un override
+     * qui throw — cf. `User.form()`, `Event.form()`, `Poi.form()`, etc.
+     *
+     * @param formData - `{ id: string }` (Form n'a pas de slug)
+     * @returns Le Form, déjà fetché (`get()` est appelé par `entity()` quand `id` est fourni).
+     *
+     * @example
+     * const org = await api.organization({ slug: "navigatorDesTierslieux" });
+     * const form = await org.form({ id: "6925e2b05dd63b02ca70d6d9" });
+     * console.log(form.serverData.name);              // "Coworking"
+     * const answers = await form.getAnswers();        // utilise le costumContext de l'org
+     */
+    form(formData?: FormInput): Promise<Form>;
+    /**
+     * Crée une instance d'Answer rattachée à l'entité courante.
+     *
+     * Méthode autorisée uniquement sur `Form` (la seule entité qui porte un
+     * `id` de formulaire pré-rempli pour les drafts). Les autres entités la
+     * bloquent via cet override par défaut qui throw.
+     *
+     * Pour fetch une Answer existante sans contexte Form, passer par
+     * `EntityRegistry.createEntityFromData` ou un endpoint adhoc.
+     *
+     * @param _answerData - `{ id: string }` (fetch) ou objet partiel (draft).
+     * @returns Une Answer.
+     * @throws {ApiError} 501 sur les entités non supportées.
+     */
+    answer(_answerData?: AnswerInput): Promise<Answer>;
     /**
      * Récupérer les organisations d'une entitée : la liste des organisations dont l'entité est membre ou admin valide.
      * Constant : GET_ORGANIZATIONS_ADMIN | GET_ORGANIZATIONS_NO_ADMIN
@@ -1600,9 +1690,17 @@ export declare class BaseEntity<TServerData = any> {
      *   const nextPage = await page.next();
      *   console.log(nextPage.pageNumber, nextPage.results.length);
      * }
+     *
+     * @example
+     * // Cibler l'endpoint navigator/gettl (mêmes paramètres et même format de réponse)
+     * const page = await entity.searchCostum(
+     *   { name: "marseille", searchType: ["projects"] },
+     *   { variant: "navigator-tl" }
+     * );
      */
     searchCostum(data?: Partial<GlobalAutocompleteCostumData>, options?: {
         restoredState?: PaginatorState;
+        variant?: SearchCostumVariant;
     }): Promise<PaginatorPage<any>>;
     /**
      * @param data

package/types/api/Classified.d.ts

@@ -24,6 +24,7 @@ export declare class Classified extends BaseEntity<ClassifiedItemNormalized> {
     badge(): Promise<never>;
     news(): Promise<never>;
     classified(): Promise<never>;
+    form(): Promise<never>;
     follow(): Promise<never>;
     unfollow(): Promise<never>;
     getGallery(): Promise<never>;

package/types/api/Comment.d.ts

@@ -54,4 +54,5 @@ export declare class Comment extends BaseEntity<CommentItemNormalized> {
         reason: string;
         comment?: string;
     }): Promise<unknown>;
+    form(): Promise<never>;
 }

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, SaveCoformAnswerData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData } from "./EndpointApi.types.js";
+import type { PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeletePoiData, DeleteEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, ShareEventsData, InviteEventData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, CoformGetAnswerFilesData, SaveCoformAnswerData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, GenerateAnswerFromFormData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -891,6 +891,15 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     globalAutocompleteCostum(data: GlobalAutocompleteCostumData): Promise<any>;
+    /**
+     * Navigator timeline (alias de globalautocomplete) : Recherche globale via navigator/gettl — schémas request/response identiques à GLOBAL_AUTOCOMPLETE_COSTUM
+     * Constant : NAVIGATOR_GETTL
+     * @param data - Données envoyées à l'API
+     * @returns Les données de réponse.
+     * @throws {ApiResponseError} - En cas d'erreur détectée dans la réponse.
+     * @throws {Error} - En cas d'erreur inattendue.
+     */
+    navigatorGettl(data: NavigatorGettlData): Promise<any>;
     /**
      * Récupérer les acteurs d'événement : Récupérer les acteurs (organizers, attendees, creators, animators) d'une entité événement.
      * Constant : COSTUM_EVENT_REQUEST_ACTORS