@communecter/cocolight-api-client 1.0.140 → 1.0.142

package/src/index.ts

@@ -41,6 +41,9 @@ const cocolightApiClient = {
 
 export default cocolightApiClient;
 
+// Helpers réactifs en exports nommés (permet `import { effect, subscribeTo } from "..."`)
+export { batch, computed, effect, getSignals, isReactive, isSignal, reactive, subscribeTo, watch } from "./utils/reactive.js";
+
 // Export des types pour faciliter l'utilisation
 
 // Classes principales
@@ -101,6 +104,10 @@ export type * from "./api/serverDataType/Action.js";
 export type * from "./api/serverDataType/common.js";
 export type * from "./api/serverDataType/Country.js";
 export type * from "./api/serverDataType/Zone.js";
+export type * from "./api/serverDataType/Notification.js";
+
+// Classes notifications (type-only, comme les entités) — instances obtenues via me.notifications
+export type { Notification, Notifications } from "./api/Notifications.js";
 
 // Types utilitaires BaseEntity
 export type {
@@ -113,6 +120,8 @@ export type {
   CostumContextFields,
   WithCostumContext,
   EntityType,
+  CoformThematicValue,
+  CoformFilterByPathResult,
 } from "./api/BaseEntity.js";
 
 // Constantes BaseEntity

package/types/api/BaseEntity.d.ts

@@ -1,4 +1,4 @@
-import type { UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, GetNewsData, GetGalleryData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestDatesData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetOrganizationsAdminData, GetOrganizationsNoAdminData, GetProjectsAdminData, GetProjectsNoAdminData, GetPoisAdminData, GetPoisNoAdminData, GetSubscribersData, GetBadgesData, CoformAnswersSearchData, SearchMemberAutocompleteData, GetEventsData, CostumFilterCoformData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, FundingEnvelopeData, CoremuOperationData, UpdatePathValueData } from "./EndpointApi.types.js";
+import type { UpdateSettingsData, UpdateBlockDescriptionData, UpdateBlockInfoData, UpdateBlockSocialData, UpdateBlockLocalityData, GetNewsData, GetGalleryData, GlobalAutocompleteCostumData, CostumEventRequestActorsData, CostumEventRequestSubeventsData, CostumEventRequestDatesData, CostumEventRequestElementEventData, CostumEventRequestCategoriesData, CostumEventRequestEventData, CostumEventRequestLinkTlToEventData, CostumEventRequestLoadContextTagData, GetOrganizationsAdminData, GetOrganizationsNoAdminData, GetProjectsAdminData, GetProjectsNoAdminData, GetPoisAdminData, GetPoisNoAdminData, GetSubscribersData, GetBadgesData, CoformAnswersSearchData, SearchMemberAutocompleteData, GetEventsData, CostumFilterCoformData, CostumFilterCoformByPathData, GetCountriesData, SearchZonesData, CoformAnswersByFormsData, FundingEnvelopeData, CoremuOperationData, UpdatePathValueData } from "./EndpointApi.types.js";
 import type { TransformsMap } from "../types/entities.js";
 import type { CountryItem } from "./serverDataType/Country.js";
 import type { ZoneItemNormalized } from "./serverDataType/Zone.js";
@@ -176,6 +176,29 @@ export type CostumContextFields = {
     sourceKey: string[];
 };
 export type WithCostumContext<T> = T & CostumContextFields;
+/**
+ * Une valeur distincte d'une thématique CoForm (retournée par `coformFilterByPath`).
+ */
+export interface CoformThematicValue {
+    /** Nom de la valeur de thématique (ex: "Cafés cantines solidaires"). */
+    name: string;
+    /** URL de l'image associée (chaîne vide si aucune). */
+    image: string;
+    /** Identifiants des éléments liés via le finder (orgas/projets/poi selon finderPath). */
+    orgaNameArray: string[];
+}
+/**
+ * Résultat normalisé de `coformFilterByPath` (endpoint COSTUM_FILTER_COFORM_BY_PATH).
+ * Reconstruit proprement la réponse backend que le normalizer générique aplatit.
+ */
+export interface CoformFilterByPathResult {
+    /** _id des answers concernées par la thématique (dédupliqués). */
+    distinctElements: string[];
+    /** Valeurs distinctes de la thématique, chacune avec image/name/éléments liés. */
+    values: CoformThematicValue[];
+    /** Compteurs renvoyés par le backend (ex: `{ answers: 14 }`). */
+    count: Record<string, number>;
+}
 type PaginationCursor = {
     searchType?: string[];
     searchBy?: string;
@@ -2044,6 +2067,50 @@ export declare class BaseEntity<TServerData = any> {
      * filters["activités"].count; // { "Atelier": 12, "Coworking": 8 }
      */
     coformFiltersSearch(data?: Partial<CostumFilterCoformData>): Promise<any>;
+    /**
+     * Récupère les valeurs distinctes d'**une seule** thématique CoForm, query pilotée
+     * côté client via `params.thematicPath` (+ `params.finderPath` optionnel).
+     *
+     * Distinct de {@link coformFiltersSearch} (qui passe `searchedData` et fait le batch
+     * multi-filtres piloté serveur) : ici on cible UN filtre précis et on construit
+     * soi-même la projection (`fields`) et les `filters`. Côté backend, c'est la branche
+     * `isset($_POST["params"])` du controller AutoGlobalThematicNtwrkAction.
+     *
+     * Utile pour un **filtre par réseau régional/thématique** : on combine `params` avec
+     * `notSourceKey: true` (cherche dans tout le réseau) ou `sourceKey: ["<réseau>"]`
+     * (scope un réseau précis — cf. `_withCostumContext`).
+     *
+     * @param data - `params.thematicPath` est requis ; le reste (fields/filters/searchType/
+     *   sortBy/indexMin/indexStep/notSourceKey/locality) est optionnel.
+     * @returns {@link CoformFilterByPathResult} : `{ distinctElements, values, count }`.
+     *   Reconstruit proprement la map backend que le normalizer générique aplatit
+     *   (la clé `results` est traitée comme wrapper de liste par `_transformData`).
+     * @throws {ApiError} 400 si `params.thematicPath` est absent.
+     *
+     * @example
+     * const res = await project.coformFilterByPath({
+     *   params: {
+     *     thematicPath: "lesCommunsDesTierslieux17102023_108_0.multiCheckboxPlus...",
+     *     finderPath: "answers.lesCommunsDesTierslieux17102023_108_0.finder...",
+     *   },
+     *   fields: [
+     *     "answers.lesCommunsDesTierslieux17102023_108_0.multiCheckboxPlus...",
+     *     "answers.lesCommunsDesTierslieux17102023_108_0.finder...",
+     *   ],
+     *   filters: {
+     *     "answers.lesCommunsDesTierslieux17102023_108_0.multiCheckboxPlus...": { $exists: true },
+     *   },
+     *   searchType: ["answers"],
+     *   notSourceKey: true,
+     * });
+     * res.count.answers;            // 14
+     * res.values[0].name;          // "Cafés cantines solidaires"
+     * res.values[0].orgaNameArray; // ["5b740..."]
+     * res.distinctElements;        // string[] des _id concernés
+     */
+    coformFilterByPath(data: Partial<CostumFilterCoformByPathData> & {
+        params: CostumFilterCoformByPathData["params"];
+    }): Promise<CoformFilterByPathResult>;
     /**
      * Recherche des zones géographiques selon un pays et un niveau administratif.
      * Utilise le contexte Communecter de l'entité courante.

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, 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";
+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, CostumFilterCoformByPathData, 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
  */
@@ -1126,6 +1126,15 @@ export declare class EndpointApi {
      * @throws {Error} - En cas d'erreur inattendue.
      */
     costumFilterCoform(data: CostumFilterCoformData): Promise<any>;
+    /**
+     * Filtre CoForm par path (thématique unique) : Récupère les valeurs distinctes d'UNE thématique CoForm (branche `isset($_POST['params'])` du controller AutoGlobalThematicNtwrkAction). La query est construite côté client via `params.thematicPath` (+ `params.finderPath` optionnel) ; le serveur fait un seul globalAutoComplete + tri. Distinct de COSTUM_FILTER_COFORM (branche `searchedData`, multi-filtres pilotés serveur).
+     * Constant : COSTUM_FILTER_COFORM_BY_PATH
+     * @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.
+     */
+    costumFilterCoformByPath(data: CostumFilterCoformByPathData): Promise<any>;
     /**
      * Récupérer la liste des pays : Récupérer la liste de tous les pays
      * Constant : GET_COUNTRIES

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

@@ -5234,6 +5234,102 @@ export interface CostumFilterCoformData {
     costumType?: string;
     [k: string]: unknown;
 }
+export interface CostumFilterCoformByPathData {
+    /**
+     * Discriminant de la branche B : chemins de la thématique et du finder. Sa présence aiguille le controller vers le mode single-filtre client-driven.
+     */
+    params: {
+        /**
+         * Chemin de la thématique dans answers (ex: `formKey.multiCheckboxPlus...`). Devient `path` côté backend.
+         */
+        thematicPath: string;
+        /**
+         * Chemin du finder (ex: `answers.formKey.finder...`). Optionnel : défaut backend `links.organizations`.
+         */
+        finderPath?: string;
+    };
+    /**
+     * Types d'entités à inclure (typiquement `["answers"]`).
+     */
+    searchType?: string[];
+    /**
+     * Projection : champs à retourner (incluant thematicPath et finderPath).
+     */
+    fields?: string[];
+    /**
+     * Filtres MongoDB additionnels (objet) ou chaîne vide.
+     */
+    filters?: {
+        [k: string]: unknown;
+    } | "";
+    /**
+     * Champ de tri (clé = champ, valeur = 1 ou -1).
+     */
+    sortBy?: {
+        [k: string]: 1 | -1;
+    };
+    /**
+     * Index de départ pour la pagination.
+     */
+    indexMin?: number;
+    /**
+     * Nombre d'éléments à récupérer (haut par défaut : agrégation des valeurs distinctes).
+     */
+    indexStep?: number;
+    /**
+     * Comptage des types dans la réponse.
+     */
+    count?: boolean;
+    /**
+     * Extension Fediverse (toujours désactivée).
+     */
+    fediverse?: boolean;
+    /**
+     * Si true, ignore le filtre sourceKey côté backend (recherche dans tout le réseau, pas seulement le costum courant).
+     */
+    notSourceKey?: boolean;
+    /**
+     * Type initial de la recherche (vide par défaut).
+     */
+    initType?: string;
+    /**
+     * Localités ciblées (object keyé, array d'objets, ou chaîne vide).
+     */
+    locality?: {
+        [k: string]: unknown;
+    } | {
+        [k: string]: unknown;
+    }[] | "";
+    /**
+     * ID du contexte costum (auto-injecté par _withCostumContext).
+     */
+    contextId?: string;
+    /**
+     * Type du contexte costum (auto-injecté).
+     */
+    contextType?: "projects" | "organizations";
+    /**
+     * Slug du costum (auto-injecté par _withCostumContext).
+     */
+    costumSlug?: string;
+    /**
+     * Alias historique de contextId (auto-injecté).
+     */
+    costumId?: string;
+    /**
+     * Alias historique de contextType (auto-injecté).
+     */
+    costumType?: "projects" | "organizations";
+    /**
+     * Mode édition costum (toujours désactivé).
+     */
+    costumEditMode?: boolean;
+    /**
+     * Clés de source pour filtrer (ignoré si notSourceKey=true).
+     */
+    sourceKey?: string[];
+    [k: string]: unknown;
+}
 export interface GetCountriesData {
     /**
      * Slug personnalisé

package/types/api/Notifications.d.ts

@@ -0,0 +1,79 @@
+import type { NotificationAuthor, NotificationItemData } from "./serverDataType/Notification.js";
+type User = import("./User.js").User;
+/**
+ * Item de notification fin. N'étend PAS BaseEntity : il garde la donnée brute, un backref
+ * User (pour router les appels via callIsMe + endpointApi) et un backref manager (pour le recount).
+ * Les drapeaux lu/vu sont réactifs (objet reactive({...}) — surface scalaire fiable).
+ */
+export declare class Notification {
+    private readonly _data;
+    private readonly _owner;
+    private _manager;
+    private readonly _state;
+    constructor(data: NotificationItemData, owner: User, manager?: Notifications | null);
+    static fromData(data: NotificationItemData, owner: User, manager?: Notifications | null): Notification;
+    /** Lie l'item à son manager (appelé par le manager au wrap). */
+    _attach(manager: Notifications): this;
+    get id(): string;
+    get isUnread(): boolean;
+    get isUnseen(): boolean;
+    get data(): NotificationItemData;
+    get author(): NotificationAuthor;
+    get createdAt(): Date;
+    _setReadLocal(): void;
+    _setSeenLocal(): void;
+    _restoreLocal(unread: boolean, unseen: boolean): void;
+    /** Marque CET item comme lu : optimiste + rollback + recount manager. */
+    markRead(): Promise<void>;
+    /** Pas d'endpoint "seen" par item : flip local uniquement. */
+    markSeen(): void;
+    toJSON(): NotificationItemData;
+}
+/**
+ * Gestionnaire de notifications de l'utilisateur connecté. Accroché à User via `me.notifications`.
+ * N'étend PAS BaseEntity. Items dans un tableau SIMPLE (jamais proxifié) ; seuls les scalaires
+ * vivent dans un reactive({...}) (loadedUnreadCount, unseenTotal, cursor, hasMore, version).
+ * Aucun effect/computed créé ici (pas d'API de dispose -> pas de fuite).
+ */
+export declare class Notifications {
+    private readonly _owner;
+    private readonly _pageSize;
+    private _items;
+    private readonly _state;
+    constructor(owner: User, pageSize?: number);
+    get items(): Notification[];
+    get loadedUnreadCount(): number;
+    get unseenTotal(): number;
+    get hasMore(): boolean;
+    _recount(): void;
+    private _wrap;
+    private _commit;
+    /** Première page (reset le curseur). Tri serveur : updated desc, 15/page. */
+    list({ indexMin }?: {
+        indexMin?: number;
+    }): Promise<Notification[]>;
+    /** Page suivante (curseur indexMin = nb d'items déjà chargés). Concatène par réassignation. */
+    loadMore(): Promise<Notification[]>;
+    /** Recharge depuis le début. */
+    refresh(): Promise<Notification[]>;
+    /**
+     * Badge : total des NON-VUS via GET_NOTIFICATIONS_COUNT (refreshTimestamp = maintenant ->
+     * liste vide + countNotif). Met à jour unseenTotal et le retourne.
+     */
+    count(): Promise<number>;
+    /**
+     * PUR : convertit des `NotificationItemData[]` plats (ex. cache React Query après
+     * hydratation SSR) en `Notification[]` liées à l'utilisateur, SANS modifier l'état du
+     * manager. À utiliser dans un `select` React Query (cache plat -> instances vivantes).
+     */
+    toItems(data: NotificationItemData[]): Notification[];
+    markAllRead(): Promise<void>;
+    markAllSeen(): Promise<void>;
+    private _bulk;
+    /** Supprime toutes les notifications de l'utilisateur + vide l'état local. */
+    clear(): Promise<void>;
+    toJSON(): NotificationItemData[];
+    restore(rawItems: NotificationItemData[]): this;
+    static restore(rawItems: NotificationItemData[], owner: User): Notifications;
+}
+export {};

package/types/api/User.d.ts

@@ -1,8 +1,10 @@
 import { BaseEntity } from "./BaseEntity.js";
+import { Notifications } from "./Notifications.js";
 import type { Badge } from "./Badge.js";
 import type { PaginatorPage, PaginatorState } from "./BaseEntity.js";
 import type { ChangePasswordData, DeleteAccountData, GetSubscriptionsAdminData, GetSubscriptionsData, GetOrganizationsNoAdminData, GetOrganizationsAdminData, GetFriendsAdminData } from "./EndpointApi.types.js";
 import type { Organization } from "./Organization.js";
+import type { NotificationItemData } from "./serverDataType/Notification.js";
 import type { EntityTypes } from "@/types/entities.js";
 type ApiClient = import("../ApiClient.js").default;
 type UserItemNormalized = import("./serverDataType/User.js").UserItemNormalized;
@@ -786,5 +788,33 @@ export declare class User extends BaseEntity<UserItemNormalized> {
      * ```
      */
     demoteFromAdmin(): Promise<unknown>;
+    /** Gestionnaire de notifications, créé paresseusement et mis en cache. */
+    private _notifications?;
+    /**
+     * Point d'entrée `me.notifications` (composition, PAS une entité BaseEntity).
+     * Sûr : endpointApi/apiClient sont initialisés dans le constructeur avant tout accès getter.
+     */
+    get notifications(): Notifications;
+    /**
+     * Récupère les notifications (mode liste). STATELESS + plat (`NotificationItemData[]`),
+     * idéal comme `queryFn` React Query / prefetch SSR — ne touche PAS le manager réactif
+     * (`me.notifications`). `ApiClient._transformData` garantit `notif` = tableau (map -> array
+     * + `id` injecté), donc on fait confiance à la normalisation amont.
+     * pathParams.id est OBLIGATOIRE : le défaut "@userId" ne matche pas le pattern de l'endpoint.
+     */
+    fetchNotifications({ indexMin }?: {
+        indexMin?: number;
+    }): Promise<NotificationItemData[]>;
+    /**
+     * Compte les notifications NON VUES (badge). STATELESS. refreshTimestamp = maintenant ->
+     * le serveur renvoie `countNotif` (total non-vus) + une liste vide.
+     */
+    fetchNotificationsCount(): Promise<number>;
+    /** Marque une notification comme lue (MARK_NOTIFICATION_AS_READ). */
+    markNotificationAsRead(id: string): Promise<unknown>;
+    /** Marque toutes les notifications comme vues/lues (NOTIFICATION_UPDATE). */
+    markAllNotifications(action: "seen" | "read"): Promise<unknown>;
+    /** Supprime toutes les notifications de l'utilisateur (REMOVE_ALL_NOTIFICATIONS). */
+    removeAllNotifications(): Promise<unknown>;
 }
 export {};

package/types/api/serverDataType/Notification.d.ts

@@ -0,0 +1,73 @@
+import type { DateValue, IdObject } from "./common.js";
+import type EJSONType from "../../EJSONType.js";
+type ObjectIDInstance = InstanceType<typeof EJSONType["ObjectID"]>;
+export type NotificationId = ObjectIDInstance | IdObject | string;
+/** Auteur APRÈS aplatissement par _transformData (la map oid->objet devient un objet). */
+export interface NotificationAuthor {
+    id?: string;
+    type?: string;
+    name: string;
+    profilThumbImageUrl?: string;
+    [k: string]: unknown;
+}
+export interface NotificationTarget {
+    type: string;
+    id: string;
+    parent?: {
+        id: string;
+        type: string;
+    };
+}
+/** État lu/vu, par destinataire. Un champ ABSENT (clé unset côté serveur) = état "faux". */
+export interface NotificationReadState {
+    isUnread?: boolean;
+    isUnseen?: boolean;
+}
+export interface NotificationNotify {
+    objectType?: string;
+    /** keyé par oid de destinataire -> état lu/vu de CE destinataire. */
+    id: Record<string, NotificationReadState>;
+    displayName?: string;
+    icon?: string;
+    url?: string;
+    label?: string;
+    labelArray?: Record<string, string[]>;
+    labelAuthorObject?: string;
+    repeat?: boolean;
+    [k: string]: unknown;
+}
+/** Un élément du tableau `notif` (forme transformée). created/updated : Date instance OU {sec,usec}. */
+export interface NotificationItemData {
+    id: string;
+    _id: NotificationId;
+    type: string;
+    verb: string;
+    author: NotificationAuthor;
+    created: Date | DateValue;
+    updated: Date | DateValue;
+    target: NotificationTarget;
+    notify: NotificationNotify;
+    timestamp?: number;
+    timeAgo?: string;
+    [k: string]: unknown;
+}
+/**
+ * Réponse de GET_NOTIFICATIONS (mode liste, body indexMin) APRÈS transform :
+ * `notif` est un tableau (la map oid->item est convertie). Vide => [].
+ */
+export interface GetNotificationsResult {
+    notif: NotificationItemData[];
+    [k: string]: unknown;
+}
+/**
+ * Réponse de GET_NOTIFICATIONS_COUNT (mode badge, body refreshTimestamp non-nul) :
+ * `notif` = notifications mises à jour APRÈS le timestamp (souvent [] si timestamp = maintenant),
+ * `countNotif` = nombre TOTAL de notifications NON VUES (isUnseen) — indépendant du timestamp.
+ * countNotif n'est présent QUE si refreshTimestamp est fourni et non-nul (sinon mode liste).
+ */
+export interface GetNotificationsCountResult {
+    notif: NotificationItemData[];
+    countNotif?: number;
+    [k: string]: unknown;
+}
+export {};