sass-cms-template-common 0.0.6 → 0.0.7

package/dist/server.d.ts

@@ -581,6 +581,9 @@ export declare class CmsDashboardServices {
     getNotifications: () => Promise<DashboardNotificationsResponse>;
 }
 
+/** Severidad de feedback derivada de un código de error. */
+export declare type CmsErrorSeverity = 'warning' | 'error';
+
 /** Evento del CMS. La forma exacta depende del recurso. */
 export declare interface CmsEvent {
     [key: string]: unknown;
@@ -1370,11 +1373,11 @@ export declare class CmsUsersServices {
     addPin: (pin: string) => Promise<UserPinAddResponse>;
     /** POST /users/pin/delete — elimina uno o más pins por ID. */
     deletePins: (ids: number[]) => Promise<CmsResponse>;
-    /** POST /users/action/setStatus — activa o desactiva un usuario. */
+    /** POST /users/actions/setStatus — activa o desactiva un usuario. */
     setUserStatus: (username: string, action: UserStatusAction) => Promise<CmsResponse>;
-    /** POST /users/action/resetPass — restablece la contraseña de un usuario. */
+    /** POST /users/actions/resetPass — restablece la contraseña de un usuario. */
     resetPassword: (username: string) => Promise<CmsResponse>;
-    /** POST /users/action/resetMfa — resetea la configuración MFA de un usuario. */
+    /** POST /users/actions/resetMfa — resetea la configuración MFA de un usuario. */
     resetMfa: (username: string, reason: string) => Promise<CmsResponse>;
 }
 
@@ -1668,6 +1671,36 @@ export declare interface CommentUserGetResponse extends CmsResponse {
     phonenumber?: string;
 }
 
+/**
+ * CMS error code → readable message map (English).
+ *
+ * English counterpart of {@link commonErrorsEs}. See that file for the key
+ * convention and the `código → código+'a'` fallback handled by
+ * `getCommonError`.
+ */
+export declare const commonErrorsEn: Record<string, string>;
+
+/**
+ * Mapa de códigos de error del CMS → mensaje legible (español).
+ *
+ * Equivalente al `CommonErrorsEs` del Angular legacy (`cmsmedios-ux`). Es la
+ * base compartida por todos los gestores; **se va ampliando** con cada código
+ * nuevo que se aprenda durante el desarrollo (ver CLAUDE.md raíz).
+ *
+ * Convención de claves: el código tal cual lo devuelve el webservice
+ * (`000.005`, `999.000`, …). Algunos mensajes genéricos usan el sufijo `a`
+ * (`999.002a`) por compatibilidad con el legacy; `getCommonError` resuelve el
+ * fallback `código → código+'a'` automáticamente.
+ */
+export declare const commonErrorsEs: Record<string, string>;
+
+/**
+ * Mapa de código de erro do CMS → mensagem legível (português).
+ *
+ * Equivalente em português de {@link commonErrorsEs}.
+ */
+export declare const commonErrorsPt: Record<string, string>;
+
 /**
  * Contribución a actualizar (POST /contributions/edit).
  *
@@ -1894,10 +1927,40 @@ export declare function findPublicationBySlug(sites: SiteSection[], slug: string
 
 export declare function findPublicationLabel(sites: SiteSection[], publicationId: string): string;
 
+/**
+ * Formatea un instante (epoch ms) en la zona horaria del sitio, de forma
+ * estable entre navegadores.
+ *
+ * @param epochMs Instante en milisegundos (UTC).
+ * @param gmtRedaction Offset GMT de la publicación.
+ * @param localeTag Tag BCP 47 (p. ej. `"es-AR"`); usar `getIntlLocaleTag(locale)`.
+ * @param options Opciones de `Intl.DateTimeFormat` (se fuerza `timeZone: 'UTC'`).
+ */
+export declare function formatSiteDateTime(epochMs: number, gmtRedaction: string | null | undefined, localeTag: string, options?: Intl.DateTimeFormatOptions): string;
+
 export declare function getAllPublications(sites: SiteSection[]): Publication[];
 
+/**
+ * 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`)
+ * y, si el idioma no tiene el código, cae a inglés. Devuelve `undefined` si el
+ * código es desconocido (el caller debe usar entonces el `error` crudo o un
+ * mensaje genérico).
+ */
+export declare function getCommonError(errorCode: string | number | Array<string | number> | null | undefined, locale?: Locale): string | undefined;
+
 export declare function getDefaultPublicationSlug(sites: SiteSection[]): string;
 
+/**
+ * Hora actual del sitio (equivalente al `getFormattedRedactionTimeUTC` del CMS
+ * Angular): "ahora" formateado en la zona de redacción de la publicación.
+ *
+ * @param gmtRedaction Offset GMT de la publicación.
+ * @param localeTag Tag BCP 47 (p. ej. `"es-AR"`).
+ * @param options Opciones de `Intl.DateTimeFormat`.
+ */
+export declare function getSiteNow(gmtRedaction: string | null | undefined, localeTag: string, options?: Intl.DateTimeFormatOptions): string;
+
 declare interface IAudiosServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -2302,6 +2365,8 @@ declare interface IZonesServices {
     authentication: Authentication;
 }
 
+declare type Locale = (typeof SUPPORTED_LOCALES)[number];
+
 /** Cuerpo de la respuesta de POST /auth/modulesAvailable */
 export declare interface ModulesAvailableResponse {
     modules: NavItemPermissions[];
@@ -2777,6 +2842,13 @@ export declare interface NewsViewsGetResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/**
+ * Normaliza un `errorCode` que puede venir como string, número o array (el CMS
+ * devuelve un array de códigos cuando hay varias violaciones de contraseña).
+ * Devuelve el primer código no vacío.
+ */
+export declare function normalizeErrorCode(errorCode: string | number | Array<string | number> | null | undefined): string | undefined;
+
 /** Cuerpo de la respuesta de POST /notification/adminConfiguration. */
 export declare interface NotificationAdminConfigurationResponse extends CmsResponse {
     /** Topics configurados para la publicación. */
@@ -2839,6 +2911,31 @@ export declare interface NotificationTopicsResponse extends CmsResponse {
     topics?: NotificationTopic[];
 }
 
+/**
+ * Utilidades de hora del sitio (zona de redacción de la publicación).
+ *
+ * El backend entrega en cada `Publication` un offset GMT fijo
+ * (`gmtRedaction`, p. ej. `"-3"` / `"+0"`) — NO una zona IANA. Por eso la
+ * conversión se hace con un offset fijo y no contempla horario de verano
+ * (DST). Es el equivalente, en React, de lo que en el CMS Angular hacía
+ * `settings.service` (`getFormattedRedactionTimeStamp` /
+ * `getFormattedRedactionTimeUTC`).
+ *
+ * El criterio: un timestamp del CMS es un instante en UTC (epoch ms). Para
+ * mostrarlo "como lo ve la redacción" se desplaza el instante por el offset y
+ * se formatea en `timeZone: 'UTC'`, de modo que el resultado es estable e
+ * independiente de la zona horaria del navegador.
+ */
+/**
+ * Convierte el offset GMT de una publicación a minutos.
+ * Acepta `"-3"`, `"+3"`, `"3"`, `"+5:30"`, tolera prefijos `GMT`/`UTC` y
+ * espacios. Si el valor no es interpretable, devuelve `0` (UTC).
+ *
+ * @param gmt Offset tal como llega en `Publication.gmtRedaction`.
+ * @returns Offset en minutos respecto de UTC (negativo al oeste de Greenwich).
+ */
+export declare function parseGmtOffsetMinutes(gmt: string | null | undefined): number;
+
 export declare function parsePublicationSlug(slug: string): number;
 
 /** Filtros de POST /contributions/paymentGateways/get. */
@@ -3650,6 +3747,12 @@ export declare interface Publication {
     timeFormat: string;
     type: string;
     updateAdmin: PublicationUpdateAdmin;
+    /**
+     * Sub-sitios (multisitio) de esta publicación. Opcional: hoy el servicio no
+     * lo devuelve y las publicaciones se listan planas. Cuando el backend lo
+     * incluya, el selector los muestra como filas hijas expandibles con contador.
+     */
+    children?: Publication[];
 }
 
 /**
@@ -3865,6 +3968,9 @@ export declare interface RecipesPublishCheckResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/** 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;
+
 /** Sección de una publicación del CMS (forma devuelta por get/exist). */
 export declare interface Section {
     id?: number;
@@ -3962,6 +4068,8 @@ export declare interface SubscriptionsGetResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+declare const SUPPORTED_LOCALES: readonly ["es", "en", "pt"];
+
 /** Término/tag del CMS. La forma exacta depende del tipo y del endpoint. */
 export declare interface Tag {
     id?: number;
@@ -4136,6 +4244,17 @@ export declare interface TagUpdateInput {
     [key: string]: unknown;
 }
 
+/**
+ * Desplaza un instante (epoch ms en UTC) al "reloj de pared" de la zona de
+ * redacción del sitio. El número resultante, formateado con `timeZone: 'UTC'`,
+ * muestra la hora local del sitio sin importar la zona del navegador.
+ *
+ * @param epochMs Instante en milisegundos (UTC).
+ * @param gmtRedaction Offset GMT de la publicación.
+ * @returns Epoch ms desplazado por el offset del sitio.
+ */
+export declare function toSiteWallClock(epochMs: number, gmtRedaction: string | null | undefined): number;
+
 /**
  * Cuerpo de la respuesta de POST /transcribe/get.
  *
@@ -4480,7 +4599,7 @@ export declare interface UsersPublicationResponse extends CmsResponse {
 /** Estado posible de un usuario del sistema. */
 export declare type UserStatus = 'active' | 'block' | 'pending';
 
-/** Acción soportada por POST /users/action/setStatus. */
+/** Acción soportada por POST /users/actions/setStatus. */
 export declare type UserStatusAction = 'activate' | 'deactivate';
 
 /** Video del CMS. La forma exacta depende del recurso y del formato pedido. */

package/dist/server.js

@@ -1,2 +1,2 @@
-import { A as e, B as t, C as n, D as r, E as i, H as a, M as o, N as s, O as c, P as l, S as u, T as d, U as f, V as p, _ as m, a as h, b as g, c as _, d as v, f as y, g as b, h as x, i as S, j as C, k as w, l as T, m as E, n as D, o as O, p as k, r as A, s as j, t as M, u as N, v as P, w as F, x as I, y as L, z as R } from "./services-BqEo-2mI.js";
-export { i as CmsAudiosServices, w as CmsAuthLoginServices, l as CmsAuthServices, d as CmsCategoriesServices, F as CmsCkeditorServices, n as CmsCommentsServices, M as CmsCommonServices, u as CmsContributionsServices, s as CmsDashboardServices, L as CmsEventsServices, P as CmsFileExplorerServices, m as CmsGeneralServices, b as CmsImagesServices, x as CmsNewsServices, E as CmsNotificationServices, k as CmsPeopleServices, y as CmsPlanningServices, v as CmsPollsServices, r as CmsPreviewServices, g as CmsProductivityPlanServices, o as CmsProfileServices, C as CmsPublicationsServices, N as CmsRecipesServices, I as CmsSectionsServices, e as CmsSitesServices, D as CmsTagsServices, A as CmsTranscribeServices, S as CmsTriviasServices, c as CmsUploadServices, T as CmsUsersServices, h as CmsVideosServices, O as CmsVodsServices, j as CmsWorkpaperServices, _ as CmsZonesServices, R as findPublicationBySlug, t as findPublicationLabel, p as getAllPublications, a as getDefaultPublicationSlug, f as parsePublicationSlug };
+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-C2aqnM7h.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 };