sass-cms-template-common 0.0.10 → 0.0.11

package/dist/server.d.ts

@@ -566,6 +566,25 @@ export declare class CmsContributionsServices {
     getPaymentGateways: (filters?: PaymentGatewaysGetFilters) => Promise<PaymentGatewaysGetResponse>;
 }
 
+/**
+ * Servicios HTTP del módulo `copilot` del CMS (gateway hacia el microservicio
+ * Copilot/Kundera). Errores propios en la serie `030.x` (ver `commonErrors`).
+ *
+ * Se construye igual que `CmsCommonServices`, con `{ axiosApi, authentication }`.
+ */
+export declare class CmsCopilotServices {
+    protected props: ICopilotServices;
+    protected authentication: Authentication;
+    constructor(props: ICopilotServices);
+    /** POST /copilot/opportunities — feed de oportunidades (permiso COPILOT_VIEW). */
+    getOpportunities: (filters?: CopilotOpportunitiesFilters) => Promise<CopilotOpportunitiesResponse>;
+    /**
+     * POST /copilot/actions — ejecuta una acción del editor sobre una
+     * oportunidad: `save` | `like` | `dislike` | `assign` (permiso COPILOT_ACTION).
+     */
+    executeAction: (input: CopilotActionInput) => Promise<CopilotActionResponse>;
+}
+
 /**
  * Servicios HTTP del módulo `dashboard` del CMS.
  *
@@ -1737,6 +1756,90 @@ export declare interface ContributionsInsertCrmResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/** Acción del editor sobre una oportunidad (POST /copilot/actions). */
+export declare type CopilotAction = 'save' | 'like' | 'dislike' | 'assign';
+
+/** Datos según la acción ejecutada (el backend lo omite si está vacío). */
+export declare interface CopilotActionData {
+    /** Acción `save` (bookmark, toggle). */
+    is_followed?: boolean;
+    /** Acciones `like` / `dislike`. */
+    interest_signal?: string;
+    /** Acción `assign`. */
+    assigned_to?: string;
+}
+
+/** Entrada de POST /copilot/actions. */
+export declare interface CopilotActionInput {
+    action: CopilotAction;
+    /** ID de la oportunidad sobre la que se acciona. */
+    opportunityId: string;
+    /**
+     * ID opaco y estable del redactor a asignar (NO el username).
+     * Obligatorio solo para `action = "assign"` (error 030.005 si falta).
+     */
+    userExternalId?: string;
+}
+
+/** Cuerpo de la respuesta de POST /copilot/actions. */
+export declare interface CopilotActionResponse extends CmsResponse {
+    copilotEnabled?: boolean;
+    action?: CopilotAction;
+    opportunity_id?: string;
+    /** Código de resultado devuelto por el microservicio (omitido si es nulo). */
+    code?: string;
+    data?: CopilotActionData;
+}
+
+/** Filtros opcionales de POST /copilot/opportunities (passthrough al micro). */
+export declare interface CopilotOpportunitiesFilters {
+    /** Filtro de estado de las oportunidades (p. ej. "open"). */
+    status?: CopilotOpportunityStatus;
+    /** Cantidad máxima de oportunidades a devolver. */
+    limit?: number;
+}
+
+/**
+ * Cuerpo de la respuesta de POST /copilot/opportunities.
+ *
+ * Si la publicación no tiene `KUNDERA_SITE_UUID` (Copilot desactivado) el CMS
+ * responde `status:"ok"` con `copilotEnabled:false` y lista vacía: NO es un
+ * error, el gestor decide qué mostrar.
+ */
+export declare interface CopilotOpportunitiesResponse extends CmsResponse {
+    copilotEnabled?: boolean;
+    /** UUID del sitio en Kundera (solo si `copilotEnabled = true`). */
+    site_uuid?: string;
+    count?: number;
+    opportunities?: CopilotOpportunity[];
+}
+
+/**
+ * Oportunidad editorial del feed de Copilot.
+ *
+ * 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.
+ */
+export declare interface CopilotOpportunity {
+    id?: string;
+    title: string;
+    /** Tema/categoría. */
+    topic?: string;
+    status: CopilotOpportunityStatus;
+    /** Puntaje (el backend lo omite si es nulo). */
+    score?: number;
+    /** Fecha de creación (ISO 8601, p. ej. "2026-06-26T10:15:00Z"). */
+    created_at?: 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
+ * cuando el microservicio agregue estados nuevos.
+ */
+export declare type CopilotOpportunityStatus = 'open' | (string & {});
+
 /** POST /dashboard/countNotificatio */
 export declare interface CountNotificationsResponse {
     status: string;
@@ -1923,6 +2026,23 @@ export declare interface FileExplorerGetFoldersResponse extends CmsResponse {
     folders: ExplorerFolder[];
 }
 
+/**
+ * Filtra los módulos de POST /auth/modulesAvailable dejando solo los que el
+ * usuario puede ver, replicando el cruce que hace `parseModuleIntoMenu` de
+ * cmsmedios: un admin ve todo; el resto solo ve un módulo si tiene la operación
+ * `${module}_VIEW` en POST /auth/permissions. La comparación es case-insensitive.
+ *
+ * Degrada con seguridad: si `permissions` es null/undefined (p. ej. porque
+ * /auth/permissions falló), NO filtra y devuelve los módulos tal cual (misma
+ * visibilidad que hoy). El acceso real lo sigue gobernando el guard de ruta
+ * (`hasModulePermission`), así que el menú puede degradar sin exponer nada.
+ *
+ * @param modules módulos crudos de POST /auth/modulesAvailable
+ * @param permissions respuesta de POST /auth/permissions (`isAdmin` + `operations`)
+ * @returns los módulos visibles para el usuario (preserva `isnew`)
+ */
+export declare function filterModulesByPermissions(modules: NavItemPermissions[], permissions: Pick<AuthPermissionsResponse, 'isAdmin' | 'operations'> | null | undefined): NavItemPermissions[];
+
 export declare function findPublicationBySlug(sites: SiteSection[], slug: string): Publication | undefined;
 
 export declare function findPublicationLabel(sites: SiteSection[], publicationId: string): string;
@@ -1961,6 +2081,19 @@ export declare function getDefaultPublicationSlug(sites: SiteSection[]): string;
  */
 export declare function getSiteNow(gmtRedaction: string | null | undefined, localeTag: string, options?: Intl.DateTimeFormatOptions): string;
 
+/**
+ * Decide si el usuario puede acceder a un módulo, replicando el
+ * `AccessPermissionsGuard` de cmsmedios: un admin siempre pasa, el comodín
+ * `All_VIEWS` siempre pasa, y en el resto el usuario debe tener una operación
+ * cuyo `name` coincida con el permiso requerido. La comparación es
+ * case-insensitive (cmsmedios pasa el permiso de la ruta a mayúsculas).
+ *
+ * @param permissions respuesta de POST /auth/permissions (`isAdmin` + `operations`)
+ * @param requiredPermission permiso que exige la ruta (p. ej. `'NEWS_VIEW'`)
+ * @returns `true` si tiene acceso; `false` si debería redirigirse a `/not-allowed`
+ */
+export declare function hasModulePermission(permissions: Pick<AuthPermissionsResponse, 'isAdmin' | 'operations'> | null | undefined, requiredPermission: string): boolean;
+
 declare interface IAudiosServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -2000,6 +2133,11 @@ declare interface IContributionsServices {
     authentication: Authentication;
 }
 
+declare interface ICopilotServices {
+    axiosApi: AxiosInstance;
+    authentication: Authentication;
+}
+
 declare interface IDashboardServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;

package/dist/server.js

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