sass-template-common 0.10.13 → 0.10.15

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

@@ -244,10 +244,53 @@ export declare type BucketOriginConfig = {
     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. */
+    /**
+     * Sirve el menú (sidebar/menu/footer/freeZone/cintillo + equipos/sites) desde
+     * el bucket. Con el toggle ON, SIN fallback a CMS: si el bucket agota los 4
+     * intentos, se sirve vacío + registro en el debugPanel (`reportBucketOriginExhausted`).
+     */
     menu?: boolean;
-    /** Sirve los banners (home/seccion/nota) desde el bucket. */
+    /**
+     * Sirve los banners (home/seccion/nota) desde el bucket. Con el toggle ON, SIN
+     * fallback a CMS: si el bucket agota los 4 intentos, se sirve vacío + registro
+     * en el debugPanel.
+     */
     banners?: boolean;
+    /**
+     * [transicional] Sirve la config de los slots dinámicos de home
+     * (`bloques/modulos-dinamicos/modulos-dinamicos.json`) desde el bucket en
+     * lugar del fan-out N contra `/config/blocks-saas`. Toggle de migración: al
+     * pasar todos los sitios a `true`, la rama legacy CMS se elimina y el toggle
+     * queda no-op (luego se remueve). El JSON keyea plano `Home_N` (sin subíndices);
+     * cada entry se resuelve con `resolveSlotContent` (content-fetch al CMS igual
+     * que legacy). SIN fallback de CONFIG a CMS: con el toggle ON el bucket es el
+     * método único; si agota los 4 intentos, los slots se sirven vacíos y se
+     * registra en el debugPanel (`reportBucketOriginExhausted`) para notar la falla.
+     * El fan-out CMS solo corre con el toggle OFF (sitios sin migrar).
+     * Ver `PLAN_DYNAMIC_SLOTS_BUCKET_ORIGIN.md` §4.3/§7.
+     */
+    slots?: boolean;
+    /**
+     * [transicional] Sirve la config del destacado dinámico
+     * (`bloques/destacado/destacado.json`) desde el bucket en lugar de
+     * `/config/blocks`. Es drop-in de TRANSPORTE (mismo `.data.data` que el CMS).
+     * ⚠ CONTRATO (verificado contra un sitio CMS funcional, golfo): el LAYOUT del
+     * destacado va en `data[0].block`, que debe ser uno de los 5 nombres de layout
+     * (`Diario` | `Diario con imagen` | `Super` | `3 notas verticales` |
+     * `3 notas horizontales`) — es la key que consume `DynamicMainSlot` vía el prop
+     * `component`. Los campos `value`/`size`/`title`/`link` NO los usa el destacado
+     * (en el CMS vuelven como tokens sin rellenar) → se ignoran. (Nota: existe
+     * `getMainBlockData`, que lee `value` contra `GetByOptions`, pero es otra ruta
+     * que el render vivo de golfo no usa.)
+     * El CONTENIDO (las notas) SIEMPRE sale del CMS (zona `destacadas`, sección
+     * provista por la app) — permanente, no transicional: este toggle solo mueve el
+     * ORIGEN DE LA CONFIG (bucket vs CMS), nunca el contenido. SIN fallback de CONFIG
+     * a CMS: con el toggle ON el bucket es el método único; si agota los 4 intentos,
+     * el destacado se sirve vacío y se registra en el debugPanel (`reportBucketOriginExhausted`).
+     * El CMS solo sirve la config con el toggle OFF (sitios sin migrar).
+     * Ver `PLAN_DYNAMIC_SLOTS_BUCKET_ORIGIN.md` §4.4/§7.
+     */
+    destacado?: boolean;
     /**
      * Referer exigido por la bucket policy (`aws:Referer`). Sin este header el
      * bucket devuelve 403 aunque la ruta/archivo exista. Default: el mismo
@@ -532,9 +575,7 @@ export declare class CommonServices {
     getEntitySection: (params: Params) => Promise<AxiosResponse<{
         data: Array<NewListResponse>;
     }, any, {}>> | undefined;
-    getMainMenu: (params: Params) => Promise<AxiosResponse<{
-        data: Array<MenuResponse>;
-    }, any, {}> | {
+    getMainMenu: (params: Params) => Promise<{
         data: {
             data: Array<MenuResponse>;
         };
@@ -562,9 +603,7 @@ export declare class CommonServices {
     getVideosList: (params: Params) => Promise<AxiosResponse<{
         data: Array<VideoResponseData>;
     }, any, {}>> | undefined;
-    getBanners: (params: Params) => Promise<AxiosResponse<{
-        data: Array<BannerResponse>;
-    }, any, {}> | {
+    getBanners: (params: Params) => Promise<{
         data: {
             data: Array<BannerResponse>;
         };
@@ -1008,9 +1047,28 @@ export declare class DynamicBlockServices extends CommonServices {
     } | {
         blockSass: BlockSaasResponse[] | undefined;
     }>;
+    /**
+     * Dada la config de UN slot (`BlockSaasResponse[]`, se usa `[0]`), dispara el
+     * content-fetch que corresponda (`videos`/`tag`/`seccion`) y devuelve
+     * `{ blockSass, content? }`. Extraído de `getBlockSass` para reusarse tanto
+     * desde la rama legacy (CMS `/config/blocks-saas`) como desde la rama de
+     * bucket (`modulos-dinamicos.json`, ver `getDynamicSlotsFromBucket`): el
+     * origen del array cambia, el resto de la resolución de contenido no.
+     */
+    resolveSlotContent: (blockSassData: Array<BlockSaasResponse> | undefined) => Promise<{
+        blockSass: BlockSaasResponse[];
+        content: {
+            data: Array<VideoResponseData>;
+        } | undefined;
+    } | {
+        blockSass: BlockSaasResponse[];
+        content: NewListResponse | undefined;
+    } | {
+        blockSass: BlockSaasResponse[] | undefined;
+    }>;
 }
 
-export declare const DynamicComponents: ({ slots, DYNAMIC_SLOT_SUBINDEXES, stylesConfig, AutorIcon, config, banners, showTagBySection, pathname, }: Props_21) => JSX.Element[];
+export declare const DynamicComponents: ({ slots, DYNAMIC_SLOT_SUBINDEXES, stylesConfig, AutorIcon, config, banners, showTagBySection, pathname, }: Props_21) => ReactNode[];
 
 export declare const DynamicMainSlot: ({ component, data, banners, rightOnlyBanner, isHome, }: Props_20) => JSX.Element;
 
@@ -1595,12 +1653,12 @@ export declare interface ImageSizesContract {
         cardTall: SizeString;
         square: SizeString;
         gallery: SizeString;
-        featuredSuperSecondary: SizeString;
-        featuredVerticalPrimary: SizeString;
-        featuredVerticalSecondary: SizeString;
-        featuredHorizontalPrimary: SizeString;
-        featuredHorizontalSecondary: SizeString;
-        featuredDiarioImageThumb: SizeString;
+        featuredSuperSecondary?: SizeString;
+        featuredVerticalPrimary?: SizeString;
+        featuredVerticalSecondary?: SizeString;
+        featuredHorizontalPrimary?: SizeString;
+        featuredHorizontalSecondary?: SizeString;
+        featuredDiarioImageThumb?: SizeString;
     };
     author: {
         avatar: SizeString;
@@ -1914,6 +1972,12 @@ export declare type LibraryConfig = {
      * comportamiento no cambia (sigue yendo al CMS). Si un archivo no existe
      * en el bucket para un sitio/tipo dado, el request falla simple (sin
      * fallback automático al CMS) — igual que cualquier otro fetch fallido.
+     *
+     * [offline] Cuando `PUBLIC_IS_OFFLINE === 'true'`, todos los archivos de bucket
+     * se leen de la subcarpeta `offline/` del mismo directorio
+     * (`.../${subtype}/offline/${subtype}.json`) y, si fallan tras agotar
+     * reintentos, NO caen al CMS ni al archivo online: se devuelve vacío. Ver
+     * `resolveBucketOriginUrl`.
      */
     BUCKET_ORIGIN?: BucketOriginConfig;
 };
@@ -1985,9 +2049,11 @@ export declare class MainComponentServices {
     readonly contract: ImageSizesContract;
     constructor(config: Config, imgSizes: any, axiosApi: AxiosInstance, exclude?: string, customMainImagesSizes?: string, imageSizes?: ImageSizesContractInput);
     getNewsListZone(params: Params): Promise<AxiosResponse<NewListResponse, any, {}> | undefined>;
-    getOutstandingBlock(params: Params): Promise<AxiosResponse<    {
-    data: Array<Outstanding>;
-    }, any, {}> | undefined>;
+    getOutstandingBlock(params: Params): Promise<{
+        data: {
+            data: Array<Outstanding>;
+        };
+    } | undefined>;
     getNewsListZoneWrapper(section: string, size: number, imagesizes?: string): Promise<AxiosResponse<NewListResponse, any, {}> | undefined>;
     getNewsDestacadoDiario(section: string): Promise<never[] | AxiosResponse<NewListResponse, any, {}>>;
     getNewsDestacadoDiarioImage(section: string): Promise<never[] | AxiosResponse<NewListResponse, any, {}>>;
@@ -3251,6 +3317,18 @@ export declare const REPORT_REASONS: {
     readonly bullying: "Bullying o acoso";
 };
 
+/**
+ * Registra en el **debugPanel** (`DebugStore`, gated por `DEBUG_ENABLED`) que un
+ * recurso de `BUCKET_ORIGIN` agotó los reintentos. En un sitio con el toggle
+ * prendido, el bucket es el MÉTODO ÚNICO: NO se cae al CMS (eso solo pasa con el
+ * toggle OFF, en sitios sin migrar). El recurso se sirve VACÍO y esta entrada
+ * deja constancia explícita del "servido vacío, sin fallback" para que la falla
+ * se NOTE en el panel en vez de quedar enmascarada. (El fallo de red crudo ya lo
+ * registra `resilientFetch`; esta entrada agrega la decisión de no-fallback.)
+ * Ver `PLAN_DYNAMIC_SLOTS_BUCKET_ORIGIN.md` §7.
+ */
+export declare function reportBucketOriginExhausted(kind: string, url: string): void;
+
 export declare function reportComment({ publication, username, id, type, baseUrl, captchaToken, apiToken, securityToken, COMMENTS_VARS, }: ReportCommentParams): Promise<{
     type: string;
     message: string;
@@ -3275,9 +3353,9 @@ export declare type ReportReasonKey = keyof typeof REPORT_REASONS;
 /**
  * Grupos requeridos del contrato: los que `resolveImageSizes` completa con el
  * default congelado y el assert exige enteros. Los slots OPCIONALES sin default
- * (como `squareLg`) se excluyen a mano — no participan del merge ni del assert
- * obligatorio. Derivado (no hardcode) para que un grupo requerido nuevo entre
- * solo y siga cubierto por el guard de completitud.
+ * obligatorio (`squareLg` a nivel raíz, `featured*` dentro de `note`) se manejan
+ * aparte — no participan del assert obligatorio. Derivado (no hardcode) para que
+ * un grupo requerido nuevo entre solo y siga cubierto por el guard de completitud.
  */
 export declare type RequiredGroup = Exclude<keyof ImageSizesContract, 'squareLg'>;
 
@@ -3309,7 +3387,18 @@ 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;
+/**
+ * Arma la URL del recurso en el bucket:
+ * `${base}/${clientName}/${site}/${type}/${subtype}/${subtype}.json`.
+ *
+ * En modo offline (`PUBLIC_IS_OFFLINE === 'true'`) el consumidor pasa
+ * `offline = true` y el archivo se resuelve dentro de la subcarpeta `offline/`
+ * del MISMO directorio: `.../${subtype}/offline/${subtype}.json`. La variante
+ * offline es un archivo aparte que convive con el de producción
+ * (`.../${subtype}/${subtype}.json`); el consumidor NO cae al CMS ni al archivo
+ * online si la offline falla (ver getMainMenu/getBanners/getDynamicSlots/destacado).
+ */
+export declare function resolveBucketOriginUrl(bucket: BucketOriginConfig, servicePrefix: string | undefined, type: 'menu' | 'banners' | 'bloques', subtype: string, offline?: boolean): string;
 
 /**
  * Recibe lo que el app mande hoy (contrato completo, parcial, o nada) y