@sia-ui/api 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @sia-ui/api
 
+## 0.8.0
+
+### Minor Changes
+
+- Français et anglais livrés, temps réel, calendrier réécrit, suivi d'opérations.
+  - **Deux langues** — `FRENCH` et `ENGLISH` (`@sia-ui/headless`), au format
+    `SiaLocale` : la langue de formatage (`language`), le vocabulaire commun et
+    un groupe typé par composant. Plus aucun texte en dur dans les composants,
+    `aria-label` compris ; dates, nombres et pluriels suivent `language`. Une
+    application qui a sa propre i18n remplit le même format. `formatMessage` et
+    `plural` (`{count}`, clés `_one` / `_other`). `ENGLISH_STATUS_MESSAGES`
+    (`@sia-ui/api`) à côté de `FRENCH_STATUS_MESSAGES`.
+    Seul changement de forme : `EventCalendarLabels.more`, qui était une
+    fonction, devient `more_one` / `more_other` avec `{count}`.
+  - **`SiaProvider` seul fournisseur** — il prend `locale` et `defaults`, et
+    s'imbrique pour une section. `SiaConfigProvider` est obsolète.
+  - **Temps réel** — `createRealtimeBinding`, `socketIoSource`,
+    `eventSourceSource` (`@sia-ui/api`), `useRealtimeStatus`, `LiveIndicator`.
+  - **`EventCalendar` réécrit** — vues mois, semaine, jour, agenda ; variantes ;
+    mode étroit. **`EventManager`** : créer, consulter, modifier, supprimer.
+  - **Nouveaux composants** — `AccountMenu`, `ColorModeToggle`, `LogStream`,
+    `JsonView`, `JobProgress`, `BrandIcon` ; `SunIcon`, `MoonIcon`.
+  - **Formulaires** — `validateAsync` par champ, `submitProps.disabled`
+    respecté ; `controlProps` sur une propriété de ressource.
+  - **Tons lisibles en mode sombre** — `--sia-<ton>-foreground`, calculés pour
+    le contraste ; noms de variables CSS en kebab-case.
+  - **Couches en portail** — menus, calendriers, boîtes et toasts, rendus hors
+    de `[data-sia-root]`, reprennent la police et la couleur de texte du
+    système au lieu de celles du navigateur.
+  - **`Drawer` et `Modal`** — la fermeture est signalée tout de suite ; un
+    double clic à l'ouverture ne referme plus.
+  - **Documentation** — la présentation décrit chaque brique métier (session,
+    greffons d'API, ressources, formulaires, temps réel, langues, utilitaires)
+    avec son scénario et un exemple.
+  - **Props des sous-composants** — chaque composant composé expose celles de
+    ce qu'il utilise (`…Props`) ; `pnpm check:slot-props` le vérifie.
+
 ## 0.7.1
 
 ### Patch Changes

package/README.md

@@ -37,6 +37,9 @@ le projet utilise déjà axios. Le paquet ne dépend d'aucun des deux.
 | `HttpError`    | statut, corps, et `fields` — trois formes d'erreurs par champ                               |
 | Greffons       | auth, rafraîchissement de jeton, 401, journal, idempotence, lecture seule, signal d'en-tête |
 | `TokenStorage` | mémoire ou navigateur, chaque accès protégé                                                 |
+| Cache          | `createQueryResource` : clés et options TanStack Query, invalidation après écriture       |
+| Temps réel     | `createRealtimeBinding` : Socket.IO ou SSE qui tient le cache à jour, rattrapage à la reconnexion |
+| Messages       | `FRENCH_STATUS_MESSAGES`, `ENGLISH_STATUS_MESSAGES` : une phrase lisible par statut      |
 | Filtres        | `$and` / `$or` portés par un en-tête plutôt que par l'URL                                   |
 
 Voir [docs/fondations/module-api.md](https://beatjo.github.io/sia-ui-site/fondations/module-api.html).
@@ -57,6 +60,43 @@ Le contenu ci-dessous reprend intégralement `CHANGELOG.md` pour rester visible
 <!-- sia:changelog:start -->
 # @sia-ui/api
 
+## 0.8.0
+
+### Minor Changes
+
+- Français et anglais livrés, temps réel, calendrier réécrit, suivi d'opérations.
+  - **Deux langues** — `FRENCH` et `ENGLISH` (`@sia-ui/headless`), au format
+    `SiaLocale` : la langue de formatage (`language`), le vocabulaire commun et
+    un groupe typé par composant. Plus aucun texte en dur dans les composants,
+    `aria-label` compris ; dates, nombres et pluriels suivent `language`. Une
+    application qui a sa propre i18n remplit le même format. `formatMessage` et
+    `plural` (`{count}`, clés `_one` / `_other`). `ENGLISH_STATUS_MESSAGES`
+    (`@sia-ui/api`) à côté de `FRENCH_STATUS_MESSAGES`.
+    Seul changement de forme : `EventCalendarLabels.more`, qui était une
+    fonction, devient `more_one` / `more_other` avec `{count}`.
+  - **`SiaProvider` seul fournisseur** — il prend `locale` et `defaults`, et
+    s'imbrique pour une section. `SiaConfigProvider` est obsolète.
+  - **Temps réel** — `createRealtimeBinding`, `socketIoSource`,
+    `eventSourceSource` (`@sia-ui/api`), `useRealtimeStatus`, `LiveIndicator`.
+  - **`EventCalendar` réécrit** — vues mois, semaine, jour, agenda ; variantes ;
+    mode étroit. **`EventManager`** : créer, consulter, modifier, supprimer.
+  - **Nouveaux composants** — `AccountMenu`, `ColorModeToggle`, `LogStream`,
+    `JsonView`, `JobProgress`, `BrandIcon` ; `SunIcon`, `MoonIcon`.
+  - **Formulaires** — `validateAsync` par champ, `submitProps.disabled`
+    respecté ; `controlProps` sur une propriété de ressource.
+  - **Tons lisibles en mode sombre** — `--sia-<ton>-foreground`, calculés pour
+    le contraste ; noms de variables CSS en kebab-case.
+  - **Couches en portail** — menus, calendriers, boîtes et toasts, rendus hors
+    de `[data-sia-root]`, reprennent la police et la couleur de texte du
+    système au lieu de celles du navigateur.
+  - **`Drawer` et `Modal`** — la fermeture est signalée tout de suite ; un
+    double clic à l'ouverture ne referme plus.
+  - **Documentation** — la présentation décrit chaque brique métier (session,
+    greffons d'API, ressources, formulaires, temps réel, langues, utilitaires)
+    avec son scénario et un exemple.
+  - **Props des sous-composants** — chaque composant composé expose celles de
+    ce qu'il utilise (`…Props`) ; `pnpm check:slot-props` le vérifie.
+
 ## 0.7.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -156,6 +156,22 @@ var FRENCH_STATUS_MESSAGES = {
   503: "Le service est momentan\xE9ment indisponible.",
   504: "Le serveur a mis trop de temps \xE0 r\xE9pondre."
 };
+var ENGLISH_STATUS_MESSAGES = {
+  0: "The server can't be reached. Check your connection.",
+  400: "The request is invalid.",
+  401: "Your session has expired. Please sign in again.",
+  403: "You don't have permission to do this.",
+  404: "The requested item can't be found.",
+  408: "The server took too long to respond.",
+  409: "This action conflicts with the current state. Reload and try again.",
+  413: "The content sent is too large.",
+  422: "Some values are invalid.",
+  429: "Too many attempts. Try again in a moment.",
+  500: "Something went wrong on the server.",
+  502: "The service is temporarily unavailable.",
+  503: "The service is temporarily unavailable.",
+  504: "The server took too long to respond."
+};
 var ECHEC_RESEAU = /failed to fetch|networkerror|load failed/i;
 var PHRASES = {
   400: "bad request",
@@ -1054,9 +1070,108 @@ function createQueryResource(service, options = {}) {
   };
 }
 
+// src/realtime.ts
+function createRealtimeBinding(options) {
+  const { source, cache, on, refetchOnReconnect = [] } = options;
+  const contexte = {
+    cache,
+    patch: (queryKey, updater) => {
+      cache.setQueryData(queryKey, updater);
+    },
+    invalidate: (...queryKeys) => {
+      for (const queryKey of queryKeys) void cache.invalidateQueries({ queryKey });
+    }
+  };
+  return {
+    source,
+    start() {
+      const desabonnements = Object.entries(on).map(
+        ([topic, gestionnaire]) => source.subscribe(topic, (event) => {
+          try {
+            gestionnaire(event, contexte);
+          } catch (error) {
+            console.error(`Temps r\xE9el : le gestionnaire de \xAB ${topic} \xBB a \xE9chou\xE9.`, error);
+          }
+        })
+      );
+      let precedent = source.status();
+      const statut = source.onStatusChange((suivant) => {
+        if (suivant === "open" && precedent !== "open" && refetchOnReconnect.length > 0) {
+          contexte.invalidate(...refetchOnReconnect);
+        }
+        precedent = suivant;
+      });
+      return () => {
+        for (const desabonner of desabonnements) desabonner();
+        statut();
+      };
+    }
+  };
+}
+function etatObservable(initial) {
+  let courant = initial;
+  const ecouteurs = /* @__PURE__ */ new Set();
+  return {
+    lire: () => courant,
+    poser: (suivant) => {
+      if (suivant === courant) return;
+      courant = suivant;
+      for (const ecouteur of ecouteurs) ecouteur(suivant);
+    },
+    ecouter: (ecouteur) => {
+      ecouteurs.add(ecouteur);
+      return () => {
+        ecouteurs.delete(ecouteur);
+      };
+    }
+  };
+}
+function socketIoSource(socket) {
+  const etat = etatObservable(socket.connected ? "open" : "connecting");
+  const ouvert = () => etat.poser("open");
+  const ferme = () => etat.poser("closed");
+  const reconnexion = () => etat.poser("connecting");
+  socket.on("connect", ouvert);
+  socket.on("disconnect", ferme);
+  socket.on("connect_error", reconnexion);
+  return {
+    subscribe(topic, handler) {
+      const listener = (event) => handler(event);
+      socket.on(topic, listener);
+      return () => {
+        socket.off(topic, listener);
+      };
+    },
+    status: etat.lire,
+    onStatusChange: etat.ecouter
+  };
+}
+function eventSourceSource(stream) {
+  const etat = etatObservable(stream.readyState === 1 ? "open" : stream.readyState === 2 ? "closed" : "connecting");
+  stream.onopen = () => etat.poser("open");
+  stream.onerror = () => etat.poser(stream.readyState === 2 ? "closed" : "connecting");
+  return {
+    subscribe(topic, handler) {
+      const listener = (event) => {
+        let contenu = event.data;
+        try {
+          contenu = JSON.parse(event.data);
+        } catch {
+        }
+        handler(contenu);
+      };
+      stream.addEventListener(topic, listener);
+      return () => stream.removeEventListener(topic, listener);
+    },
+    status: etat.lire,
+    onStatusChange: etat.ecouter
+  };
+}
+
 exports.ACCESS_TOKEN_KEY = ACCESS_TOKEN_KEY;
 exports.ApiClient = ApiClient;
 exports.BaseService = BaseService;
+exports.ENGLISH_STATUS_MESSAGES = ENGLISH_STATUS_MESSAGES;
 exports.FILTERS_HEADER = FILTERS_HEADER;
 exports.FRENCH_STATUS_MESSAGES = FRENCH_STATUS_MESSAGES;
 exports.HttpError = HttpError;
@@ -1074,11 +1189,14 @@ exports.createLoggerPlugin = createLoggerPlugin;
 exports.createMemoryTokenStorage = createMemoryTokenStorage;
 exports.createQueryResource = createQueryResource;
 exports.createReadOnlyPlugin = createReadOnlyPlugin;
+exports.createRealtimeBinding = createRealtimeBinding;
 exports.createRefreshTokenPlugin = createRefreshTokenPlugin;
 exports.createResourceService = createResourceService;
 exports.createUnauthorizedPlugin = createUnauthorizedPlugin;
+exports.eventSourceSource = eventSourceSource;
 exports.filtersHeader = filtersHeader;
 exports.isGenericMessage = isGenericMessage;
 exports.localizeError = localizeError;
 exports.nestFieldErrors = nestFieldErrors;
 exports.normalizeFilters = normalizeFilters;
+exports.socketIoSource = socketIoSource;

package/dist/index.d.cts

@@ -250,6 +250,8 @@ declare function createApiClient(options: ApiClientOptions): ApiClient;
  * `0` couvre l'échec réseau : le serveur injoignable, la connexion coupée.
  */
 declare const FRENCH_STATUS_MESSAGES: Readonly<Record<number, string>>;
+/** Les mêmes, en anglais. */
+declare const ENGLISH_STATUS_MESSAGES: Readonly<Record<number, string>>;
 /**
  * Vrai quand le message du serveur est générique.
  *
@@ -560,6 +562,89 @@ declare function createQueryResource<TEntity, TCreate = Partial<TEntity>, TUpdat
 };
 type QueryResource<TEntity> = ReturnType<typeof createQueryResource<TEntity>>;
 
+/** L'état d'une connexion temps réel. */
+type RealtimeStatus = "connecting" | "open" | "closed";
+/**
+ * Un flux d'événements, quel qu'il soit : Socket.IO, SSE, WebSocket nu.
+ *
+ * La forme minimale qu'une liaison demande — s'abonner à un sujet, et suivre
+ * l'état de la connexion. `socketIoSource` et `eventSourceSource` en
+ * fabriquent une ; un autre transport n'a qu'à fournir ces trois membres.
+ */
+interface RealtimeSource {
+    subscribe(topic: string, handler: (event: unknown) => void): () => void;
+    status(): RealtimeStatus;
+    onStatusChange(listener: (status: RealtimeStatus) => void): () => void;
+}
+/**
+ * Ce que la liaison demande du cache de requêtes : invalider, et patcher.
+ * Le `QueryClient` de TanStack Query le satisfait tel quel.
+ */
+interface QueryCacheClient extends QueryInvalidator {
+    setQueryData: (queryKey: readonly unknown[], updater: (old: unknown) => unknown) => unknown;
+}
+/** Les outils remis à chaque gestionnaire d'événement. */
+interface RealtimeContext {
+    /** Remplace une entrée du cache, sans requête : le détail d'une ligne. */
+    patch: <T>(queryKey: readonly unknown[], updater: (old: T | undefined) => T | undefined) => void;
+    /** Rend des requêtes périmées : les listes, un compteur. */
+    invalidate: (...queryKeys: Array<readonly unknown[]>) => void;
+    cache: QueryCacheClient;
+}
+interface RealtimeBindingOptions {
+    source: RealtimeSource;
+    cache: QueryCacheClient;
+    /** Un gestionnaire par sujet : \`"operation.updated": (event, { patch, invalidate }) => …\`. */
+    on: Record<string, (event: never, context: RealtimeContext) => void>;
+    /**
+     * À la reconnexion, ce qui a pu être manqué pendant la coupure est
+     * invalidé : ces clés, typiquement les listes suivies.
+     */
+    refetchOnReconnect?: Array<readonly unknown[]>;
+}
+/**
+ * Relie un flux d'événements au cache de requêtes.
+ *
+ * Chaque projet réécrivait la même chose : s'abonner, patcher le détail,
+ * invalider les listes, se désabonner au bon moment, et rattraper ce qui
+ * s'est passé pendant une coupure. \`start()\` branche tout et rend la
+ * fonction qui débranche tout — la forme exacte d'un nettoyage d'effet :
+ *
+ * \`\`\`ts
+ * useEffect(() => liaison.start(), [liaison]);
+ * \`\`\`
+ */
+declare function createRealtimeBinding(options: RealtimeBindingOptions): {
+    source: RealtimeSource;
+    start(): () => void;
+};
+type RealtimeBinding = ReturnType<typeof createRealtimeBinding>;
+/** La forme d'un socket Socket.IO, sans en dépendre. */
+interface SocketLike {
+    connected: boolean;
+    on(event: string, listener: (...args: never[]) => void): unknown;
+    off(event: string, listener: (...args: never[]) => void): unknown;
+}
+/** Un socket Socket.IO en source temps réel. L'authentification reste au socket. */
+declare function socketIoSource(socket: SocketLike): RealtimeSource;
+/** La forme d'un \`EventSource\`, sans en dépendre (et testable sans navigateur). */
+interface EventSourceLike {
+    readyState: number;
+    onopen: ((event: unknown) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+    addEventListener(type: string, listener: (event: {
+        data: string;
+    }) => void): void;
+    removeEventListener(type: string, listener: (event: {
+        data: string;
+    }) => void): void;
+}
+/**
+ * Un flux SSE en source temps réel. Chaque événement nommé devient un sujet ;
+ * son \`data\` est lu en JSON, ou passé tel quel s'il n'en est pas.
+ */
+declare function eventSourceSource(stream: EventSourceLike): RealtimeSource;
+
 interface AxiosLikeInstance {
     request<T = unknown>(config: {
         url: string;
@@ -582,4 +667,4 @@ interface AxiosLikeInstance {
 declare function createFetchTransport(fetcher?: typeof fetch): ApiTransport;
 declare function createAxiosTransport(axios: AxiosLikeInstance): ApiTransport;
 
-export { ACCESS_TOKEN_KEY, ApiClient, type ApiClientOptions, type ApiFilters, type ApiMethod, type ApiPlugin, type ApiPluginHook, type ApiRequestConfig, type ApiRequestContext, type ApiRequestInput, type ApiTransport, type ApiTransportRequest, type ApiTransportResponse, type AuthPluginOptions, BaseService, type BrowserTokenStorageOptions, type CursorMeta, FILTERS_HEADER, FRENCH_STATUS_MESSAGES, type FieldError, type FieldErrorExtractor, type FilterCondition, type FilterGroup, type FilterOperator, type FilterValue, type HeaderSignalPluginOptions, HttpError, type IdempotencyPluginOptions, type LoggerPluginOptions, type PageMeta, type PaginatedResponse, type QueryFnContext, type QueryInvalidator, type QueryParamObject, type QueryParams, type QueryResource, type QueryResourceOptions, REFRESH_TOKEN_KEY, type RefreshTokenConfig, ResponseHandler, type ResponseHandlerConfig, type RtkBaseQueryResult, type SaveVariables, type TokenStorage, type UnauthorizedPluginOptions, buildQueryString, createApiClient, createAuthPlugin, createAxiosTransport, createBrowserTokenStorage, createFetchTransport, createHeaderSignalPlugin, createIdempotencyPlugin, createLoggerPlugin, createMemoryTokenStorage, createQueryResource, createReadOnlyPlugin, createRefreshTokenPlugin, createResourceService, createUnauthorizedPlugin, filtersHeader, isGenericMessage, localizeError, nestFieldErrors, normalizeFilters };
+export { ACCESS_TOKEN_KEY, ApiClient, type ApiClientOptions, type ApiFilters, type ApiMethod, type ApiPlugin, type ApiPluginHook, type ApiRequestConfig, type ApiRequestContext, type ApiRequestInput, type ApiTransport, type ApiTransportRequest, type ApiTransportResponse, type AuthPluginOptions, BaseService, type BrowserTokenStorageOptions, type CursorMeta, ENGLISH_STATUS_MESSAGES, type EventSourceLike, FILTERS_HEADER, FRENCH_STATUS_MESSAGES, type FieldError, type FieldErrorExtractor, type FilterCondition, type FilterGroup, type FilterOperator, type FilterValue, type HeaderSignalPluginOptions, HttpError, type IdempotencyPluginOptions, type LoggerPluginOptions, type PageMeta, type PaginatedResponse, type QueryCacheClient, type QueryFnContext, type QueryInvalidator, type QueryParamObject, type QueryParams, type QueryResource, type QueryResourceOptions, REFRESH_TOKEN_KEY, type RealtimeBinding, type RealtimeBindingOptions, type RealtimeContext, type RealtimeSource, type RealtimeStatus, type RefreshTokenConfig, ResponseHandler, type ResponseHandlerConfig, type RtkBaseQueryResult, type SaveVariables, type SocketLike, type TokenStorage, type UnauthorizedPluginOptions, buildQueryString, createApiClient, createAuthPlugin, createAxiosTransport, createBrowserTokenStorage, createFetchTransport, createHeaderSignalPlugin, createIdempotencyPlugin, createLoggerPlugin, createMemoryTokenStorage, createQueryResource, createReadOnlyPlugin, createRealtimeBinding, createRefreshTokenPlugin, createResourceService, createUnauthorizedPlugin, eventSourceSource, filtersHeader, isGenericMessage, localizeError, nestFieldErrors, normalizeFilters, socketIoSource };

package/dist/index.d.ts

@@ -250,6 +250,8 @@ declare function createApiClient(options: ApiClientOptions): ApiClient;
  * `0` couvre l'échec réseau : le serveur injoignable, la connexion coupée.
  */
 declare const FRENCH_STATUS_MESSAGES: Readonly<Record<number, string>>;
+/** Les mêmes, en anglais. */
+declare const ENGLISH_STATUS_MESSAGES: Readonly<Record<number, string>>;
 /**
  * Vrai quand le message du serveur est générique.
  *
@@ -560,6 +562,89 @@ declare function createQueryResource<TEntity, TCreate = Partial<TEntity>, TUpdat
 };
 type QueryResource<TEntity> = ReturnType<typeof createQueryResource<TEntity>>;
 
+/** L'état d'une connexion temps réel. */
+type RealtimeStatus = "connecting" | "open" | "closed";
+/**
+ * Un flux d'événements, quel qu'il soit : Socket.IO, SSE, WebSocket nu.
+ *
+ * La forme minimale qu'une liaison demande — s'abonner à un sujet, et suivre
+ * l'état de la connexion. `socketIoSource` et `eventSourceSource` en
+ * fabriquent une ; un autre transport n'a qu'à fournir ces trois membres.
+ */
+interface RealtimeSource {
+    subscribe(topic: string, handler: (event: unknown) => void): () => void;
+    status(): RealtimeStatus;
+    onStatusChange(listener: (status: RealtimeStatus) => void): () => void;
+}
+/**
+ * Ce que la liaison demande du cache de requêtes : invalider, et patcher.
+ * Le `QueryClient` de TanStack Query le satisfait tel quel.
+ */
+interface QueryCacheClient extends QueryInvalidator {
+    setQueryData: (queryKey: readonly unknown[], updater: (old: unknown) => unknown) => unknown;
+}
+/** Les outils remis à chaque gestionnaire d'événement. */
+interface RealtimeContext {
+    /** Remplace une entrée du cache, sans requête : le détail d'une ligne. */
+    patch: <T>(queryKey: readonly unknown[], updater: (old: T | undefined) => T | undefined) => void;
+    /** Rend des requêtes périmées : les listes, un compteur. */
+    invalidate: (...queryKeys: Array<readonly unknown[]>) => void;
+    cache: QueryCacheClient;
+}
+interface RealtimeBindingOptions {
+    source: RealtimeSource;
+    cache: QueryCacheClient;
+    /** Un gestionnaire par sujet : \`"operation.updated": (event, { patch, invalidate }) => …\`. */
+    on: Record<string, (event: never, context: RealtimeContext) => void>;
+    /**
+     * À la reconnexion, ce qui a pu être manqué pendant la coupure est
+     * invalidé : ces clés, typiquement les listes suivies.
+     */
+    refetchOnReconnect?: Array<readonly unknown[]>;
+}
+/**
+ * Relie un flux d'événements au cache de requêtes.
+ *
+ * Chaque projet réécrivait la même chose : s'abonner, patcher le détail,
+ * invalider les listes, se désabonner au bon moment, et rattraper ce qui
+ * s'est passé pendant une coupure. \`start()\` branche tout et rend la
+ * fonction qui débranche tout — la forme exacte d'un nettoyage d'effet :
+ *
+ * \`\`\`ts
+ * useEffect(() => liaison.start(), [liaison]);
+ * \`\`\`
+ */
+declare function createRealtimeBinding(options: RealtimeBindingOptions): {
+    source: RealtimeSource;
+    start(): () => void;
+};
+type RealtimeBinding = ReturnType<typeof createRealtimeBinding>;
+/** La forme d'un socket Socket.IO, sans en dépendre. */
+interface SocketLike {
+    connected: boolean;
+    on(event: string, listener: (...args: never[]) => void): unknown;
+    off(event: string, listener: (...args: never[]) => void): unknown;
+}
+/** Un socket Socket.IO en source temps réel. L'authentification reste au socket. */
+declare function socketIoSource(socket: SocketLike): RealtimeSource;
+/** La forme d'un \`EventSource\`, sans en dépendre (et testable sans navigateur). */
+interface EventSourceLike {
+    readyState: number;
+    onopen: ((event: unknown) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+    addEventListener(type: string, listener: (event: {
+        data: string;
+    }) => void): void;
+    removeEventListener(type: string, listener: (event: {
+        data: string;
+    }) => void): void;
+}
+/**
+ * Un flux SSE en source temps réel. Chaque événement nommé devient un sujet ;
+ * son \`data\` est lu en JSON, ou passé tel quel s'il n'en est pas.
+ */
+declare function eventSourceSource(stream: EventSourceLike): RealtimeSource;
+
 interface AxiosLikeInstance {
     request<T = unknown>(config: {
         url: string;
@@ -582,4 +667,4 @@ interface AxiosLikeInstance {
 declare function createFetchTransport(fetcher?: typeof fetch): ApiTransport;
 declare function createAxiosTransport(axios: AxiosLikeInstance): ApiTransport;
 
-export { ACCESS_TOKEN_KEY, ApiClient, type ApiClientOptions, type ApiFilters, type ApiMethod, type ApiPlugin, type ApiPluginHook, type ApiRequestConfig, type ApiRequestContext, type ApiRequestInput, type ApiTransport, type ApiTransportRequest, type ApiTransportResponse, type AuthPluginOptions, BaseService, type BrowserTokenStorageOptions, type CursorMeta, FILTERS_HEADER, FRENCH_STATUS_MESSAGES, type FieldError, type FieldErrorExtractor, type FilterCondition, type FilterGroup, type FilterOperator, type FilterValue, type HeaderSignalPluginOptions, HttpError, type IdempotencyPluginOptions, type LoggerPluginOptions, type PageMeta, type PaginatedResponse, type QueryFnContext, type QueryInvalidator, type QueryParamObject, type QueryParams, type QueryResource, type QueryResourceOptions, REFRESH_TOKEN_KEY, type RefreshTokenConfig, ResponseHandler, type ResponseHandlerConfig, type RtkBaseQueryResult, type SaveVariables, type TokenStorage, type UnauthorizedPluginOptions, buildQueryString, createApiClient, createAuthPlugin, createAxiosTransport, createBrowserTokenStorage, createFetchTransport, createHeaderSignalPlugin, createIdempotencyPlugin, createLoggerPlugin, createMemoryTokenStorage, createQueryResource, createReadOnlyPlugin, createRefreshTokenPlugin, createResourceService, createUnauthorizedPlugin, filtersHeader, isGenericMessage, localizeError, nestFieldErrors, normalizeFilters };
+export { ACCESS_TOKEN_KEY, ApiClient, type ApiClientOptions, type ApiFilters, type ApiMethod, type ApiPlugin, type ApiPluginHook, type ApiRequestConfig, type ApiRequestContext, type ApiRequestInput, type ApiTransport, type ApiTransportRequest, type ApiTransportResponse, type AuthPluginOptions, BaseService, type BrowserTokenStorageOptions, type CursorMeta, ENGLISH_STATUS_MESSAGES, type EventSourceLike, FILTERS_HEADER, FRENCH_STATUS_MESSAGES, type FieldError, type FieldErrorExtractor, type FilterCondition, type FilterGroup, type FilterOperator, type FilterValue, type HeaderSignalPluginOptions, HttpError, type IdempotencyPluginOptions, type LoggerPluginOptions, type PageMeta, type PaginatedResponse, type QueryCacheClient, type QueryFnContext, type QueryInvalidator, type QueryParamObject, type QueryParams, type QueryResource, type QueryResourceOptions, REFRESH_TOKEN_KEY, type RealtimeBinding, type RealtimeBindingOptions, type RealtimeContext, type RealtimeSource, type RealtimeStatus, type RefreshTokenConfig, ResponseHandler, type ResponseHandlerConfig, type RtkBaseQueryResult, type SaveVariables, type SocketLike, type TokenStorage, type UnauthorizedPluginOptions, buildQueryString, createApiClient, createAuthPlugin, createAxiosTransport, createBrowserTokenStorage, createFetchTransport, createHeaderSignalPlugin, createIdempotencyPlugin, createLoggerPlugin, createMemoryTokenStorage, createQueryResource, createReadOnlyPlugin, createRealtimeBinding, createRefreshTokenPlugin, createResourceService, createUnauthorizedPlugin, eventSourceSource, filtersHeader, isGenericMessage, localizeError, nestFieldErrors, normalizeFilters, socketIoSource };

package/dist/index.js

@@ -154,6 +154,22 @@ var FRENCH_STATUS_MESSAGES = {
   503: "Le service est momentan\xE9ment indisponible.",
   504: "Le serveur a mis trop de temps \xE0 r\xE9pondre."
 };
+var ENGLISH_STATUS_MESSAGES = {
+  0: "The server can't be reached. Check your connection.",
+  400: "The request is invalid.",
+  401: "Your session has expired. Please sign in again.",
+  403: "You don't have permission to do this.",
+  404: "The requested item can't be found.",
+  408: "The server took too long to respond.",
+  409: "This action conflicts with the current state. Reload and try again.",
+  413: "The content sent is too large.",
+  422: "Some values are invalid.",
+  429: "Too many attempts. Try again in a moment.",
+  500: "Something went wrong on the server.",
+  502: "The service is temporarily unavailable.",
+  503: "The service is temporarily unavailable.",
+  504: "The server took too long to respond."
+};
 var ECHEC_RESEAU = /failed to fetch|networkerror|load failed/i;
 var PHRASES = {
   400: "bad request",
@@ -1052,4 +1068,102 @@ function createQueryResource(service, options = {}) {
   };
 }
 
-export { ACCESS_TOKEN_KEY, ApiClient, BaseService, FILTERS_HEADER, FRENCH_STATUS_MESSAGES, HttpError, REFRESH_TOKEN_KEY, ResponseHandler, buildQueryString, createApiClient, createAuthPlugin, createAxiosTransport, createBrowserTokenStorage, createFetchTransport, createHeaderSignalPlugin, createIdempotencyPlugin, createLoggerPlugin, createMemoryTokenStorage, createQueryResource, createReadOnlyPlugin, createRefreshTokenPlugin, createResourceService, createUnauthorizedPlugin, filtersHeader, isGenericMessage, localizeError, nestFieldErrors, normalizeFilters };
+// src/realtime.ts
+function createRealtimeBinding(options) {
+  const { source, cache, on, refetchOnReconnect = [] } = options;
+  const contexte = {
+    cache,
+    patch: (queryKey, updater) => {
+      cache.setQueryData(queryKey, updater);
+    },
+    invalidate: (...queryKeys) => {
+      for (const queryKey of queryKeys) void cache.invalidateQueries({ queryKey });
+    }
+  };
+  return {
+    source,
+    start() {
+      const desabonnements = Object.entries(on).map(
+        ([topic, gestionnaire]) => source.subscribe(topic, (event) => {
+          try {
+            gestionnaire(event, contexte);
+          } catch (error) {
+            console.error(`Temps r\xE9el : le gestionnaire de \xAB ${topic} \xBB a \xE9chou\xE9.`, error);
+          }
+        })
+      );
+      let precedent = source.status();
+      const statut = source.onStatusChange((suivant) => {
+        if (suivant === "open" && precedent !== "open" && refetchOnReconnect.length > 0) {
+          contexte.invalidate(...refetchOnReconnect);
+        }
+        precedent = suivant;
+      });
+      return () => {
+        for (const desabonner of desabonnements) desabonner();
+        statut();
+      };
+    }
+  };
+}
+function etatObservable(initial) {
+  let courant = initial;
+  const ecouteurs = /* @__PURE__ */ new Set();
+  return {
+    lire: () => courant,
+    poser: (suivant) => {
+      if (suivant === courant) return;
+      courant = suivant;
+      for (const ecouteur of ecouteurs) ecouteur(suivant);
+    },
+    ecouter: (ecouteur) => {
+      ecouteurs.add(ecouteur);
+      return () => {
+        ecouteurs.delete(ecouteur);
+      };
+    }
+  };
+}
+function socketIoSource(socket) {
+  const etat = etatObservable(socket.connected ? "open" : "connecting");
+  const ouvert = () => etat.poser("open");
+  const ferme = () => etat.poser("closed");
+  const reconnexion = () => etat.poser("connecting");
+  socket.on("connect", ouvert);
+  socket.on("disconnect", ferme);
+  socket.on("connect_error", reconnexion);
+  return {
+    subscribe(topic, handler) {
+      const listener = (event) => handler(event);
+      socket.on(topic, listener);
+      return () => {
+        socket.off(topic, listener);
+      };
+    },
+    status: etat.lire,
+    onStatusChange: etat.ecouter
+  };
+}
+function eventSourceSource(stream) {
+  const etat = etatObservable(stream.readyState === 1 ? "open" : stream.readyState === 2 ? "closed" : "connecting");
+  stream.onopen = () => etat.poser("open");
+  stream.onerror = () => etat.poser(stream.readyState === 2 ? "closed" : "connecting");
+  return {
+    subscribe(topic, handler) {
+      const listener = (event) => {
+        let contenu = event.data;
+        try {
+          contenu = JSON.parse(event.data);
+        } catch {
+        }
+        handler(contenu);
+      };
+      stream.addEventListener(topic, listener);
+      return () => stream.removeEventListener(topic, listener);
+    },
+    status: etat.lire,
+    onStatusChange: etat.ecouter
+  };
+}
+
+export { ACCESS_TOKEN_KEY, ApiClient, BaseService, ENGLISH_STATUS_MESSAGES, FILTERS_HEADER, FRENCH_STATUS_MESSAGES, HttpError, REFRESH_TOKEN_KEY, ResponseHandler, buildQueryString, createApiClient, createAuthPlugin, createAxiosTransport, createBrowserTokenStorage, createFetchTransport, createHeaderSignalPlugin, createIdempotencyPlugin, createLoggerPlugin, createMemoryTokenStorage, createQueryResource, createReadOnlyPlugin, createRealtimeBinding, createRefreshTokenPlugin, createResourceService, createUnauthorizedPlugin, eventSourceSource, filtersHeader, isGenericMessage, localizeError, nestFieldErrors, normalizeFilters, socketIoSource };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sia-ui/api",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Typed HTTP client with CRUD services, plugins and injectable transports.",
   "keywords": [
     "sia-ui",
@@ -42,7 +42,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@sia-ui/utils": "0.7.1"
+    "@sia-ui/utils": "0.8.0"
   },
   "devDependencies": {
     "tsup": "^8.5.1",