@bacano/sdk 1.2.5 → 1.2.7

package/react.cjs

@@ -259,6 +259,12 @@ var GET_PRODUCTS = (
       id
       name
       description
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
       long_description
       slug
       seo_title
@@ -494,6 +500,12 @@ var GET_PRODUCT_BY_PK = (
       limit: 1
     ) {
       id
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
       product_option_group_members(limit: 1) {
         group {
           id
@@ -743,6 +755,12 @@ var GET_PRODUCT_SEO_ENTRIES = (
       id
       name
       slug
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
       seo_title
       seo_description
       seo_image_file_id
@@ -2376,6 +2394,7 @@ var GET_PRODUCT_FILTERS = (
   query GetProductFilters(
     $companyId: uuid!
     $chainId: uuid!
+    $websiteId: uuid!
     $where: products_bool_exp = {}
     $attributeListKey: String!
   ) {
@@ -2383,6 +2402,12 @@ var GET_PRODUCT_FILTERS = (
       where: {
         _and: [
           { company_id: { _eq: $companyId } }
+          {
+            product_website_publications: {
+              website_id: { _eq: $websiteId }
+              is_visible: { _eq: true }
+            }
+          }
           {
             chain_products: {
               chain_id: { _eq: $chainId }
@@ -2395,6 +2420,12 @@ var GET_PRODUCT_FILTERS = (
       }
     ) {
       id
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
       category
       subcategory
       color
@@ -2502,6 +2533,7 @@ var GET_SEARCH_SUGGESTIONS = (
   query GetSearchSuggestions(
     $companyId: uuid!
     $chainId: uuid!
+    $websiteId: uuid!
     $term: String!
     $productLimit: Int = 5
     $brandLimit: Int = 3
@@ -2509,6 +2541,10 @@ var GET_SEARCH_SUGGESTIONS = (
     products(
       where: {
         company_id: { _eq: $companyId }
+        product_website_publications: {
+          website_id: { _eq: $websiteId }
+          is_visible: { _eq: true }
+        }
         chain_products: {
           chain_id: { _eq: $chainId }
           is_enabled: { _eq: true }
@@ -2521,6 +2557,29 @@ var GET_SEARCH_SUGGESTIONS = (
     ) {
       id
       name
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
+      product_variants(where: { is_disabled: { _eq: false } }) {
+        id
+        product_variant_prices(
+          where: {
+            price_type: { _eq: CLIENT }
+            _or: [
+              { chain_id: { _eq: $chainId } }
+              { chain_id: { _is_null: true } }
+            ]
+          }
+        ) {
+          id
+          price
+          price_type
+          chain_id
+        }
+      }
     }
     brands(
       where: {
@@ -3002,6 +3061,7 @@ function mapProduct(raw, storageUrl, labels, chainId) {
     createdAt: raw.created_at,
     updatedAt: raw.updated_at ?? raw.created_at,
     variants,
+    outOfStockVisibilityOverride: raw.product_website_publications?.[0]?.show_when_out_of_stock ?? null,
     detailVariants,
     media: raw.product_media.map((m) => mapMedia(m, storageUrl)),
     attributes: raw.product_attributes.map(
@@ -3363,7 +3423,7 @@ async function getWebsiteAvailabilityByVariantId(graphqlUrl, getHeaders, variant
   }
   return availabilityByVariantId;
 }
-async function filterProductsForWebsiteStock(graphqlUrl, getHeaders, products, chainId, websiteId) {
+async function filterProductsForWebsiteStock(graphqlUrl, getHeaders, products, chainId, websiteId, showOutOfStockByDefault = false, onlyInStock = false) {
   const variantIds = products.flatMap(
     (product) => product.variants.map((variant) => variant.id)
   );
@@ -3389,11 +3449,11 @@ async function filterProductsForWebsiteStock(graphqlUrl, getHeaders, products, c
         pricing: resolveProductPricing(prices)
       };
     }).filter(
-      (variant) => inStockVariantIds.has(variant.id) && variant.pricing.currentPrice != null
+      (variant) => (inStockVariantIds.has(variant.id) || !onlyInStock && (product.outOfStockVisibilityOverride ?? showOutOfStockByDefault)) && variant.pricing.currentPrice != null
     )
   })).filter((product) => product.variants.length > 0);
 }
-async function filterSeoProductsForWebsiteStock(graphqlUrl, getHeaders, products, chainId, websiteId) {
+async function filterSeoProductsForWebsiteStock(graphqlUrl, getHeaders, products, chainId, websiteId, showOutOfStockByDefault = false) {
   const variantIds = products.flatMap(
     (product) => product.product_variants.map((variant) => variant.id)
   );
@@ -3415,7 +3475,7 @@ async function filterSeoProductsForWebsiteStock(graphqlUrl, getHeaders, products
       const pricing = resolveProductPricing(
         selectPublicPrices(prices, chainId)
       );
-      return inStockVariantIds.has(variant.id) && pricing.currentPrice != null;
+      return (inStockVariantIds.has(variant.id) || (product.product_website_publications?.[0]?.show_when_out_of_stock ?? showOutOfStockByDefault)) && pricing.currentPrice != null;
     })
   );
 }
@@ -3486,7 +3546,8 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
       getHeaders,
       [mappedProduct],
       ctx.chainId,
-      ctx.websiteId
+      ctx.websiteId,
+      ctx.config?.show_out_of_stock_products === true
     );
     if (!filteredProducts[0]) return null;
     const specifications = await loadProductSpecifications([product.id]);
@@ -3719,7 +3780,8 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
         getHeaders,
         data.products ?? [],
         ctx.chainId,
-        ctx.websiteId
+        ctx.websiteId,
+        ctx.config?.show_out_of_stock_products === true
       );
       const entries = availableProducts.slice(0, limit).map((product) => mapProductSeoEntry(product, storageUrl)).filter((entry) => Boolean(entry));
       return {
@@ -3796,7 +3858,9 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
           (p) => mapProduct(p, storageUrl, publicAttributeLabels, chainId)
         ),
         chainId,
-        ctx.websiteId
+        ctx.websiteId,
+        ctx.config?.show_out_of_stock_products === true,
+        opts?.inStock === true
       );
       const specifications = await loadProductSpecifications(
         products.map((product) => product.id)
@@ -3903,6 +3967,7 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
           {
             companyId: ctx.companyId,
             chainId,
+            websiteId: ctx.websiteId,
             attributeListKey: DEFAULT_FILTER_ATTRIBUTE_LIST_KEY,
             where: buildProductWhere(opts.filters ?? {}, chainId)
           },
@@ -3926,7 +3991,7 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
               variant.product_variant_prices.map(mapPrice),
               chainId
             );
-            return prices.length > 0 && (availabilityByVariantId.get(variant.id)?.inStock ?? false);
+            return prices.length > 0 && ((availabilityByVariantId.get(variant.id)?.inStock ?? false) || (product.product_website_publications?.[0]?.show_when_out_of_stock ?? ctx.config?.show_out_of_stock_products === true));
           });
           if (!hasVisibleVariant) continue;
           applicableCategories.add(product.category);
@@ -4014,6 +4079,7 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
         {
           companyId: ctx.companyId,
           chainId,
+          websiteId: ctx.websiteId,
           attributeListKey: opts?.attributeListKey ?? DEFAULT_FILTER_ATTRIBUTE_LIST_KEY,
           where: {
             ...opts?.categoryName ? { category: { _eq: opts.categoryName } } : {},
@@ -4068,7 +4134,9 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
             chainId
           ),
           inStock: availabilityByVariantId.get(variant.id)?.inStock ?? false
-        })).filter((variant) => variant.inStock && variant.prices.length > 0);
+        })).filter(
+          (variant) => (variant.inStock || (product.product_website_publications?.[0]?.show_when_out_of_stock ?? ctx.config?.show_out_of_stock_products === true)) && variant.prices.length > 0
+        );
         if (visibleVariants.length === 0) continue;
         categoryCounts.set(
           product.category,
@@ -4153,6 +4221,7 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
           "NO_CHAIN"
         );
       }
+      const chainId = ctx.chainId;
       const term = `%${opts.query}%`;
       const limit = opts.limit ?? 8;
       const data = await executeGraphQL(
@@ -4160,7 +4229,8 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
         GET_SEARCH_SUGGESTIONS,
         {
           companyId: ctx.companyId,
-          chainId: ctx.chainId,
+          chainId,
+          websiteId: ctx.websiteId,
           term,
           productLimit: Math.min(limit, 5),
           brandLimit: Math.max(limit - 5, 3)
@@ -4168,8 +4238,29 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
         getHeaders
       );
       const suggestions = [];
+      const availability = await getWebsiteAvailabilityByVariantId(
+        graphqlUrl,
+        getHeaders,
+        (data.products ?? []).flatMap(
+          (product) => product.product_variants.map((variant) => variant.id)
+        ),
+        chainId,
+        ctx.websiteId
+      );
       for (const p of data.products ?? []) {
-        suggestions.push({ type: "product", text: p.name, id: p.id });
+        const showWithoutStock = p.product_website_publications?.[0]?.show_when_out_of_stock ?? ctx.config?.show_out_of_stock_products === true;
+        const isVisible = p.product_variants.some((variant) => {
+          const hasPrice = resolveProductPricing(
+            selectPublicPrices(
+              variant.product_variant_prices.map(mapPrice),
+              chainId
+            )
+          ).currentPrice != null;
+          return hasPrice && (showWithoutStock || availability.get(variant.id)?.inStock === true);
+        });
+        if (isVisible) {
+          suggestions.push({ type: "product", text: p.name, id: p.id });
+        }
       }
       for (const b of data.brands ?? []) {
         suggestions.push({ type: "brand", text: b.name, id: b.id });

package/react.js

@@ -202,6 +202,12 @@ var GET_PRODUCTS = (
       id
       name
       description
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
       long_description
       slug
       seo_title
@@ -437,6 +443,12 @@ var GET_PRODUCT_BY_PK = (
       limit: 1
     ) {
       id
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
       product_option_group_members(limit: 1) {
         group {
           id
@@ -686,6 +698,12 @@ var GET_PRODUCT_SEO_ENTRIES = (
       id
       name
       slug
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
       seo_title
       seo_description
       seo_image_file_id
@@ -2319,6 +2337,7 @@ var GET_PRODUCT_FILTERS = (
   query GetProductFilters(
     $companyId: uuid!
     $chainId: uuid!
+    $websiteId: uuid!
     $where: products_bool_exp = {}
     $attributeListKey: String!
   ) {
@@ -2326,6 +2345,12 @@ var GET_PRODUCT_FILTERS = (
       where: {
         _and: [
           { company_id: { _eq: $companyId } }
+          {
+            product_website_publications: {
+              website_id: { _eq: $websiteId }
+              is_visible: { _eq: true }
+            }
+          }
           {
             chain_products: {
               chain_id: { _eq: $chainId }
@@ -2338,6 +2363,12 @@ var GET_PRODUCT_FILTERS = (
       }
     ) {
       id
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
       category
       subcategory
       color
@@ -2445,6 +2476,7 @@ var GET_SEARCH_SUGGESTIONS = (
   query GetSearchSuggestions(
     $companyId: uuid!
     $chainId: uuid!
+    $websiteId: uuid!
     $term: String!
     $productLimit: Int = 5
     $brandLimit: Int = 3
@@ -2452,6 +2484,10 @@ var GET_SEARCH_SUGGESTIONS = (
     products(
       where: {
         company_id: { _eq: $companyId }
+        product_website_publications: {
+          website_id: { _eq: $websiteId }
+          is_visible: { _eq: true }
+        }
         chain_products: {
           chain_id: { _eq: $chainId }
           is_enabled: { _eq: true }
@@ -2464,6 +2500,29 @@ var GET_SEARCH_SUGGESTIONS = (
     ) {
       id
       name
+      product_website_publications(
+        where: { website_id: { _eq: $websiteId }, is_visible: { _eq: true } }
+        limit: 1
+      ) {
+        show_when_out_of_stock
+      }
+      product_variants(where: { is_disabled: { _eq: false } }) {
+        id
+        product_variant_prices(
+          where: {
+            price_type: { _eq: CLIENT }
+            _or: [
+              { chain_id: { _eq: $chainId } }
+              { chain_id: { _is_null: true } }
+            ]
+          }
+        ) {
+          id
+          price
+          price_type
+          chain_id
+        }
+      }
     }
     brands(
       where: {
@@ -2945,6 +3004,7 @@ function mapProduct(raw, storageUrl, labels, chainId) {
     createdAt: raw.created_at,
     updatedAt: raw.updated_at ?? raw.created_at,
     variants,
+    outOfStockVisibilityOverride: raw.product_website_publications?.[0]?.show_when_out_of_stock ?? null,
     detailVariants,
     media: raw.product_media.map((m) => mapMedia(m, storageUrl)),
     attributes: raw.product_attributes.map(
@@ -3306,7 +3366,7 @@ async function getWebsiteAvailabilityByVariantId(graphqlUrl, getHeaders, variant
   }
   return availabilityByVariantId;
 }
-async function filterProductsForWebsiteStock(graphqlUrl, getHeaders, products, chainId, websiteId) {
+async function filterProductsForWebsiteStock(graphqlUrl, getHeaders, products, chainId, websiteId, showOutOfStockByDefault = false, onlyInStock = false) {
   const variantIds = products.flatMap(
     (product) => product.variants.map((variant) => variant.id)
   );
@@ -3332,11 +3392,11 @@ async function filterProductsForWebsiteStock(graphqlUrl, getHeaders, products, c
         pricing: resolveProductPricing(prices)
       };
     }).filter(
-      (variant) => inStockVariantIds.has(variant.id) && variant.pricing.currentPrice != null
+      (variant) => (inStockVariantIds.has(variant.id) || !onlyInStock && (product.outOfStockVisibilityOverride ?? showOutOfStockByDefault)) && variant.pricing.currentPrice != null
     )
   })).filter((product) => product.variants.length > 0);
 }
-async function filterSeoProductsForWebsiteStock(graphqlUrl, getHeaders, products, chainId, websiteId) {
+async function filterSeoProductsForWebsiteStock(graphqlUrl, getHeaders, products, chainId, websiteId, showOutOfStockByDefault = false) {
   const variantIds = products.flatMap(
     (product) => product.product_variants.map((variant) => variant.id)
   );
@@ -3358,7 +3418,7 @@ async function filterSeoProductsForWebsiteStock(graphqlUrl, getHeaders, products
       const pricing = resolveProductPricing(
         selectPublicPrices(prices, chainId)
       );
-      return inStockVariantIds.has(variant.id) && pricing.currentPrice != null;
+      return (inStockVariantIds.has(variant.id) || (product.product_website_publications?.[0]?.show_when_out_of_stock ?? showOutOfStockByDefault)) && pricing.currentPrice != null;
     })
   );
 }
@@ -3429,7 +3489,8 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
       getHeaders,
       [mappedProduct],
       ctx.chainId,
-      ctx.websiteId
+      ctx.websiteId,
+      ctx.config?.show_out_of_stock_products === true
     );
     if (!filteredProducts[0]) return null;
     const specifications = await loadProductSpecifications([product.id]);
@@ -3662,7 +3723,8 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
         getHeaders,
         data.products ?? [],
         ctx.chainId,
-        ctx.websiteId
+        ctx.websiteId,
+        ctx.config?.show_out_of_stock_products === true
       );
       const entries = availableProducts.slice(0, limit).map((product) => mapProductSeoEntry(product, storageUrl)).filter((entry) => Boolean(entry));
       return {
@@ -3739,7 +3801,9 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
           (p) => mapProduct(p, storageUrl, publicAttributeLabels, chainId)
         ),
         chainId,
-        ctx.websiteId
+        ctx.websiteId,
+        ctx.config?.show_out_of_stock_products === true,
+        opts?.inStock === true
       );
       const specifications = await loadProductSpecifications(
         products.map((product) => product.id)
@@ -3846,6 +3910,7 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
           {
             companyId: ctx.companyId,
             chainId,
+            websiteId: ctx.websiteId,
             attributeListKey: DEFAULT_FILTER_ATTRIBUTE_LIST_KEY,
             where: buildProductWhere(opts.filters ?? {}, chainId)
           },
@@ -3869,7 +3934,7 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
               variant.product_variant_prices.map(mapPrice),
               chainId
             );
-            return prices.length > 0 && (availabilityByVariantId.get(variant.id)?.inStock ?? false);
+            return prices.length > 0 && ((availabilityByVariantId.get(variant.id)?.inStock ?? false) || (product.product_website_publications?.[0]?.show_when_out_of_stock ?? ctx.config?.show_out_of_stock_products === true));
           });
           if (!hasVisibleVariant) continue;
           applicableCategories.add(product.category);
@@ -3957,6 +4022,7 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
         {
           companyId: ctx.companyId,
           chainId,
+          websiteId: ctx.websiteId,
           attributeListKey: opts?.attributeListKey ?? DEFAULT_FILTER_ATTRIBUTE_LIST_KEY,
           where: {
             ...opts?.categoryName ? { category: { _eq: opts.categoryName } } : {},
@@ -4011,7 +4077,9 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
             chainId
           ),
           inStock: availabilityByVariantId.get(variant.id)?.inStock ?? false
-        })).filter((variant) => variant.inStock && variant.prices.length > 0);
+        })).filter(
+          (variant) => (variant.inStock || (product.product_website_publications?.[0]?.show_when_out_of_stock ?? ctx.config?.show_out_of_stock_products === true)) && variant.prices.length > 0
+        );
         if (visibleVariants.length === 0) continue;
         categoryCounts.set(
           product.category,
@@ -4096,6 +4164,7 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
           "NO_CHAIN"
         );
       }
+      const chainId = ctx.chainId;
       const term = `%${opts.query}%`;
       const limit = opts.limit ?? 8;
       const data = await executeGraphQL(
@@ -4103,7 +4172,8 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
         GET_SEARCH_SUGGESTIONS,
         {
           companyId: ctx.companyId,
-          chainId: ctx.chainId,
+          chainId,
+          websiteId: ctx.websiteId,
           term,
           productLimit: Math.min(limit, 5),
           brandLimit: Math.max(limit - 5, 3)
@@ -4111,8 +4181,29 @@ function createCatalogModule(graphqlUrl, getHeaders, getContext, storageUrl) {
         getHeaders
       );
       const suggestions = [];
+      const availability = await getWebsiteAvailabilityByVariantId(
+        graphqlUrl,
+        getHeaders,
+        (data.products ?? []).flatMap(
+          (product) => product.product_variants.map((variant) => variant.id)
+        ),
+        chainId,
+        ctx.websiteId
+      );
       for (const p of data.products ?? []) {
-        suggestions.push({ type: "product", text: p.name, id: p.id });
+        const showWithoutStock = p.product_website_publications?.[0]?.show_when_out_of_stock ?? ctx.config?.show_out_of_stock_products === true;
+        const isVisible = p.product_variants.some((variant) => {
+          const hasPrice = resolveProductPricing(
+            selectPublicPrices(
+              variant.product_variant_prices.map(mapPrice),
+              chainId
+            )
+          ).currentPrice != null;
+          return hasPrice && (showWithoutStock || availability.get(variant.id)?.inStock === true);
+        });
+        if (isVisible) {
+          suggestions.push({ type: "product", text: p.name, id: p.id });
+        }
       }
       for (const b of data.brands ?? []) {
         suggestions.push({ type: "brand", text: b.name, id: b.id });

package/skills/bacano-web/references/common.md

@@ -40,11 +40,21 @@ función apagada en un bloqueo artificial.
 ## SEO y compartición
 
 - Título, descripción, canonical, robots, Open Graph y Twitter por ruta.
+- Conservar los campos SEO editados de verdad en Bacano, pero no publicar
+  `lorem ipsum` u otros borradores visibles como metadata. Usar fallbacks
+  específicos para cada página y evitar duplicar la marca en el título.
 - `robots.txt`, sitemap con URLs canónicas y ausencia de rutas privadas.
+- En el dominio publicado, comprobar con `GET` el código, tipo de contenido y
+  política de caché de sitemap y robots. Las rutas estables de descubrimiento
+  no deben heredar `immutable` de los assets versionados; contrastar un error
+  de Search Console con su prueba en tiempo real antes de culpar al XML. Ver
+  `STOREFRONT_PERFORMANCE.md`.
 - Jerarquía de encabezados, idioma, texto alternativo, enlaces internos y
   JSON-LD coherente con el contenido visible.
 - Confirmar 404 real, canonical único, ausencia de slugs/URLs duplicadas y
   redirección consistente entre `www`, dominio raíz y HTTP/HTTPS.
+- El host del sitemap, canonical, Open Graph y redirección final debe coincidir;
+  no basta con que cada URL funcione por separado.
 - Usar `hreflang` solo cuando existan versiones regionales o de idioma reales.
 - Favicon, iconos, manifest y vista previa al compartir.
 
@@ -56,6 +66,9 @@ función apagada en un bloqueo artificial.
 - Revisar desktop y mobile, DPR 1/2, CLS, LCP, fuentes y JavaScript inicial.
   Tratar una medición sintética aislada como diagnóstico, no como verdad de
   campo; repetir y distinguir regresión sostenida de ruido.
+- En carruseles, contar imágenes descargadas, no solo elementos visibles;
+  comprobar navegación a fotos lejanas y compatibilidad con los navegadores
+  móviles soportados. Ver `STOREFRONT_PERFORMANCE.md`.
 - Confirmar caché y CORS/CORP de media pública sin proxies locales.
 
 ## Accesibilidad y experiencia

package/skills/bacano-web/references/storefront.md

@@ -18,6 +18,17 @@ Aplicar además de los controles comunes.
   alterar canonical.
 - Precio, SKU, stock, variante seleccionada, JSON-LD, carrito, WhatsApp y
   eventos deben referirse a la misma variante.
+- Verificar la regla de **productos agotados** del website y las excepciones
+  por producto y por web. La regla predeterminada oculta agotados; una excepción
+  `true` los muestra, `false` los oculta y `null` hereda la regla. La publicación
+  del producto, cadena activa y precio público siguen siendo requisitos. El
+  SDK aplica la visibilidad en catálogo, rutas, SEO, filtros, recomendaciones y
+  búsqueda: la tienda no debe duplicar ese filtrado ni consultar Hasura.
+- Un producto agotado visible no es comprable: comprobar `inStock: false` y
+  `maxPurchasableQuantity: 0` en estado vivo, controles de cantidad y checkout.
+  `getProducts({ inStock: true })` debe seguir excluyéndolo. Si el sitio es
+  estático, cambiar esta regla exige rebuild para que rutas, sitemap y HTML
+  reflejen los productos ahora visibles u ocultos.
 - El HTML inicial debe contener producto, precio y enlaces reales sin depender
   de JavaScript. Después de hidratar, refrescar únicamente estado volátil por
   lotes con `getProductLiveState()` y respetar `maxPurchasableQuantity`.
@@ -45,6 +56,8 @@ Aplicar además de los controles comunes.
 ## Carrito y checkout
 
 - Carrito invitado persiste y sincroniza sin duplicar líneas.
+- Si una operación bloquea temporalmente otras mutaciones del carrito, mostrar
+  el indicador de carga en el producto accionado, no en todas las tarjetas.
 - Probar alta, baja, cambios de cantidad, límites de stock, cupón, envío gratis,
   impuestos, moneda y redondeo.
 - Probar solo los modos activos entre COUNTER, PICKUP y SHIPPING; propia y
@@ -56,6 +69,9 @@ Aplicar además de los controles comunes.
 
 - Leer y aplicar `STOREFRONT_PAYMENTS.md`; no reconstruir en la tienda URLs,
   credenciales ni payloads privados de Wompi, Mercado Pago o Addi.
+- Si se muestran marcas de pasarela o redes, comprobar que corresponden al
+  método efectivamente devuelto por Bacano y no sugieren un método adicional
+  ni un medio que el checkout alojado no tenga confirmado.
 - Ejecutar al menos un happy path real o sandbox por cada método crítico
   publicado. Probar pago inmediato, transferencia, Wompi y contraentrega solo
   si están activos; los estados alternos de cada proveedor quedan en su matriz