sass-template-common 0.10.0 → 0.10.10

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

@@ -51,8 +51,12 @@ export declare type Analytics = {
     comscore: string | undefined;
 };
 
+export declare const assetsImagesPrefixer: (imagePath: string, assetsClient?: string) => string;
+
 export declare const AssetsPreconnect: () => false | "" | JSX.Element | undefined;
 
+export declare function auditConfigOrigin(entry: ConfigOriginAuditEntry): void;
+
 export declare interface Author {
     firstname: string;
     lastname: string;
@@ -177,15 +181,14 @@ export declare const bannersReplace: (bannerLineAd: string, replaces?: {
 }) => string;
 
 /**
- * Splits a single large news-list fetch into `batchCount` parallel requests
- * of `batchSize` items each, then combines results in order.
- *
- * Page mapping (batchCount=3, newsListLimit=45 → batchSize=15):
- *   userPage=1 → API pages 1, 2, 3  (items 1–45)
- *   userPage=2 → API pages 4, 5, 6  (items 46–90)
+ * Variante metadata: mismo split que `createBatchedFetch` pero devuelve
+ * `hasNextPage` (último batch lleno) y el primer response crudo, para derivar
+ * next/prev y el título de sección. Lee el conteo de batches del MISMO
+ * `CONFIG_batchedFetch` que el render (vía `resolveBatchCount`), de modo que la
+ * paginación de metadata y la lista visible nunca discrepan.
  *
- * hasNextPage is true when the last batch came back full (length === batchSize),
- * which is equivalent to the original `data.length === newsListLimit` check.
+ * `ceil` (antes `floor`) alinea la matemática con `createBatchedFetch`; para los
+ * totales usados en prod (45, 15) ambos coinciden por ser divisibles.
  */
 export declare function batchedNewsFetch({ fetchFn, baseParams, userPage, newsListLimit, batchCount, }: BatchFetchParams): Promise<BatchFetchResult>;
 
@@ -227,6 +230,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 +254,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 +317,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) */
@@ -501,7 +523,7 @@ export declare class CommonServices {
         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;
@@ -531,7 +553,7 @@ export declare class CommonServices {
         data: {
             data: Array<BannerResponse>;
         };
-    } | undefined>;
+    }>;
     getPages: (params: Params) => Promise<AxiosResponse<{
         data: Array<FreeZoneResponse>;
     }, any, {}>> | undefined;
@@ -697,6 +719,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>;
@@ -733,6 +809,25 @@ declare interface CreateAssessmentParams {
     userIpAddress?: string;
 }
 
+/**
+ * Divide un fetch de lista en `batches` requests paralelos de `ceil(totalSize/
+ * batches)` ítems cada uno (páginas contiguas del upstream) y concatena los
+ * resultados en orden, devolviendo el MISMO envelope que un fetch único
+ * (`{ data: { data: [] } }`) para que caiga directo en un `PromiseArray` con
+ * `custom_extractData: getResponse`.
+ *
+ * Mapeo de páginas (batches=5, totalSize=45 → batchSize=9):
+ *   userPage=1 → API pages 1..5   (ítems 1–45)
+ *   userPage=2 → API pages 6..10  (ítems 46–90)
+ *
+ * `fetchFn` recibe `(size, page)` y devuelve la respuesta del CMS o `undefined`.
+ */
+export declare function createBatchedFetch(fetchFn: (size: number, page: number) => Promise<any> | undefined, totalSize: number, userPage: number, batches?: number): Promise<{
+    data: {
+        data: any[];
+    };
+}>;
+
 export declare const cutString: (text: string, length?: number) => string;
 
 export declare interface DataNews {
@@ -824,6 +919,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;
@@ -979,6 +1076,24 @@ export declare type FetchConfig = {
     newsType: string;
 };
 
+/**
+ * Envuelve `fetchFn` con batch SI la ruta está activada en config; si no, hace
+ * el fetch único (comportamiento de master). Behavior-preserving cuando el batch
+ * está off, así que es seguro envolver todas las rutas de lista de una — solo
+ * las que estén en `CONFIG_batchedFetch.routes` cambian de comportamiento.
+ */
+export declare function fetchMaybeBatched(route: string, fetchFn: (size: number, page: number) => Promise<any> | undefined, totalSize: number, userPage: number): Promise<{
+    data: {
+        data: any[];
+    };
+}>;
+
+/**
+ * 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;
@@ -987,6 +1102,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;
@@ -1135,7 +1252,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
@@ -1163,6 +1283,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: {
@@ -1339,6 +1463,16 @@ export declare const HeaderSectionComponent: FC<Props_12>;
 
 export declare function HomeCard(props: SectionCardProps_3): JSX.Element;
 
+/**
+ * Genera el string HTML de una HomeCard de tipo "imagen" sin pasar por React.
+ * Reemplaza a <HomeCard> para el tipo imagen en LandingTemplate.
+ *
+ * - `priorityHigh` (lo decide el caller) → fetchpriority="high" / loading="eager".
+ *   Por default false → low/lazy.
+ * - Sin espacio extra en la clase homeCardImage cuando no hay preRenderClass.
+ */
+export declare function homeCardImagenToHTMLString(item: NewListResponseData, index: number, paths: RoutePathConfig, share?: Omit<NoteShare, 'googleProfile'>, priorityHigh?: boolean): string;
+
 declare interface ICommonServices {
     config?: Config;
     imgSizes?: any;
@@ -1451,6 +1585,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;
@@ -1465,6 +1601,14 @@ export declare const isHomePath: (pathname?: string) => boolean;
 
 export declare const isPhotoGallery: (news: NewListResponseData) => boolean | undefined;
 
+/**
+ * ¿La ruta tiene batch activo? Precedencia:
+ *  1. `CONFIG_batchedFetch.routes[route]` explícito (true/false) gana.
+ *  2. Retro-compat: el legacy `CONFIG_sectionBatchedFetch` solo cubría `seccion`.
+ *  3. Off por default.
+ */
+export declare function isRouteBatched(route: string): boolean;
+
 export declare class IssuuServices {
     private issuuApi;
     private api;
@@ -1572,17 +1716,56 @@ export declare type LibraryConfig = {
      */
     CONFIG_sectionMetaInfo?: boolean;
     /**
-     * [renderizado] Cuando es `true`, la lista de sección se obtiene con
-     * `batchedNewsFetch` (N fetches paralelos en lugar de uno). Hoy implementado
-     * en el sitio soyfutbol; se formaliza acá como opt-in. Default `false`
-     * → un único fetch (comportamiento de master).
+     * @deprecated Reemplazado por `CONFIG_batchedFetch.routes.seccion`. Se mantiene
+     * como shim de retro-compatibilidad: si `CONFIG_batchedFetch` no está seteado y
+     * este flag es `true`, el batch de sección (solo metadata next/prev) sigue
+     * funcionando con el conteo default. Cuando ambos están, `CONFIG_batchedFetch`
+     * gana. Remover cuando todos los sitios migren a `CONFIG_batchedFetch`.
      */
     CONFIG_sectionBatchedFetch?: boolean;
+    /**
+     * [renderizado] Formaliza el fetch de listas de noticias por batches: divide un
+     * único fetch de `config.newsListLimit` ítems en `batches` fetches paralelos
+     * (páginas contiguas del upstream) y los concatena, devolviendo el MISMO
+     * envelope que un fetch único. Es la versión canónica del sistema que vivía
+     * suelto en soyfutbol (`newsListBatches` + `batchFetchRoutes`).
+     *
+     * - `batches`: número de fetches paralelos por lista. Sin la key (o 1) → un
+     *   único fetch = comportamiento de master (aditivo, cero cambio por default).
+     * - `routes`: opt-in por ruta (`home`/`seccion`/`tema`/`ultimas-noticias`/
+     *   `autor`/...). Solo las rutas en `true` se batchean; el resto hace fetch único.
+     *
+     * Unifica render y metadata: cuando una ruta está activa acá, tanto la lista
+     * visible como la derivación next/prev usan el MISMO `batches`, evitando el
+     * desajuste "next dice que hay más pero la página muestra un solo fetch".
+     * Reemplaza al legacy `CONFIG_sectionBatchedFetch`.
+     */
+    CONFIG_batchedFetch?: {
+        /** N fetches paralelos por lista. Default efectivo 3 si algo lo activa sin fijarlo. */
+        batches?: number;
+        /** Opt-in por ruta. Claves = route keys de `MetadataDefaultsKeys`. */
+        routes?: Record<string, boolean>;
+    };
+    /**
+     * [render] Cuando es `true`, `LandingTemplate` renderiza las cards de tipo
+     * `imagen` con el fast-render HTML-string (`homeCardImagenToHTMLString`) en
+     * lugar del componente React `<HomeCard>`, ahorrando reconciliación/hidratación.
+     * El fast-render se saltea online cuando la URL de preview no es absoluta y
+     * SIEMPRE cae a `<HomeCard>` en offline (el path HTML-string no pasa por el
+     * hidratador de imágenes offline). Default `false` → usa `<HomeCard>` React.
+     */
+    CONFIG_landingFastRender?: boolean;
     CONFIG_deferBanners?: {
         common?: boolean;
         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;
@@ -2335,6 +2518,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) => {
@@ -2745,6 +2934,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 = {
@@ -3005,6 +3196,17 @@ export declare interface ResilientFetchOptions {
     baseDelayMs?: number;
 }
 
+/**
+ * Conteo de batches efectivo leído de `getConfig().CONFIG_batchedFetch.batches`.
+ * Default `3` cuando algo activa el batch sin fijar el número (preserva el
+ * comportamiento histórico del path de metadata, cuyo default era 3).
+ */
+export declare function resolveBatchCount(): 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';
@@ -3015,6 +3217,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 = {
@@ -3309,6 +3518,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;