sass-template-common 0.9.241 → 0.10.1

package/README.md

@@ -1,36 +1,36 @@
-# sass-template-common
-
-Librería web, maqueta de configuración y componentes para proyectos sass.
-
-## Publicar nueva versión
-
-Para que los cambios se reflejen al publicar:
-
-1. **Subir versión** (obligatorio; si no, npm rechaza o se usa la misma versión):
-   ```bash
-   pnpm version:patch   # 0.3.21 → 0.3.22
-   # o
-   pnpm version:minor   # 0.3.21 → 0.4.0
-   pnpm version:major   # 0.3.21 → 1.0.0
-   ```
-
-2. **Build limpio + publicar**:
-   ```bash
-   pnpm run clean && pnpm run build && pnpm publish
-   ```
-   O en un solo paso (patch):
-   ```bash
-   pnpm release:patch
-   ```
-
-3. **`prepublishOnly`**: Antes de cada `pnpm publish` se ejecuta `clean` + `build`, así siempre se publica un build nuevo.
-
-4. **En proyectos que consumen la lib**: Actualizar la dependencia y reinstalar:
-   ```bash
-   pnpm update sass-template-common
-   # o cambiar la versión en package.json y luego
-   pnpm install
-   ```
-   Si usan versión fija (`"0.3.21"`), hay que actualizarla a la nueva (p. ej. `"0.3.22"`).
-
-**Si no ves los cambios:** comprueba que subiste la versión (`version:patch` o similar), que hiciste `clean` + `build` antes de publicar, y que el proyecto consumidor tiene actualizada la dependencia (o `^0.3.21` y ha ejecutado `pnpm update`).
+# sass-template-common
+
+Librería web, maqueta de configuración y componentes para proyectos sass.
+
+## Publicar nueva versión
+
+Para que los cambios se reflejen al publicar:
+
+1. **Subir versión** (obligatorio; si no, npm rechaza o se usa la misma versión):
+   ```bash
+   pnpm version:patch   # 0.3.21 → 0.3.22
+   # o
+   pnpm version:minor   # 0.3.21 → 0.4.0
+   pnpm version:major   # 0.3.21 → 1.0.0
+   ```
+
+2. **Build limpio + publicar**:
+   ```bash
+   pnpm run clean && pnpm run build && pnpm publish
+   ```
+   O en un solo paso (patch):
+   ```bash
+   pnpm release:patch
+   ```
+
+3. **`prepublishOnly`**: Antes de cada `pnpm publish` se ejecuta `clean` + `build`, así siempre se publica un build nuevo.
+
+4. **En proyectos que consumen la lib**: Actualizar la dependencia y reinstalar:
+   ```bash
+   pnpm update sass-template-common
+   # o cambiar la versión en package.json y luego
+   pnpm install
+   ```
+   Si usan versión fija (`"0.3.21"`), hay que actualizarla a la nueva (p. ej. `"0.3.22"`).
+
+**Si no ves los cambios:** comprueba que subiste la versión (`version:patch` o similar), que hiciste `clean` + `build` antes de publicar, y que el proyecto consumidor tiene actualizada la dependencia (o `^0.3.21` y ha ejecutado `pnpm update`).

package/dist/sass-template-common.d.ts

@@ -53,6 +53,8 @@ export declare type Analytics = {
 
 export declare const AssetsPreconnect: () => false | "" | JSX.Element | undefined;
 
+export declare function auditConfigOrigin(entry: ConfigOriginAuditEntry): void;
+
 export declare interface Author {
     firstname: string;
     lastname: string;
@@ -227,6 +229,11 @@ export declare interface BlockSaasResponseData {
 export declare type BucketOriginConfig = {
     /** Base URL pública del bucket (sin slash final). Ej: `https://debate-site-configs.s3.us-west-2.amazonaws.com` */
     url: string;
+    /**
+     * Base URL alternativa (CloudFront u otro proxy cacheado). Si está definida,
+     * reemplaza `url` al armar las rutas de menú/banners en bucket.
+     */
+    proxyUrl?: string;
     /** Prefijo raíz del cliente dentro del bucket (ej. `'debate'`). */
     clientName: string;
     /** Sirve el menú (sidebar/menu/footer/freeZone/cintillo + equipos/sites) desde el bucket. */
@@ -246,8 +253,15 @@ export declare type BucketOriginConfig = {
      * (ej. `debate/debate/menu/...` en vez de `debate//menu/...`).
      */
     forceSite?: string;
+    /**
+     * TTL (ms) del cache in-memory SSR para menú/banners (bucket o API). Default 45000.
+     * `0` desactiva. Prioridad sobre `CONFIG_configCacheTtlMs`.
+     */
+    cacheTtlMs?: number;
 };
 
+export declare function buildConfigMenuApiPath(servicePrefix: string, configVersion: string, fileName: string): string;
+
 export declare const buildTagUrl: (tag: Tag, paths: RoutePathConfig) => string;
 
 declare interface ButtonCSS {
@@ -302,6 +316,13 @@ export declare const CarruselOpinion: FC<SectionCardCarouselProps>;
  */
 export declare const cleanSchema: <T>(value: T) => T;
 
+export declare function clearConfigOriginAudit(): void;
+
+/** Limpia el cache (útil en tests o tras invalidación manual). */
+export declare function clearConfigOriginCache(cacheKey?: string): void;
+
+export declare function clearConfigOriginComparisonCache(): void;
+
 export declare const coloringByStrokeSVGs: string[];
 
 /** Textos del popup anónimo (AnonimusPopUp.tsx) */
@@ -497,13 +518,11 @@ export declare class CommonServices {
     }, any, {}>> | undefined;
     getMainMenu: (params: Params) => Promise<AxiosResponse<{
         data: Array<MenuResponse>;
-    }, any, {}> | AxiosResponse<{
-        data: Array<MenuResponse>;
     }, any, {}> | {
         data: {
             data: Array<MenuResponse>;
         };
-    } | undefined> | undefined;
+    }>;
     getNewsListZone: (params: Params) => Promise<AxiosResponse<NewListResponse, any, {}>> | undefined;
     getNewsListZoneSection: (params: Params) => Promise<AxiosResponse<NewListResponse, any, {}>> | undefined;
     getNewsList: (params: Params) => Promise<AxiosResponse<NewListResponse, any, {}>> | undefined;
@@ -527,20 +546,22 @@ export declare class CommonServices {
     getVideosList: (params: Params) => Promise<AxiosResponse<{
         data: Array<VideoResponseData>;
     }, any, {}>> | undefined;
-    getBanners: (params: Params) => Promise<{
+    getBanners: (params: Params) => Promise<AxiosResponse<{
+        data: Array<BannerResponse>;
+    }, any, {}> | {
         data: {
             data: Array<BannerResponse>;
         };
-    } | undefined>;
+    }>;
     getPages: (params: Params) => Promise<AxiosResponse<{
         data: Array<FreeZoneResponse>;
     }, any, {}>> | undefined;
     getRankingS3: (url: string, headers?: {
         Referer: string;
-    }) => Promise<void | AxiosResponse<{
+    }) => Promise<AxiosResponse<{
         data: Array<NewListResponseData>;
     }, any, {}> | {
-        data: never[];
+        data: Array<NewListResponseData>;
     }>;
     getNews: (params: Params) => Promise<AxiosResponse<{
         data: Array<NewListResponseData>;
@@ -561,9 +582,7 @@ export declare class CommonServices {
         data: Array<NewListResponseData>;
     }, any, {}>> | undefined;
     getNewsItemsRelated: (path: string, params?: Params) => Promise<AxiosResponse<NewListResponse, any, {}> | {
-        data: {
-            data: never[];
-        };
+        data: NewListResponse;
     }> | undefined;
     sendEmail: (data: EmailParams) => Promise<AxiosResponse<{
         data: Array<ItemList>;
@@ -699,6 +718,60 @@ export declare type ConfigMain = {
     };
 };
 
+export declare type ConfigOriginAuditEntry = {
+    kind: 'menu' | 'banners';
+    origin: 'api' | 'bucket';
+    outcome: ConfigOriginOutcome;
+    target: string;
+    durationMs: number;
+    ok?: boolean;
+};
+
+export declare type ConfigOriginAuditReport = {
+    entries: ConfigOriginAuditEntry[];
+    totals: {
+        network: number;
+        cacheHit: number;
+        dedup: number;
+        api: number;
+        bucket: number;
+        networkMs: number;
+    };
+    comparison?: ConfigOriginComparisonReport | null;
+};
+
+export declare type ConfigOriginComparisonReport = {
+    runs: number;
+    rows: ConfigOriginComparisonRow[];
+    homeParallel: {
+        api: number;
+        bucket: number;
+    };
+    generatedAt: string;
+    cached: boolean;
+};
+
+export declare type ConfigOriginComparisonRow = {
+    name: string;
+    api: ConfigOriginTimingStats;
+    bucket: ConfigOriginTimingStats;
+    winner: 'api' | 'bucket';
+    advantagePct: number;
+    deltaMs: number;
+};
+
+export declare type ConfigOriginOutcome = 'network' | 'cache-hit' | 'dedup';
+
+export declare type ConfigOriginTimingStats = {
+    ok: boolean;
+    status: number;
+    size: number;
+    avg: number;
+    p50: number;
+    min: number;
+    max: number;
+};
+
 export declare const ContactInfoServer: FC<Props_9>;
 
 export declare const ContactInput: FC<Props_40>;
@@ -826,6 +899,8 @@ export declare function decodeApiEnv<T = any>(encoded: Record<string, any>): T;
  */
 export declare const DEFAULT_HEAD_CONFIG: headConfig;
 
+export declare const DEFAULT_S3_REFERER = "https://goamg.amplifyapp.com/vndomv";
+
 declare type DestacadoDiario = {
     customSectionCardStyles: SectionCardCSS;
     customNewsDescriptionStyles: NewsDescriptionBlockCSS;
@@ -916,6 +991,12 @@ export declare type EmailParams = {
     body: string;
 };
 
+/**
+ * Fallback completo (no solo `{data: []}`) para endpoints tipados `NewListResponse`:
+ * algunos consumidores leen `response.data.entity`/`site`/`publication`, no solo `.data.data`.
+ */
+export declare function emptyNewListResponse(): NewListResponse;
+
 export declare function encodeApiEnv<T extends Record<string, any>>(env: T): Record<string, any>;
 
 export declare interface Entity {
@@ -975,6 +1056,12 @@ export declare type FetchConfig = {
     newsType: string;
 };
 
+/**
+ * Cache in-memory + deduplicación de requests en vuelo (misma clave → misma promesa).
+ * TTL corto pensado para SSR: evita 4–5 GETs repetidos de menú/banners por instancia.
+ */
+export declare function fetchWithConfigCache<T>(cacheKey: string, fetchFn: () => Promise<T>, ttlMs?: number): Promise<T>;
+
 export declare const Font: ({ config }: {
     config: Config;
 }) => JSX.Element | null;
@@ -983,6 +1070,8 @@ export declare const Footer: FC<Props_33>;
 
 export declare const FormatAfterScripts: (props: ScriptProps) => JSX.Element | null;
 
+export declare function formatConfigOriginComparisonTable(report: ConfigOriginComparisonReport): string;
+
 export declare const formatDate: (date: number, DATE_CONFIG?: {
     PUBLIC_LNG: string;
     DATE_TIMEZONE: string;
@@ -1131,7 +1220,10 @@ export declare const generalGetData: (promiseArray: PromiseArray) => Promise<{
 
 export declare const GenerateBody: ({ children, defaultRouteName, banners, pathname, slug, config, internalPath, currentNew, tagsParsed, scriptReplaces, body_custom_elements, }: Props_5) => JSX.Element;
 
-export declare function GenerateHead({ axiosApi, headConfig: headConfigInput, meta, imgSizes, defaultMetadataName, pathname, slug, texts, query, autor, listAutor, currentNew, banners, schemasImages, internalPath, meta_info, config, socials, speculationType, preloadImageUrl, custom_Speculation, custom_metadata, custom_scriptReplaces, head_custom_elements, schemasCustomEndpoints, }: Props_4): Promise<ReactNode>;
+export declare function GenerateHead({ axiosApi, headConfig: headConfigInput, meta, imgSizes, defaultMetadataName, pathname, slug, texts, query, autor, listAutor, currentNew, banners, schemasImages, internalPath, meta_info, config, socials, speculationType, preloadImageUrl, custom_Speculation, custom_metadata, custom_scriptReplaces, head_custom_elements, schemasCustomEndpoints, configOriginAuditReport, }: Props_4): Promise<ReactNode>;
+
+/** Cliente axios compartido por origen de bucket (keep-alive en Node SSR). */
+export declare function getBucketHttpClient(baseUrl: string, referer: string): AxiosInstance;
 
 /**
  * Helper para conseguir el recaptcha token usando grecaptcha.enterprise
@@ -1159,6 +1251,10 @@ export declare interface GetCommentsParams {
 
 export declare function getConfig(): LibraryConfig;
 
+export declare function getConfigCacheTtlMs(): number;
+
+export declare function getConfigOriginAuditReport(comparison?: ConfigOriginComparisonReport | null): ConfigOriginAuditReport;
+
 export declare const getDynamicSlots: (axiosApi: AxiosInstance, config: Config, imgSizes: {
     [key: string]: any;
 }, imgSizesVideo: {
@@ -1447,6 +1543,8 @@ export declare interface Info {
 
 export declare function initLibrary(userConfig?: LibraryConfig): void;
 
+export declare function isConfigOriginAuditEnabled(): boolean;
+
 export declare interface ISection {
     name: string;
     slug: string;
@@ -1579,6 +1677,12 @@ export declare type LibraryConfig = {
         middle?: boolean;
         innote?: boolean;
     };
+    /**
+     * TTL (ms) del cache in-memory SSR para `getMainMenu` / `getBanners` vía API CMS.
+     * Default 45000. `0` desactiva el cache. También configurable en
+     * `BUCKET_ORIGIN.cacheTtlMs` (tiene prioridad si está definido).
+     */
+    CONFIG_configCacheTtlMs?: number;
     PAGE_SWIPER?: {
         home: boolean;
         autor: boolean;
@@ -2331,6 +2435,12 @@ export declare type Params = {
     related?: number;
 };
 
+export declare function parseConfigOriginCacheKey(cacheKey: string): {
+    kind: 'menu' | 'banners';
+    origin: 'api' | 'bucket';
+    target: string;
+};
+
 export declare const parseTags: (keywords: any) => string;
 
 export declare const pathnameSplit: (pathname: string) => {
@@ -2741,6 +2851,8 @@ declare type Props_4 = {
     headConfig?: Partial<headConfig>;
     head_custom_elements?: any;
     schemasCustomEndpoints?: string[];
+    /** Reporte SSR de menú/banners (cache/dedup/network). Solo con HTML_AUDIT. */
+    configOriginAuditReport?: ConfigOriginAuditReport | null;
 };
 
 declare type Props_40 = {
@@ -2982,6 +3094,29 @@ export declare interface ReportCommentParams {
 
 export declare type ReportReasonKey = keyof typeof REPORT_REASONS;
 
+/**
+ * Reintenta `fn` con backoff exponencial, acotando cada intento con `timeoutMs`
+ * (un fetch a un bucket S3 colgado no debe bloquear el request indefinidamente).
+ * Si se agotan los reintentos (o el error no es reintentable, ej. 404), registra el
+ * fallo en DebugStore y devuelve `fallback` en vez de rechazar: una falla del bucket
+ * no debe tumbar el render del sitio consumidor.
+ */
+export declare function resilientFetch<T, F>(fn: () => Promise<T> | T, fallback: F, { label, endpoint, params, retries, timeoutMs, baseDelayMs, }: ResilientFetchOptions): Promise<T | F>;
+
+export declare interface ResilientFetchOptions {
+    /** Identifica el fetch en logs y en el DebugStore (ej. '/news-list-zone', 'bucket:menu'). */
+    label: string;
+    endpoint?: string;
+    params?: Record<string, any>;
+    retries?: number;
+    timeoutMs?: number;
+    baseDelayMs?: number;
+}
+
+export declare function resolveBucketMenuSubtype(path?: string): string;
+
+export declare function resolveBucketOriginUrl(bucket: BucketOriginConfig, servicePrefix: string | undefined, type: 'menu' | 'banners', subtype: string): string;
+
 export declare interface RoutePathConfig {
     autor: string | 'autor';
     tema: string | 'tema';
@@ -2992,6 +3127,13 @@ export declare interface RoutePathConfig {
     'ultimas-noticias': string | 'ultimas-noticias';
 }
 
+export declare function runConfigOriginComparison(params: {
+    axiosApi: AxiosInstance;
+    servicePrefix: string;
+    configVersion: string;
+    runs?: number;
+}): Promise<ConfigOriginComparisonReport | null>;
+
 export declare function ScriptHydrator({ containerId, containerId2 }: Props_17): null;
 
 declare type ScriptProps = {
@@ -3286,6 +3428,9 @@ declare interface TagSectionProps {
     paths: RoutePathConfig;
 }
 
+/** Loguea el resumen en consola, limpia el buffer y devuelve el reporte (SSR). */
+export declare function takeConfigOriginAuditReport(comparison?: ConfigOriginComparisonReport | null): ConfigOriginAuditReport | null;
+
 /** Cabecera / edición (barra superior) */
 export declare type TextsHeader = {
     menuText: string;