ng-easycommerce 1.1.2 → 1.1.3

package/lib/ec-component/cart-bootstrap-navigation.d.ts

@@ -0,0 +1,7 @@
+export declare type CartBootstrapRecoveryRoute = 'cart' | 'checkout' | null;
+/** Identifica las rutas del core que deben salir al inicio tras reemplazar un token inactivo. */
+export declare const cartBootstrapRecoveryRoute: (url: string) => CartBootstrapRecoveryRoute;
+/** Ejecuta la navegación solo desde la ruta core correspondiente al consumidor. */
+export declare const navigateHomeAfterCartBootstrapRecovery: (url: string, expectedRoute: CartBootstrapRecoveryRoute, consumeRecovery: () => boolean, navigateHome: () => any) => boolean;
+/** Invalida el estado local y sale únicamente de una ruta de checkout. */
+export declare const handleInvalidatedCheckoutNavigation: (url: string, invalidateCheckout: () => void, navigateHome: () => any) => boolean;

package/lib/ec-component/cart-ec/cart-ec.component.d.ts

@@ -1,4 +1,4 @@
-import { OnInit, TemplateRef } from "@angular/core";
+import { OnInit, OnDestroy, TemplateRef } from "@angular/core";
 import { Router } from "@angular/router";
 import { BsModalService } from "ngx-bootstrap/modal";
 import { BsModalRef } from 'ngx-bootstrap/modal/bs-modal-ref.service';
@@ -12,7 +12,7 @@ import { Observable } from "rxjs";
 import { AddressingService } from '../../services/checkout/addressing.service';
 import { ChannelConfigService } from '../../services/channel-config.service';
 import { SeoService } from '../../services/seo.service';
-export declare class CartEcComponent extends ComponentHelper implements OnInit {
+export declare class CartEcComponent extends ComponentHelper implements OnInit, OnDestroy {
     cartService: CartService;
     authService: AuthService;
     protected consts: Constants;
@@ -48,10 +48,13 @@ export declare class CartEcComponent extends ComponentHelper implements OnInit {
         [key: string]: string;
     };
     supportsUnitPromotionHover: boolean;
+    private cartBootstrapRecoverySubscription;
+    private handleCartBootstrapRecovery;
     constructor(cartService: CartService, authService: AuthService, consts: Constants, productsService: ProductsService, router: Router, modalService: BsModalService, toastrService: ToastService, addressingService: AddressingService, channelConfigService: ChannelConfigService, seo: SeoService);
     ngOnChanges(): void;
     updateLoggedIn(): void;
     ngOnInit(): void;
+    ngOnDestroy(): void;
     private updateCartSeo;
     /**
      * Convierte un monto crudo al formato decimal esperado por la UI.

package/lib/ec-component/checkout-ec/checkout-ec.component.d.ts

@@ -44,6 +44,11 @@ export declare class CheckoutEcComponent extends ComponentHelper implements OnIn
     private paymentAutoOpened;
     private autoClosedSteps;
     private manuallyOpenedSteps;
+    private cartBootstrapRecoverySubscription;
+    private cartCheckoutInvalidationSubscription;
+    private checkoutInvalidationHandled;
+    private handleCartBootstrapRecovery;
+    private handleCartCheckoutInvalidation;
     hideTaxes: boolean;
     showTaxLegend: boolean;
     shipmentSummary: {

package/lib/ec-component/checkout-ec/dataform-ec/dataform-ec.component.d.ts

@@ -1,4 +1,4 @@
-import { EventEmitter, OnInit, TemplateRef } from '@angular/core';
+import { EventEmitter, OnInit, OnDestroy, TemplateRef } from '@angular/core';
 import { FormBuilder, FormGroup } from '@angular/forms';
 import { BehaviorSubject } from 'rxjs';
 import { ComponentHelper } from '../../../classes/component-helper';
@@ -13,7 +13,7 @@ import { ParametersService } from '../../../services/parameters.service';
 import { ChannelConfigService } from '../../../services/channel-config.service';
 import { CheckoutService } from '../../../services/checkout/checkout.service';
 import { OrderUtilityService } from '../../../utils/order-util.service';
-export declare class DataFormEcComponent extends ComponentHelper implements OnInit {
+export declare class DataFormEcComponent extends ComponentHelper implements OnInit, OnDestroy {
     authService: AuthService;
     fb: FormBuilder;
     toast: ToastService;
@@ -78,15 +78,36 @@ export declare class DataFormEcComponent extends ComponentHelper implements OnIn
     documentErrorMessage: string;
     documentErrorMessageFacturacion: string;
     customerHasCustomerTaxRate: boolean;
+    checkoutLoginPending: boolean;
+    checkoutLoginAddressSelectionRequired: boolean;
+    checkoutLoginAddressBookLoading: boolean;
+    checkoutLoginAddressBookLoadFailed: boolean;
     documentTypeDropdownOpen: boolean;
     documentTypeFactDropdownOpen: boolean;
     private lastSavedState;
     private isDirty;
     private suppressDirty;
     private addressSyncedForCompletion;
+    private checkoutLoginAttemptId;
+    private checkoutLoginSessionToken;
+    private checkoutLoginSessionEmail;
+    private checkoutLoginSubscription;
+    private checkoutLoginAuthSubscription;
+    private addressBookRequestId;
+    private destroyed$;
     private lastSummaryTotalsSnapshot;
     constructor(authService: AuthService, fb: FormBuilder, toast: ToastService, addressingService: AddressingService, cartService: CartService, checkoutService: CheckoutService, orderUtils: OrderUtilityService, modalService: BsModalService, paramsService: ParametersService, consts: Constants, channelConfig: ChannelConfigService);
     ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** Espera el resumen autenticado antes de reutilizar una dirección ingresada como invitado. */
+    handleCheckoutLogin: (email: string) => void;
+    showNewAddressOptionDuringLogin: () => boolean;
+    private isNewAddressCreationBlocked;
+    retryCheckoutLoginAddressBook: () => void;
+    private getAuthenticatedEmail;
+    private isCheckoutLoginSessionCurrent;
+    private cancelCheckoutLoginWait;
+    private loadCheckoutLoginAddressBook;
     /**
      * @description filtra los paises de acuerdo al a los codigos retornados en la funcion getCountries.
      * Casos de usos: Si getCountries es vacio, retorna el arreglo que ingresa por parametro.
@@ -132,7 +153,7 @@ export declare class DataFormEcComponent extends ComponentHelper implements OnIn
     updatePostalCodeValidationFacturacion(selectedCountry: any): void;
     updateDocumentValidation(selectedDocumentType: any): void;
     updateDocumentValidationFacturacion(selectedDocumentType: any): void;
-    selectAddress: (items: any, showNotesError?: boolean) => Promise<void>;
+    selectAddress: (items: any, showNotesError?: boolean, explicitConfirmation?: boolean) => Promise<void>;
     getMode: () => boolean;
     setMode: (mode: any) => void;
     getModeFacturacion: () => boolean;
@@ -146,6 +167,8 @@ export declare class DataFormEcComponent extends ComponentHelper implements OnIn
     toggleAddressDropdown: () => void;
     selectAddressFromDropdown: (address: any) => void;
     onSelectionNotesChange: () => void;
+    requiresExplicitAddressConfirmation: () => boolean;
+    confirmAddressStep: () => Promise<void>;
     getSelectedAddressLabel: () => any;
     getAddressOptionLabel: (address: any) => string;
     getDefaultSelectedLabel: () => any;
@@ -160,6 +183,7 @@ export declare class DataFormEcComponent extends ComponentHelper implements OnIn
     private applySelectedAddress;
     private setCheckoutFormReadonly;
     private shouldAutoSelectAddress;
+    private isAddressSelectionNotesRequired;
     private addTemporaryAddressFromForm;
     private removeTemporaryAddress;
     private buildCurrentState;

package/lib/services/cart.service.d.ts

@@ -1,6 +1,7 @@
+import { OnDestroy } from '@angular/core';
 import { Product } from '../interfaces/product';
 import { CartItem, CartItemPricing } from '../interfaces/cart-item';
-import { Observable } from 'rxjs';
+import { Observable, Subscription } from 'rxjs';
 import { ConnectionService } from '../api/connection.service';
 import { Constants } from '../core.consts';
 import { AuthService } from './auth.service';
@@ -9,11 +10,26 @@ import { OrderUtilityService } from '../utils/order-util.service';
 import { CheckoutData } from '../interfaces/checkout-data';
 import { CartAffordable } from '../interfaces/cart/cart-affordable';
 import { ChannelConfigService } from './channel-config.service';
-import { AnalyticsService } from '../../public-api';
+import { AnalyticsService } from './analytics.service';
 import { Router } from '@angular/router';
 import { Channel } from '../interfaces/channel';
 import { CartItemPricePresentation, CartSummaryPricePresentation, PricePresentationService } from '../utils/price-presentation.service';
-export declare class CartService {
+export interface CartResponseContext {
+    token: string | null;
+    generation: number;
+    requestId: number;
+    allowTokenChange: boolean;
+}
+export declare type CartSyncStatus = 'ready' | 'syncing' | 'invalidated' | 'error' | 'authentication-changed';
+export interface CartSyncState {
+    status: CartSyncStatus;
+    reason?: 'checkout-interrupted' | 'network' | 'server' | 'token-unavailable' | 'authentication' | 'invalid-response' | 'cart-not-active';
+}
+export interface CartCheckoutInvalidation {
+    transitionId: string;
+    reason: 'checkout-completed' | 'cart-not-active';
+}
+export declare class CartService implements OnDestroy {
     private connection;
     private toastrService;
     private consts;
@@ -27,9 +43,17 @@ export declare class CartService {
     private couponSubject;
     private cartSubject;
     private requestInProcess;
+    private cartSyncStateSubject;
     private promotionsSubject;
+    private cartBootstrapRecoverySubject;
+    private cartCheckoutInvalidationSubject;
     private balanceCustomerSubject;
     private items;
+    private pendingBootstrapCartAdds;
+    private readonly maxPendingBootstrapCartAdds;
+    private pendingBootstrapCartAddsLimitNotified;
+    private pendingBootstrapCartAddInFlight;
+    private pendingBootstrapCartQueueGeneration;
     private count;
     private locale;
     private logged_in;
@@ -45,9 +69,53 @@ export declare class CartService {
     addressBookApi: () => string;
     taxesApi: () => string;
     cart_token: any;
+    private cartLifecycleGeneration;
+    private cartRequestId;
+    private lastAppliedCartRequestId;
+    private readonly cartSyncKey;
+    private readonly tabId;
+    private readonly seenCartSyncEvents;
+    private cartSyncBlocked;
+    private cartSyncReading;
+    private cartSyncReadAgain;
+    private cartSyncTimer;
+    private pendingCheckoutRecovery;
+    private cartNotActiveRecovery;
+    private cartNotActiveTransitionId;
+    private cartNotActiveToken;
+    private cartNotActiveRecoveryTimer;
+    private cartBootstrapLookupInFlight;
+    private cartBootstrapPickup;
+    private cartBootstrapAllowsPendingAdds;
+    private cartBootstrapLookupRequiredForRetry;
+    private cartBootstrapPickupRequiredForRetry;
+    private cartBootstrapRecoveryNavigation;
+    private lastRouterNavigationId;
+    private routerNavigationSubscription;
+    private activeCheckoutTransitionId;
+    private completedCheckoutTransitionId;
+    private authContextBlocked;
+    private checkoutRecoveryTimer;
+    private checkoutInvalidatedAt;
+    private readonly checkoutRecoveryTimeoutMs;
+    private readonly cartRequestTimeoutMs;
+    private authRetryAllowed;
+    private authContext;
+    private pendingGuestCartAssociationToken;
+    private readonly storageListener;
+    private readonly visibilityListener;
+    private readonly pageshowListener;
     cartItems: Observable<CartItem[]>;
     coupon: Observable<any>;
     loading: Observable<boolean>;
+    /** Estado que permite a los consumidores diferenciar el carrito listo de una recuperación pendiente o fallida. */
+    cartSyncState: Observable<CartSyncState>;
+    /** Emite únicamente si el bootstrap descartó un token inactivo y recuperó otro carrito correctamente. */
+    cartBootstrapRecovery: Observable<{
+        reason: "inactive-token-replaced";
+    }>;
+    /** Notifica al checkout montado cuando se invalida el token que su CartService estaba usando. */
+    cartCheckoutInvalidation: Observable<CartCheckoutInvalidation>;
     cart: Observable<any>;
     promotions: Observable<CheckoutData[]>;
     deleting: Boolean;
@@ -67,10 +135,49 @@ export declare class CartService {
     showMax$: Observable<boolean>;
     showPrice$: Observable<boolean>;
     constructor(connection: ConnectionService, toastrService: ToastService, consts: Constants, authService: AuthService, orderUtils: OrderUtilityService, analyticsService: AnalyticsService, channelConfigService: ChannelConfigService, router: Router, pricePresentationService: PricePresentationService);
+    ngOnDestroy(): void;
+    /** Consume el evento de bootstrap una sola vez y solo durante la navegación que inició la recuperación. */
+    consumeCartBootstrapRecovery(): boolean;
+    private getCurrentRouterNavigationId;
+    private markCartBootstrapRecoveryPending;
+    private completeCartBootstrapRecovery;
+    private createCartSyncId;
+    private getAuthContext;
+    private cartTransitionIdForToken;
+    private notifyCheckoutInvalidation;
+    private publishCartSync;
+    private handleStorageEvent;
+    private receiveCartSync;
+    private checkPendingCartSync;
+    private scheduleCartRefresh;
+    private refreshCartFromBackend;
+    private setCartSyncState;
+    private startCheckoutRecoveryWatchdog;
+    private markInterruptedCheckoutIfExpired;
+    private invalidateLocalCart;
+    /** Reintenta una lectura fallida. Si el token ya fue invalidado, no crea otro carrito. */
+    retryCartSync: () => boolean;
+    /** Reanuda explícitamente un checkout interrumpido consultando /carts sin token. */
+    recoverInterruptedCheckout: () => boolean;
+    /** Impide enviar nuevas mutaciones mientras la pestaña reconcilia una invalidación remota. */
+    canMutateCart: () => boolean;
+    /** Confirma que el resumen listo ya pertenece al contexto de autenticación vigente. */
+    isCartReadyForCurrentAuthContext: () => boolean;
+    private discardPendingBootstrapCartAdds;
+    private flushPendingBootstrapCartAdds;
+    /** Detecta el contrato de carrito finalizado sin tratar otros conflictos HTTP como invalidez del carrito. */
+    isCartNotActiveError: (error: any) => boolean;
+    /** Consume un CART_NOT_ACTIVE, invalida solo el token de esa solicitud e inicia una recuperación única. */
+    handleCartMutationError: (error: any, requestToken?: string) => boolean;
+    private startCartNotActiveRecovery;
+    private startCartNotActiveRecoveryWatchdog;
     getCart2(): CartItem[];
     getAddressBook: () => Promise<any>;
-    getTaxes: () => Promise<import("rxjs").Subscription>;
+    getTaxes: () => Promise<Subscription>;
     private getCart;
+    private startCartBootstrapPickup;
+    private resumeCartBootstrapIfInvalidated;
+    private finishCheckoutCartRecovery;
     private getCartByToken;
     private getCartByCustomer;
     /**
@@ -78,6 +185,12 @@ export declare class CartService {
      *  CART CRUD SERVER'S SYNCRONIZED
      */
     private initializeCart;
+    /** Captura la generación del ciclo del carrito y el orden de inicio de la petición. */
+    captureCartResponseContext: (allowTokenChange?: boolean) => CartResponseContext;
+    isCartResponseContextCurrent: (context: CartResponseContext) => boolean;
+    isCartBusinessError: (response: any) => boolean;
+    /** Adopta y sincroniza un resumen exitoso si todavía pertenece a la versión vigente del carrito. */
+    applyCartResponse: (response: any, context: CartResponseContext, emitEvent?: boolean, publishInvalidation?: boolean, flushPendingAdds?: boolean) => boolean;
     /**
      * Reasigna `product.price` al precio base legacy que espera el template histórico del carrito.
      *
@@ -115,7 +228,7 @@ export declare class CartService {
      *  @public
      *  CART CRUD
      */
-    addToCart: (product: Product, quantity: number, variant_id: any, comments?: string) => void;
+    addToCart: (product: Product, quantity: number, variant_id: any, comments?: string, fromBootstrapQueue?: boolean, queueGeneration?: number) => void;
     addToLot: (product: Product, quantity: number, variant_id: any, id?: any, order_item_id?: any, lot_quantity?: any, unit_price?: any, unit_total?: any, ajustement_total?: any, total_lot?: any, lot_status?: any, date_request?: any, notes?: any, shipping_address_id?: any, shipping_address_name?: any, action?: any) => void;
     addToCartPromise: (product: Product, quantity: number, variant_id: any, comments?: string) => Promise<{
         error: boolean;
@@ -134,7 +247,7 @@ export declare class CartService {
     clearAndResetCustomerCart(): void;
     handleError: (error: {
         error: string;
-    }) => void;
+    }, requestToken?: string) => void;
     getCountFromItemInCart: (codeVariant: any) => number;
     findItemByIdVariant: (variant_id: any) => any;
     findItem: (product_id: any) => any;
@@ -212,7 +325,7 @@ export declare class CartService {
     changeHaveToUpdate: (value: any) => any;
     readyForCheckout: (successCallback?: Function, errorCallback?: Function) => CartAffordable;
     updateItemsOnError: (itemsWithError: any[], code: string) => void;
-    loadCartByToken: (token: string) => Promise<import("rxjs").Subscription>;
+    loadCartByToken: (token: string) => Promise<Subscription>;
     /**
      *  UTILS
      */

package/lib/services/checkout/addressing.service.d.ts

@@ -241,7 +241,7 @@ export declare class AddressingService extends StepService {
             };
         };
     };
-    setTypeSelectAddress: (type: typeSelectAddress) => void;
+    setTypeSelectAddress: (type: boolean | "ONLY_LOAD_ADDRESS" | "ONLY_ADDRESS_SELECTION" | "LOAD_ADDRESS_AND_SELECTION") => void;
     setTypeForms: (type: typeForms) => void;
 }
 export {};

package/lib/services/checkout/checkout.service.d.ts

@@ -40,6 +40,7 @@ export declare class CheckoutService implements OnInit {
     private asociatedDataSubject;
     private order;
     private checkout_data;
+    private checkoutStateGeneration;
     total: any;
     private cartLocal;
     private user;
@@ -61,6 +62,8 @@ export declare class CheckoutService implements OnInit {
     setSteps: (steps: StepI[], autohandle?: boolean) => void;
     setStepReady: (step_number: any, data: any, order?: any, automatic?: any) => Promise<boolean>;
     setStepDoing: (step_number: any) => Promise<boolean>;
+    /** Invalida de inmediato los datos y pasos del checkout asociado a un carrito finalizado. */
+    invalidateCheckoutState: () => void;
     restartAllStepsFrom: (step_number: any, included?: boolean, update?: boolean) => Step[];
     isCheckoutReady: () => boolean;
     isStepReady: (step_name: any) => any;

package/lib/services/checkout/shipment.service.d.ts

@@ -44,8 +44,8 @@ export declare class ShipmentService extends StepService {
     constructor(connection: ConnectionService, transformer: ShipmentDataTransformer, shippingPriceDisplay: ShippingPriceDisplayService, analyticsService: AnalyticsService, consts: Constants, cartService: CartService, storesService: StoresService, checkoutService: CheckoutService);
     getShipmentMethods: () => Promise<any[]>;
     getShippingOptions: () => Promise<any[]>;
-    setMethod: (method: any) => Promise<void>;
-    setMethodOnly: (method: any) => Promise<void>;
+    setMethod: (method: any) => Promise<boolean>;
+    setMethodOnly: (method: any) => Promise<boolean>;
     setShippingOption: (payload: {
         method: string;
         option: string;

package/lib/services/gift-card.service.d.ts

@@ -14,6 +14,7 @@ export declare class GiftCardService {
     setCoupon: (coupon: any) => void;
     removeCoupon: () => void;
     deleteCoupon: () => void;
+    private setOperationError;
     handleResponse: (response: any, coupon: any) => void;
     avoidCoupon: () => void;
 }