@communecter/cocolight-api-client 1.0.192 → 1.0.193

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@communecter/cocolight-api-client",
-  "version": "1.0.192",
+  "version": "1.0.193",
   "description": "Client Axios simplifié pour l'API cocolight",
   "repository": {
     "type": "git",

package/types/api/BaseEntity.d.ts

@@ -72,12 +72,15 @@ type ParentLike = BaseEntity<any> & {
  *
  * - `default`   → `/co2/search/globalautocomplete`
  * - `navigator-tl` → `/costum/navigator/gettl`
+ * - `navigator-tl-ressource` → `/costum/navigator/getsressourcetl` (annuaire de ressources tiers-lieux :
+ *   même payload que gettl, réponse = answers BRUTES + porteur résolu/address/geo + documents ;
+ *   schéma 200 permissif — cf. NAVIGATOR_GET_RESSOURCE_TL)
  * - `admin`     → `/co2/search/globalautocompleteadmin/type/{type}/id/{id}/canSee/true`
  *   (SearchNew::searchAdmin — réservé aux admins de l'entité porteuse : `fields` = projection
  *   EXACTE, `preferences` NON strippé → badge/filtre `toBeValidated`, tri serveur via `sort`.
  *   pathParams {type,id} posés automatiquement depuis l'entité appelante — cf. searchCostum.)
  */
-export type SearchCostumVariant = "default" | "navigator-tl" | "admin";
+export type SearchCostumVariant = "default" | "navigator-tl" | "navigator-tl-ressource" | "admin";
 /**
  * Types de coercion backend supportés par `UPDATE_PATH_VALUE.setType`.
  *

package/types/api/EndpointApi.d.ts

@@ -1,5 +1,5 @@
 import type ApiClient from "../ApiClient.js";
-import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, ContactSendData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GlobalAutocompleteAdminCostumData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, CreateInvitationLinkData, ConnectByRefData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteMembersData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, DeleteCoformAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, CostumToolsCatalogData, CostumToolUsersData, CostumCommunInfoData, CostumSaveToolEnrichmentData, CostumCommunListData, GenerateAnswerFromFormData, GenerateProjectFromAnswerData, GenerateMilestoneFromDepenseData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, PersonValidateInvitationData, ValidateInvitationByMailData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, TransferSourceCheckData, TransferSourceApplyData, TransferSourceRollbackData, TransferSourceHistoryData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, CostumResolvedData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
+import type { DocumentListData, PersonRegisterData, AuthenticateUrlData, RefreshTokenUrlData, PasswordRecoveryData, PasswordResetData, ServerExchangeTokenData, ChangePasswordData, DeleteAccountData, UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, UpdateBlockSlugData, CheckData, ProfilImageData, ProfilBannerData, GetElementsAboutData, MulticonnectData, RelaunchInvitationData, ContactSendData, GetNewsData, GetNewsByIdData, AddNewsData, AddImageNewsData, AddFileNewsData, DeleteNewsData, UpdateNewsData, ShareNewsData, GetCommentsData, AddCommentsData, DeleteCommentsData, UpdateCommentsData, SearchTagsData, ShowVoteData, GlobalAutocompleteData, CityAutocompleteData, CityAutocompleteByCountryData, SuggestionInputData, GetProjectsNoAdminData, GetProjectsAdminData, GetPoisNoAdminData, GetPoisAdminData, GlobalAutocompleteAdminCostumData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetUserEligiblePlacesData, GetMembersNoAdminData, GetMembersAdminData, GetFriendsAdminData, GetSubscriptionsData, GetSubscriptionsAdminData, GetSubscribersData, GetSubscribersAdminData, GetContributorsNoAdminData, GetContributorsAdminData, GetBadgesData, GetBadgesFiltersData, ConnectData, CreateInvitationLinkData, ConnectByRefData, DisconnectData, GetElementsKeyData, GetFavorisData, DeleteFavorisData, AddFavorisData, AddOrganizationData, AddProjectData, AddPoiData, AddEventData, DeleteElementData, AddImageElementData, LinkValidateData, SearchMemberAutocompleteData, GetNotificationsData, GetNotificationsCountData, NotificationUpdateData, MarkNotificationAsReadData, ActivitypubSearchData, ActivitypubLinkData, ActivitypubGetCommunityData, GetBadgeData, AddBadgesData, AssignBadgesData, GetEventsData, SearchEventsCostumData, ShareEventsData, InviteMembersData, FollowData, GetCostumJsonData, GlobalAutocompleteCostumData, NavigatorGettlData, NavigatorGetRessourceTlData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestDatesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetGalleryData, GetAttendeesNoAdminData, GetAttendeesAdminData, CoformAnswersSearchData, CoformAnswersByIdData, GetCoformByIdData, CoformUploadAnswerFileData, DeleteCoformAnswerFileData, CoformGetAnswerFilesData, GetCoformCatalogsData, SaveCoformAnswerData, GetCoformAnswerHistoryData, GetCoformMultievalDataData, GetCoformCommontableContributorsData, AddVoteData, AddReportAbuseData, UpdatePathValueData, DeleteDocumentByContextData, DeleteDocumentByIdData, DemoteAdminData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, CostumToolsCatalogData, CostumToolUsersData, CostumCommunInfoData, CostumSaveToolEnrichmentData, CostumCommunListData, GenerateAnswerFromFormData, GenerateProjectFromAnswerData, GenerateMilestoneFromDepenseData, FundingEnvelopeData, CoremuOperationData, CostumProjectActionRequestNewData, CostumProjectActionRequestSetStatusData, CostumProjectActionRequestSetDateData, CostumProjectActionRequestSetContributorsData, CostumProjectActionRequestCancelData, CostumProjectActionRequestArchiveData, LinkDiscourseAccountData, UnlinkDiscourseAccountData, DiscourseProfileData, DiscourseCheckEmailData, DiscourseDismissLinkData, LinkMediawikiAccountData, UnlinkMediawikiAccountData, GetMediawikiContributionsData, AddClassifiedData, PersonActivateData, PersonValidateInvitationData, ValidateInvitationByMailData, ImportPreviewData, ExportElementsData, ImportElementsData, GeocodageData, ValidateGroupData, SetSourceData, TransferSourceCheckData, TransferSourceApplyData, TransferSourceRollbackData, TransferSourceHistoryData, ModerateData, NewsModerateData, CommentModerateData, UploadDocumentData, ZoneGetShapeData, ZoneGetZonirisData, CostumListValuesData, CostumResolvedData, DirectoryProposalData, DirectoryProposalCountData, DirectoryProposalNewCounterData } from "./EndpointApi.types.js";
 /**
  * Classe EndpointApi générée automatiquement depuis endpoints-copie.json
  */
@@ -967,6 +967,15 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     navigatorGettl(data: NavigatorGettlData): Promise<any>;
+    /**
+     * Annuaire de ressources tiers-lieux (navigator/getsressourcetl) : Recherche globale via navigator/getsressourcetl — payload identique à NAVIGATOR_GETTL / GLOBAL_AUTOCOMPLETE_COSTUM (drop-in de SearchNew::globalAutoComplete), suivi du post-traitement serveur Navigator::getRessourceTL : tiers-lieu porteur résolu via l input `finder` (address/geo/geoPosition remontés à la racine, finder.<parentId>.img), garde `filters[address.level1]` sur ce porteur (retirée du payload avant la recherche ; sans porteur → exclu), `documents` (photos) par réponse. `answers` reste un blob BRUT keyé par étape (PAS re-keyé par formId comme gettl). `fields` doit contenir `answers` ET `form` : sans `answers` projeté aucun porteur n est résolu (et la garde address.level1 exclut alors TOUT) ; sans `form`, le serveur se rabat sur les 3 chemins finder et seul le 1er (salles) résout (BUG-L-265).
+     * Constant : NAVIGATOR_GET_RESSOURCE_TL
+     * @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.
+     */
+    navigatorGetRessourceTl(data: NavigatorGetRessourceTlData): 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

package/types/api/EndpointApi.types.d.ts

@@ -4988,6 +4988,168 @@ export interface NavigatorGettlData {
     };
     [k: string]: unknown;
 }
+export interface NavigatorGetRessourceTlData {
+    /**
+     * Nom ou mot-clé de la recherche
+     */
+    name?: string;
+    /**
+     * Localités ciblées. Trois formes acceptées : object keyé (forme historique), array d'objets (forme alternative consommée par `foreach`), ou chaîne vide (placeholder = pas de filtre).
+     */
+    locality?: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[^\s]+$".
+         */
+        [k: string]: {
+            /**
+             * Identifiant de la localité
+             */
+            id: string;
+            /**
+             * Type de localité
+             */
+            type: "cities" | "cp" | "country" | "level1" | "level2" | "level3" | "level4" | "level5";
+            postalCode?: string;
+            countryCode?: string;
+            name?: string;
+            level?: string | number;
+        };
+    } | {
+        id: string;
+        type: "cities" | "cp" | "country" | "level1" | "level2" | "level3" | "level4" | "level5";
+        postalCode?: string;
+        countryCode?: string;
+        name?: string;
+        level?: string | number;
+    }[] | "";
+    /**
+     * Types d'entités à inclure dans la recherche
+     */
+    searchType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
+    /**
+     * Balises (tags) à utiliser pour filtrer la recherche
+     */
+    searchTags?: string[];
+    /**
+     * Liste fixe des types à compter dans les résultats
+     */
+    countType: ("NGO" | "LocalBusiness" | "Group" | "GovernmentOrganization" | "Cooperative" | "organizations" | "projects" | "events" | "citoyens" | "poi" | "news" | "answers" | "forms" | "classifieds")[];
+    /**
+     * Sélecteur des champs où chercher le terme `name`. Trois formes acceptées : `"ALL"` (cherche dans name/title/slug/tags/source.keys/sigle/description), chaîne CSV (`"name,slug,tags"`), ou tableau de chemins (`["name", "address.addressLocality"]`).
+     */
+    searchBy?: string | [string, ...string[]];
+    /**
+     * 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;
+    /**
+     * Filtres additionnels appliqués à la recherche (objet ou chaîne vide)
+     */
+    filters?: {
+        [k: string]: unknown;
+    } | "";
+    /**
+     * Liste des champs à retourner
+     */
+    fields?: string[];
+    /**
+     * Champ de tri (clé = champ, valeur = 1 ou -1)
+     */
+    sortBy?: {
+        [k: string]: 1 | -1;
+    };
+    /**
+     * Indique si la recherche doit s'étendre au Fediverse (toujours désactivé)
+     */
+    fediverse: boolean;
+    /**
+     * Indique si la recherche est effectuée à partir d'une carte (toujours désactivé)
+     */
+    mapUsed?: true;
+    /**
+     * Indique si on doit exclure les éléments avec une source
+     */
+    notSourceKey?: true;
+    /**
+     * ID du contexte de recherche (actuellement vide)
+     */
+    contextId?: string;
+    /**
+     * Type de contexte de recherche (actuellement vide)
+     */
+    contextType?: "projects" | "organizations";
+    /**
+     * Slug du costume utilisé pour la recherche
+     */
+    costumSlug: string;
+    /**
+     * Alias historique de `contextId` — id du contexte costum. Le backend lit l'un OU l'autre (`isset($post['contextId']) ? ... : $post['costumId']`).
+     */
+    costumId?: string;
+    /**
+     * Alias historique de `contextType` — type du contexte costum.
+     */
+    costumType?: "projects" | "organizations";
+    /**
+     * Mode d'affichage / comportement côté backend. Valeurs observées : `table` (charge `creatorData`), `mapWithDirectory`. String libre.
+     */
+    mode?: string;
+    /**
+     * Clés de source pour la recherche
+     */
+    sourceKey?: string[];
+    /**
+     * Indique si le mode d'édition du costume est activé (toujours désactivé)
+     */
+    costumEditMode: boolean;
+    options?: {
+        tags?: {
+            /**
+             * Verbe d'action pour le filtre de recherche
+             */
+            verb?: string;
+            [k: string]: unknown;
+        };
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
 export interface CostumEventRequestActorsData {
     /**
      * Types de liens à inclure (ex: organizer, attendees, creator, animator)