ng-easycommerce 0.0.688 → 0.0.689

package/README.md

@@ -1,3 +1,16 @@
+# Version 0.0.689
+- SEO: `CollectionEcComponent` normaliza el breadcrumb antes de armar el `title`, aceptando valores string u objetos con `title`, `name` o `label` para evitar renders como `[object Object] | ...`.
+- SEO: el `title` de colección mantiene el patrón `'<sección> | <sitio>'` y la `description` vuelve a derivarse del texto visible de la categoría o del término de búsqueda.
+- SEO: la corrección es compatible con clientes anteriores que ya entregaban strings en `breadcrumb` y con los que todavía exponen objetos de navegación.
+- SEO: `CartEcComponent` ahora setea `title`, `description`, `canonical` y `noindex` para la ruta de carrito, manteniendo la ruta fuera de indexación pero con metadata consistente.
+- SEO: `CheckoutEcComponent` adopta el mismo patrón con `title`, `description`, `canonical` y `noindex`, dejando la ruta interna fuera de indexación.
+- SEO: se amplía la documentación de adopción para `cart` y `checkout` en `src/lib/assets/docs/SEO.md` y se conserva el patrón opt-in para los frontends que quieran reutilizarlo.
+- SEO: se agrega `SeoService` reutilizable en `projects/ng-easycommerce/src/lib/services/seo.service.ts` con helpers para `title`, `description`, `og:image`, `og:type`, `canonical` y `robots`.
+- SEO: el servicio es opt-in y no altera por sí solo el comportamiento de los clientes existentes; los frontends pueden adoptarlo por ruta sin romper integraciones viejas.
+- SEO: el paquete lo expone desde `src/public-api.ts` para que los consumidores puedan inyectarlo desde el core compartido.
+- SEO: se documenta el patrón de integración en `src/lib/assets/docs/SEO.md` para que otros frontends puedan adoptarlo de forma gradual.
+- SEO: `ecAddActionRedirect` publica `href` también para rutas internas calculadas por `blocksService.formUrl(banner)`, mejorando crawlability en banners y bloques.
+- SEO: `ProductOffDirective` deja de crear un ancla para el badge `% OFF`, evitando links vacíos en tarjetas de producto.
 # Version 0.0.688
 - Facebook Pixel: se mantiene la carga única e idempotente, evitando reinyecciones y dobles inicializaciones del script.
 - Facebook Pixel: el tracking se ejecuta fuera de la zona de Angular y conserva un fallback seguro si `NgZone` no está disponible.

package/assets/docs/SEO.md

@@ -0,0 +1,174 @@
+# SEO base para Angular 9
+
+Este documento describe cómo integrar el SEO base que expone `ng-easycommerce` para los frontends que todavía trabajan con Angular 9.
+
+## Objetivo
+
+Centralizar en el core una capa reutilizable de metadata para:
+
+- títulos por ruta;
+- meta description;
+- `og:type`;
+- `og:image`;
+- canonical;
+- `robots`.
+
+La funcionalidad es opt-in. Un frontend que no inyecta `SeoService` sigue funcionando igual que antes.
+
+## Alcance
+
+Esta implementación cubre SEO on-page y metadata dinámica desde Angular 9.
+
+No reemplaza:
+
+- SSR;
+- prerender;
+- sitemap;
+- `robots.txt`;
+- JSON-LD;
+- indexación del contenido inicial del HTML renderizado por servidor.
+
+Sirve para mejorar el HTML que emite el frontend una vez cargado y para ordenar la metadata por ruta.
+
+## API pública
+
+El servicio se exporta desde `src/public-api.ts`:
+
+```ts
+import { SeoService } from 'ng-easycommerce';
+```
+
+Helpers disponibles en `SeoService`:
+
+- `setTitle(title: string, suffix = true)`
+- `setDescription(description: string)`
+- `setOgImage(url: string)`
+- `setOgType(type: string)`
+- `setCanonical(url: string)`
+- `setRobots(content: string)`
+- `setNoIndex(noIndex = true)`
+- `getSiteName()`
+
+## Cómo funciona
+
+El servicio usa las APIs nativas de Angular para metadata:
+
+- `Title`
+- `Meta`
+
+Además:
+
+- el canonical se aplica solo en navegador;
+- si una etiqueta ya existe, el servicio la reutiliza o la actualiza;
+- el `siteName` se toma desde la configuración del canal cuando existe;
+- si el frontend no usa el servicio, no cambia ninguna ruta ni metadata.
+
+Además, la adopción SEO en bloques y banners puede apoyarse en `ecAddActionRedirect`:
+
+- cuando el banner no trae `url`, el core calcula una ruta interna con `blocksService.formUrl(banner)`;
+- esa ruta queda publicada en `href` para que el enlace sea rastreable;
+- el click sigue resolviéndose por Angular en rutas internas;
+- los enlaces externos conservan `target="_blank"` y `rel="noopener noreferrer"`.
+
+## Patrón de integración
+
+La idea es que cada frontend llame al servicio en los componentes que representan una ruta pública.
+
+### Páginas indexables
+
+Usar cuando la ruta debe aparecer en buscadores:
+
+- home;
+- colecciones;
+- ficha de producto;
+- secciones públicas;
+- páginas de contenido público.
+
+Ejemplo:
+
+```ts
+constructor(private seoService: SeoService) {}
+
+ngOnInit(): void {
+  this.seoService.setTitle('Colección Mujer');
+  this.seoService.setDescription('Ropa y accesorios para mujer.');
+  this.seoService.setCanonical(this.currentUrl);
+  this.seoService.setOgType('website');
+  this.seoService.setRobots('index,follow');
+}
+```
+
+### Páginas que no deben indexarse
+
+Usar para rutas internas, de autenticación o de cuenta:
+
+- cart;
+- checkout;
+- login;
+- registro;
+- recuperar contraseña;
+- reset de contraseña;
+- confirmación de cuenta;
+- backoffice o áreas internas equivalentes.
+
+Ejemplo:
+
+```ts
+constructor(private seoService: SeoService) {}
+
+ngOnInit(): void {
+  this.seoService.setTitle('Checkout');
+  this.seoService.setDescription('Finalizá tu compra en la tienda.');
+  this.seoService.setCanonical(this.currentUrl);
+  this.seoService.setNoIndex(true);
+}
+```
+
+## Recomendaciones de uso
+
+- Definir metadata por ruta, no solo de forma global.
+- Usar títulos descriptivos y consistentes con el contenido visible.
+- Mantener `robots` explícito en páginas que no deban indexarse.
+- Si la ficha de producto, el carrito, el checkout o la sección no tiene descripción real, usar un texto corto derivado del contenido visible.
+- No asumir que todos los frontends necesitan activar esta capa al mismo tiempo.
+
+## Compatibilidad
+
+La implementación fue pensada para no romper clientes que aún no la adoptan:
+
+- el servicio no se ejecuta solo;
+- no modifica rutas ni guardas;
+- no cambia el HTML si el frontend no lo invoca;
+- soporta frontend/core viejos sin exigir SSR;
+- permite adopción gradual por componente o por ruta.
+
+Si un cliente actualiza el core pero no incorpora `SeoService`, conserva el comportamiento anterior.
+
+## Qué debe implementar cada frontend
+
+Cada frontend que quiera usar esta base debe:
+
+1. inyectar `SeoService` en los componentes de las rutas públicas;
+2. setear título y description según el contenido real;
+3. marcar `noindex` en rutas internas;
+4. completar canonical con la URL actual;
+5. ajustar `og:type` y `og:image` cuando corresponda.
+
+No hace falta duplicar la lógica de metadata en cada proyecto si el core ya la resuelve.
+
+## Ejemplos de rutas ya cubiertas en el core
+
+El core ya aplica esta lógica en:
+
+- `src/lib/ec-component/home-ec/home-ec.component.ts`
+- `src/lib/ec-component/collection-ec/collection-ec.component.ts`
+- `src/lib/ec-component/cart-ec/cart-ec.component.ts`
+- `src/lib/ec-component/checkout-ec/checkout-ec.component.ts`
+- `src/lib/ec-component/product-detail-ec/product-detail-ec.component.ts`
+- `src/lib/ec-component/section-container-ec/section-container-ec.component.ts`
+- `src/lib/ec-component/auth-ec/auth-ec.component.ts`
+- `src/lib/ec-component/auth-ec/forgot-password-ec/forgot-password-ec.component.ts`
+- `src/lib/ec-component/password-reset-ec/password-reset-ec.component.ts`
+- `src/lib/ec-component/auth-ec/confirm-account-ec/confirm-account-ec.component.ts`
+
+Esa lista sirve como referencia para nuevos frontends que quieran replicar el mismo patrón.