sass-template-common 0.10.36 → 0.10.38

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

@@ -203,32 +203,6 @@ export declare const bannersReplace: (bannerLineAd: string, replaces?: {
     [key: string]: string;
 }) => string;
 
-/**
- * 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.
- *
- * `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>;
-
-declare type BatchFetchParams = {
-    fetchFn: (params: Params) => Promise<any> | undefined;
-    baseParams: Params;
-    userPage: number;
-    newsListLimit: number;
-    batchCount?: number;
-};
-
-export declare type BatchFetchResult = {
-    data: any[];
-    hasNextPage: boolean;
-    firstBatchResponse: any;
-};
-
 export declare const becomeVideoObject: (video: VideoResponseData, showtime?: boolean, showsubtitle?: boolean, showauthor?: boolean) => NewListResponseData;
 
 export declare interface BlockSaasResponse {
@@ -865,6 +839,16 @@ export declare const ContentLayout1: FC<Props_24>;
 
 export declare const ContentLayoutTema: FC<Props_38>;
 
+/**
+ * Aviso RUIDOSO de violación de contrato: un campo REQUERIDO por el render llegó
+ * ausente. El componente degrada para no romper el stream SSR (evita el "200 OK +
+ * HTML de Internal Server Error"), pero deja rastro para detectar el agujero.
+ *
+ * NO debería dispararse nunca si el consumidor valida el contrato en su frontmatter
+ * (ver ENTREGABLE-1). Si aparece en los logs, el contrato tiene un hueco.
+ */
+export declare const contractWarn: (component: string, field: string, extra?: unknown) => void;
+
 export declare const createAssessment: ({ projectID, recaptchaKey, token, recaptchaAction, apiKey, userAgent, userIpAddress, }: CreateAssessmentParams) => Promise<number | null>;
 
 /**
@@ -889,25 +873,6 @@ 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 {
@@ -1177,18 +1142,6 @@ 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.
@@ -1778,14 +1731,6 @@ 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;
@@ -1891,37 +1836,6 @@ export declare type LibraryConfig = {
     CONFIG_videoClipUrl?: string;
     CONFIG_newNoteBannersIndexing?: boolean;
     CONFIG_buscar_html?: boolean;
-    /**
-     * @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
@@ -3465,13 +3379,6 @@ export declare interface ResilientFetchOptions {
     maxDelayMs?: 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;
 
 /**