sass-template-common 0.10.41 → 0.11.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

@@ -853,20 +853,8 @@ export declare const ContentLayoutTema: FC<Props_38>;
  */
 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>;
+export declare const createAssessment: ({ projectID, recaptchaKey, token, recaptchaAction, apiKey, userAgent, userIpAddress, config, }: CreateAssessmentParams) => Promise<number | null>;
 
-/**
- * Crea una evaluación para analizar el riesgo de una acción de la IU.
- * Usa la API REST de reCAPTCHA Enterprise (sin SDK, ~12MB menos en deploy).
- *
- * projectID: El ID del proyecto de Google Cloud.
- * recaptchaKey: La clave reCAPTCHA (site key) asociada con el sitio.
- * token: El token generado obtenido del cliente.
- * recaptchaAction: El nombre de la acción que corresponde al token.
- * apiKey: API key de Google Cloud para autenticar la petición REST.
- * userAgent: (opcional) User-Agent del request para mejor detección.
- * userIpAddress: (opcional) IP del usuario para mejor detección.
- */
 declare interface CreateAssessmentParams {
     projectID: string;
     recaptchaKey: string;
@@ -875,6 +863,7 @@ declare interface CreateAssessmentParams {
     apiKey: string;
     userAgent?: string;
     userIpAddress?: string;
+    config?: Pick<LibraryConfig, 'CONFIG_blockRecaptcha'>;
 }
 
 export declare const cutString: (text: string, length?: number) => string;
@@ -1328,9 +1317,11 @@ export declare function getBucketHttpClient(baseUrl: string, referer: string): A
  * <script src="https://www.google.com/recaptcha/enterprise.js?render=your_site_key"></script>
  * @param captchaAction Nombre de la acción para el captcha
  * @param siteKey La clave del sitio para el captcha
+ * @param config Config del sitio (prop `API_ENV`) para leer el kill switch
+ *   `CONFIG_blockRecaptcha`. Si se omite se cae al singleton de `initLibrary`.
  * @returns Una promesa que se resuelve con el token del captcha
  */
-export declare const getCaptchaToken: (captchaAction: captchaActionType, siteKey: string) => Promise<string>;
+export declare const getCaptchaToken: (captchaAction: captchaActionType, siteKey: string, config?: Pick<LibraryConfig, "CONFIG_blockRecaptcha">) => Promise<string>;
 
 export declare function getComments({ publication, path, size, sizereply, id, lastid, state, apiToken, API_ENV, }: GetCommentsParams): Promise<any>;
 
@@ -1735,6 +1726,21 @@ export declare const isHomePath: (pathname?: string) => boolean;
 
 export declare const isPhotoGallery: (news: NewListResponseData) => boolean | undefined;
 
+/**
+ * ¿reCAPTCHA está desactivado? Fuente ÚNICA del kill switch
+ * `CONFIG_blockRecaptcha`; la consumen todos los puntos de uso de reCAPTCHA de
+ * la librería (script enterprise, widget v2, generación de token y las tres
+ * verificaciones server-side).
+ *
+ * `cfg` explícito (típicamente el prop `API_ENV` de un componente cliente, o
+ * las `COMMENTS_VARS` de un endpoint) GANA sobre el singleton de `initLibrary`,
+ * que se usa como fallback: en el cliente el singleton puede no estar poblado
+ * porque cada isla hidrata su propio grafo de módulos.
+ *
+ * Default `false` cuando nadie define el flag → comportamiento actual.
+ */
+export declare function isRecaptchaBlocked(cfg?: Pick<LibraryConfig, 'CONFIG_blockRecaptcha'>): boolean;
+
 export declare class IssuuServices {
     private issuuApi;
     private api;
@@ -1889,6 +1895,35 @@ export declare type LibraryConfig = {
     CAPTCHA_KEY?: string;
     COMMENTS_CAPTCHA_API_KEY?: string;
     CAPTCHA_KEY_V2?: string;
+    /**
+     * [kill switch] Desactiva TODOS los usos de reCAPTCHA de la librería en un
+     * solo lugar. Con `true`:
+     *
+     * - no se inyecta el script de enterprise (`ReCaptchaRender`,
+     *   `CommentLazyLoader`),
+     * - no se renderiza el widget v2 (`FormActions`, `ReportPop`),
+     * - `getCaptchaToken` NO toca `window.grecaptcha` y devuelve el sentinel
+     *   `RECAPTCHA_DISABLED_TOKEN`,
+     * - las verificaciones server-side (`createAssessment`,
+     *   `verifyCaptchaToken`, `verifyCaptchaTokenEnterprise`) cortan antes del
+     *   fetch a Google y devuelven "pasó" (score 1 / `true`),
+     * - la validación de forms (`isFormValid`) deja de exigir token.
+     *
+     * Default `false`: el comportamiento es EXACTAMENTE el actual, así que subir
+     * de versión sin declarar el flag no cambia nada en ningún repo (el flag es
+     * puramente aditivo y retro-compatible).
+     *
+     * Es un flag de SEGURIDAD: en `true` los endpoints quedan sin protección
+     * anti-bot, así que se usa para desbloquear un sitio (keys mal
+     * configuradas, cuota agotada, captcha rompiendo el flujo), no como default.
+     *
+     * Los componentes cliente lo leen del prop `API_ENV` (el singleton de
+     * `initLibrary` no está garantizado en cada isla de hidratación), por eso hay
+     * que incluir `CONFIG_blockRecaptcha` en el `API_ENV_KEYS` de cada sitio que
+     * pase config al cliente. Los helpers server-side lo leen del singleton, o
+     * del parámetro explícito cuando lo reciben.
+     */
+    CONFIG_blockRecaptcha?: boolean;
     SHOW_TAG_BY_SECTION?: boolean;
     FETCH_SIZE_MORE_NEWS?: number;
     FETCH_SIZE_RELATED_NEWS?: number;
@@ -1998,9 +2033,11 @@ export declare class MainComponentServices {
     config: any;
     /**
      * @deprecated Ya no se lee: los tamaños salen de `this.contract` (§3). Bigfish
-     * pasa `imgSizesVideo` acá (quirk documentado en el snapshot de Fase 0), por eso
-     * `this.imgSizes.lg` valía `video.lg`; ahora eso se expresa como `contract.video.lg`.
-     * Se mantiene el parámetro posicional por retrocompat hasta Fase 3.
+     * pasaba `imgSizesVideo` acá (quirk documentado en el snapshot de Fase 0), por
+     * eso `this.imgSizes.lg` resolvía a `video.lg` dentro de los destacados. Ese
+     * quirk quedó saldado: los destacados son de NOTAS y hoy leen slots de
+     * `contract.note` (ver cada getter). Se mantiene el parámetro posicional por
+     * retrocompat hasta Fase 3.
      */
     imgSizes: any;
     configVersion: string;
@@ -2671,6 +2708,7 @@ declare type PrefixConfig = {
     PUBLIC_SERVICE_PREFIX?: string;
     PUBLIC_IS_SUB_PUBLICATION?: string;
     FORCE_SUB_PUBLICATION_PREFIX?: string;
+    LINK_REMOVE?: string;
 };
 
 export declare interface PreloadImage {
@@ -2807,6 +2845,8 @@ declare type Props_14 = {
         COGNITO_AUTH_PREFIX: string;
         PUBLIC_ENV: string;
         CAPTCHA_KEY: string;
+        /** Kill switch de reCAPTCHA. Sin definir: captcha activo (como hoy). */
+        CONFIG_blockRecaptcha?: boolean;
         PUBLIC_SERVICE_PREFIX?: string;
         PUBLIC_IS_SUB_PUBLICATION?: string;
         FORCE_SUB_PUBLICATION_PREFIX?: string;
@@ -2820,6 +2860,8 @@ declare type Props_15 = {
         COGNITO_AUTH_PREFIX: string;
         PUBLIC_ENV: string;
         CAPTCHA_KEY: string;
+        /** Kill switch de reCAPTCHA. Sin definir: captcha activo (como hoy). */
+        CONFIG_blockRecaptcha?: boolean;
     };
     termsAndConditionsUrl?: string;
 };
@@ -3239,9 +3281,17 @@ declare type Props_9 = {
 
 export declare const Readest: FC<Props_29>;
 
+/**
+ * Token que devuelve `getCaptchaToken` cuando reCAPTCHA está desactivado por
+ * `CONFIG_blockRecaptcha`. Es un placeholder no vacío a propósito: los call
+ * sites cortan con "Captcha token no generado" ante un token falsy, y el
+ * server ni lo mira porque su verificación también está gateada por el flag.
+ */
+export declare const RECAPTCHA_DISABLED_TOKEN = "recaptcha-disabled";
+
 export declare const ReCaptchaRender: ({ defaultRouteName }: {
     defaultRouteName: string;
-}) => false | "" | JSX.Element | undefined;
+}) => false | "" | JSX.Element | null | undefined;
 
 export declare function RegisterForm({ texts, API_ENV, termsAndConditionsUrl }: Props_15): JSX.Element;
 
@@ -3797,11 +3847,22 @@ export declare const toISOWithTimeZone: (value: number | string, timeZone: strin
  * front prefix público. Se arma: origin público + front prefix + path sin el
  * service prefix. El origin ajeno queda normalizado como efecto.
  *
+ * IMPORTANTE — el swap sólo se habilita si el sitio DECLARA que el service
+ * prefix es un namespace interno, vía front prefix (`FORCE_SUB_PUBLICATION_PREFIX`
+ * / `PUBLIC_IS_SUB_PUBLICATION`) o vía `LINK_REMOVE` apuntando al mismo prefijo.
+ * Sin esa declaración el "swap" degeneraría en un BORRADO de segmento, y el
+ * nombre del service prefix puede coincidir con el de una sección real: en
+ * `futbol.radioformula.com.mx` (`PUBLIC_SERVICE_PREFIX=futbol`, sin front
+ * prefix) el canonical `.../futbol/nota.html` apunta a la sección `/futbol`,
+ * no a un namespace filtrado, y reescribirlo rompía la URL.
+ *
  * Todo lo demás se devuelve sin tocar → retrocompatible:
  *   - URL ya correcta (path bajo `/en`, no bajo `/soyfutbolen`),
  *   - canónica cross-domain intencional de contenido sindicado (path NO bajo
  *     el service prefix),
  *   - publicación principal (sin service prefix → return temprano),
+ *   - sitio con service prefix pero sin front prefix ni `LINK_REMOVE` (no hay
+ *     namespace interno declarado → return temprano),
  *   - subpublicación directa (`frontPrefix === servicePrefix`: el swap deja el
  *     path igual y el origin ya es el propio → no-op).
  *
@@ -3875,14 +3936,17 @@ export declare const validateHttpUrl: (url: string) => string;
  * @param projectId El ID del proyecto de Google Cloud
  * @param captchaKey La clave del sitio de reCAPTCHA
  * @param captchaAction El nombre de la acción que corresponde al token
+ * @param config Config del sitio para leer el kill switch
+ *   `CONFIG_blockRecaptcha`. Si se omite se cae al singleton de `initLibrary`.
  * @returns Una promesa que se resuelve con la puntuación de riesgo
  */
-export declare const verifyCaptchaTokenEnterprise: ({ token, projectId, captchaKey, apiKey, captchaAction, }: {
+export declare const verifyCaptchaTokenEnterprise: ({ token, projectId, captchaKey, apiKey, captchaAction, config, }: {
     token: string;
     projectId: string;
     captchaKey: string;
     apiKey: string;
     captchaAction: captchaActionType;
+    config?: Pick<LibraryConfig, "CONFIG_blockRecaptcha">;
 }) => Promise<number>;
 
 export declare const VideoBlock3: FC<Props_35>;