sass-template-common 0.10.15 → 0.10.17

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

@@ -1165,7 +1165,10 @@ export declare function fetchMaybeBatched(route: string, fetchFn: (size: number,
  * 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 function fetchWithConfigCache<T>(cacheKey: string, fetchFn: () => Promise<T>, options?: number | {
+    ttlMs?: number;
+    shouldCache?: (value: T) => boolean;
+}): Promise<T>;
 
 export declare const Font: ({ config }: {
     config: Config;
@@ -3360,22 +3363,48 @@ export declare type ReportReasonKey = keyof typeof REPORT_REASONS;
 export declare type RequiredGroup = Exclude<keyof ImageSizesContract, 'squareLg'>;
 
 /**
- * Reintenta `fn` con backoff exponencial, acotando cada intento con `timeoutMs`
- * (un fetch a un bucket S3 colgado no debe bloquear el request indefinidamente).
+ * Defaults alineados con AWS SDK JS v3 (`standard` retry + NodeHttpHandler):
+ * - maxAttempts 3 → 1 intento + 2 reintentos (`retries = 2`)
+ * - backoff exponencial con full jitter (base 100ms, cap 20s)
+ * - timeout por intento (SSR): el SDK no lo pone por defecto; acá sí para no
+ *   colgar el render si el bucket no responde. El timeout ESCALA por intento
+ *   (2500 → 5000 → 10000): el primer request de una instancia SSR fría paga
+ *   DNS + TCP + TLS contra S3 y puede superar los 2500ms; sin escalado, los 3
+ *   intentos caen por timeout y la PRIMERA carga se sirve vacía.
+ */
+export declare const RESILIENT_FETCH_DEFAULTS: {
+    readonly retries: 2;
+    readonly timeoutMs: 2500;
+    readonly maxTimeoutMs: 10000;
+    readonly baseDelayMs: 100;
+    readonly maxDelayMs: 20000;
+};
+
+/**
+ * Reintenta `fn` con backoff exponencial + jitter (paridad SDK `standard`),
+ * 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 function resilientFetch<T, F>(fn: () => Promise<T> | T, fallback: F, { label, endpoint, params, retries, timeoutMs, maxTimeoutMs, baseDelayMs, maxDelayMs, }: 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>;
+    /**
+     * Reintentos adicionales tras el primer intento.
+     * Default 2 → 3 intentos totales (paridad con `maxAttempts: 3` del SDK).
+     */
     retries?: number;
+    /** Timeout del PRIMER intento; los reintentos lo duplican hasta `maxTimeoutMs`. */
     timeoutMs?: number;
+    maxTimeoutMs?: number;
     baseDelayMs?: number;
+    maxDelayMs?: number;
 }
 
 /**