sass-template-common 0.10.39 → 0.10.41

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

@@ -220,7 +220,8 @@ export declare interface BlockSaasResponseData {
 }
 
 /**
- * Ruta del recurso en el bucket: `${clientName}/${servicePrefix}/${type}/${subtype}/${subtype}.json`.
+ * Ruta del recurso en el bucket: `${clientName}/${site}/${type}/${subtype}/${subtype}.json`,
+ * donde `site` = `forceSite` ?? `servicePrefix` ?? `clientName` (ver `forceSite`).
  * `subtype` se deriva en runtime (nombre del archivo de menú sin `.html`, o el
  * `template` de banners en minúscula) — no forma parte de esta config.
  */
@@ -288,10 +289,20 @@ export declare type BucketOriginConfig = {
      */
     referer?: string;
     /**
-     * Segmento de sitio a usar en la ruta del bucket cuando el sitio no tiene
-     * `servicePrefix` (ej. soyfutbol). Sin este valor, y sin `servicePrefix`,
-     * se usa `clientName` como fallback para que la ruta quede bien formada
-     * (ej. `debate/debate/menu/...` en vez de `debate//menu/...`).
+     * Segmento de sitio a usar en la ruta del bucket. Es un OVERRIDE explícito:
+     * si está definido GANA sobre `PUBLIC_SERVICE_PREFIX`. Orden de resolución:
+     * `forceSite` > `servicePrefix` > `clientName`.
+     *
+     * Sirve para dos casos:
+     * 1. Sitios sin `servicePrefix` (ej. soyfutbol): evita que la ruta quede mal
+     *    formada (`debate//menu/...`) cayendo a `clientName`.
+     * 2. Sitios cuyo `servicePrefix` NO coincide con el segmento del bucket
+     *    (ej. vader-en: `PUBLIC_SERVICE_PREFIX=en` porque así lo pide el CMS, pero
+     *    en el bucket el sitio es `vaderen`). El prefix no se puede tocar porque lo
+     *    consume `getServicePrefix` para armar las URLs del CMS, así que `forceSite`
+     *    es la única salida.
+     *
+     * Ver `resolveBucketOriginUrl`.
      */
     forceSite?: string;
     /**