ng-easycommerce-v18 0.3.22-beta.2 → 0.3.23-beta.1

package/lib/classes/filters/attributes-filter.d.ts

@@ -1,14 +1,38 @@
 import { FilterElement, FilterType } from "../../interfaces";
 import { Filter } from "./filter";
+import { Params } from "@angular/router";
+/**
+ * AttributesFilter
+ * - Gestiona el filtro de atributos (estructura de padres/children).
+ * - Soporta hidratación desde query params y aplicación de códigos seleccionados.
+ */
 export declare class AttributesFilter extends Filter {
     private _optionsService;
     data: FilterElement[];
     multi: boolean;
+    private _codesFromQuery;
     constructor(initialValue?: any, options?: any);
     type(): FilterType;
     setContent(options: any, initialValue?: any): void;
     getContent(): FilterElement[];
+    /**
+     * ADDED: toUrlParams construye la porción de query string que representa las selecciones de atributos.
+     */
     toUrlParams(actual_url?: string, sublist?: any, already?: any): string;
     cleanResult(text: string): string;
+    /**
+     * ADDED: createElement transforma cada nodo original en FilterElement y marca selección inicial si corresponde.
+     */
     createElement(filter: any, original: any, initialValue?: any): any;
+    /** hidratar desde la URL */
+    hydrateFromQuery(params: Params): void;
+    /**
+     * ADDED: applyCodes recorre la estructura y marca selected=true en los children cuyo código está en 'codes'.
+     * Además marca el parent como seleccionado si alguno de sus hijos lo está.
+     */
+    private applyCodes;
+    /**
+     * ADDED: clearSelection desmarca todos los parents y children (restablece el filtro).
+     */
+    private clearSelection;
 }

package/lib/classes/filters/category-filter.d.ts

@@ -1,14 +1,41 @@
 import { FilterElement, FilterType } from "../../interfaces";
 import { Filter } from "./filter";
+/**
+ * CategoryFilter
+ * - Gestiona el filtro de categorías.
+ * - Mantiene la estructura de categorías (parents/children) y permite:
+ *   * Inicializar desde OptionsService.
+ *   * Marcar elementos según slug o query param.
+ *   * Generar porción de query string (&category=...).
+ */
 export declare class CategoryFilter extends Filter {
-    private initialValues?;
     private _optionsService;
+    private _filtersService;
     data: FilterElement[];
     multi: boolean;
-    constructor(initialValues?: any);
+    constructor(initialValue?: any);
     type(): FilterType;
     setContent(options: any, initialValue?: any): void;
     getContent(): FilterElement[];
-    toUrlParams(actual_url?: string, sublist?: any): string;
+    /**
+     * toUrlParams
+     * - Recorre la estructura y devuelve la porción de query string para la categoría seleccionada.
+     * - Prioriza el primer selected encontrado (solo una categoría se envía).
+     */
+    toUrlParams(): string;
     createElement(filter: any, original: any, initialValue?: any): any;
+    /**
+     * setFromSlug
+     * - Marca como selected los nodos cuyo slug/path/name coincide con el slug proporcionado.
+     * - Utiliza removeAccents para comparar sin tildes y en minúsculas.
+     * - No retorna valor, solo modifica this.data.
+     */
+    setFromSlug(slug: string): void;
+    /**
+     * hydrateFromQuery
+     * - Marca la categoría según el parámetro de query 'category' si existe.
+     * - Busca el code exacto en la estructura y marca el nodo correspondiente.
+     * - Loggea si se encontró o no la categoría.
+     */
+    hydrateFromQuery(query: any): void;
 }

package/lib/constants/core.constants.service.d.ts

@@ -27,6 +27,11 @@ export declare class CoreConstantsService {
      * Guarda la variable window del web browser.
      */
     private window?;
+    /**
+     * Tipo de ruta actual (ej: 'categories', 'attributes', etc).
+     * Lo usamos para que PaginationService sepa qué filtro esperar.
+     */
+    currentRouteType: string | null;
     constructor();
     /**
      * Path usado en las colecciones de productos.
@@ -144,6 +149,8 @@ export declare class CoreConstantsService {
     getParamsProductsWithUniqueVariant: () => ParamsProductsWithUniqueVariant;
     getChannel(): string;
     form_sender: boolean;
+    setCurrentRouteType(type: string | null): void;
+    getCurrentRouteType(): string | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<CoreConstantsService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<CoreConstantsService>;
 }

package/lib/ec-components/collection-ec/collection-ec.component.d.ts

@@ -1,4 +1,4 @@
-import { OnInit } from '@angular/core';
+import { OnDestroy, OnInit } from '@angular/core';
 import { DefaultFilter, FilterType, Product } from '../../interfaces';
 import { AuthService, OptionsService, ProductsService } from '../../ec-services';
 import { ActivatedRoute } from '@angular/router';
@@ -6,10 +6,11 @@ import { CoreConstantsService } from '../../constants';
 import { Observable } from 'rxjs';
 import { Filter } from '../../classes';
 import * as i0 from "@angular/core";
-export declare class CollectionEcComponent implements OnInit {
+export declare class CollectionEcComponent implements OnInit, OnDestroy {
     protected _productsService: ProductsService;
     protected _activeRoute: ActivatedRoute;
     protected _optionsService: OptionsService;
+    private _filtersService;
     params$: Observable<import("@angular/router").Params>;
     queryParams$: Observable<import("@angular/router").Params>;
     products$: Observable<Product[]>;
@@ -22,17 +23,17 @@ export declare class CollectionEcComponent implements OnInit {
     private loaded;
     optionsFilters: FilterType[];
     filters_sort: Filter[];
-    private _filtersService;
     filters$: Observable<Filter[]>;
     ready$: Observable<boolean>;
     private window?;
     isList: boolean;
+    private destroy$;
     setAsList: (value: boolean) => boolean;
     ngOnInit(): void;
     private total;
     private platformId;
     constructor();
-    getProducts(): void;
+    ngOnDestroy(): void;
     onScroll(): void;
     productHasStock(product: Product): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<CollectionEcComponent, never>;

package/lib/ec-components/filters-ec/filters-ec.component.d.ts

@@ -15,6 +15,7 @@ export declare class FiltersEcComponent {
     injector: Injector;
     isAuthenticated$: boolean;
     hidePrices: boolean;
+    private route;
     setSelect: any;
     ngOnInit(): void;
     constructor();
@@ -23,6 +24,18 @@ export declare class FiltersEcComponent {
     /** 2) Para cualquier otro FilterType, devuelvo Filter */
     getSpecificFilter(type: FilterType): Filter | null;
     onSelect(event: any, filter: FilterElement[] | null): void;
+    /**
+     * Maneja el click sobre un elemento de filtro (categoría, atributo, etc.).
+     *
+     * - Para categorías: navega a la URL de la categoría.
+     * - Para atributos: actualiza la query string de la URL con `attributeCodes`.
+     * - Para otros filtros: delega en FiltersService para marcar seleccionado.
+     *
+     * La idea es que **la URL siempre represente los filtros aplicados**,
+     * de modo que:
+     *   - al hacer F5 no se pierdan los filtros,
+     *   - los links sean compartibles (deep linking).
+     */
     setSelected(filter: Filter | null, selected: FilterElement | null): void;
     uniqueSelection(filter: {
         data: any[];

package/lib/ec-components/price-range-filter/price-range-filter.component.d.ts

@@ -3,6 +3,8 @@ import { PriceRangeFilter } from '../../classes/filters/price_range-filter';
 import * as i0 from "@angular/core";
 export declare class PriceRangeFilterComponent {
     private _filtersService;
+    private router;
+    private route;
     priceGap: number;
     roundStep: number;
     filter: PriceRangeFilter;

package/lib/ec-services/filters.service.d.ts

@@ -1,6 +1,7 @@
 import { Observable } from 'rxjs';
 import { Filter } from '../classes';
 import { FilterElement, PaginationSettings, FilterType } from '../interfaces';
+import { Params } from '@angular/router';
 import * as i0 from "@angular/core";
 export declare class FiltersService {
     private _apiConsts;
@@ -16,6 +17,7 @@ export declare class FiltersService {
     private _defaultFilters;
     private _paginationSettings;
     private _filtersInitialized;
+    private _lastRouteQuery;
     constructor();
     /**
      * Retorna la url para el filtrado
@@ -30,7 +32,7 @@ export declare class FiltersService {
      */
     generateFinalApi(search_value?: string): string;
     private isUpdated;
-    setFilters(paginationSettings: PaginationSettings, search_value?: string): void;
+    setFilters(paginationSettings: PaginationSettings, search_value?: string, routeQueryParams?: any): void;
     getFilters(paginationSettings?: PaginationSettings): Filter[] | undefined;
     getSpecificFilters(types: FilterType[]): Filter[];
     setFilterSelected(filterObj: Filter, filterElem: FilterElement): void;
@@ -40,6 +42,21 @@ export declare class FiltersService {
      * el array de filtros para que PaginationService vuelva a llamar
      */
     updatePriceRangeFilter(min: number, max: number): void;
+    /**
+     * Fuerza a emitir de nuevo los filtros actuales.
+     * Útil cuando un filtro async (categorías, atributos) termina de cargarse
+     * y necesitamos que PaginationService vuelva a armar la URL.
+     */
+    refreshFilters(): void;
+    /**
+     * Punto central donde se hidratan los filtros a partir de la URL:
+     * - Lee type/value de la ruta (ej. /collection/categories/:value).
+     * - Lee query params (category, price_min, price_max, attributeCodes, search, etc.).
+     * - Crea instancias de filtros y les delega la hidratación específica.
+     *
+     * Este método se llama tanto en SSR como en navegador.
+     */
+    hydrateFromRoute(paginationSettings: PaginationSettings, routeParams: Params, routeQuery: Params): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<FiltersService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<FiltersService>;
 }

package/lib/ec-services/pagination.service.d.ts

@@ -3,14 +3,30 @@ import { Pagination, Product } from '../interfaces';
 import { Filter } from '../classes';
 import * as i0 from "@angular/core";
 /**
- * Servicio para manejar la paginación de los productos.
- * @class PaginationService
+ * Servicio para manejar la paginación y la carga de productos.
+ *
+ * Se encarga de:
+ * - Escuchar los cambios en los filtros (categorías, atributos, precio, búsqueda, etc.).
+ * - Construir la URL al backend con esos filtros.
+ * - Pedir los productos al endpoint de product-search.
+ * - Exponer un observable con la última página de productos (`paginationData$`)
+ *   y otros helpers (precio mínimo/máximo, siguiente página, etc.).
  */
 export declare class PaginationService {
     private _connectionService;
     private _filtersService;
     private _constants;
-    paginationData$: Observable<any>;
+    /**
+     * Flujo principal: a partir de los filtros → arma URL → consulta backend → devuelve productos.
+     *
+     * Pasos:
+     * 1) Espera a que `FiltersService` emita filtros válidos.
+     * 2) Construye la URL final con `buildUrl()`.
+     * 3) Evita repetir llamadas si la URL no cambió (`distinctUntilChanged`).
+     * 4) Llama al backend con `getData(url)`.
+     * 5) Comparte el último resultado con todos los suscriptores (`shareReplay(1)`).
+     */
+    paginationData$: Observable<Product[]>;
     private _dataPagination;
     private _waiting;
     private _finished;
@@ -85,11 +101,11 @@ export declare class PaginationService {
      */
     buildUrl(filters: Filter[]): string;
     /**
-     * Devuelve un observable de los productos que devolvio la última página obtenida.
+     * Devuelve un observable de los productos que devolvió la última página obtenida.
      * @param url
      * @returns
      */
-    getData(url: string): Observable<any>;
+    getData(url: string): Observable<Product[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<PaginationService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<PaginationService>;
 }

package/lib/ec-services/products.service.d.ts

@@ -25,7 +25,7 @@ export declare class ProductsService {
      * @param paginationSettings
      * @param searchValue
      */
-    getProductsForFilter(paginationSettings?: PaginationSettings, searchValue?: any): any;
+    getProductsForFilter(paginationSettings?: PaginationSettings, searchValue?: any, routeQueryParams?: any): any;
     /**
      * Actualiza los productos con los de la siguiente pagina.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ng-easycommerce-v18",
-  "version": "0.3.22-beta.2",
+  "version": "0.3.23-beta.1",
   "peerDependencies": {
     "@angular/common": "^18.2.0",
     "@angular/core": "^18.2.0"