sass-cms-template-common 0.0.12 → 0.0.14

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).
  *
@@ -583,6 +599,13 @@ export declare class CmsCopilotServices {
      * oportunidad: `save` | `like` | `dislike` | `assign` (permiso COPILOT_ACTION).
      */
     executeAction: (input: CopilotActionInput) => Promise<CopilotActionResponse>;
+    /**
+     * POST /copilot/snooze — "recordar luego" de una oportunidad de la campanita
+     * (permiso COPILOT_VIEW). La oportunidad desaparece de la campanita para el
+     * usuario y reaparece sola al vencer el plazo configurado.
+     * @param opportunityId - Id de la oportunidad a posponer.
+     */
+    snooze: (opportunityId: string) => Promise<CopilotSnoozeResponse>;
 }
 
 /**
@@ -1819,7 +1842,8 @@ export declare interface CopilotOpportunitiesResponse extends CmsResponse {
  *
  * La doc del gateway lista `id`, `topic` y `created_at`, pero el microservicio
  * (observado en dev) puede omitirlos: solo `title`, `status` y `score` están
- * garantizados. El consumidor debe tolerar los faltantes.
+ * garantizados. El consumidor debe tolerar los faltantes. En dev (2026-07-06) el
+ * micro también entrega `source`, `type`, `reasons` e `is_followed`.
  */
 export declare interface CopilotOpportunity {
     id?: string;
@@ -1831,8 +1855,23 @@ export declare interface CopilotOpportunity {
     score?: number;
     /** Fecha de creación (ISO 8601, p. ej. "2026-06-26T10:15:00Z"). */
     created_at?: string;
+    /** Fuente detectada (p. ej. "rss"). Verificado en dev 2026-07-06. */
+    source?: CopilotOpportunitySource;
+    /** Subtipo de match del micro (p. ej. "rss_match"). */
+    type?: string;
+    /** Motivos por los que el micro la propuso (para tooltip/detalle). */
+    reasons?: string[];
+    /** Si el editor ya la siguió/guardó (acción "save" de `copilot/actions`). */
+    is_followed?: boolean;
 }
 
+/**
+ * Fuente de la que el microservicio detectó la oportunidad. Valor observado en
+ * dev hoy: `"rss"`. Se deja abierto (passthrough) para no romper cuando el micro
+ * agregue fuentes nuevas.
+ */
+declare type CopilotOpportunitySource = 'rss' | 'gtrends' | 'sconsole' | 'x' | (string & {});
+
 /**
  * Estado de una oportunidad tal como lo entrega el microservicio (passthrough).
  * El único valor documentado hoy es `"open"`; se deja abierto para no romper
@@ -1840,6 +1879,18 @@ export declare interface CopilotOpportunity {
  */
 export declare type CopilotOpportunityStatus = 'open' | (string & {});
 
+/**
+ * Cuerpo de la respuesta de POST /copilot/snooze (NAA-4645). El "recordar luego"
+ * de la campanita: la oportunidad se oculta para ese usuario y reaparece sola al
+ * vencer el plazo configurado.
+ */
+export declare interface CopilotSnoozeResponse extends CmsResponse {
+    copilotEnabled?: boolean;
+    opportunity_id?: string;
+    /** Momento hasta el cual la oportunidad queda oculta (ISO 8601 o epoch). */
+    snoozed_until?: string | number;
+}
+
 /** POST /dashboard/countNotificatio */
 export declare interface CountNotificationsResponse {
     status: string;
@@ -1847,10 +1898,32 @@ export declare interface CountNotificationsResponse {
     unreadNotifications?: number;
 }
 
+/**
+ * Oportunidad editorial copilot presente en POST /dashboard/notification
+ * (NAA-4645). El back manda hasta 3, ordenadas por `score` desc, y solo si hay.
+ */
+export declare interface DashboardCopilotOpportunity {
+    /** Id de la oportunidad (opportunity_id, requerido para el snooze). */
+    id?: string;
+    title: string;
+    /** Tema/categoría de la oportunidad. */
+    topic?: string;
+    /** Puntaje de coincidencia editorial (0-100). */
+    score?: number;
+    /** Fecha de creación (ISO 8601, p. ej. "2026-06-26T10:15:00Z"). */
+    created_at?: string;
+    isRead?: boolean;
+}
+
 /** Cuerpo de la respuesta de POST /dashboard/countNotifications. */
 export declare interface DashboardCountNotificationsResponse extends CmsResponse {
     /** Total de notificaciones no leídas del usuario autenticado. */
     unreadNotifications?: number;
+    /**
+     * Oportunidades copilot no leídas (NAA-4645). Ya está **sumado** dentro de
+     * `unreadNotifications`; solo aparece si copilot aplica al usuario/publicación.
+     */
+    copilotOpportunities?: number;
 }
 
 /** Actividad vencida o por vencer presente en POST /dashboard/notification. */
@@ -1895,6 +1968,8 @@ export declare interface DashboardNotificationsResponse extends CmsResponse {
     newsTask?: DashboardNewsTask[];
     /** Actividades vencidas o por vencer. */
     expireTask?: DashboardExpireTask[];
+    /** Oportunidades editoriales copilot (hasta 3, por `score` desc). NAA-4645. */
+    copilot?: DashboardCopilotOpportunity[];
 }
 
 /** Evento de encoder de video presente en POST /dashboard/notification. */
@@ -2071,6 +2146,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.
@@ -2458,6 +2541,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;
@@ -2531,8 +2620,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;

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