sass-template-common 0.9.240 → 0.10.0

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

@@ -497,7 +497,11 @@ export declare class CommonServices {
     }, any, {}>> | undefined;
     getMainMenu: (params: Params) => Promise<AxiosResponse<{
         data: Array<MenuResponse>;
-    }, any, {}>> | undefined;
+    }, 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;
@@ -523,16 +527,20 @@ export declare class CommonServices {
     }, any, {}>> | undefined;
     getBanners: (params: Params) => Promise<AxiosResponse<{
         data: Array<BannerResponse>;
-    }, any, {}> | undefined>;
+    }, 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>;
@@ -553,9 +561,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>;
@@ -908,6 +914,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 {
@@ -2974,6 +2986,25 @@ 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 interface RoutePathConfig {
     autor: string | 'autor';
     tema: string | 'tema';