sass-cms-template-common 0.0.13 → 0.0.15

package/dist/server.d.ts

@@ -326,6 +326,22 @@ export declare interface CkeditorPrompt {
     [key: string]: unknown;
 }
 
+export declare interface ClassifiedNetworkError {
+    errorCode: NetworkErrorCode;
+    /** Si conviene reintentar la petición. */
+    retryable: boolean;
+    /** Mensaje crudo del error original (para el detalle copiable del toast). */
+    error: string;
+}
+
+/**
+ * Clasifica una excepción (error de axios en el servidor, o `TypeError:
+ * Failed to fetch` del navegador al invocar un server action) como error de
+ * red/servidor. Devuelve `null` si NO es un error de red (p. ej. un 4xx o una
+ * excepción de lógica): el caller lo trata entonces como error de negocio.
+ */
+export declare function classifyNetworkError(error: unknown): ClassifiedNetworkError | null;
+
 /**
  * Servicios HTTP del módulo `audios` del CMS (solo endpoints JSON POST).
  *
@@ -731,6 +747,44 @@ export declare class CmsImagesServices {
     getImageComparation: (image: ImageComparationPair) => Promise<ImageComparationResponse>;
 }
 
+/**
+ * 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>;
+}
+
 /**
  * Servicios HTTP del módulo `news` del CMS (core + publish, unpublish, pin,
  * massive, freshness, views y analytics).
@@ -2130,6 +2184,14 @@ export declare function getCommonError(errorCode: string | number | Array<string
 
 export declare function getDefaultPublicationSlug(sites: SiteSection[]): string;
 
+/**
+ * Si un resultado ya devuelto por un server action es un envelope de error con
+ * un código de red (`{ status: 'error', errorCode: 'net.*' }`), devuelve ese
+ * código; si no, `null`. Permite reintentar cuando el fallo de red se detectó
+ * en el servidor (Next→OpenCms) y viajó como `CmsResponse`.
+ */
+export declare function getNetworkErrorCodeFromResult(result: unknown): NetworkErrorCode | null;
+
 /**
  * Hora actual del sitio (equivalente al `getFormattedRedactionTimeUTC` del CMS
  * Angular): "ahora" formateado en la zona de redacción de la publicación.
@@ -2517,6 +2579,12 @@ declare interface ISitesServices {
     authentication: Authentication;
 }
 
+/** `true` si el código dado es uno de los códigos internos de red. */
+export declare function isNetworkErrorCode(code: string | null | undefined): boolean;
+
+/** `true` si un código de red debe reintentarse. */
+export declare function isRetryableNetworkCode(code: string | null | undefined): boolean;
+
 declare interface ITagsServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -2590,8 +2658,28 @@ export declare type NavLinkItem = {
     accent?: 'ai';
     /** Si el href apunta al admin legacy (JSP/Angular), se prefija con `legacyBaseUrl`. */
     legacy?: boolean;
+    /**
+     * Si la ruta del Angular master exige el id de publicación al final
+     * (p. ej. `/admin/tags/:idPub`, `/admin/planning/:idPub`), se le agrega
+     * `selectedPublicationId`. Solo aplica junto con `legacy`.
+     */
+    appendPublicationId?: boolean;
+};
+
+/** Códigos internos de error de red/servidor (no son del CMS). */
+export declare const NETWORK_ERROR_CODES: {
+    /** Sin conexión a internet (no se pudo alcanzar el servidor). */
+    readonly offline: "net.offline";
+    /** La petición excedió el timeout. */
+    readonly timeout: "net.timeout";
+    /** El backend no responde (502/503/504). */
+    readonly unavailable: "net.unavailable";
+    /** Error interno del servidor (5xx genérico). */
+    readonly server: "net.server";
 };
 
+export declare type NetworkErrorCode = (typeof NETWORK_ERROR_CODES)[keyof typeof NETWORK_ERROR_CODES];
+
 /** Cuerpo de la respuesta de POST /news/edit/adminNewsConfiguration. */
 export declare interface NewsAdminConfigurationResponse extends CmsResponse {
     [key: string]: unknown;
@@ -4172,6 +4260,30 @@ export declare interface RecipesPublishCheckResponse extends CmsResponse {
 /** 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;

package/dist/server.js

@@ -1,2 +1,2 @@
-import { $ as e, A as t, B as n, C as r, D as i, E as a, F as o, I as s, J as c, K as l, L as u, M as d, N as f, O as p, P as m, Q as h, R as g, S as _, T as v, V as y, X as b, Y as x, Z as S, _ as C, a as w, b as T, c as E, d as D, et as O, f as k, g as A, h as j, i as M, j as N, k as P, l as F, m as I, n as L, nt as R, o as z, p as B, q as V, r as H, rt as U, s as W, t as G, tt as K, u as q, v as J, w as Y, x as X, y as Z, z as Q } from "./services-DS4p6Tpl.js";
-export { i as CmsAudiosServices, t as CmsAuthLoginServices, o as CmsAuthServices, a as CmsCategoriesServices, v as CmsCkeditorServices, r as CmsCommentsServices, G as CmsCommonServices, _ as CmsContributionsServices, Y as CmsCopilotServices, m as CmsDashboardServices, Z as CmsEventsServices, J as CmsFileExplorerServices, C as CmsGeneralServices, A as CmsImagesServices, j as CmsNewsServices, I as CmsNotificationServices, B as CmsPeopleServices, k as CmsPlanningServices, D as CmsPollsServices, p as CmsPreviewServices, T as CmsProductivityPlanServices, f as CmsProfileServices, d as CmsPublicationsServices, q as CmsRecipesServices, X as CmsSectionsServices, N as CmsSitesServices, L as CmsTagsServices, H as CmsTranscribeServices, M as CmsTriviasServices, P as CmsUploadServices, F as CmsUsersServices, w as CmsVideosServices, z as CmsVodsServices, W as CmsWorkpaperServices, E as CmsZonesServices, U as commonErrorsEn, R as commonErrorsEs, K as commonErrorsPt, s as filterModulesByPermissions, l as findPublicationBySlug, V as findPublicationLabel, g as formatSiteDateTime, c as getAllPublications, h as getCommonError, x as getDefaultPublicationSlug, Q as getSiteNow, u as hasModulePermission, e as normalizeErrorCode, n as parseGmtOffsetMinutes, b as parsePublicationSlug, O as resolveErrorSeverity, y as toSiteWallClock, S as toTestId };
+import { $ as e, A as t, B as n, C as r, D as i, E as a, F as o, I as s, J as c, K as l, L as u, M as d, N as f, O as p, P as m, Q as h, R as g, S as _, T as v, V as y, X as b, Y as x, Z as S, _ as C, a as w, at as T, b as E, c as D, ct as O, d as k, et as A, f as j, g as M, h as N, i as P, it as F, j as I, k as L, l as R, lt as z, m as B, n as V, nt as H, o as U, ot as W, p as G, q as K, r as q, rt as J, s as Y, st as X, t as Z, tt as Q, u as $, ut as ee, v as te, w as ne, x as re, y as ie, z as ae } from "./services-BQ1IbdWe.js";
+export { i as CmsAudiosServices, t as CmsAuthLoginServices, o as CmsAuthServices, a as CmsCategoriesServices, v as CmsCkeditorServices, r as CmsCommentsServices, Z as CmsCommonServices, _ as CmsContributionsServices, ne as CmsCopilotServices, m as CmsDashboardServices, ie as CmsEventsServices, te as CmsFileExplorerServices, C as CmsGeneralServices, M as CmsImagesServices, N as CmsNewsServices, B as CmsNotificationServices, G as CmsPeopleServices, j as CmsPlanningServices, k as CmsPollsServices, p as CmsPreviewServices, E as CmsProductivityPlanServices, f as CmsProfileServices, d as CmsPublicationsServices, $ as CmsRecipesServices, re as CmsSectionsServices, I as CmsSitesServices, V as CmsTagsServices, q as CmsTranscribeServices, P as CmsTriviasServices, L as CmsUploadServices, R as CmsUsersServices, w as CmsVideosServices, U as CmsVodsServices, Y as CmsWorkpaperServices, D as CmsZonesServices, A as NETWORK_ERROR_CODES, Q as classifyNetworkError, h as cmsNetworkBridge, ee as commonErrorsEn, z as commonErrorsEs, O as commonErrorsPt, s as filterModulesByPermissions, l as findPublicationBySlug, K as findPublicationLabel, g as formatSiteDateTime, c as getAllPublications, T as getCommonError, x as getDefaultPublicationSlug, H as getNetworkErrorCodeFromResult, ae as getSiteNow, u as hasModulePermission, J as isNetworkErrorCode, F as isRetryableNetworkCode, W as normalizeErrorCode, n as parseGmtOffsetMinutes, b as parsePublicationSlug, X as resolveErrorSeverity, e as resumeAxiosOnNetworkError, y as toSiteWallClock, S as toTestId };