sass-cms-template-common 0.0.34 → 0.0.36

package/dist/index.d.ts

@@ -24,6 +24,9 @@ import { Theme } from '@mui/material/styles';
  */
 export declare const ACCOUNT_NAV_BLOCKS: NavBlock[];
 
+/** Módulo del Authenticator que guarda los pines del menú de cmsmedios. */
+export declare const ADMIN_ANGULAR_MODULE = "admin-angular";
+
 /**
  * Catálogo de mensajes del gestor por idioma. Cada gestor declara su propio
  * `en` como fuente de la forma y valida `es`/`pt` con `satisfies typeof enTree`
@@ -43,7 +46,7 @@ export declare type AppMessageNode = string | {
 /** Árbol de mensajes del gestor (namespaces → claves → string anidable). */
 export declare type AppMessages = Record<string, AppMessageNode>;
 
-export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, onNotificationsOpen, notificationsLoading, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, previewFormats, operationPermissions, isAdmin, onPreviewSelect, showAppearanceMenu, LinkComponent, permissions, navHrefOverrides, locale, language, messages, appMessages, baseUrl, profileServices, }: AppShellProps): JSX.Element;
+export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, onNotificationsOpen, notificationsLoading, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, previewFormats, operationPermissions, isAdmin, onPreviewSelect, showAppearanceMenu, LinkComponent, permissions, navHrefOverrides, locale, language, messages, appMessages, baseUrl, profileServices, sidebarAuthService, }: AppShellProps): JSX.Element;
 
 export declare type AppShellProps = {
     pathname: string;
@@ -111,6 +114,11 @@ export declare type AppShellProps = {
      * accesos es solo visual y no persiste entre sesiones.
      */
     profileServices?: SidebarRailPinService;
+    /**
+     * Pines y módulos hermanos del Authenticator (como cmsmedios). Si se pasa, el
+     * menú lateral lo usa en vez de los pines de `profileServices`.
+     */
+    sidebarAuthService?: SidebarRailAuthService;
 };
 
 /** Traductor genérico de claves del gestor por ruta con puntos (`ns.clave`). */
@@ -264,6 +272,13 @@ export declare interface AuthPermissionsResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/** Identidad del pin en el Authenticator. */
+declare type AuthPinRef = {
+    moduleName: string;
+    itemKey: string;
+    pinned: boolean;
+};
+
 /** Cuerpo de la respuesta de POST /auth/relogin. */
 export declare interface AuthReloginResponse extends CmsResponse, AuthSessionData {
 }
@@ -296,6 +311,30 @@ export declare interface AuthSessionResult extends CmsResponse {
 /** Respuesta de POST /auth/setNewPassword. */
 export declare type AuthSetNewPasswordResponse = AuthSessionResult;
 
+/** Ítem de `GET /api/v1/auth/sidebar` (lo que el menú usa). */
+export declare type AuthSidebarItem = {
+    itemKey: string;
+    translations?: Record<string, string>;
+    icon?: string | null;
+    href?: string | null;
+    pinned?: boolean;
+};
+
+export declare type AuthSidebarResponse = {
+    sections?: AuthSidebarSection[];
+};
+
+/** Módulo (webapp) de `GET /api/v1/auth/sidebar`. */
+export declare type AuthSidebarSection = {
+    moduleName: string;
+    translations?: Record<string, string>;
+    icon?: string | null;
+    url?: string | null;
+    /** `false` = solo aporta ítems; no es una webapp a la que saltar. */
+    sidebarHost?: boolean;
+    items?: AuthSidebarItem[];
+};
+
 /** Propiedades comunes a todos los campos de la configuración. */
 declare type BaseFieldConfig = {
     /** Identificador único del campo (clave en `FieldValues`). */
@@ -351,6 +390,17 @@ export declare type BtnDropdownProps = {
     testId?: string;
 };
 
+/**
+ * Aplica sobre el menú lo mismo que cmsmedios toma del Authenticator:
+ * 1. Pines de `admin-angular` (su `itemKey` en mayúsculas = `module` del ítem).
+ *    Van arriba en el orden de cmsmedios: sección por sección, de atrás hacia
+ *    adelante (primero los hijos anclados de un ítem con submenú). Salen de su
+ *    lugar original.
+ * 2. Pines de otras apps: también arriba, como links a esa app.
+ * 3. Módulos hermanos (`sidebarHost !== false`): al final de la primera sección.
+ */
+export declare function buildCmsmediosMenu(groups: NavLinkItem[][], permissions: Array<NavItemPermissions>, sidebar: AuthSidebarResponse | null, locale: string, selectedPublicationId?: string): CmsmediosMenuLayout;
+
 /**
  * Construye el catálogo estándar de campos de "Búsqueda avanzada" del CMS con
  * los textos por defecto de la librería (resueltos al idioma activo). Es lo que
@@ -532,6 +582,23 @@ export declare interface ClassifiedNetworkError {
  */
 export declare function classifyNetworkError(error: unknown): ClassifiedNetworkError | null;
 
+/**
+ * Menú lateral igual al de cmsmedios y al del gestor de noticias (NAA-5415):
+ * copia del `CMS_MENU_CATALOG` de `bluestack-cms-news`
+ * (`src/components/sidebar/cmsMenuCatalog.ts`), que a su vez copia el
+ * `defaultMenuSections` de `cmsmedios-ux` (`menu.service.ts`). Si cambia allá,
+ * se replica acá: entre gestores de React el menú tiene que ser el mismo.
+ *
+ * Tres secciones separadas por una línea. Dentro de cada una, el orden es el
+ * de cmsmedios (alfabético por el texto fijo en español, igual en todos los
+ * idiomas) con "Otros" al final de la primera. Ya viene ordenado: el filtro por
+ * módulos/permisos solo quita ítems, no reordena.
+ *
+ * Los ítems de otros gestores React (Noticias, CoPilot, Usuarios) los resuelve
+ * cada gestor con `navHrefOverrides`; el href de acá es el de respaldo.
+ */
+export declare const CMS_MENU_SECTIONS: NavLinkItem[][];
+
 /**
  * Contenedor de "Búsqueda avanzada" reutilizable y declarativo. Recibe una lista
  * de `fields` y los renderiza en una grilla, manejando el estado del formulario
@@ -1154,17 +1221,17 @@ export declare type CmsEmptyStateProps = {
 
 /**
  * Página de error compartida por todos los gestores (mecanismo en la lib).
- * Replica la de cmsmedios: ilustración + título + subtítulo + botón HOME, y en
- * el 404 la línea "Error 404. Copiar detalle." que copia la URL al portapapeles.
- * Los textos salen del i18n de la lib (namespace `errorPage`, es/en/pt), así que
- * ningún gestor los duplica.
+ * Header propio (logo + Apariencia) + ilustración/texto centrados + footer,
+ * con la tarjeta "Detalle del error" copiable (Código, Usuario en el 403,
+ * Dirección y Fecha). Los textos salen del i18n de la lib (namespace
+ * `errorPage`, es/en/pt), así que ningún gestor los duplica.
  */
-export declare function CmsErrorPage({ variant, homeHref, LinkComponent, illustrationSrc, }: CmsErrorPageProps): JSX.Element;
+export declare function CmsErrorPage({ variant, homeHref, LinkComponent, illustrationSrc, logo, userEmail, changeAccountHref, supportEmail, }: CmsErrorPageProps): JSX.Element;
 
 export declare type CmsErrorPageProps = {
     /** Tipo de error a mostrar. */
     variant: CmsErrorPageVariant;
-    /** Destino del botón HOME. Por defecto la raíz del gestor (`/`). */
+    /** Destino del botón "Ir al gestor". Por defecto la raíz del gestor (`/`). */
     homeHref?: string;
     /** Componente de enlace del host (p. ej. `next/link`). Por defecto un `<a>`. */
     LinkComponent?: CmsLinkComponent;
@@ -1173,6 +1240,18 @@ export declare type CmsErrorPageProps = {
      * `/errors/notfound.png` o `/errors/not-allowed.png` según la variante.
      */
     illustrationSrc?: string;
+    /** Logo de marca del gestor, mostrado en el header propio de la página. */
+    logo?: ReactNode;
+    /**
+     * Email del usuario logueado. Solo se usa en `variant="not-allowed"`: alimenta
+     * la fila "Usuario" de la tarjeta de detalle y el pie "Sesión iniciada como…".
+     * Sin este dato esas dos piezas no se muestran.
+     */
+    userEmail?: string;
+    /** Destino de "Cambiar de cuenta" (403). Por defecto `/logout`. */
+    changeAccountHref?: string;
+    /** Email de soporte para el hint del 404. Por defecto `soporte@bluestack.la`. */
+    supportEmail?: string;
 };
 
 /** Variante de error a mostrar: 404 (no encontrado) o sin permisos. */
@@ -1380,6 +1459,13 @@ export declare type CmsLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     children?: ReactNode;
 };
 
+/** Menú ya resuelto: anclados arriba, secciones y la identidad de pin de cada ítem. */
+declare type CmsmediosMenuLayout = {
+    pinned: NavLinkItem[];
+    groups: NavLinkItem[][];
+    pinRefs: Map<NavLinkItem, AuthPinRef>;
+};
+
 /** Message tree shape; values are strings, keys are inferred from `enMessages`. */
 export declare type CmsMessages = DeepStringMap<typeof enMessages>;
 
@@ -3413,29 +3499,29 @@ export declare const enMessages: {
         readonly COMMENTS: "Comments";
         readonly POLLS: "Polls";
         readonly MEDIA: "Media";
-        readonly AUDIOS: "Audio";
+        readonly AUDIOS: "Audios";
         readonly IMAGES: "Images";
         readonly PLAYLISTS: "Playlist";
         readonly VIDEOS: "Videos";
-        readonly NEWS: "News";
+        readonly NEWS: "Posts";
         readonly PLANNING: "Planning";
         readonly ANALYTICS: "Analytics";
         readonly TAGS: "Tags";
-        readonly TRIVIAS: "Trivia";
-        readonly OTHERS: "Other";
+        readonly TRIVIAS: "Trivias";
+        readonly OTHERS: "Others";
         readonly NEWSWIRES: "News Wires";
         readonly EVENTS: "Events";
-        readonly PAGES: "Pages";
+        readonly PAGES: "Explorer";
         readonly FEEDS: "Feed";
         readonly PERSONS: "People";
         readonly CONTRIBUTIONS: "Contributions";
         readonly RECIPES: "Recipes";
-        readonly POSTS: "Posts";
+        readonly POSTS: "UGC";
         readonly BANNERS: "Banners";
         readonly BLOCKS: "Blocks";
         readonly MENUS: "Menu";
-        readonly TOPICS: "Topics";
-        readonly ADVANCEDQUERYS: "Advanced search";
+        readonly TOPICS: "Themes";
+        readonly ADVANCEDQUERYS: "Search";
         readonly IMPORTS: "Imports";
         readonly NEWSLETTERS: "Newsletters";
         readonly NOTIFICATIONS: "Notifications";
@@ -3448,6 +3534,12 @@ export declare const enMessages: {
         readonly COPILOT: "CoPilot";
         readonly ZONES: "Zones";
         readonly IA: "IA";
+        readonly PRODUCTION: "Production";
+        readonly FREQUENCY: "Frequency";
+        readonly VODS: "Videos OnDemand";
+        readonly SUBSCRIPTIONS: "Subscriptions";
+        readonly MYPLAN: "Production";
+        readonly USERS_MANAGER: "Users";
     };
     readonly sidebar: {
         readonly navAriaLabel: "Main navigation";
@@ -3611,7 +3703,7 @@ export declare const enMessages: {
         readonly defaultInfo: "Information";
     };
     readonly network: {
-        readonly disconnected: "No connection. Check your network or Wi-Fi status. We will retry when the connection is restored.";
+        readonly disconnected: "No connection.\nPlease check your Internet connection status.\nThe system will automatically retry pending actions once the connection is restored.";
         readonly retrying: "Retrying requests.";
     };
     readonly userAvatar: {
@@ -3619,16 +3711,28 @@ export declare const enMessages: {
         readonly unknownUser: "Unknown user";
     };
     readonly errorPage: {
-        readonly homeButton: "Home";
-        readonly notFoundTitle: "Sorry an error occurred.";
-        readonly notFoundSubtitle: "This website is no longer available. Keep browsing!";
+        readonly homeButton: "Go to manager";
+        readonly notFoundTitle: "We couldn't find this page";
+        readonly notFoundSubtitle: "This content may have been moved, unpublished, or the link may be mistyped.";
         readonly notFoundCode: "404";
+        readonly notFoundCodeLabel: "404 — Page not found";
         readonly errorLabel: "Error";
-        readonly copyDetail: "Copy detail.";
-        readonly copyDetailText: "The route {url} you are trying to access is no longer available.";
-        readonly copied: "Text copied to clipboard!";
-        readonly notAllowedTitle: "Sorry.\nYou do not have access.";
-        readonly notAllowedSubtitle: "What you want to see is restricted by permissions. Keep browsing!";
+        readonly notAllowedTitle: "You don't have permission to access this";
+        readonly notAllowedSubtitle: "Your account does not have the permissions needed to view this page. If you think this is a mistake, request access from the site administrator.";
+        readonly notAllowedCode: "403";
+        readonly notAllowedCodeLabel: "403 — Access denied";
+        readonly detailTitle: "Error detail";
+        readonly detailFieldCode: "Code";
+        readonly detailFieldAddress: "Address";
+        readonly detailFieldUser: "User";
+        readonly detailFieldDate: "Date";
+        readonly copyDetail: "Copy";
+        readonly copied: "Copied";
+        readonly helpHintPrefix: "Need help? Copy the detail and write to";
+        readonly loggedInAsPrefix: "Signed in as";
+        readonly changeAccount: "Change account";
+        readonly footerBrand: "Bluestack CMS";
+        readonly footerCodeLabel: "Error code";
     };
 };
 
@@ -3674,6 +3778,12 @@ export declare const esMessages: {
         COPILOT: string;
         ZONES: string;
         IA: string;
+        PRODUCTION: string;
+        FREQUENCY: string;
+        VODS: string;
+        SUBSCRIPTIONS: string;
+        MYPLAN: string;
+        USERS_MANAGER: string;
     };
     sidebar: {
         navAriaLabel: string;
@@ -3849,12 +3959,24 @@ export declare const esMessages: {
         notFoundTitle: string;
         notFoundSubtitle: string;
         notFoundCode: string;
+        notFoundCodeLabel: string;
         errorLabel: string;
-        copyDetail: string;
-        copyDetailText: string;
-        copied: string;
         notAllowedTitle: string;
         notAllowedSubtitle: string;
+        notAllowedCode: string;
+        notAllowedCodeLabel: string;
+        detailTitle: string;
+        detailFieldCode: string;
+        detailFieldAddress: string;
+        detailFieldUser: string;
+        detailFieldDate: string;
+        copyDetail: string;
+        copied: string;
+        helpHintPrefix: string;
+        loggedInAsPrefix: string;
+        changeAccount: string;
+        footerBrand: string;
+        footerCodeLabel: string;
     };
 };
 
@@ -4157,7 +4279,7 @@ export declare function findPublicationLabel(sites: SiteSection[], publicationId
  * que la carga vive en `theme/fonts.ts` y se inyecta vía el provider MUI.
  */
 export declare const fontFamilies: {
-    readonly googleSans: "\"Google Sans\",\"Helvetica\",\"Arial\",sans-serif";
+    readonly googleSans: "\"Google Sans\",\"Roboto\",\"Helvetica\",\"Arial\",sans-serif";
     /** Monoespaciada (url del toast de error, fragmentos de código). No es de marca. */
     readonly mono: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
 };
@@ -4194,6 +4316,13 @@ export declare function formatSiteDateTime(epochMs: number, gmtRedaction: string
 
 export declare function getAllPublications(sites: SiteSection[]): Publication[];
 
+/**
+ * Ícono a partir del nombre que guarda el Authenticator (`"PollIcon"`), en su
+ * variante Outlined. El barrel de íconos se baja aparte y solo para estos
+ * ítems; mientras llega (o si el nombre no existe) se ve el genérico.
+ */
+export declare function getAuthSidebarIcon(name?: string | null): ElementType;
+
 /**
  * Resuelve el mensaje legible de un código de error en el idioma indicado.
  * Aplica el fallback legacy `código → código+'a'` (p. ej. `999.002` → `999.002a`)
@@ -4836,6 +4965,16 @@ export declare type NavLinkItem = {
     module: string;
     /** Override opcional del label traducido vía i18n (`navigation.{module}`). */
     label?: string;
+    /**
+     * Clave i18n de `navigation` cuando no coincide con `module` (p. ej. PLANS y
+     * MYPLAN se leen los dos como `PRODUCTION`). Si falta, se usa `module`.
+     */
+    labelKey?: string;
+    /**
+     * Se dibuja aunque su `module` no venga en `modulesAvailable` (ítems que manda
+     * el Authenticator: pines de otras apps y módulos hermanos).
+     */
+    alwaysVisible?: boolean;
     badge?: string;
     children?: NavLinkItem[];
     defaultOpen?: boolean;
@@ -6474,6 +6613,12 @@ export declare const ptMessages: {
         COPILOT: string;
         ZONES: string;
         IA: string;
+        PRODUCTION: string;
+        FREQUENCY: string;
+        VODS: string;
+        SUBSCRIPTIONS: string;
+        MYPLAN: string;
+        USERS_MANAGER: string;
     };
     sidebar: {
         navAriaLabel: string;
@@ -6649,12 +6794,24 @@ export declare const ptMessages: {
         notFoundTitle: string;
         notFoundSubtitle: string;
         notFoundCode: string;
+        notFoundCodeLabel: string;
         errorLabel: string;
-        copyDetail: string;
-        copyDetailText: string;
-        copied: string;
         notAllowedTitle: string;
         notAllowedSubtitle: string;
+        notAllowedCode: string;
+        notAllowedCodeLabel: string;
+        detailTitle: string;
+        detailFieldCode: string;
+        detailFieldAddress: string;
+        detailFieldUser: string;
+        detailFieldDate: string;
+        copyDetail: string;
+        copied: string;
+        helpHintPrefix: string;
+        loggedInAsPrefix: string;
+        changeAccount: string;
+        footerBrand: string;
+        footerCodeLabel: string;
     };
 };
 
@@ -6968,6 +7125,19 @@ export declare interface ResilientRunOptions {
     maxRetries?: number;
     /** Mostrar el toast "reintentando" al reanudar tras una desconexión. Default true. */
     notifyRetry?: boolean;
+    /**
+     * Clave para **deduplicar** llamados idénticos en vuelo (p. ej. el usuario le
+     * dio clic varias veces al mismo botón mientras esperaba reconexión). Si ya
+     * hay un `run` con la misma clave esperando conexión/reintentando, este NO
+     * vuelve a invocar `fn`: se engancha a esa misma promesa y ambos llamantes
+     * reciben el mismo resultado (un solo request real, no uno por clic).
+     *
+     * Sin esta opción no hay dedupe (comportamiento previo, sin cambios). El
+     * gestor arma la clave con lo que identifica **esa** acción de negocio, p. ej.
+     * `` `users/setStatus:${userId}` ``: no la deriva la lib porque es una
+     * decisión del caller (no todo llamado conviene deduplicar).
+     */
+    dedupeKey?: string;
 }
 
 export declare function resolveCmsAssetUrl(path: string, cmsOrigin?: string): string;
@@ -7210,7 +7380,20 @@ export declare type SidebarProps = {
  * todo. El anclado se identifica por `item.module` y persiste vía
  * `profileServices.addPins`/`deletePins`/`getPins` (recurso de perfil).
  */
-export declare function SidebarRail({ pathname, permissions, LinkComponent, legacyBaseUrl, cmsBaseUrl, legacySession, selectedPublicationId, navHrefOverrides, items, profileServices, }: SidebarRailProps): JSX.Element;
+export declare function SidebarRail({ pathname, permissions, LinkComponent, legacyBaseUrl, cmsBaseUrl, legacySession, selectedPublicationId, navHrefOverrides, items, sections, profileServices, authService, }: SidebarRailProps): JSX.Element;
+
+/**
+ * Pines y módulos hermanos del Authenticator, igual que cmsmedios
+ * (`MenuService.mergeWithAuthenticatorSidebar` + `PinesService`). El gestor lo
+ * arma con su token y la publicación actual:
+ * - `getSidebar` → `GET /api/v1/auth/sidebar?publicationId=N`
+ * - `pin` / `unpin` → `POST` / `DELETE /api/v1/auth/sidebar/pin`
+ */
+export declare type SidebarRailAuthService = {
+    getSidebar: () => Promise<AuthSidebarResponse>;
+    pin: (moduleName: string, itemKey: string) => Promise<void>;
+    unpin: (moduleName: string, itemKey: string) => Promise<void>;
+};
 
 /** Servicio de pines usado por el rail: solo necesita estos tres métodos. */
 export declare type SidebarRailPinService = Pick<CmsProfileServices, 'addPins' | 'deletePins' | 'getPins'>;
@@ -7232,14 +7415,28 @@ export declare type SidebarRailProps = {
      * gestor hermano para el ajeno). Misma pestaña. Ver `resolveNavHrefOverride`.
      */
     navHrefOverrides?: Record<string, string>;
-    /** Ítems de navegación. Por defecto, `ACCOUNT_NAV_BLOCKS`. */
+    /**
+     * Ítems en una sola lista, sin separadores. Si se pasa, gana sobre `sections`
+     * (compatibilidad con los gestores que mandaban su propia lista).
+     */
     items?: NavLinkItem[];
+    /**
+     * Ítems agrupados en secciones separadas por una línea. Por defecto,
+     * `CMS_MENU_SECTIONS`: el mismo menú que cmsmedios y el gestor de noticias.
+     */
+    sections?: NavLinkItem[][];
     /**
      * Servicio de pines (`CmsProfileServices`, construido por el host con su
      * `axiosApi`/`authentication`). Si se omite, el anclado es solo visual y no
      * persiste entre sesiones.
      */
     profileServices?: SidebarRailPinService;
+    /**
+     * Pines y módulos hermanos del Authenticator, como cmsmedios. Si se pasa,
+     * reemplaza a `profileServices` (pines viejos del perfil del CMS) y el orden
+     * de los anclados es el de cmsmedios. Ver `buildCmsmediosMenu`.
+     */
+    authService?: SidebarRailAuthService;
 };
 
 /**
@@ -8095,6 +8292,11 @@ export declare type UserAvatarProps = {
  *   resultado de error para que el caller muestre el toast.
  * - **Error de negocio (4xx / `status:'fail'`):** no reintenta; devuelve el
  *   resultado tal cual para que el caller decida (toast/update optimista).
+ * - **Clics repetidos a la misma acción** (con `dedupeKey`): mientras el
+ *   primer llamado siga esperando reconexión o reintentando, los siguientes
+ *   con la misma clave no disparan `fn` de nuevo — se enganchan a la misma
+ *   promesa, así solo sale un request real aunque el usuario haya hecho clic
+ *   varias veces.
  *
  * El toast global de "sin conexión" / "conexión restablecida" lo dispara
  * `CmsNetworkToaster`; este hook solo añade el "reintentando…" por acción.
@@ -8102,8 +8304,11 @@ export declare type UserAvatarProps = {
  * Uso en el gestor:
  * ```ts
  * const run = useResilientAction();
- * const res = await run(() => setUserStatus(slug, id, action),
- *   { service: '/users/actions/setStatus', params: { id, action } });
+ * const res = await run(() => setUserStatus(slug, id, action), {
+ *   service: '/users/actions/setStatus',
+ *   params: { id, action },
+ *   dedupeKey: `users/setStatus:${id}`,
+ * });
  * ```
  */
 export declare function useResilientAction(): ResilientRunner;