@communecter/cocolight-api-client 1.0.131 → 1.0.132

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

@@ -20,4 +20,5 @@ export declare class Answer extends BaseEntity<AnswerItemNormalized> {
        * Constant : COFORM_ANSWERS_BY_ID
        */
     get(): Promise<Record<string, any>>;
+    form(): Promise<never>;
 }

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,9 @@ type NewsInput = {
 type ActionInput = {
     id: string;
 } | Record<string, any>;
+type FormInput = {
+    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 +60,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;
 };
@@ -118,6 +130,8 @@ export type CostumContextFields = {
     costumSlug: string;
     contextId: string;
     contextType: EntityType;
+    costumId: string;
+    costumType: EntityType;
     sourceKey: string[];
 };
 export type WithCostumContext<T> = T & CostumContextFields;
@@ -143,6 +157,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: {
@@ -1158,6 +1178,23 @@ 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>;
     /**
      * 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 +1637,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