sass-cms-template-common 0.0.14 → 0.0.16

package/dist/index.d.ts

@@ -1381,6 +1381,44 @@ export declare type CmsMultiSelectFieldProps = {
     testId?: string;
 };
 
+/**
+ * Singleton que conecta el interceptor de axios con el provider de red. El
+ * provider llama `register` al montar y `unregister` al desmontar; el
+ * interceptor usa los métodos (con fallback seguro si no hay provider).
+ */
+export declare const cmsNetworkBridge: {
+    register(next: CmsNetworkBridgeHandlers): void;
+    unregister(): void;
+    /** `true` si hay un `CmsNetworkProvider` montado escuchando. */
+    readonly isRegistered: boolean;
+    reportOffline(): void;
+    waitForOnline(): Promise<void>;
+    verifyConnectivity(): Promise<boolean>;
+};
+
+/**
+ * Puente entre el interceptor de axios (un módulo, sin React) y el
+ * `CmsNetworkProvider` (React). Replica el rol del `NetworkService` que se
+ * inyecta en el `NetworkInterceptor` del Angular legacy: el interceptor no
+ * puede usar hooks, así que el provider registra aquí sus funciones y el
+ * interceptor las consume.
+ *
+ * Módulo **server-safe** (sin React, sin `'use client'`): así lo puede importar
+ * el `lib/http/axios.ts` del gestor —que corre tanto en cliente como en
+ * servidor— sin arrastrar componentes cliente. En el servidor el bridge queda
+ * sin registrar (no hay provider) y `resumeAxiosOnNetworkError` re-lanza el
+ * error para que lo maneje el server action (`toCmsError`).
+ */
+/** Funciones que el `CmsNetworkProvider` registra para el interceptor. */
+export declare interface CmsNetworkBridgeHandlers {
+    /** Marca la conexión como offline de inmediato (dispara el toast). */
+    reportOffline: () => void;
+    /** Resuelve cuando la conexión vuelve (confirmada por el ping/eventos). */
+    waitForOnline: () => Promise<void>;
+    /** Confirma por ping si hay internet real. `true` = online. */
+    verifyConnectivity: () => Promise<boolean>;
+}
+
 export declare const CmsNetworkContext: Context<CmsNetworkContextValue | null>;
 
 export declare interface CmsNetworkContextValue {
@@ -1396,9 +1434,17 @@ export declare interface CmsNetworkContextValue {
     waitForOnline: () => Promise<void>;
     /**
      * Fuerza una verificación por ping (útil cuando una petición falló por red
-     * pero `navigator.onLine` todavía dice `true`).
+     * pero `navigator.onLine` todavía dice `true`). Resuelve a `true` si confirma
+     * conexión real, `false` si confirma que no hay internet.
+     */
+    verifyConnectivity: () => Promise<boolean>;
+    /**
+     * Marca la conexión como `offline` de inmediato (dispara el toast de "sin
+     * conexión" sin esperar al ping). Lo usa el reintento cuando el navegador ya
+     * reporta que no hay internet, para que el error se vea al perder la conexión
+     * y no recién al recuperarla.
      */
-    verifyConnectivity: () => void;
+    reportOffline: () => void;
 }
 
 /**
@@ -1412,7 +1458,7 @@ export declare interface CmsNetworkContextValue {
  * El mecanismo vive en la lib; el **disparo** de toasts lo hace
  * `CmsNetworkToaster` (globales) y `useResilientAction` (por petición).
  */
-export declare function CmsNetworkProvider({ children, pingUrl, pingIntervalMs, }: CmsNetworkProviderProps): JSX.Element;
+export declare function CmsNetworkProvider({ children, pingUrl, pingIntervalMs, pingTimeoutMs, }: CmsNetworkProviderProps): JSX.Element;
 
 export declare interface CmsNetworkProviderProps {
     children: ReactNode;
@@ -1425,6 +1471,12 @@ export declare interface CmsNetworkProviderProps {
     pingUrl?: string | null;
     /** Intervalo del polling de ping mientras siga offline (ms). Default 5000. */
     pingIntervalMs?: number;
+    /**
+     * Timeout del ping antes de darlo por fallido (ms). Sin él, un `fetch` a un
+     * host externo sin internet puede colgarse hasta que la red vuelva, y el
+     * offline se detectaría tarde. Default 5000.
+     */
+    pingTimeoutMs?: number;
 }
 
 /** Estado de conectividad del navegador. */
@@ -6540,6 +6592,30 @@ export declare function resolveCmsOrigin(cmsOrigin?: string): string;
 /** Devuelve la severidad de toast para un código de error (`warning`/`error`). */
 export declare function resolveErrorSeverity(errorCode: string | number | Array<string | number> | null | undefined): CmsErrorSeverity;
 
+/**
+ * Da resiliencia de red a una petición de axios, replicando el
+ * `NetworkInterceptor` del Angular legacy. Pensado para el `onRejected` del
+ * interceptor de respuesta de axios del gestor:
+ *
+ * ```ts
+ * api.interceptors.response.use(
+ *   (r) => r,
+ *   (error) => resumeAxiosOnNetworkError(error, (config) => api.request(config)),
+ * );
+ * ```
+ *
+ * - **En el servidor, o no es error de red, o no hay provider montado** →
+ *   re-lanza el error (lo maneja el caller / `toCmsError`).
+ * - **Sin internet** (el navegador reporta offline, o el ping confirma que no
+ *   hay salida real, p. ej. `ERR_NAME_NOT_RESOLVED`): muestra "sin conexión"
+ *   (vía el provider), arranca el ping y, al volver la conexión, **reintenta**
+ *   la petición (retoma el servicio).
+ * - **Con internet** (el caído era el backend: 5xx/timeout): re-lanza sin
+ *   reintentar, para no repetir a ciegas un POST. Ese caso lo cubre
+ *   `useResilientAction`/`toCmsError` en las mutaciones envueltas.
+ */
+export declare function resumeAxiosOnNetworkError<T = unknown>(error: unknown, reAttempt: (config: unknown) => Promise<T>): Promise<T>;
+
 /** Sección de una publicación del CMS (forma devuelta por get/exist). */
 export declare interface Section {
     id?: number;
@@ -6679,8 +6755,8 @@ export declare type SelectOption = {
  * - Trigger por defecto: borde `m3.outlineVariant` (#C4C6CF), texto `controlText`
  *   (#000) en negrita, fondo transparente; hover → `neutralHover` (state layer
  *   M3 `onSurface` al 8%, #191C20).
- * - Trigger activo (abierto) o resaltado (valor activo): fondo `secondary`
- *   (#D8E2FF), sin borde.
+ * - Trigger resaltado (valor activo, `highlighted`): fondo `secondary`
+ *   (#D8E2FF), sin borde. Abrir el menú NO lo colorea: queda outlined.
  * - Opción del menú: hover → `neutralHover` (state layer M3 `onSurface` al 8%,
  *   #191C20); seleccionada → fondo `secondary` (#D8E2FF). El menú es full-bleed
  *   (sin padding lateral ni radio en los ítems): el resaltado llega de borde a
@@ -6688,8 +6764,9 @@ export declare type SelectOption = {
  */
 export declare const SelectStyles: {
     /**
-     * Disparador outlined con label + chevron. Se rellena con `secondary` cuando
-     * está abierto (`open`) o resaltado (`highlighted`, valor activo).
+     * Disparador outlined con label + chevron. Se rellena con `secondary` solo
+     * cuando está resaltado (`highlighted`, valor activo); abrir el menú (`open`)
+     * NO lo colorea.
      */
     sxTrigger: (highlighted: boolean, open: boolean) => SxProps<Theme>;
     /** Paper sin padding lateral: los ítems llegan de borde a borde. */